hydromt_wflow.WflowSedimentModel.setup_rivers#

WflowSedimentModel.setup_rivers(hydrography_fn, river_geom_fn=None, river_upa=30, rivdph_method='powlaw', slope_len=2000.0, min_rivlen_ratio=0.0, min_rivdph=1, min_rivwth=30, smooth_len=5000.0, rivman_mapping_fn='/usr/share/miniconda/envs/hydromt-wflow/lib/python3.9/site-packages/hydromt_wflow/data/wflow/N_river_mapping.csv', **kwargs)#

This component sets the all river parameter maps.

The river mask is defined by all cells with a mimimum upstream area threshold river_upa [km2].

The river length is defined as the distance from the subgrid outlet pixel to the next upstream subgrid outlet pixel. The min_rivlen_ratio is the minimum global river length to avg. cell resolution ratio and is used as a threshold in window based smoothing of river length.

The river slope is derived from the subgrid elevation difference between pixels at a half distance slope_len [m] up- and downstream from the subgrid outlet pixel.

The river manning roughness coefficient is derived based on reclassification of the streamorder map using a lookup table rivman_mapping_fn.

The river width is derived from the nearest river segment in river_geom_fn. Data gaps are filled by the nearest valid upstream value and averaged along the flow directions over a length smooth_len [m]

The river depth is calculated using the rivdph_method, by default powlaw: h = hc*Qbf**hp, which is based on qbankfull discharge from the nearest river segment in river_geom_fn and takes optional arguments for the hc (default = 0.27) and hp (default = 0.30) parameters. For other methods see hydromt.workflows.river_depth().

Adds model layers:

wflow_river map: river mask [-]
wflow_riverlength map: river length [m]
wflow_riverwidth map: river width [m]
RiverDepth map: bankfull river depth [m]
RiverSlope map: river slope [m/m]
N_River map: Manning coefficient for river cells [s.m^1/3]
rivers geom: river vector based on wflow_river mask

Parameters:

hydrography_fn (str, Path) –
Name of data source for hydrography data. Must be same as setup_basemaps for consistent results.
- Required variables: [‘flwdir’, ‘uparea’, ‘elevtn’]
- Optional variables: [‘rivwth’, ‘qbankfull’]
river_geom_fn (str, Path, optional) –
Name of data source for river data.
- Required variables: [‘rivwth’, ‘qbankfull’]
river_upa (float) – minimum upstream area threshold for the river map [km2]
slope_len (float) – length over which the river slope is calculated [km]
min_rivlen_ratio (float) – Ratio of cell resolution used minimum length threshold in a moving window based smoothing of river length, by default 0.0 The river length smoothing is skipped if min_riverlen_ratio = 0. For details about the river length smoothing, see pyflwdir.FlwdirRaster.smooth_rivlen()
rivdph_method ({'gvf', 'manning', 'powlaw'}) – see py:meth:hydromt.workflows.river_depth for details, by default “powlaw”
smooth_len (float, optional) – Length [m] over which to smooth the output river width and depth, by default 5e3
min_rivdph (float, optional) – Minimum river depth [m], by default 1.0
min_rivwth (float, optional) – Minimum river width [m], by default 30.0