XCSAO Cursor Commands

In xcsao, four different sets of cursor commands are active, depending on what kind of plot you are looking at:
The final display (dispmode=1) shows both the object spectrum and the cross-correlation vector. Fit parameters, display mode, and template use can be changed.
Spectrum display with labelled lines (dispmode=2 or 3) shows the spectrum with emission and absorption lines labelled. Fit parameters, display mode, velocity, and template use can be changed.
Intermediate plots except continuum fitting, including the object spectrum, continuum removal, Fourier transforms, and cross-correlation vector, can be smoothed and zoomed, among other things.

XCSAO Final Display Cursor Commands

The following keystrokes are active for the final plot displaying the spectrum and the correlation peak (dispmode=1) in addition to the normal IRAF cursor facilities (a list of which is available by typing ":.help"). The numbers in parentheses indicate the version of rvsao when a command was implemented for the first time. Note that these commands are different than those used in the intermediate displays.
@
Make a hard copy on the device designated by plotter.
c
Reset correlation peak fitting function and fraction to fit (1.7) and transform filter parameters. (2.0)
d
Toggle the debugging flag to print more information (or less) about processing.
e
Edit the spectrum and recorrelate it.
f
Change transform filter parameters. (1.7)
g
Smooth spectrum n times before plotting. This only affects the current spectrum display and the final spectrum graph, not the spectrum data. (1.8)
j
Set quality flag to conditional (1.8)
k
Toggle to continuum-subtracted spectrum and back, if in modes 2 or 3 or if displaying labeled lines with the l command. (2.1)
l
Plot spectrum with absorption lines labelled. Label emission lines if the R-value for an emission line template (emission lines not chopped) is > 5 or if they have already been fit by EMSAO. (dispmode=2)
m
Change the format in which to display summary page on an interactive display device and on the hard-copy device plotter. If the format code is negated, the spectrum is plotted with the intensity scaled from zero rather than the spectrum minimum.
=-1 Display all of spectrum, with portion used marked, scaled from an intensity of zero, and cross-correlation with template information.
=0 Display only part of spectrum used in correlation and cross-correlation with template information.
=1 Display all of spectrum, with portion used marked, and cross-correlation with template information.
=2 Display spectrum with absorption and known emission lines labelled and both template and emission line information. (2.0)
n
Set quality flag to unacceptable. (1.8)
p
Rerun this cross-correlation, stopping in the filtered cross-correlation plot to select a peak other than the highest one.
q
Leave plot, completing this object spectrum.
x
Exit from this spectrum.
r
Replot cross-correlation summary page.
t
Plot the correlation and mark the spectrum for the t'th template as listed on the graphical summary display. This list is ordered from the best correlation (highest R-value) to the current object spectrum to the worst. This order can change with every object spectrum, while the ASCII report always lists the templates in the same order they are entered in the templates parameter. (2.0)
v
Change the velocity limits within which a correlation peak is allowed. (1.7)
x
Exit without updating the header.
y
Set quality flag in header to yes. (1.8)
? or space
Display menu of cursor commands for this display mode to non-graphics window

XCSAO Line-Labelled Display Cursor Commands

The following keystrokes are active for the final line-labelled plot (dispmode=2) in addition to the normal IRAF cursor facilities (a list of which is available by typing ":.help"). The numbers in parentheses indicate the version of rvsao when a command was implemented for the first time. Note that these commands are different than those used in the intermediate displays.
@
Make a hard copy on the device designated by plotter.
/
Toggle the plot between full screen spectrum display and spectrum plus line and template results.
e
Edit the spectrum.
g
Smooth spectrum n times before plotting. This only affects the current spectrum display and the final spectrum graph, not the spectrum data. (1.8)
j
Set quality flag to conditional (1.8)
n
Set quality flag to unacceptable. (1.8)
p
Replot the current display.
t
Plot line labels at the velocity from the correlation of the t'th template.(1.9)
u
Unzoom the spectrum graph if using display mode 2 (1.8)
v
Plot line labels at selected velocity e>mission x>correlation c>ombined.
x
Plot the spectrum, without line labels, and the cross-correlation on the same page. (dispmode=1)
y
Set quality flag in header to yes. (1.8)
z
Zoom in on the spectrum graph between two z cursor clicks. (1.8)
.
After d, cancel deletion. After z, cancel zoom.
? or space
Display menu of cursor commands for this display mode to non-graphics window

XCSAO Intermediate Display Cursor Commands

The following keystrokes are active for intermediate spectrum and cross-correlation plots in addition to the normal IRAF cursor facilities. A list of these commands is available by typing ? or h. A list of available IRAF cursor commands is available by typing ":.help". The numbers in parentheses indicate the version of rvsao when a command was implemented for the first time. Note that different keystrokes are active for the final summary displays.
@
Make a hard copy on the device designated by plotter.
c
Prints cursor position in x and y. This is the default. All other undefined keys perform this same function.
d
Replaces a region between the marked vertical cursors with interpolated values from the edges of the marked region. This is typically used to eliminate poorly subtracted night sky lines or emission lines.
g
Smooth spectrum n times before plotting. This only affects the current spectrum display, not the spectrum data. (changed from n to match other modes in RVSAO 2.0)
h
Toggle display of heading above the graph. For figures for publication, this information is often unnecessary or dupilcated in the figure caption. A cleaner graph can be created by turning the header display off. Note that the aspect ration of the graph will change. (2.0)
p
Forces the current vertical cursor location to be chosen as the peak in the cross-correlation function which is used to obtain the redshift and dispersion. The maximum within 25 pixels of the cursor is actually used. (In display of filtered cross-correlation only)
q
Quit and exit.
r
Forces a replot of the current spectrum at the original scale.
s
Change peak search half-width. (in display of filtered cross-correlation only)
u
Redisplay the entire plot after zooming.
x
Cancel zoom or delete command after first position has been entered.
z
Zoom in on the region marked by two successive 's
? (or space)
Display a menu of these cursor commands to the non-graphics window

Last updated 19 November 2009

[xcsao]