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.