PLOT: Plot a Row or Column of an Image or Spectrum

Form: PLOT b1 b2 b3 .. [R=n1,n2] [C=n1,n2] [RS=r1,r2] [CS=c1,c2]
 $$
[XS=f] [XE=f] [MIN=f] [MAX=f] [XMIN=] [XMAX=] [YMIN=] [YMAX=]
 $$
[SEMILOG] [LOG] [R4] [NH=nh] [NV=nv] [OLD]
 $$
[HIST] [POINTS=psty] [USER] [PIXEL] [GRID]
 $$
[NOLABEL] [NOERASE] [INFO] [PROFILE] [MULT=]
 $$
[INT] [MACRO=file] [HARD] [PORT] [PSFILE=file] [EPS] [WAIT]
b1,b2,b3..
the image buffers which will be plotted (up to 15).
BOX=b
limits the image 'buf' to box 'b'.
R=n1,n2, C=n1,n2
plots the selected row(s) or column(s).
RS=r1,r2
plots sum of selected rows.
CS=c1,c2
plots sum of selected columns.
XS, XE
select limits for x-axis of plot (also XMIN & XMAX).
MIN, MAX
select limits for y-axis of plot (also YMIN & YMAX).
SEMILOG
plots log(y) against x.
LOG
plots log(y) against log(x).
R4
plot x**0.25 instead of x.
NH=nh, NV=nv
number of horizontal and vertical windows for multiple plots in multiple windows
WIND=nx,ny,iw
sets desired plotting window
OLD
uses parameters from previous plot.
HIST
produces a histogram style (step) plot instead of a line plot.
POINTS=psty
Plot points in the given Mongo style instead of a line plot.
USER
uses axis scaling and labels stored in the FITS header.
PIXEL
force plot in pixels of wavelength calibrated spectra.
GRID
produces a full plot grid.
NOLABEL
suppresses all labelling of the plot.
NOERASE
do not erase the previous plot to allow overlapping plots (see WAIT for hardcopy).
INFO
puts additional information about the data on the plot.
PROFILE
plots results from the PROFILE common block
MULT=n
plots the nth galaxy from the internal multiple nucleus common block
INT
places the user in interactive Mongo after plotting.
MACRO=file
executes the Mongo macro file 'file' after plotting.
HARD
sends the output to the hardcopy device specified by the TERM command.
PORT
make an portrait mode plot (default: landscape).
WAIT
keep the hardcopy channel open so subsequent plots will appear on the same image (or PostScript file).
PSFILE=file
directs PostScript output to the specified file, rather than sending it to the printer
EPS
make an Encapsulated PostScript file.

PLOT produces a plot of a selected rows, columns, or spectra for up to 15 different images, using the LickMongo plotting package. All the specified buffers will come out on the same plot, or each successive specified buffer can come out in a series of windows (with the number of horizontal and vertical windows specified by the NH= and NV= keywords). If desired, all the plots can come out in a single subwindow using the WIND= keyword. PLOT also allows the possibility of hardcopy on your hardcopy device (as specified by the TERM HARCOPY= command).

The index 'buf' specifies which of the image buffers contains the image for plotting a row or column. No 'buf' is needed to plot results from the PROFILE or the MULT common block, which contain profiles determined with the PROFILE or SNUC command. The optional index 'box' specifies one of the 10 available boxes (see BOX command) to be used to select a sub-section of an image. Row 'n' is displayed by using the option R=n, column 'n' by using the C=n option, and spectrum 'n' by using no option. The RS and CS keywords are used to display the sum of the selected rows or columns in an image.

Normally the endpoints of the x- and y-axes are selected in this way: The x-axis runs over the entire row, column, or spectrum selected. The minimum and maximum y-values define the corresponding limits for the y-axis.

XS and XE override this autoscaling and allow you to set the limits along the X-axis. XS and XE refer to the starting and ending X values in pixels (or Angstroms for a spectrum with a wavelength scale determined.) If the USER option is defined, XS and XE are in the user-defined coordinates. MIN and MAX override the autoscaling and allow the user to set the limits along the Y-axis.

The keyword GRID will produce a coordinate grid on the plot. This is very useful if you are trying to make measurements from a hard copy plot. The keyword INFO will put some additional information onto the plot.

LOG and SEMILOG will produce Log-Log or Log-Linear plots as desired. The R4 keyword will plot $x^1/4$ along the x-axis, particularly useful when plotting the output image from PROFILE. NOLABEL prevents the drawing of axis labels and the name of the image or spectrum. Use this with NOERASE to overplot several graphs. The OLD keyword will produce a plot using the last used set of parameters.

If multiple window are desired, use the NH= and NV= keywords to set the number of windows in the horizontal and vertical directions, respectively. The plots of b1, b2, b3 ... will appear in the window starting in the upper left and progressing right across the page and then down. If limits are specified with MIN and MAX, e.g., all windows will have these limits. If no limits are specified, each window will autoscale individually.

If you wish all plots to be sent to a subwindow, use the WIND= keyword, with three parameters following the normal LickMongo syntax; number of windows in the x direction, number of windows in the ydirection, and a specification of which window to draw into (e.g. WIND=2,3,5 will draw in the upper left window of a 2x3 layout).

HARD will send the plot to the hardcopy device as specified by the TERM command (or the default device). If you use the PSFILE=file option, PostScript output is sent to the specified file, rather than directly to the printer. The PORT keyword will make a Portrait mode plot (long side of the paper vertical), and EPS will make an Encapsulated PostScript file. EPS should be used in conjunction with the PSFILE= keyword to create the EPS file.

The MACRO=file keyword can be used to execute the Mongo macro file 'file' after each plot is made. This provides a way to add additional annotation or data to a plot (especially for preparation of figures for papers or talks).

INT is an alternative to MACRO= that invokes an interactive LickMongo shell allowing users to enter plot annotations and other commands interactively. Note that if this is done on a screen plot you need to use the WRITE ALL ... command in LickMongo to save the macro, then when you make a hardcopy you can use the MACRO= keyword to execute the LickMongo commands.) If MACRO= and INT are both specified, the macro file will be executed before the user is put into the interactive LickMongo shell.

USER will scale and label the axes according to the user-defined coordinates instead of pixels. This is done using the CRVALn, CRPIXn, CDELTm, CTYPEn and BUNIT cards in the image (or spectrum) FITS header. The conversion between user coordinates and pixels is given by:

for Columns, or for Rows, where
CRPIXn = INTEGER equal to the starting pixel of a Column (n=1) or a Row (n=2) in an image. For spectra, CRPIX1=1 typically.
CRVALn = REAL value of user coordinates at pixel=CRPIXn. For spectra, CRVAL1 = the starting wavelength (of pixel=1 typically).
CDELTn = REAL value scaling factor between rows (n=2) or columns (n=1) and user coordinates. For spectra, CDELT1 = linear dispersion.

The X-axis label is taken from the CTYPEn card, which is a CHARACTER string surrounded by single quote (') marks. The Y-axis label is taken from the BUNIT card, which is a CHARACTER string surrounded by single quote (') marks containing the appropriate units for the "Intensity" units of the pixels (e.g. counts/sec or flux). These header cards may be set using the HEDIT command. If a particular FITS card is not found, appropriate defaults are chosen, but be warned: older images and spectra from the Lick Data Taking programs do not conform to the FITS standard and may give strange results.

Examples:

PLOT 1 R=100
Plots row 100 of image 1.
PLOT 1 RS=100,120 MIN=0. MAX=100.
Plots sum of rows 100 to 120 of image 1, with Y-axis running from 0. to 100.
PLOT 4 XS=20 XE=45 R=4
Plots row 4 of image 4, where the X-axis runs over columns 20 through 45.
PLOT 4 OLD SEMILOG
Plot the old graph (whatever it was) in semi-log format.
PLOT 1
Plots the spectrum in buffer 1. No row or column specifers are necessary.
PLOT 4 INT
After plotting the spectrum (note that 4 must be a spectrum as no row or col was specified!) enter interactive Mongo mode to label and finish the plot.
PLOT 3 R=50 HIST
Draws a plot of row 50 in image 3. The plot is done in histogram style.
PLOT 3 MIN=0.0 MAX=1000. HIST
Does the same as example 8, but sets the Y-axis to run from 0.0 to 1000.0.
PLOT 2 R=50 HARD USER
Plots R=50 of image 2 on the Imagen laser printer and scales and labels the axes with the user coordinate info stored in the FITS header of image 2.