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](http://earthengine.google.com) that allows querying various hydrological variables, useful as an input for hydrological models.

[![Build Status](https://travis-ci.org/openearth/hydro-engine.svg?branch=master)](https://travis-ci.org/openearth/hydro-engine)

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/run.sh](https://github.com/Deltares/hydro-engine/blob/master/examples/run.sh), 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=”https://github.com/Deltares/hydro-engine/blob/master/docs/example_query.png?raw=true” alt=”Example” width=”626” height=”485”>

Supported functionality:

  • Querying upstream catchments as a single or multiple polygons. Source: [HydroBASINS](http://www.hydrosheds.org/page/hydrobasins)
  • Querying upstream drainage network as polylines. Source: [HydroSHEDS](http://hydrosheds.org)
  • Querying raster variables:
    • dem [m] - in meters, source: 30m SRTM v4
    • hand [m] - Height Above the Nearest Drainage ([HAND](http://global-hand.appspot.com))
    • 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](http://www.earth2observe.eu/)

History

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.

Filename, size & hash SHA256 hash help File type Python version Upload date
hydroengine-0.0.30-py2.py3-none-any.whl (6.1 kB) Copy SHA256 hash SHA256 Wheel py2.py3
hydroengine-0.0.30.tar.gz (370.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page