specplot in overlay=? bottom=? left=? top=? right=? labspc=? world=?
This routine plots a spectrum (or any one-dimensional NDF section) in the current (AGI) picture of the graphics device.
S P E C P L O T The plot can basically be an overlay over the most recent data picture inside the current picture, or a new plot inside the current picture. (The current picture after SPECPLOT is the same as before.) The screen contents of the current picture can be erased or not. The plot location and size is governed by the outer and the inner box. The inner box is the area where data are plotted, the outer box contains the inner box and the plot labels. In the overlay case the inner box and its world coordinates are identified with the most recent data picture inside the current picture. No labelling is done in the overlay case, so the outer box has no meaning in this case. In the case of a new plot, the outer box will be identified with the current picture, although the plot labels are allowed to extend beyond this area. Depending on the choice of labelling, a sensible location for the inner box is offered. After the inner box is specified, its world coordinates are enquired. The prompt values correspond to the extreme values found in the data. The location and world coordinates of the inner box are saved as a data picture in the AGI data base. The labelling consists of axes, axis ticks, numeric labels at the major ticks, and text labels. The axes are counted from bottom clockwise. Each axis can be drawn or not. Each drawn axis can have ticks or not. Each axis can have numeric labels or not. The left and right axes can have either horizontal (orthogonal) or vertical (parallel) numeric labels. Each axis can have a text label or not. The kind of labelling is controlled by several 4-character strings. Each character is the switch for axis 1, 2, 3, 4 respectively. "0" turns an option off for that axis, "+" turns it on. For the ticks and for numeric labels of axes 2 and 4, "-" is also allowed. It yields inward ticks and vertical numeric labels. The data can be plotted as a set of markers, as a line-style polygon connecting the data points, or as a bin-style polygon. In addition error bars or pixel width bars can be plotted. Each of the options can be selected independent of the others, i.e. several (or all) options can be selected at the same time. If no variance information is available, error bars are de-selected automatically. Bad data are omitted from the plot. If error bars are selected, bad variances cause the corresponding data also to be omitted. The attributes of the plot can be selected. These are - colour - line thickness - character height (equivalent to marker size) - simple or roman font - dash pattern for polygon connections Most parameters default to the last used value.
specplot spectrum accept This is the simplest way to plot a 1-D data set in its full length. specplot imagerow(-100.:50.,15.) accept This will take a 2-D data set IMAGEROW and plot part of the row specified by the second coordinate being 15. The part of the row plotted corresponds to the first coordinate being between -100 and +50. Note that the decimal point forces use of axis data. Omitting the period would force use of pixel numbers. specplot imagecol(15.,-100.:50.) accept This will take a 2-D data set IMAGEROW and plot part of the column specified by the first coordinate being 15. The part of the row plotted corresponds to the second coordinate being between -100 and +50. Note that the decimal point forces use of axis data. Omitting the period would force use of pixel numbers. specplot spectrum lin=false bin=true accept Replace direct connections between data points by bin-style connections. specplot spectrum mark=1 accept Mark each data point by a diagonal cross. specplot spectrum error=true width=true accept Draw an error bar and a pixel width bar for each data point. specplot spectrum roman=true height=1.5 colour=3 accept Draw text with the roman font, draw text and makers 1.5 times their normal size, and plot the whole thing in green colour. specplot spectrum bottom=Weekday left="Traffic noise [dBA]" accept Specify text labels on the command line instead of constructing them from the file's axis and data info. specplot spectrum overlay=true clear=false accept The position and scale of the plot are determined by the previous plot (which might have been produced by a different application). specplot spectrum world=[0.,1.,-1.,1.] accept Use plot limits different from the extreme data values.
This routine recognises and uses coordinate transformations in AGI pictures.
FIGARO A general data reduction system