hydromt_wflow.workflows.reservoirattrs#

hydromt_wflow.workflows.reservoirattrs(gdf, timeseries_fn=None, perc_norm=50, perc_min=20, logger=<Logger hydromt_wflow.workflows.waterbodies (WARNING)>)[source]#

Return reservoir attributes (see list below) needed for modelling.

When specified, some of the reservoir attributes can be derived from earth observation data. Two options are currently available: 1. Global Water Watch data (Deltares, 2022) using gwwapi and 2. JRC (Peker, 2016) using hydroengine.

The following reservoir attributes are calculated:

  • resmaxvolume : reservoir maximum volume [m3]

  • resarea : reservoir area [m2]

  • resdemand : reservoir demand flow [m3/s]

  • resmaxrelease : reservoir maximum release flow [m3/s]

  • resfullfrac : reservoir targeted full volume fraction [m3/m3]

  • resminfrac : reservoir targeted minimum volume fraction [m3/m3]

Parameters:
  • gdf (geopandas.GeoDataFrame) – GeoDataFrame containing reservoirs geometries and attributes.

  • timeseries_fn (str, optional) – Name of database from which time series of reservoir surface water area will be retrieved. Currently available: [‘jrc’, ‘gww’] Defaults to Deltares’ Global Water Watch database.

  • perc_norm (int, optional) – Percentile for normal (operational) surface area

  • perc_min (int, optional) – Percentile for minimal (operational) surface area

Returns:

  • df_out (pandas.DataFrame) – DataFrame containing reservoir attributes.

  • df_plot (pandas.DataFrame) – DataFrame containing debugging values for reservoir building.

  • df_ts (pandas.DataFrame) – DataFrame containing all downloaded reservoir time series.