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.1, 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 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) – minimum global river length to avg. cell resolution ratio, by default 0.1
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