QRadioPredict is an experimental software for VHF-UHF propagation prediction and radio coverage analysis. Currently it works on Linux and has been ported to Windows 32 bit (Vista) and has the following features:
QRadioPredict can operate as a traditional standalone program with static plots and radio links, or can be connected to Flightgear, the free flight simulator, in order to use it's powerful radio simulation.
QRadioPredict is distributed as source code package and binaries for Linux and Windows. Please see https://sourceforge.net/projects/qradiopredict/ for downloads. On Linux, to run QRadioPredict you need to have installed the following:
On Debian:
apt-get install gdal-bin libgdal1 libgdal1-dev libgeos-3.3.3 libgeos-dev libsqlite3-0
On Ubuntu (16.04 LTS):
apt-get install gdal-bin libgdal1i libgdal1-dev libgeos-dev libsqlite3-0 libboost-all-dev
MacOSX: you can build the program from source, no binaries are available.
Linux: place the material_radio_properties.txt and propagation.sqlite files in the same directory as the qradiopredict executable.
The first time you start QRadioPredict you should open Edit -> Settings and set your local preferences and paths. You can choose if to use the newer ITWOM prediction model or use ITM. There is now an additional checkbox which if it is ticked, will make the plot more precise at large distances, but will also take longer to generate.
You may find that sometimes ITM generates more accurate predictions than ITWOM or viceversa. This is the reason for the dual support of both algorithms.
You can have one mobile station on the map, and up to four ground stations. Set the locations for the mobile using the flightplan/waypoints tab. For point to point predictions you are required to have at least one waypoint. Each ground station tab has a button which generates 2D plots on the map. Set the opacity of the plot using the slider on the top right side, and the plot distance using the filed just below the opacity slider. Run the program standalone, or connect it to Flightgear by pressing the "Start Flightgear" button and then after it has started, the connect button. Send all data to Flightgear by pressing the third button, which should start your simulation.
The terrain data format is NASA SRTM 3 arcsec, in HGT files which are 2884802 bytes in size. Tou can obtain the data from NASA sites like http://dds.cr.usgs.gov/srtm/version2_1/SRTM3/Eurasia/
Newer versions with holes filled and contours seamless integrated are vailable from CGIAR (SRTM v4) http://www.cgiar-csi.org/data/srtm-90m-digital-elevation-database-v4-1.
After downloading the height files, fill in the setting box with the path to the directory where they are placed (no spaces). Note: you need to extract the files before placing them in this directory. Only files with the extension .hgt are usable by the program.
The clutter data consists of one raster file for the whole of Europe obtained from the CLC2006 project.
You can download Europe Corine data from http://www.eea.europa.eu/data-and-maps/data/corine-land-cover-2006-raster-3/clc-2006-100m/g100_06.zip. After unzipping the files, set the path to the TIF file inside Settings. Alternatively, if you want to use global data from the global VMAP0 program as well as other sources, you can obtain them through the USGS interface http://landcover.usgs.gov/globallandcover.php.
Usage of other types of landcover in the form of shapefiles is possible, but support for this feature has been removed temporarily. There are plans to use OpenStreetMap building data in the future. If you are interested in this feature, you should contact the author.
You can delete a waypoint or a ground station by pressing the red X button on the lower left. When running standalone, the second button from the standalone group will sequence to the next waypoint.
Connecting to Flightgear: you should first read the Flightgear documentation at http://wiki.flightgear.org/Radio_propagation to understand how does the flight simulator fit into the radio environment. Note that the public available version may not be usable with QRadioPredict, due to stale (older) code. If you wish to use the latest Flighgear radio code, you should contact the author for details on obtaining and compiling from source.
See the bug tracker on Github: https://github.com/QDeltaSoft/QRadioPredict/issues
You can either file a ticket at https://sourceforge.net/projects/qradiopredict/ or open a thread in the forums.
The source code is hosted on Github: https://github.com/QDeltaSoft/qradiopredict
To compile qradiopredict from source you need the following dependencies:
apt-get install gdal-bin libgdal1 libgdal1-dev libgeos-3.3.3 libgeos-dev libsqlite3-0
QRadioPredict comes with a simple qmake build setup. It can be compiled from within Qt Creator or in a terminal:
$ git clone https://github.com/QDeltaSoft/qradiopredict.git qradiopredict $ cd qradiopredict $ mkdir build $ cd build $ qmake-qt4 .. $ make
To create the database (which needs to be located in the same directory with the executable):
$ cat db_structure.sql | sqlite3 propagation.sqlite
Also copy material_radio_properties.txt in the same directory with the executable.
To build in debug mode add "CONFIG+=debug" to the qmake step above. There are also some other qmake options, see the qradiopredict.pro file.
QRadioPredict is designed and developed by Adrian Musceac YO8RZZ, and it is licensed under the GNU General Public License version 2. The Irregular Terrain Model was originally developed by the U.S. Department of Commerce NTIA/ITS - Institute for Telecommunication Sciences and converted to C++ and improved by several others. The MapGraphics library was coded by Raptorswing and comes with a FreeBSD license. Following people and organisations have contributed:
Also thanks to Durk Talsma, Flightgear developer, who encouraged me to contribute my code, and Torsten Dreyer, for giving me a detailed lesson of Flightgear internal working.
Some of the icons are from the GNOME and KDE icon themes.
Let me know if somebody or something is missing from the list!
Adrian YO8RZZ