cpd

set current plotting device

Syntax:	cpd	<plot device>
	cpd	<filename>
	cpd	<filename>/{ps,cps,vps,vcps}
	cpd	none

Set current plot device. The same can be achieved with the setplot device command, which takes the same options. In XSPEC12 as in previous versions, the plot device options are those allowed by the PGPLOT library.

When plotting to the screen, the most commonly used devices are /xs (/xserve) and /xw (/xwindow). If you select /xs, the plot window is persistent: it remains visible and in the selected position even after the XSPEC session is finished. With /xw the plot window closes at the end of the XSPEC session. Also note that on some platforms, when using /xs in multiple desktops, you might not see the window appear in a second desktop if it is still open in the first.

If the second argument does not start with a '/' character, which indicates that the string represents a PGPLOT device, it is taken to be a filename for Postscript output, and the default postscript driver will be used. The default postscript driver produces a monochrome plot in landscape orientation.

The filename argument can be followed by a '/' that specifies a particular postscript driver variant. Allowable variants are: cps (color postscript), vps (monochrome portrait orientation), and vcps (color portrait orientation), as well as the default, ps.

PGPLOT devices

A number of plot device types are supported in XSPEC. PGPLOT devices available on Unix machines are:

/GIF	Graphics Interchange Format file, landscape orientation
/VGIF	Graphics Interchange Format file, portrait orientation
/NULL	Null device, no output
/PPM	Portable Pixel Map file, landscape orientation
/VPPM	Portable Pixel Map file, portrait orientation
/PS	PostScript file, landscape orientation
/VPS	PostScript file, portrait orientation
/CPS	Colour PostScript file, landscape orientation
/VCPS	Colour PostScript file, portrait orientation
/TEK4010	Tektronix 4010 terminal
/GF	GraphOn Tek terminal emulator
/RETRO	Retrographics VT640 Tek emulator
/GTERM	Color gterm terminal emulator
/XTERM	XTERM Tek terminal emulator
/ZSTEM	ZSTEM Tek terminal emulator
/V603	Visual 603 terminal
/KRM3	Kermit 3 IBM-PC terminal emulator
/TK4100	Tektronix 4100 terminals
/VT125DEC	VT125 and other REGIS terminals
/XDISP	pgdisp or figdisp server
/XWINDOW	X window window@node:display.screen/xw
/XSERVE	An /XWINDOW window that persists for re-use

cpd none closes the device. For Postscript output, it flushes the write buffer into the file and closes the file. Note that in XSPEC12, each plot command produces a separate page in the postscript file, unlike previously where each plot overwrote the previous plot.

Examples:

Produce a set of color postscript plots in landscape orientation

// ... commands to produce a plot.
XSPEC12> cpd   dataplot.ps/cps
XSPEC12> plot data chi
XSPEC12> plot ufspec
XSPEC12> plot efficiency
XSPEC12> cpd none

Will produce 3 plots in the file dataplot.ps

Note, in contrast, that the hardcopy command will print only the plot that is currently in a graphics frame.

HEASARC Home | Observatories | Archive | Calibration | Software | Tools | Students/Teachers/Public

Last modified: Friday, 23-Aug-2024 13:20:40 EDT

HEASARC Staff Scientist Position - Applications are now being accepted for a Staff Scientist with significant experience and interest in the technical aspects of astrophysics research, to work in the High Energy Astrophysics Science Archive Research Center (HEASARC) at NASA Goddard Space Flight Center (GSFC) in Greenbelt, MD. Refer to the AAS Job register for full details.