NAME

       voaP2PPlot - Plot VOACAP point-to-point predictions

SYNOPSIS

       voaP2PPlot [options] aFile

DESCRIPTION

       voaP2PPlot A python script used to graphically display the contents of output files produced by VOACAP.

OPTIONS

       -b band
              Where  the  integer 'band' specifies a band plan to be overlayed on the plot.  Supported bandplans
              are 1:SWL 2:UK Amateur 3:KSA Amateur

       -c     Display contour lines on the image

       -f max_frequency
              A float used to specify the maximum frequency (MHz) to display, e.g. '-f 20' limits the y-axis  to
              20MHz.  Values must be in the range 5-30MHz Autoscaling may be switched on with the value '-f a'.

       -g group
              Where  group  is an integer specifying the group within a file containing multiple groups to plot.
              Multiple groups must be separated by commas, e.g. '-g 1,3,4' will print groups 1, 3 & 4

       -h     Prints a help message and quits.

       -k, --background
              Specify the colour of the background. Any legal HTML color  specification  is  supported  e.g  '-k
              red', '-k #eeefff', (default = white)

       -l 'label'
              Where 'label' is a string printed as a main title at the top of the plot.

       -m colour-map
              Specifies  the  colour-map  to use. Supported colour maps are 1:Bone, 2:Cool 3:Copper 4:Gray 5:Hot
              6:Hsv 7:Jet 8:Pink 9:Spring 10:Summer 11:Winter (default = 8)

       -o file-name
              Used to specify an output file to save the plot to.  The file-name extension  defines  the  output
              file format.  .png/.pdf files are supported.

       -q     Process  quietly,  don't  produce  a  graph  on  the  screen.   This only makes sense when used in
              conjunction with the -o option.

       -r resolution
              Specifies the size in Dots per Inch (DPI) of the output image.  Default = 150

       -t type
              Specifies the type of image to plot.  Supported image types are 0:None 1:MUFday  2:REL  3:SNR  4:S
              DBW (default = 1)

       -z time-Zone
              Specifies the timezone to shift the plots to.

EXAMPLES

       voaP2PPlot voacapx.out
              Plots the contents of the file voacapx.out.

       voaP2PPlot -c -m 3voacapx.out
              Plots using colour map 3, adding contour lines to the plot.

       voaP2PPlot -b 1 -o plot.pdf voacapx.out
              Overlays the plot with the SWL band-plan, saving the plot to the file plot.pdf

       voaP2PPlot -t 2 -z 3 voacapx.out
              Produces a reliability plot, shifted to a timezone 3 hours ahead of UTC.

ENVIRONMENT

       voaP2PPlot does not require or make use of any environmental variables.   The program requires the python
       library matlibplot to run.

BUGS

       No  known  bugs,  that's  probably  a sign of incomplete testing rather than a bug free program :-).  The
       program is not very tolerant of incorrect arguments, this will be addressed in future versions.

AUTHOR

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

ACKNOWLEDGMENTS

       Credit and thanks to Jari Perkiomaki, OH6BG (OH6BG) for program testing and suggestions.

Linux                                               MAY 2008                                       voaP2PPlot(1)