THe wflow_routing Model

Warning

The documentation of this model is incomplete

Introduction

A

Dependencies

T

Configuration

It needs a number of settings in the ini file. The default name for the file is wflow_routing.ini. it is also possible to insert this section in the wflow_sbm or wflow_hbv ini file and point to that file.

See below for an example:

[inputmapstacks]
# Name of the mapstack with specific discharge (mm/timestep output from the hydrological model)
IW= inmaps/IW

A description of the implementation of the kinematic wave is given on the pcraster website

In addition to the settings in the ini file you need to give the model additional maps or lookuptables in the staticmaps or intbl directories:

wflow_routing module documentation

Run the wflow_routing model..

usage

wflow_routing [-h][-v level][-F runinfofile][-L logfile][-C casename][-R runId]
      [-c configfile][-T last_step][-S first_step][-s seconds][-l loglevel]
      
-F: if set wflow is expected to be run by FEWS. It will determine
    the timesteps from the runinfo.xml file and save the output initial
    conditions to an alternate location. Also set fewsrun=1 in the .ini file!
    
-X: save state at the end of the run over the initial conditions at the start        

-T: Set last timestep

-S: Set the start timestep (default = 1)

-s: Set the model timesteps in seconds

-I: re-initialize the initial model conditions with default

-C: set the name  of the case (directory) to run

-R: set the name runId within the current case

-L: set the logfile

-c: name of wflow the configuration file (default: Casename/wflow_routing.ini).

-h: print usage information

-l: loglevel (most be one of DEBUG, WARNING, ERROR)

$Author$ $Id$ $Rev$

class wflow_routing.WflowModel(cloneMap, Dir, RunDir, configfile)

Bases: pcraster.framework.dynamicPCRasterBase.DynamicModel

Changed in version 0.1: - initial version.

default_summarymaps()

Returns a list of default summary-maps at the end of a run. This is model specific. You can also add them to the [summary]section of the ini file but stuff you think is crucial to the model should be listed here

dynamic()

Stuf that is done for each timestep

Below a list of variables that can be save to disk as maps or as timeseries (see ini file for syntax):

Dynamic variables

Variables:

• self.SurfaceRunoff – Surface runoff in the kinematic wave [m^3/s]
• self.WaterLevel – Water level in the kinematic wave [m] (above the bottom)

Static variables

Variables:

• self.Altitude – The altitude of each cell [m]
• self.Bw – Width of the river [m]
• self.River – booolean map indicating the presence of a river [-]
• self.DLC – length of the river within a cell [m]
• self.ToCubic – Mutiplier to convert mm to m^3/s for fluxes

initial()

Initial part of the model, executed only once. Reads all static data from disk

Surface water

Variables:

• N.tbl – Manning’s N parameter
• N_river.tbl – Manning’s N parameter fro cells marked as river

resume()

stateVariables()

returns a list of state variables that are essential to the model. This list is essential for the resume and suspend functions to work.

This function is specific for each model and must be present.

Variables:

• self.SurfaceRunoff – Surface runoff in the kin-wave resrvoir [m^3/s]
• self.WaterLevel – Water level in the kin-wave resrvoir [m]

supplyCurrentTime()

gets the current time in seconds after the start of the run

suspend()

updateRunOff()

Updates the kinematic wave reservoir. Should be run after updates to Q

wflow_routing.main(argv=None)

Perform command line execution of the model.

wflow_routing.usage(*args)