An R package for accessing elevation data from various sources
The elevatr
package currently provides access to
elevation data from AWS Open Data Terrain Tiles
and the Open Topography Global datasets API
for raster digital elevation models. For point elevation data,the USGS Elevation Point Query
Service) may be used or the point elevations may be derived from the
AWS Tiles. Additional elevation data sources may be added as they come
available.
Currently this package includes just two primary functions to access elevation web services:
get_elev_point()
: Get point elevations using the USGS
Elevation Point Query Service (for the US Only) or using the AWS Terrian
Tiles (global). This will accept a data frame of x (long) and y (lat), a
SpatialPoints/SpatialPointsDataFame, or a Simple Features object as
input. A SpatialPointsDataFrame or Simple Features object is returned,
depending on the class of the input locations.get_elev_raster()
: Get elevation data as a raster
(e.g. a Digital Elevation Model) from the AWS Open Data Terrain Tiles.
Other sources may be added later. This will accept a data frame of of x
(long) and y (lat) or any sp
or raster
object
as input and will return a raster
object of the elevation
tiles that cover the bounding box of the input spatial data.Version 0.4.1 of this package is currently available from CRAN and may be installed by:
install.packages("elevatr")
The development version (this repo) may installed with
devtools
:
library(devtools)
install_github("jhollist/elevatr")
As elevatr
is getting more widely used, there have been
some great contributions, use cases, and additional packages that have
come from the user community. If you have one you’d like to share, let
me know and I will gladly add it. Here are some of the ones that I have
seen. Thank you all!
rayshader
and elevatr
cheatsheetrayvista
package uses rayshader
,
maptiles
, and elevatr
to create some cool
visualizationsMapzen terrain tiles (which supply the AWS source) contain 3DEP, SRTM, and GMTED2010 content courtesy of the U.S. Geological Survey and ETOPO1 content courtesy of U.S. National Oceanic and Atmospheric Administration. The Open Topography API provide access to the SRTM and the ALOS World 3D datasets. See https://opentopography.org/ for details.
The source code for this repository is maintained at https://github.com/jhollist/elevatr which is also mirrored at https://github.com/usepa/elevatr
The United States Environmental Protection Agency (EPA) GitHub project code is provided on an “as is” basis and the user assumes responsibility for its use. EPA has relinquished control of the information and no longer has responsibility to protect the integrity , confidentiality, or availability of the information. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by EPA. The EPA seal and logo shall not be used in any manner to imply endorsement of any commercial product or activity by EPA or the United States Government.