aboutsummaryrefslogtreecommitdiff
path: root/noao/onedspec/specplot.key
blob: acb61487330dfc66b1169376b20abdfbef6e6309 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
SPECPLOT COMMAND OPTIONS

				SUMMARY

? Help                    o Reorder                 v Velocity plot
a Append spectrum         p Position label          w Window
d Delete spectrum         q Quit                    x No scaling
e Undelete spectrum       r Redraw                  y Offset layout
f Toggle world/pixel      s Shift                   z Scale layout
i Insert spectrum         t Set X scale             
l Label                   u Set wavelength          

:/title <val>              :move[#] <to_index>        :ulabel[#|*] <val>
:/xlabel <val>             :offset[#|*] <val>         :units[#|*] <val>
:/xwindow <min max>        :ptype[#|*] <val>          :velocity[#|*] <val>
:/ylabel <val>             :redshift[#|*] <val>       :vshow <file>
:/ywindow <min max>        :scale[#|*] <val>          :w0[#|*] <val>
:color[#|*] <val>          :shift[#|*] <val>          :wpc[#|*] <val>
:fraction <val>            :show <file>               :xlpos[#|*] <val>
:label <val>               :step <val>                :ylpos[#|*] <val>

				CURSOR COMMANDS

The indicated spectrum is the one with a point closest to the cursor position.

? - Print help summary
a - Append a new spectrum following the indicated spectrum
d - Delete the indicated spectrum
e - Insert last deleted spectrum before indicated spectrum
f - Toggle between world coordinates and logical pixel coordinates
i - Insert a new spectrum before the indicated spectrum
l - Define the user label at the indicated position
o - Reorder the spectra to eliminate gaps
p - Define the label position at the indicated position
q - Quit
r - Redraw the plot
s - Repeatedly shift the indicated spectrum position with the cursor
     q - Quit shift                      x - Shift horizontally in velocity
     s - Shift vertically in scale       y - Shift vertically in offset
     t - Shift horizontally in velocity  z - Shift horizontally in velocity
         and vertically in scale             and vertically in offset
t - Set a wavelength scale using the cursor
u - Set a wavelength point using the cursor
v - Set velocity plot with zero point at cursor
w - Window the plot
x - Cancel all scales and offsets
y - Automatically layout the spectra with offsets to common mean
z - Automatically layout the spectra scaled to common mean


			COLON COMMANDS

A command without a value generally shows the current value of the
parameter while with a value it sets the value of the parameter.  The
show commands print to the terminal unless a file is given.  For the
spectrum parameters the index specification, "[#]", is optional.  If
absent the nearest spectrum to the cursor when the command is given is
selected except that for the "units" command all spectra are selected.
The index is either a number or the character *.  The latter
applies the command to all the spectra.

:show <file>			Show spectrum parameters (file optional)
:vshow <file>			Show verbose parameters (file optional)
:step <val>			Set or show step
:fraction <val>			Set or show autolayout fraction
:label <val>			Set or show label type
				  (none|imtitle|imname|index|user)

:move[#] <to_index>		Move spectrum to new index position
:shift[#|*] <val>		Shift spectra by adding to index
:w0[#|*] <val>			Set or show zero point wavelength
:wpc[#|*] <val>			Set or show wavelength per channel
:velocity[#|*] <val>		Set or show radial velocity (km/s)
:redshift[#|*] <val>		Set or show redshift
:offset[#|*] <val>		Set or show intensity offset
:scale[#|*] <val>		Set or show intensity scale
:xlpos[#|*] <val>		Set or show X label position
:ylpos[#|*] <val>		Set or show Y label position
:ptype[#|*] <val>		Set or show plotting type
:color[#|*] <val>		Set or show color (1-9)
:ulabel[#|*] <val>		Set or show user labels
:units[#|*] <val>		Change coordinate units (see below)

:/title <val>			Set the title of the graph
:/xlabel <val>			Set the X label of the graph
:/ylabel <val>			Set the Y label of the graph
:/xwindow <min max>		Set the X graph range
				  (use INDEF for autoscaling)
:/ywindow <min max>		Set the X graph range
				  (use INDEF for autoscaling)
 

Examples:
    w0		  Print value of wavelength zero point
    w0 4010	  Set wavelength zero point of spectrum nearest the cursor
    w0[3] 4010	  Set wavelength zero point of spectrum with index 3
    w0[*] 4010	  Set wavelength zero point of all spectra


				UNITS

The units are specified by strings having a unit type from the list
below along with the possible modifiers, "inverse", to select
the inverse of the unit and "log" to select logarithmic units.
The various identifiers may be abbreviated as words but the syntax
is not sophisticated enough to recognized standard scientific abbreviations
such as mm for millimeter.

	   angstroms - Wavelength in Angstroms
	  nanometers - Wavelength in nanometers
	millimicrons - Wavelength in millimicrons
	     microns - Wavelength in microns
	 millimeters - Wavelength in millimeters
	  centimeter - Wavelength in centimeters
	      meters - Wavelength in meters
	       hertz - Frequency in hertz (cycles per second)
	   kilohertz - Frequency in kilohertz
	   megahertz - Frequency in megahertz
	    gigahertz - Frequency in gigahertz
	         m/s - Velocity in meters per second
	        km/s - Velocity in kilometers per second
	          ev - Energy in electron volts
	         kev - Energy in kilo electron volts
	         mev - Energy in mega electron volts
		   z - Redshift

The velocity and redshift units require a trailing value and unit defining the
velocity zero point.  For example to plot velocity relative to
a wavelength of 1 micron the unit string would be:

	km/s 1 micron

The syntax :units[#] km/s <value> <unit> is available to plot different
(or the same) spectrum with different features at zero velocity.