---
name: "voaP2PPlotServer"
section: "1"
platform: "linux"
package: "pythonprop"
version: "0.30.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/voaP2PPlot"
---

# voaP2PPlotServer(1)

Plot VOACAP point-to-point predictions

Part of [voaP2PPlot(1)](/voaP2PPlot/1.md).

## 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.