voacap icon
HZ1JW Software


pythonProp is a collection of Python 3 scripts designed to create voacap input (.dat) files and plot the resulting predictions.  The package makes use of the matplotlib library (voaAreaPlot also requires the basemap toolkit.)

The package is released under the GPL license so may be freely modified. Please post any changes that may be of use to others via the contact details at the bottom of the page.

Top of Page


See below for a few screen shots of the voacapgui application and some plots produced with the pythonProp utilities;
Input File voaP2PPlot voacapgui Multiple voaP2PPlot voa3dplot
Top of Page


An input GUI for voacapl.  This is under active development - please pass on any feature requests / bug reports.

The program is started from the command line with the command 'voacapgui' or from the Gnome desktop with the application command 'voacapgui'.

Top of Page


This script plots the output of a Point-to-Point prediction. Signal to Noise (SNR), Reliability (REL), Maximum Usable Frequency (MUF) or Received Signal Strength (S DBW) may be plotted. The application supports time shifting of the lower (GMT)

Refer to the man page for details.

Top of Page


This script plots the output of VOAARea predictions (.VGx files). Signal to Noise (SNR), Reliability (REL) or Maximum Usable Frequency (MUF) may be plotted. To produce correct type of input projection data files, the projection type flag in the input file's GRIDSIZE card must be set to '1', i.e.

Gridsize : 59 1

See the man page for details.

Top of Page


The latest version of the scripts is available from the following link; http://www.qsl.net/hz1jw/pythonprop/downloads/pythonprop-0.28.tar.gz.

v0.21 onwards uses Python 3.

Please note that as of 20th July 2015, the codebase has been moved from Sourceforge to the Github repositary at https://github.com/jawatson/pythonprop. The pages at the original sourceforge site are no longer maintained.

Top of Page


The scripts require the 'matplotlib' library and associated 'basemap' toolkit.


Matplotlib and the basemap toolkit are available from the Ubuntu repositories and may be installed with the command;

$ sudo apt-get install yelp python3-gi python3-gi-cairo rarian-compat \
  gnome-doc-utils pkg-config python3-dateutil python3-mpltoolkits.basemap \
  python3-cairocffi python3-matplotlib-gtk3

Fedora (F23)

All required libraries are available from Fedora's repositories. The following command will install the basemap package (which will in turn call up and install all required dependencies) and the packages required to support building the help documentation;

$ sudo dnf install yelp rarian-compat gnome-doc-utils \
  pkgconfig python3-dateutil python3-basemap \
  python3-cairocffi python3-cffi python3-matplotlib-gtk3

All Distributions:   If not available from your distro's repositories, matplotlib and the basemap toolkit may be installed from source files available from the following URLs;

Matplotlib: http://sourceforge.net/projects/matplotlib/files/matplotlib/

Basemap: http://sourceforge.net/projects/matplotlib/files/matplotlib-toolkits/basemap-1.0.3/

Once downloaded, follow the instructions to compile and install each package with the usual setup.py commands;

python3 setup.py build
python3 setup.py install

Note:  If anyone has advice on how to install these libraries on other platforms, please let me know how so that I can post instructions here.

pythonProp: Download the pythonProp package from the link above and use the following commands to install the scripts;

$ gunzip -c pythonProp-0.21.tar.gz | tar x
$ cd pythonProp-0.21
$ ./configure
$ sudo make install

The installer places the python scripts in /usr/local/share/pythonProp and shell script 'wrappers' in /usr/local/bin.

Upgrading From Earlier Versions: Earlier distributions placed the mufPlot, voaAreaPlot.py and voafile.py in /usr/local/bin. It's probably safer to delete these older files.

Top of Page

Acknowledgements & Disclaimer

Sincere thanks to Jari PerkiPerkömäki (OH6BG), Alex Hill (G7KSE), Lowell (KC7DX) and Andreas Weller for bug testing, support and suggestions.

Top of Page