SPEX Reference manual (PDF) - SRON

2.22 Plot: Plotting data and models 35
Warning: To make a plot, always start with a ”plot device” command to open any plot device you wish.
Next select a plot type using ”plot type”. After this you can give any plot commands to modify or display
the plot.
Warning: Some of the more fancy plotting options, like adding labels to a plot, are broken. To make
more sophisticated plots, it is advisable to save the plot to a QDP file with ‘plot adum’ and adapt them
through QDP (Ftools). We intent to update the plotting system in a future version of SPEX.
Syntax
The following syntax rules apply for plot:
plot - (Re)draws the plot on the graphics device. Take care to open at least one device first (with a
”plot dev” command)
plot frame new - Creates a new additional plot frame, where an other plot type can be displayed (or the
same plot type but with different units). Take care to position the viewport of the new and old frames
to the desired locations.
plot frame #i - Sets frame number #i to be the currently active frame. After this command has been
issued, all plot commands will only affect the currently active frame.
plot frame delete #i - Deletes frame number #i.
plot type #a - Specifies what is to be plotted in the selected frame. #a can be any of the plot types
specified in Sect. 5.2.
plot device #a1 [#a2] - Selects a graphics device #a1 and optional file name #a2 (in the case of a
postscript or gif device). File extensions (for example .ps) should be specified. For valid devices, see
Sect. 5.1.
plot close #i - Close graphics device number #i. Note, always close a postscript device before quiting
/spex, otherwise the contents may be corrupted.
plot hlan - Make a hardcopy in landscape orientation and send it to the standard printer. Use is made
of the unix command ”lp -c filename”.
plot hpor - As above, but for portrait orientation
plot x lin - Plot the x-axis on a linear scale
plot x log - Plot the x-axis on a log scale
plot y lin - Plot the y-axis on a linear scale
plot y log - Plot the y-axis on a log scale
plot y mix #r1 #r2 - Plot the y-axis on a mixed linear/logarithmic scale; for y-values below #r1 the
data will be plotted linear, and for y-values above #r1 the data will be plotted logarithmically; the linear
part occupies the fraction of the total frame height given by #r2. See also Sect. 5.8.2.
plot z lin - Plot the z-axis on a linear scale. The z-axis is defined for two-dimensional plots like contour
plots.
plot z log - As above, but using a log scale.
plot ux #a - Set the plot units on the x-axis, #a can be Å, keV, eV, or whatever unit that is allowed.
The allowed values depend upon the plot type. See Sect. 5.8.1 for allowed units for each plot type.
plot ux vel #r #a - Plot the x-axis in velocity units (kms −1 ), with reference energy provided as #r if
#a is ”keV” or reference wavelength provided as #r if #a is ”Ang”. Note that the same zero scale will
be set for all plot windows.
plot uy #a - Same as above, but for the y-axis
plot uz #a - Same as above, but for the z-axis
plot rx #r1 #r2 - set the plot range on the x-axis from #r1 to #r2
plot ry #r1 #r2 - Same as above, but for the y-axis
plot rz #r1 #r2 - Same as above, but for the z-axis
plot view default #l - For #l is true, the default viewport is used. For #l is false, the default viewport
is overruled and you can specify your own viewport limits with the ”set view x” and ”set view y”
commands. Useful for stacking different plot frames.
plot view x #r1 #r2 - Set the x viewport range from #r1 to #r2, where #r1 and #r2 must be in the
range 0–1.
plot view y #r1 #r2 - Same as above, but for the y-range.