Download and merge DEM tiles for processing interferograms with ISCE2.
Project description
dem_stitcher
The purpose of this repo is to download Digital Elevation Model (DEM) tiles and do some basic transformations so that they can be ingested into ISCE2 for the ARIA pipeline. We could see this being used in different applications. Meant to be "plugged-in" to other python routines.
This is the joint work of Charlie Marshak, David Bekaert, Michael Denbina, and Marc Simard.
Please look at the demonstration here.
Credentials
The virtual reading of Nasadem and SRTM require earthdata login credentials to be put into the ~/.netrc
file. If these are not present, the stitcher will
fail with BadZipFile Error
as the request is made behind the secnes with rasterio
. Specifically,
machine urs.earthdata.nasa.gov
login <username>
password <password>
Installation with pip
- Download the
requirements.txt
and install them:pip install -r requirements.txt
- Install dem stitcher:
pip install dem_stitcher
Installation for Development
Tested with 3.8.5 Anaconda Python.
pip install -r requirements.txt
- Install the package either:
pip install .
(or to make editablepip install -e .
)pip install ...
from github as here
DEMs
The DEMs we have are:
Look at this readme and this notebook for some more information.
Transformations
- Merge tiles from server
- Resample to
epsg:4326
- (optional; default
True
) Pixel centered referenced raster ensuring (a) half-pixel shift in the north-west direction if the original raster tiles are centered around the UL corner point and (b) tagging the data with{'AREA_OR_POINT: 'Point'}
.- SRTM v3 and TDX are pixel centered
- The USGS DEMs are not
- (optional; default
True
) - transform vertical heights to WGS84 Ellipsoidal height.
Testing
- Install
papermill
andpytest
. - Install a new jupyter kernel to reference
dem_stitcher
withpython -m ipykernel install --user --name dem_stitcher
(the notebooks use this kernel name). - Run pytest.
There are automatic github actions that run the said tests as well.
Contributing
- Create an GitHub issue ticket desrcribing what changes you need (e.g. issue-1)
- Fork this repo
- Make your modifications in your own fork
- Make a pull-request in this repo with the code in your fork and tag the repo owner / largest contributor as a reviewer
Support
Create an issue ticket.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dem_stitcher-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 77a009debae20313673dc5019188381f6e9fc054610c95e4c41be22c772a3b67 |
|
MD5 | ef299c00adc5f846ab142b8d98a52da0 |
|
BLAKE2b-256 | 3fb671b7518037ec166d96a296600393ca3221934157ad68c8aa758eb2419ec7 |