Initial commit

1 files changed, 134 insertions, 0 deletions

diff --git a/noao/onedspec/specplot.key b/noao/onedspec/specplot.key
new file mode 100644
index 00000000..acb61487
--- /dev/null
+++ b/noao/onedspec/specplot.key
@@ -0,0 +1,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.