| bplot | noao.onedspec | bplot |
bplot -- Plot spectra noninteractively using SPLOT
bplot images [records]
The following parameters are used in response to particular keystrokes. In splot they are query parameters but in bplot they are hidden parameters.
The spectra in the input image list are successively processed by the task splot with input supplied by the cursor parameter and the output sent to the specified graphics device. The range of apertures and bands specified by apertures and bands will be processed for each image. In the iids/irs packages the record extension syntax is used with input root names and a record number list. The hidden parameters from splot apply to this task.
The cursor file(s) consists of line(s) of the form:
[x y 1] key [command]
where x and y are the position of the cursor (may be zero or absent if the cursor position is irrelevant) and key is one of the keystrokes understood by splot . If the key is ":" then the colon command string follows. The default cursor file consists of the single line:
0 0 1 q
If more than one cursor file is specified they are sequentially assigned to each aperture and the list is repeated as needed. This allows the aperture to be manipulated in differing ways.
1. To plot all of apertures of the multiaperture spectra indicated by the file "nite1.lst" on the default plotter and run in the background:
cl> bplot @nite1.lst graphics=stdplot &
2. To preview the plots:
cl> bplot @nite1.lst graphics=stdgraph
3. To produce a histogram type plot about Balmer alpha for aperture 5 of each spectrum with the IRAF banner suppressed:
cl> type curfile
6555 0 1 a
6570 0 1 a
q
cl> splot.options="auto hist nosysid"
cl> splot.xmin=6555
cl> splot.xmax=6570
cl> bplot @nite1.lst apertures=5 cursor=curfile
4. To produce plots with four spectra per page:
cl> bplot @nite1.lst ... >G nite1.mc
cl> gkimosaic nite1.mc dev=stdplot
The first command redirects the output of the graphics to the metacode file nite1.mc. The task gkimosaic is used to make multiple plots per page. Other tasks in the plot package may be used to manipulate and redisplay the contents of the metacode file.
5. To plot a list of apertures with a different cursor file for each aperture:
cl> bplot @nite1.lst apertures=3,9,14 cursor=@nite1.cur
In this case the file "nite1.cur" is assumed to be a list of individual cursor file names, for instance:
cur.03 cur.09 cur.14
that are in one to one correspondence with the range of apertures.
The cursor file command keystrokes cannot include any of the cursor mode (CAPITALIZED) keys. This results from the implementation of the cursor mode commands as external to both BPLOT and SPLOT.
When first entered, SPLOT will always display an initial plot. BPLOT calls SPLOT once for each aperture in each image and thus produces N(apertures)*N(images) initial plots. The plots are not optional because of the possible confusion a blank screen might cause an inexperienced user. If the initial plots are unwanted they must be edited out of the graphics stream. This can be done as follows, by directing the graphics output of BPLOT to a metacode file and then using GKIEXTRACT to remove only the desired plots from the metacode file:
cl> bplot @nite1.lst cursor=curfile >G nite1.mc
cl> gkiextract nite1.mc 2x2 | gkimosaic dev=stdplot
This assumes that curfile is designed to produce only one plot in addition to the non-optional initial plot. In this case there will be two plots per aperture per image and we extract every other plot starting with the second (as encoded in the range string: "2x2").
splot, specplot, slist, gkiextract, gkimosaic, implot, graph, ranges