Skip to content

1. Dependencies & Installation

Jump to bottom
Mark Jessop edited this page Oct 28, 2018 · 21 revisions

This page describes setup of the Horus GUI Utilities on a Windows or Linux PC. Note that OziPlotter mapping utility is Windows only (but there is now an alternative KML output utility available here.

For setup of a headless Raspberry Pi LoRa-UDP Server, refer to this page.

1. Dependencies

  • Python 2.7
  • PyQt5
  • Other Python Libraries:
    • crcmod
    • dateutil
    • requests
    • shapely (which also depends on GEOS)

The above dependencies can be satisfied under Windows using the Anaconda Python Distribution. Make sure to grab the Python 2.7 version!

When installing make sure the 'Add Anaconda Python to system PATH' tickbox is checked, else the below commands will not work.

Once installed, open an administrator command prompt and run:

> conda install pyserial shapely
> pip install crcmod python-dateutil

Under Linux (Debian/Ubuntu) you can get the required packages by running:

$ sudo apt-get install python-dev python-serial python-pip python-requests python-shapely python-pyqt5 git
$ sudo pip install crcmod python-dateutil fastkml

The rest of the required packages should be acquired when horuslib is installed (below).

1.1 Anaconda Upgrade Warning

If you already have an older version of Anaconda Python installed, you may need to follow these steps:

  • Uninstall the old Anaconda version using the uninstaller in C:\Anaconda
  • Install the new anaconda Python version, noting that it installs into C:\ProgramData\ for some reason...
  • During installation, ensure the 'Add Anaconda to system PATH' checkbox is ticked.
  • Set file associations for .py files, by right-clicking on one a .py file and choosing 'Open With', then 'Browse', and navigating to C:\ProgramData\Anaconda2. Use 'pythonw.exe' if you don't want a command prompt to open, or otherwise use 'python.exe'
  • If this fails to work, open regedit, and navigate to HKEY_CLASSES_ROOT\Applications\ and find the entry for python.exe or pythonw.exe, and edit the 'shell\open\command' default registry entry to reflect the new path to the python.exe or pythonw.exe binary.

2. Download & Installation

The horus_utils software can be either cloned using a git client by running:

$ git clone https://github.com/projecthorus/horus_utils.git

or downloaded as a zip.

The shared functions & objects used in the various GUI utilities are located in the 'horuslib' package and need to be installed to be usable. Navigate to the directory where you have downloaded/cloned horus_utils, and run:

$ cd horus_utils
$ python setup.py install

(Under Linux you may need to run the above using sudo)

You can then test the installation by running any of the GUI utilities (i.e. SummaryGUI.py) from the apps directory. If you have set up file associations for .py files, you may be able to just double-click on the Python script, otherwise open a command prompt and run:

> cd apps
> python SummaryGUI.py

If all goes well, the application will load without errors.

Next up, you will need to edit the configuration files.

Clone this wiki locally