Content-type: text/html Man page of voaAreaPlot

voaAreaPlot

Section: User Manuals (1)
Updated: May 2008
Index Return to Main Contents
 

NAME

voaAreaPlot - Plot VOACAP Area Data Files  

SYNOPSIS

voaAreaPlot [options] fileName.voa  

DESCRIPTION

voaAreaPlot A python script used to graphically display the contents of output files produced by VOACAP 'area' calculations. 'fileName.voa' is the path to the .voa input file. The corresponding output file (with the .vg1 extension) must be located in the same directory as the .voa file.  

OPTIONS

--version
Display the version number and exit.
-c, --contours
Plot contours on the map.
-d DATATYPE, --datatype=DATATYPE
An integer number representing the data type (MUF, REL or SNR) to plot. Valid values of DATATYPE are 1 (MUF), 2 (REL) and 3 (SNR). Default value is 1 (MUF)
-h, --help
Print a help message and exit.
-i, --meridian
Plot meridians (lines of constant latitude) on the map..
-l, --parallels (lines of constant longitude) on the map.
Plot parallels.
-m COLOURMAP, --cmap=COLOURMAP
COLOURMAP specifies the Colour map used by the plot. Valid values are; 'autumn', 'bone', 'cool','copper', 'gray', 'hot', 'hsv', 'jet', 'pink', 'spring', 'summer', 'winter'. Default value is 'jet'
-n POI_FILE, --interest=POI_FILE
POI_FILE is a text file with points of interest to plot on the map. The file is comma (,) delimited with a single point of interest on each line in the form "longitude, latitude, text_name". The file format is the same as Garmin's POI csv files. A sample file would look like;

-r RESOLUTION, --resolution=RESOLUTION
A single character that specifies the resolution to plot with. May be one of 'c' (crude), 'l' (low), 'i' (intermediate), 'h' (high), 'f' (full). Default is 'c' (crude).
-v VG_FILES, --vg_files=VG_FILES
VG_FILES specifies which .vg files to plot, e.g. '-v 1,3,5,6' or use '-v a' to print all plots associated with the input file. Default is 1.


36.599998, 28.366667, Tabuk
39.183334, 21.700001, Jeddah
42.799999, 18.299999, Khamis Mushait
40.549999, 21.483334, Taif
50.150002, 26.266666, Dahran

-p PROJECTION, --projection=PROJECTION
PROJECTION specifies the map projection. Valid values are 'cyl' = Cylindrical Equidistant (default), 'mill' = Miller Cylindrical, 'sinu' = Sinusoidal, 'ortho' = Orthographic, 'eqdc' = Equidistant Conic, 'robin' = Robinson, 'moll' = Mollweide & 'tmerc' = Transverse Mercator.
-r RESOLUTION, --resolution=RESOLUTION
A single character representing resolution of the final plot. RESOLUTION may be one of 'c' (crude), 'l' (low), 'i' (intermediate), 'h' (high), 'f' (full)
-t, --terminator
Displays the night/day terminator and Sun's position on the map.
-v VG_FILES, --vg_files=VG_FILES
Specify which vg_files to plot.
-z TIMEZONE, --timezone=TIMEZONE
Displays the night/day terminator and Sun's position on the map.

 

EXAMPLES

voaAreaPlot aDataFile.voa
Plots the contents of the file aDataFile.voa using default settings.
voaAreaPlot -r i -p mill aDataFile.voa
Plots an intermediate resolution miller projection.
voaAreaPlot -m autumn -p ortho aDataFile.voa
Plots an orthographic projection using the colour map 'autumn'.

 

ENVIRONMENT

voaAreaPlot does not require or make use of any environmental variables. The program requires the matlibplot library and basemap toolkit to run.  

BUGS

Probably lots, but none that will corrupt data (all files are opened for reading only). This is definitely alpha release material. Please submit .voa and .vg* files when submitting bug reports  

AUTHOR

This program was written by James Watson (M0DNS / HZ1JW) <jimwatson at mac dot com>

 

ACKNOLEDGMENTS

I'm indebted to the authors of matplotlib and the basemap toolkit whaich make plotting complex data sets straight forward and fun :-) Also to Lowell and Alex for beta testing and support.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
ENVIRONMENT
BUGS
AUTHOR
ACKNOLEDGMENTS

This document was created by man2html, using the manual pages.
Time: 11:23:21 GMT, July 10, 2009