Skip to main content

Python library to get elevation data

Project description


Actions Status Code Coverage License: MIT PyPI version

pyhigh is a Python package for accessing elevation data, which is retrieved from a USGS dataset. The package uses caching to avoid unecessary downloads from the USGS dataset, but please respect their download policies.


> pip install pyhigh


Command-line utility

The pyhigh Python package includes a command-line tool of the same name to retreive the elevation at a particular latitude and longitude:

> pyhigh --lat 36.52011 --lon -118.671

As necessary, files will be download from a USGS dataset and cache in the folder pyhigh/pyhigh/.cache. To clear this cache, use the --clean argument:

> pyhigh --clean

Python API

The get_elevation function returns the elevation, in meters, at the given latitude and longitude.

>>> from pyhigh import get_elevation
>>> get_elevation(lat=36.52011, lon=-118.671)

It is also possible to request a bunch elevations for a bunch of latitudes and longitudes at once. The result returned is a NumPy array of elevations.

>>> from pyhigh import get_elevation_batch
>>> get_elevation_batch([(36.52011, -118.671),
...                      (36.62011, -118.771)])
array([1884., 2438.])

This is more efficient than individual calls to get_elevation because elevation reads are pooled together to avoid reading the same *.hgt file multiple times.

Finally, the pyhigh cache of *.hgt files can be cleared with the API function clear_cache:

>>> from pyhigh import clear_cache
>>> clear_cache()

Project details

Download files

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

Files for pyhigh, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size pyhigh-0.0.5.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page