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.