Skip to main content

Command-line interface for Hydro Engine

Project description

Hydro Engine is a small service and a command-line tool built on top of [Google Earth Engine]( that allows querying various hydrological variables, useful as an input for hydrological models.

[![Build Status](](

The command-line Python tool can be installed using the following commands: ` > pip install hydroengine `

Once the package is installed, you can use `hydroengine` command to download input data needed for your hydrological model.

Upstream catchments, rivers and various raster variables can be queried using following commands:

` > hydroengine region.json --get-catchments catchments.json > hydroengine region.json --get-rivers rivers.json > hydroengine region.json --get-raster dem dem.tif 1000 EPSG:4326 > hydroengine region.json --get-lakes lakes.json > hydroengine region.json --get-lake-variable 183160 water_area area.json `

See [examples/](, showing how different data types can be downloaded.

All data types can be queried for an input area or location (GeoJSON polygon geometry). A polygon may define a flood location. For example, in the figure below, a single point near Houston is used to query upstream catchments and a drainage network, providing runoff water for that location.

<img src=”” alt=”Example” width=”626” height=”485”>

Supported functionality:

  • Querying upstream catchments as a single or multiple polygons. Source: [HydroBASINS](
  • Querying upstream drainage network as polylines. Source: [HydroSHEDS](
  • Querying raster variables:
    • dem [m] - in meters, source: 30m SRTM v4
    • hand [m] - Height Above the Nearest Drainage ([HAND](
    • FirstZoneCapacity [-] - ?
    • FirstZoneKsatVer [-] - ?
    • FirstZoneMinCapacity [-] - ?
    • InfiltCapSoil [-] - ?
    • M [-] - ?
    • PathFrac [-] - ?
    • WaterFrac [-] - ?
    • thetaS [-] - ?
    • soil_type [-] - soil type, based on ?
    • landuse [-] - land use type, based on MODIS 500m
    • LAI01…LAI12 - leaf area index monthly climatology, source: [eartH2Observe](


0.1.0 (2018-08-27)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for hydroengine, version 0.0.30
Filename, size File type Python version Upload date Hashes
Filename, size hydroengine-0.0.30-py2.py3-none-any.whl (6.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size hydroengine-0.0.30.tar.gz (370.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page