vec_plot

Syntax

vec_plot --help
vec_plot [options] names...
vec_plot -png [options] names...
vec_plot -ps [-xp xoff] [-yp yoff] [options] names...
vec_plot -ppm [options] names...
vec_plot -ppmx [options] names...
vec_plot -xml [options] names...
vec_plot -x [-display display] [-xoff xoff] [-yoff yoff] [options] names..

Synopsis

Plot vec format files.

Options

`--help`	print the help message and exit.
`--version`	print the RST version number and exit.
`-old_aacgm`	use older AACGM rather than default AACGM-v2 for magnetic coordinates..
`-cf cfname`	read command line options from the file cfname.
`-wdt width`	set the width of the plot to width.
`-logo`	add a credit and logo to the plot.
`-p panel`	set the number of panels in the plot to panel.
`-bgcol aarrggbb`	set the background color to aarrggbb, specified as the hexadecimal value for the 32-bit alpha,red,green and blue component color.
`-txtcol aarrggbb`	set the color of the text to aarrggbb, specified as the hexadecimal value for the 32-bit alpha,red,green and blue component color.
`-grdcol aarrggbb`	set the color of the grid to aarrggbb, specified as the hexadecimal value for the 32-bit alpha,red,green and blue component color.
`name...`	the filenames of the `vec` format files to plot.
`-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.
`-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 vec format 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 PostScript. The output file is written to standard output.

The program will attempt to calculate the number of panels to include in the plot based on the number of input files. However this behavior can be overridden using the "-p" option.

The number and complexity of the command line options makes typing them a laborious process, especially when producing multiple plots. To solve this problem, command line options can be placed in plain text file that can be parsed by the program using the " -cf" option. This allows the user to create a set of configuration files for producing different plots.

Examples

vec_plot -x 20021106*.vec

Plot all the vec format files that match the pattern 20021106*.vec".

vec_plot -logo 20041106*.vec > vec.rp.xml

Generate an rPlot XML plot of all the vec format files that match the pattern 20041106*.vec".