pvlib.location.lookup_altitude(latitude, longitude)[source]#

Look up location altitude from low-resolution altitude map supplied with pvlib. The data for this map comes from multiple open data sources with varying resolutions aggregated by Mapzen.

More details can be found here https://github.com/tilezen/joerd/blob/master/docs/data-sources.md

Altitudes from this map are a coarse approximation and can have significant errors (100+ meters) introduced by downsampling and source data resolution.

  • latitude (float.) – Positive is north of the equator. Use decimal degrees notation.

  • longitude (float.) – Positive is east of the prime meridian. Use decimal degrees notation.


altitude (float) – The altitude of the location in meters.



  • ArcticDEM terrain data DEM(s) were created from DigitalGlobe, Inc., imagery and funded under National Science Foundation awards 1043681, 1559691, and 1542736;

  • Australia terrain data © Commonwealth of Australia (Geoscience Australia) 2017;

  • Austria terrain data © offene Daten Österreichs - Digitales Geländemodell (DGM) Österreich;

  • Canada terrain data contains information licensed under the Open Government Licence - Canada;

  • Europe terrain data produced using Copernicus data and information funded by the European Union - EU-DEM layers;

  • Global ETOPO1 terrain data U.S. National Oceanic and Atmospheric Administration

  • Mexico terrain data source: INEGI, Continental relief, 2016;

  • New Zealand terrain data Copyright 2011 Crown copyright (c) Land Information New Zealand and the New Zealand Government (All rights reserved);

  • Norway terrain data © Kartverket;

  • United Kingdom terrain data © Environment Agency copyright and/or database right 2015. All rights reserved;

  • United States 3DEP (formerly NED) and global GMTED2010 and SRTM terrain data courtesy of the U.S. Geological Survey.



Mapzen, Linux foundation project for open data maps


Joerd, tool for downloading and processing DEMs, Used by Mapzen


AWS, Open Data Registry Terrain Tiles

Examples using pvlib.location.lookup_altitude#

Shaded fraction of a horizontal single-axis tracker

Shaded fraction of a horizontal single-axis tracker