elevatr

A Python package to simplify downloading and processing elevation data.
Enjoy exploring the heights of the world with elevatr! 🏔️🚀

Explore the docs »

🌄 Overview

elevatr is a Python library designed for downloading and processing elevation data. It is particularly useful for geospatial analyses and visualizations. The library supports high-resolution raster data and offers easy-to-use tools for displaying and exporting elevation information. 🗺️📊

📦 Installation

To install elevatr, run the following command:

pip install elevatr

🛠️ How To Use

📥 Download Elevation Data

Here is a simple example of how to use elevatr to download elevation data:

import elevatr as elv

# Define the bounding box of the area of interest (min_lon, min_lat, max_lon, max_lat)
bbx = (-5.14, 41.33, 9.56, 51.09)

# Set the level of precision (between 0 and 14)
zoom = 6

# Access the elevation data
raster = elv.get_elev_raster(locations=bbx, zoom=zoom)

📝 Note: Please choose the zoom level incrementally, a high level of zoom on a large area can take a lot of time and memory.

🖼️ Display the elevation data:

raster.show(cmap='terrain', clip_zero=True)

🌍 Example output:

🏔️ Visualize in 3D

raster.show_3d(
    solid=True,
    light_intensity=0.5,
    transparent_background=True,
    zscale=40,
    phi=30,
    theta=180,
    file_path="elevation.png",
)

Render a stunning 3D view of your elevation data! 🌐✨

🌍 Example output:

💾 Save to TIFF File

raster.to_tif("elevation.tif")

Save your elevation data to a TIFF file for further use! 🗂️✨

🌐 Data Sources

List of Sources

The underlying data sources are a mix of:

• 3DEP: Formerly NED and NED Topobathy in the United States, 10 meters outside of Alaska, 3 meters in select land and territorial water areas.
• ArcticDEM: Strips of 5 meter mosaics across all of the land north of 60° latitude, including Alaska, Canada, Greenland, Iceland, Norway, Russia, and Sweden.
• CDEM: Canadian Digital Elevation Model in Canada, with variable spatial resolution (from 20-400 meters) depending on the latitude.
• data.gov.uk: 2 meters over most of the United Kingdom.
• data.gv.at: 10 meters over Austria.
• ETOPO1: For ocean bathymetry, 1 arc-minute resolution globally.
• EUDEM: In most of Europe at 30 meter resolution, including Albania, Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Cyprus, Czechia, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Kosovo, Latvia, Liechtenstein, Lithuania, Luxembourg, Macedonia, Malta, Montenegro, Netherlands, Norway, Poland, Portugal, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, and United Kingdom.
• Geoscience Australia's DEM of Australia: 5 meters around coastal regions in South Australia, Victoria, and Northern Territory.
• GMTED: Globally, coarser resolutions at 7.5", 15", and 30" in land areas.
• INEGI: Continental relief in Mexico.
• Kartverket: Digital Terrain Model, 10 meters over Norway.
• LINZ: 8 meters over New Zealand.
• SRTM: Globally except high latitudes, 30 meters (90 meters nominal quality) in land areas.

Data Sources per Zoom Level

📝 Note: Information about data sources is provided here.

⚖️ License

Elevatr is licensed under the MIT License. This means you are free to use, modify, and distribute this software. However, the software is provided “as is”, without warranty of any kind.

🙏 Acknowledgments

This package is inspired by the great elevatr package for the R language. It was this package that inspired me to create a similar package to ease access to this data for Python users.

back to top

GitHub @titouanlegourrierec  · Email titouanlegourrierec@icloud.com