DEM reconditioning for hydrological applications
Project description
hydro-snap
Hydro-snap is an efficient tool for seamlessly aligning digital elevation models (DEMs) with mapped stream networks, ensuring accurate hydrological flow paths with minimal terrain alteration.
Example of a flow accumulation before (left) and after (right) alignment with HydroSnap. The DEM on the right has been aligned with the mapped stream network, ensuring accurate hydrological flow paths.
Hydro-snap allows users to:
- Align a DEM with a mapped stream network
- (Optionally) delineate a catchment from a provided outlet point
- (Optionally) force the flow accumulation to be consistent with a provided catchment boundary
The flow direction and accumulation are computed after the DEM has been aligned with the stream network, using the pysheds library.
Installation
Hydro-snap can be installed using pip:
pip install hydro-snap
Data requirements
You will need the following data to use hydro-snap:
- A digital elevation model (DEM) in GeoTIFF format
- A mapped stream network in shapefile format
- (Optional) A shapefile containing the outlet point of the catchment
- (Optional) A shapefile containing the catchment boundary
- (Optional) A shapefile containing the breaches in catchment boundary
Usage
Hydro-snap can be used to align a DEM with a mapped stream network using the following code:
from hydro_snap import recondition_dem
recondition_dem('path/to/DEM', 'path/to/streams.shp', 'output/dir')
When the catchment outlet is provided, the catchment can be delineated:
from hydro_snap import recondition_dem
# Recondition the DEM
recondition_dem('path/to/DEM', 'path/to/streams.shp', 'output/dir',
outlet_shp='path/to/outlet.shp')
A catchment delineation can be provided to force the flow accumulation to be consistent with its boundary. In order to allow the water to flow out of the catchment, breach(es) in the catchment boundary (outlet) must be provided:
from hydro_snap import recondition_dem
# Recondition the DEM
recondition_dem('path/to/DEM', 'path/to/streams.shp', 'output/dir',
catchment_shp='path/to/catchment.shp',
breaches_shp='path/to/breaches.shp')
Project details
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 hydro_snap-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f7b659cf9a0c4e0613b2f2be09f5e8e5c2cd8a455acdce34ef9523cb08cd2e3e |
|
MD5 | 506840cbb901957764feb158ba5c82c8 |
|
BLAKE2b-256 | c7cebc631d364e96f27fc1913b7b1325be4b77c424b61ee08f40c610191a040d |