voaP2PPlot(1)

✨ voaP2PPlot — plot VOACAP point-to-point predictions ✨

okay bestie, gather round, because this little icon of a program lives in section 1 of the User Manuals and it is literally here to make your VOACAP output look cute. 💖

---

🌸 NAME 🌸

voaP2PPlot — Plot VOACAP point-to-point predictions 🦋

---

🌈 SYNOPSIS 🌈

voaP2PPlot [options] aFile

---

💅 DESCRIPTION 💅

So voaP2PPlot is a python script, and its whole job — its entire main character purpose — is to graphically display the contents of output files produced by VOACAP. That's it. That's the gig. You feed it a VOACAP output file and it turns those numbers into a picture. ✨

---

🎀 OPTIONS 🎀

• -b band — where the integer band says which band plan gets overlayed on the plot. The supported bandplans are 1:SWL, 2:UK Amateur, 3:KSA Amateur. 👑
• -c — puts contour lines on the image. contour lines!! very demure, very mindful. 💅
• -f max_frequency — a float that sets the maximum frequency (MHz) to display. Like, -f 20 limits the y-axis to 20MHz. Values have to be in the range 5-30MHz. Autoscaling can 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. no cap. 🍓
• -h — prints a help message and quits. a classic, an icon, a legend. 🙈
• -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. name your art, bestie. 🎀
• -m colour-map — specifies the colour-map to use. The 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. (so like, don't do it alone, it's giving nothing 😭)
• -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 voacapx.out

• voaP2PPlot -c -m 3voacapx.out — plots using colour map 3, adding contour lines to the plot. (and yes, the space between 3 and voacapx.out is missing in the original, that's exactly how it's written, we do not editorialise 💀)

voaP2PPlot -c -m 3voacapx.out

• 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 -b 1 -o plot.pdf voacapx.out

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

voaP2PPlot -t 2 -z 3 voacapx.out

---

🧚 ENVIRONMENT 🧚

voaP2PPlot does not require or make use of any environmental variables. none. zero. nothing. But — and this is the important part — the program requires the python library matlibplot to run. (that's the spelling right there in the manual, we keep it exactly as written 🫶)

---

💀 BUGS 💀

No known bugs — which, as the manual itself says, is probably a sign of incomplete testing rather than a bug free program :-). Also, fair warning bestie: the program is not very tolerant of incorrect arguments. That's gonna get addressed in future versions.

lowkey scary but highkey honest, and honestly? we respect the transparency. 🙈

---

👑 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. 🫶✨

---

and that's the whole page, bestie — Linux, MAY 2008, section 1, iykyk. go plot something pretty. 💅🎀🦋