User Choices

pywatemsedem

pywatemsedem uses the same structure for user input as WaTEM/SEDEM. This implies that user choices are grouped in the same way as in WaTEM/SEDEM. As such, user choices are grouped in the following sets:

Options: configuration of basic model functionalities (e.g. which model equations to use)
Parameters: basic model parameters (e.g. bulk density, kTC values)
Output: which output to generate
Extensions: enabling/disabling extra model functionalities
Extension parameters: extra parameters needed when extensions are enabled

Standard values for the first four sets are given in the last section of this page, listed per model resolution.

Note

It is important to note that all the pywatemsedem user choices hold functionalities that are inherited from the WaTEM/SEDEM model (see model parameters in WaTEM/SEDEM documentation page). As such many of these options hold the same key, but another functionality. If the functionality of the option is different for the WaTEM/SEDEM model, then this is indicated in the text (indicated with For functionality in WaTEM/SEDEM, see ..). If the functionality is the same, then a link to the documentation of WaTEM/SEDEM is presented (indicated with see ..).

We refer to the example notebook on how to use the user choices

Options

L model

For functionality in WaTEM/SEDEM pascal, see here

S model

For functionality in WaTEM/SEDEM pascal, see here

Calculate Tillage Erosion

For functionality in WaTEM/SEDEM pascal, see here

Extensions

Create kTC

This option indicates whether a User provided kTC map is used, and whether WaTEM/SEDEM needs to generate a kTC value by itself. Typically, this option is set to 0 when a WaTEM/SEDEM simulation for scenario analysis is done - in this case, a kTC map will be generated by the pywatemsedem engine - and is set to 1 when a WaTEM/SEDEM calibration is done - in this case, kTC maps are generated by the WaTEM/SEDEM engine.

For functionality in WaTEM/SEDEM pascal, see here

Include sewers

For functionality in WaTEM/SEDEM pascal, see here

UseTillage

For functionality in WaTEM/SEDEM pascal, see here

Create ktil map

For functionality in WaTEM/SEDEM pascal, see here

Estimate clay content

For functionality in WaTEM/SEDEM pascal, see here

Manual outlet selection

For functionality in WaTEM/SEDEM pascal, see here

Calibrate

For functionality in WaTEM/SEDEM pascal, see here

Adjusted Slope

For functionality in WaTEM/SEDEM pascal, see here

Buffer reduce area

For functionality in WaTEM/SEDEM pascal, see here

Force Routing

This options allows to use user-defined routing. This functions is useful for situations where it is known from expert knowledge that the general flow pattern is incorrect.

For functionality in WaTEM/SEDEM pascal, see here

River Routing

For functionality in WaTEM/SEDEM pascal, see here

Include buffers

Load and translate buffer shapefiles to WaTEM/SEDEM buffer rasters. Consider buffers for WaTEM/SEDEM model simulation. For functionality in WaTEM/SEDEM pascal, see here

Include dams

Load and translate buffer shapefiles to WaTEM/SEDEM grass rasters. Consider grass for WaTEM/SEDEM model simulation. For functionality in WaTEM/SEDEM pascal, see here

Include ditches

For functionality in WaTEM/SEDEM pascal, see here

Parameters

Parcel connectivity cropland

See here

Parcel connectivity forest

See here

Parcel trapping efficiency cropland

See here

Parcel trapping efficiency forest

See here

Parcel trapping efficiency pasture

See here

R factor

See here

Max kernel

See here

Max kernel river

See here

Bulk density

See here:

Parameters extensions

ktc low

See here

ktc high

See here

ktc limit

See here

ktil default

See here

ktil threshold

See here

Clay content parent material

See here

Alpha

See here

Beta

See here

Stream velocity

See here

Final timestep output

See here

begin_jaar

(begin) Year of simulation (in development).

begin_maand

(begin) Month of simulation (in development).

Sewer exit

Only CN. For functionality in WaTEM/SEDEM pascal, see here

LS correction

For functionality in WaTEM/SEDEM pascal, see here

Output

The output options below are all inherited by WaTEM/SEDEM. This implies that the keys and functionalities of these options in pywatemsedem and WaTEM/SEDEM are exactly the same. For an explanation of these functionalities, we refer to the WaTEM/SEDEM documentation page

Write aspect

See here

Write LS factor

See here

Write RUSLE

See here

Write sediment export

See here

Write slope

See here

Write total runoff

See here

Write upstream area

See here

Write water erosion

See here

Output per river segment

See here

Write rainfall excess

See here

Write routing table

see here

Maximize grass strips (maximize_grass_strips)

The option (boolean) enable the maximisation of for grass strips in the WaTEM/SEDEM parcels raster. In essence, with this option, the pywatemsedem.core.grasstrips.expand_grass_strips_with_triggers()-function is used. This function aims to expand or maximize grass strips within the boundaries of a parcel, so to avoid that grass strips are removed by overlap with river and infrastructure pixels (note that river and infrastructure pixels have a higher priority in the hierarchy of the WaTEM/SEDEM perceelskaart). This algorithm loops with a 3x3-window over a grass strip raster, and checks if any of the pixels in the 3x3-window are located next to a trigger pixel. If this is the case, the considered pixel in the window is also considered to be a grass pixel. Note that in essence this algorithm is used as a solution to a resolution issue: because of the higher priority of infrastructure and rivers in pywatemsedem, grass strips ‘disappear’ at a resolution of 20 m.