pc_plot

Syntax

pc_plot --help
pc_plot [options] name
pc_plot -png [options] name
pc_plot -ps [-l] [-xp xoff] [-yp yoff] [options] name
pc_plot -ppm [options] name
pc_plot -ppmx [options] name
pc_plot -xml [options] name
pc_plot -x [-display display] [-xoff xoff] [-yoff yoff] [options] name

Synopsis

Plot the cross polar cap potential, scatter statistics or IMF conditions from a convection map file.

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`-cf cfname`	read command line options from the file cfname.
`-old`	the input file is a `map` format file.
`-vb`	verbose. Log information to the console.
`-w width`	set the width of the plot to width.
`-h height`	set the height of the plot to height.
`-sd yyyymmdd`	plot starting from the date yyyymmdd.
`-st hr:mn`	plot starting from the time hr:mn.
`-ed yyyymmdd`	stop plotting at the date yyyymmdd.
`-et hr:mn`	stop plotting at the time hr:mn.
`-ex hr:mn`	plot an interval whose extent is hr:mn.
`-s`	include the scatter statistics in the plot.
`-b`	include the IMF in the plot.
`-nodelay`	do not use the IMF delay when plotting the IMF.
`-pmin pmin`	set the minimum of the potential scale to be pmin.
`-pmax pmax`	set the maximum of the potential scale to be pmax.
`-smin smin`	set the minimum of the scatter scale to be smin.
`-smax smax`	set the maximum of the scatter scale to be smax.
`-bxmin bxmin`	set the minimum of the X component of the IMF scale to be bxmin.
`-bxmax bxmax`	set the maximum of the X component of the IMF scale to be bxmax.
`-bymin bymin`	set the minimum of the Y component of the IMF scale to be bymin.
`-bymax bymax`	set the maximum of the Y component of the IMF scale to be bymax.
`-bzmin bzmin`	set the minimum of the Z component of the IMF scale to be bzmin.
`-bzmax bzmax`	set the maximum of the Z component of the IMF scale to be bzmax.
`name`	the filename of the `cnvmap` format file to plot.
`-ps`	produce a Portable Network Graphics (PNG) image as the output.
`-ps`	produce a PostScript plot as the output.
`-xp xoff`	set the X offset of the PostScript plot to xoff.
`-yp xoff`	set the Y offset of the PostScript plot to yoff.
`-l`	set the orientation of the PostScript plot to landscape,
`-ppm`	produce a Portable PixMap (PPM) image as the output.
`-ppmx`	produce an extended Portable PixMap (PPMX) image as the output.
`-xml`	produce an XML image representation as the output.
`-x`	plot the data on an X-terminal.
`-display display`	connect to the xterminal named display.
`-xoff xoff`	open the window, xoff pixels from the left edge of the screen.
`-yoff yoff`	open the window ypad pixels from the top edge of the screen.

Description

Plot the cross polar cap potential, scatter statistics or IMF conditions from a convection map file.

The output can be to an X terminal, Portable PixMap (PPM) files, extended Portable PixMap (PPMX), rPlot XML document, Portable Network Graphics (PNG), or PostScript file. The default output is PostScript.

If the "-x" option is specified the program will display plots in an X terminal window in all other cases the output is written to standard out.

Examples

pc_plot -x -old 20040830.map

Plot the cross polar cap potential from the file "20040830.map" on the X terminal.

pc_plot -smax 1400.0 -s 20021219.cnvmap > pc.rp.xml

Generate an rPlot XML plot of the cross polar cap potential and scatter statistics from the file "20021219.map". The plot is stored in the file "pc.rp.xml".