istp_plot

Syntax

istp_plot --help
istp_plot [-cf cfname] [options]
istp_plot -png [options]
istp_plot -ps [-land] [-xp xoff] [-yp yoff] [options]
istp_plot -ppm [options]
istp_plot -ppmx [options]
istp_plot -xml [options]
istp_plot -x [-display display] [-xoff xoff] [-yoff yoff] [options]

Synopsis

Plot ISTP data from CDF files.

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.
`-plot names...`	plot the parameters given by the comma separated list of parameters,names.
`-path path`	read the data files from the directory path.
`-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.
`-gse`	plot in GSE coordinates, not GSM.
`-pos`	include spacecraft position in the plot.
`-mfi`	plot MFI data.
`-swe`	plot SWE data.
`-mag`	plot MAG data.
`-pla`	plot PLA data.
`-mgf`	plot MGF data.
`-lep`	plot LEP data.
`-cpi`	plot CPI data.
`-ace`	plot ACE data.
`-wind`	plot Wind data.
`-imp8`	plot IMP8 data.
`-geotail`	plot Geotail data.
`-png`	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 ISTP magnetic field and solar wind data from a set of CDF files. The output can be to an X terminal, XML rplot file, Portable PixMap (PPM) file, extended Portable PixMap (PPMX) file, Portable Network Graphics (PNG), or PostScript file. The default output is XML. The output file is written to standard output.

The program usually plots 24 hours of magnetic field data in GSM co-ordinates for a given start date and satellite.

Magnetic field and solar wind data can be plotted together by combining the appropriate options.

The data files are taken from the sub-directories "ace", "wind", "imp8" and "geotail", of the path given by the "-path" option or by the environment variable ISTP_PATH.

Examples

istp_plot -x -ace -sd 19990406

Plot 24 hours of ACE data starting at 00:00UT on April, 6 1999 on the X terminal.

istp_plot -ps -ace -mfi -swe -sd 19980404 -st 12:00 -ex 8:00 > plot.ps

Generate a PostScript plot of Ace MFI and SWE data for the 8 hour period starting at 12:00UT on April 4, 1998. The plot is stored in the file "plot.ps".

istp_plot -ace -mfi -sd 19990715 -st 4:00 -ed 19990718 -et 12:00 > plot.rp.xml

Generate an XML rPlot file of Ace MFI for the period starting at 04:00UT on July 15, 1999, and ending at 12:00UT July 18,1999. The plot is stored in the file "plot.rp.xml".