CUSF Landing Prediction Software
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
deploy
docs
tawhiri
testing
tests
ui
.gitignore
.travis.yml
AUTHORS
LICENCE
MANIFEST.in
README.md
requirements.txt
setup.cfg
setup.py

README.md

Tāwhirimātea

Documentation Status

Introduction

Tawhiri is the name given to the next version of the CUSF Landing Prediction Software, which will probably be different enough from the current version (see below) to warrant a new name.

The name comes from a Māori god of weather, which rather aptly “drove Tangaroa and his progeny into the sea ” (WP).

More information

Please see the CUSF wiki, which contains pages on Tawhiri and prediction in general.

More detailed API and setup documentation.

Setup

Predictor

…is written for Python 3, is compatible with Python 2, and needs Cython:

$ virtualenv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
$ python setup.py build_ext --inplace

The last line (re-)builds the Cython extensions, and needs to be run again after modifying any .pyx files.

Downloader

The downloader uses gevent, so we are disappointingly restricted to running it under Python 2 for now (Issue #18).

$ sudo aptitude install libevent-dev libjasper-dev libopenjpeg-dev libpng-dev

Acquire a sufficiently modern version of libgrib-api-dev from APT. The version in 12.04 is too old. 1.10.4 is known to work.

$ virtualenv -p python2 venv
$ source venv/bin/activate
$ pip install numpy
$ pip install pygrib==2.0.0 pyproj 'gevent<1.0'

License

Tawhiri is Copyright 2014 (see AUTHORS & individual files) and licensed under the GNU GPL 3 (see LICENSE).