Repository files navigation

WSPR is a digital radio communication mode for probing potentialpropagation paths or antenna performance with low-power transmissions.

The Weak Signal Propagation Reporter Network (WSPRnet) is a group ofamateurs radio operators using WSPR with very low power (QRP/QRPp)transmissions. They automatically upload their reception reports to acentral database called WSPRnet. This program downloads the data ofthese transmission reports create several graphs useful to analyze howpropagation works or to optimize your antenna setting.

This program depends on the following Python packages:matplotlib,numpy,requests. You can also optionally installmpl_tookints, if you want todisplay maps.

To use this program you need to send wspr data to wsprnet.org. This isdone with either a wsprlite (see down the page) or using the softwareWSJT-X. Then you need to get your key from dxplorer.net.

Set the environment variablesCALLSIGN andKEY with your call andkey. The just run the program. The program without any argument willdownload from DXplorer your last 24 hours data and graph theresults. You can also callleaf.py with the argument--file. Thefile needs to be a JSON file with the same format as the file providedby the site DXplorer.

wspr$ export CALLSIGN="W6BSD"wspr$ export KEY="xxxxxSECRET_KEYxxxxx"wspr$ ./leaf.py --helpusage: The program leaf.py download the last 24 hours worth of data from WSPRnet and compute statistical analysis of your contacts.To use leaf.py you need to set 2 environment variables onewith your call sign the second one with your wspr (dxplorer) key.For example:$ export CALLSIGN="W6BSD"$ export KEY="aGAT9om5wASsmx8CIrH48MB8Dhh"WSPR Stats.optional arguments:  -h, --help            show this help message and exit  -D, --debug           Print information useful for debugging  -t TARGET_DIR, --target-dir TARGET_DIR                        Target directory where the images will be saved                        [default: /tmp]  -f FILE, --file FILE  JSON file from DXPlorer.net  -b BAND, --band BAND  Band to download, in Mhz [default: 20m]

The most classic graph is the maximum distance where your signal was picked up.This following graph shows the 90th percentile if the distance.

The following box plot graph show for each hour at what distance thebulk of your communication was heard. It also shows the distanceminima, maxima and the outliers.

The violin graph shows how the station hearing your signal aredistributed in the IQR (Interquartile range).

This histogram graph show at what distance your contacts are made. Theabsence or low number of contact indicate the skip zones.

The azimuth graph shows what distance / direction your signal has beenheard.

Pinpoint on a map all your contacts.

The WSPRlite is a special test transmitter that sends a signal to aWorldwide network of receiving stations.

Thanks to Paul Simon (W6EXT) for the Saturday morning coffee discussions on statistics and the best ways to interpret the WSPR data.

For more informations please check this blog posts:80-meter NVIS antenna

-- Fred C /W6BSD --