Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Ground Elevation API

Project Description

A Python module and web API for worldwide elevation data.

This project is a part of the larger Tawhiri Landing Predictor Software.

The digital elevation data is sourced from the Viewfinder Panoramas website.

See the CUSF wiki for more details:




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


Python dependences may be found in requirements.txt. To run the downloader you will also require the convert command (from imagemagick).

Running a development webserver

The ruaumoko-api command can be used to run a development web server.

$ ruaumoko-api runserver

This will use the default configuration. To use a custom configuration to, for example, change the dataset location and enable debugging use the RUAUMOKO_SETTINGS environment variable:

$ cat > ruaumoko-development.txt <<EOL
ELEVATION_DIRECTORY = '/path/to/your/dataset'
DEBUG = True
$ RUAUMOKO_SETTINGS=ruaumoko-development.txt ruaumoko-api runserver

Dataset Format

Throughout Ruaumoko, data is indexed latitude-first/row-first

The 15-arcsecond (i.e., dividing a degree into 240 points) data comes as a grid of 24 TIFs, named A-X (C layout). Each TIF is a 10801 by 14401 array of 16 bit signed integers. The download script concatenates the arrays (after unpacking the TIFs) to get a single binary file, which is cast to an array with dimensions (4, 6, 10801, 14401).

Note that 4 * 10800 = 180 * 240 and 6 * 14400 = 360 * 240.

Each TIF overlaps with the ones on each side by one row, that is, the 10801th row of ‘A’ is the same as the 1st row of chunk ‘G’.

The top left corner of chunk A is at (lat) 90 (lng) -180. Latitude decreases down the rows; longitude increases along the columns.

Release History

Release History

This version
History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Ruaumoko-0.2.0.tar.gz (105.8 kB) Copy SHA256 Checksum SHA256 Source Oct 24, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting