Tawhiri 0.2.0

High Altitude Balloon Landing Prediction Software

# Tāwhirimātea

[](https://readthedocs.org/projects/tawhiri/?badge=latest)

## 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](http://en.wikipedia.org/wiki/M%C4%81ori_people) god of weather, which rather aptly “drove Tangaroa and his progeny into the sea ” [(WP)](http://en.wikipedia.org/wiki/Tawhiri).

## More information

Please see the [CUSF wiki](http://www.cusf.co.uk/wiki/), which contains pages on [Tawhiri](http://www.cusf.co.uk/wiki/tawhiri:start) and [prediction in general](http://www.cusf.co.uk/wiki/landing_predictor).

[More detailed API and setup documentation](http://tawhiri.cusf.co.uk/).

## Setup

### Predictor

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

`bash $ 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).

`bash $ 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.

`bash $ 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](http://gplv3.fsf.org/) (see LICENSE).