CatchmentLinearReservoir Class

Constructor of CatchmentLinearReservoir

Additional constant flow added to the total runoff Unit: [m3/s] Default: 0

Total area of catchment Type: Catchment area Unit: [m2] Default: 1e8 (100 km2)

Full area of catchment Type: Catchment area Unit: [km2] Default: 100

Evaporation boundary

Rainfall boundary source

Get and set the list of coordinates of the catchment

A overall data interface for cathcment data, containing data properties that are common for all catchments.

This interface contains data and parameters for setting up a catchment model, and represents as such only setup data. Computational variables and methods are not included in this interface. It can be used to explore data and parameters required when setting up the catchment model.

Get and set the central point of the catchment

A set of check points in time that must be hit by the catchments.

Current time of catchment

Effective area. The effective area is the area that collects water. Can be smaller than total area, eg for Linear Reservoir or when LIDs are present.

Effective area (fraction of full area) of the catchement used by the Dutch model Unit: [-]

Time step used in the simulation, it may change. It is set initially in Prepare to TimeStep, and can be updated by individual catchment models when required, i.e. it may differ from TimeStep.

Return the end time of the catchment simulation. This is set during prepare, and the catchment must make sure not to run beyond this time.

True if evaporation is enabled, and an evaporation boundary has been defined.

If set to false the initial recover rate is used during dry periods. Default: False

Runoff/outflow from first reservoir. Only active when the double linear reservoir is active, i.e. the french rural catchment.

State variable

Dry depth used for switching Horton's mode between dry and wet in Kinematic Wave model when InfiltrationAfterRain == true. In this case the switching to regeneration of infiltration capacity is controlled by a low limit of the water depth on the surface. Unit: [m] Default: 1e-6

Impervious area for the French model.

For an urban catchment it is also used as a factor which defines the part of the catchment considered to contribute to the runoff.

Unit: [-]

True if the infiltration process is inlcuded. Default: False

True if infiltration shall occur also after rain Default: True

Time in seconds where infiltration has taken place. Grows over the entire simulation

State variable for the Dutch model, NL.

Maximum value of InitialLossStorageDepth Unit: [m]

Recovery rate for initial loss capacity. The initial loss capacity is regenerated in dry periods by a linear recovery rate.

Used as constant evaporation, when evaporation is not defined explicitly. If evaporation is defined explicitly (see EvaporationFromTimeSeries), this is neglected.

Unit: [m/s] Default: 0.00005 [m/hour] = 1.2 [mm/day]

Initial loss storage depth.

State variable (not for all derived catchment models)

Unit: [m]

Lag time is the reciprocal equivalent of the linear reservoir time constant used in model FR. If set to 0, the linear reservoir time constant is calculated automatically. Unit: [s] default: 300

Length of the catchment used in the Lag time calculation if Lagtime is not given by the user. Unit: [m] Default: 10

Load per inhabitant. Unit: [-]

Maximum runoff flow

Minimum runoff flow

Minimum time the catchment should be able to provide values. The catchment will cache or recalculate values from MinTime to EndTime. MinTime must be updated ("dragged behind" time of calculation) from the caller to allow the catchment to discard cached values.

Model type NL model corresponds to C1 FR model corresponds to C2

A overall data interface for cathcment data, containing data properties that are common for all catchments.

This interface contains data and parameters for setting up a catchment model, and represents as such only setup data. Computational variables and methods are not included in this interface. It can be used to explore data and parameters required when setting up the catchment model.

Observed data. Used for creating calibration plots and for auto-calibration reference data.

Number of person equivalent in the catchment, used with catchment discharge source boundary

Hydrological reduction coeeficient. The runoff reduction factor, accounts for water losses caused by e.g evapo-transpiration, imperfect imperviousness, etc. on the contributing area. Unit: [-]

Total runoff from catchment at present time step. Unit: [m^3/s]

Get the Diagnostics instance for a Catchment. Used during runtime.

Slope of the catchment used in the Lag time calculation if Lagtime is not given by the user. Unit: [-] Default: 0.001

Snow melt coefficient. Note: the snow melt coefficient is not in SI unit, because the temperature is assumed to be in degres Celcius. Unit: [m/degCelcius/s]

Snow storage

State variable

Only applicable when UseSnowModule is set.

Unit: [m]

Start time of catchment data - the earliest time for which the catchment can return data

List of Lids

The linear reservoir Time constant used in model NL Unit: [1/s] Default: 3e-3

Time of minimum runoff flow

Time of maximum runoff flow

Time step used by the catchment model

Total volume of additional inflow

Total infiltration into this catchment (integrated over time)

Total rainfall on this catchment (integrated over time)

Total runoff from this catchment (integrated over time)

Set the TSBuffer to use in this catchment

Flag defining if the catchment is an urban or a rural catchment. If value is undefined, it is automatically determined.

When automatically determined, a catchment is urban when it is French (FR) and has an ImperviousArea factor larger than or equal to 0.2

Flag telling if initial conditions is taken from a hotstart file Default: false

True if the snow module is activated. If True, a temperature time series has to be provided for the catchment.

Volume of water added to catchment after a time step. This water will be eventually routed.

Return dictionary of runoff as a function of year

Dictionary of statistics as a function of year

Apply a boundary to this catchment

Apply a boundary to this catchment

Apply a boundary to this catchment

Apply boundary to LID's in catchment

Apply boundary to LID's in catchment

Apply boundary to LID's in catchment

Apply boundary to LID's in catchment

Apply snow module if activated, and update _actRainDepth.

Return true if boundaries of the specified type are additive; the contributions of two discharge boundaries add up, while two temperature boundaries do not.

Calculate statistics on catchment.

Create offers, populating _offers and [!:_offerDelegates]

Determines whether the specified object is equal to the current object.

Destructor

Finalizes the time step for the catchment.

Serves as the default hash function.

Get the type of boundary required by this catchment

Gets the Type of the current instance.

Get or create a RRYearlyStat object for the specified year.

Initialize Rainfall Runoff model. Sets up static data.

Initializes the cathcment plugins.

Creates a shallow copy of the current Object.

List of data types that is offered and can be used in GetValue

This procedure forwards the calculation with one time step.

Prepare Rainfall Runoff model. Sets up dynamic data so that the model is ready for first time step.

Prepares the catchment for the time step.

Prepares the cathcment plugins.

Prepare boundary source.

Prepare state, especially time

Write current state of plugins

Read state and apply to module. Returns true if state was successfully read.

Reset the catchment and set the current time.

Remove boundaries applied in previous runs

Set the paraneters for the Horton infiltration

If state has been updated from outside, call this method to recalculate state dependent parameters.

This procedure is the one actually calculating the new time step.

List of data types that is offered and can be used in GetValue

Return the time of next update. Used for PostTimeStepEvent event in Catchments. If a catchment uses variable timesteps, then this function must be overridden!!

Get value getter for the specified data quantity

Returns a string that represents the current object.

Transfer current state to state N. First thing to do when starting a timestep.

Trigger the PostTimeStepEvent, called at end of a time step.

The type of catchment: NAM, Urban A etc

Update internal state of catchment to time Time()

Updates check point time.

Updates the routing for the catchment.

Updates the storage for the catchment.

Update time, setting _timeNew to _timeOld + _effectiveTimeStep. This method will assue that _timeNew does not go beyond _endTime, by modifying _effectiveTimeStep. Before calling UpdateTime, be sure that _effectiveTimeStep is set.

Updates the present time if it is greater than the check point time.

Validate that the catchment is set up correctly

Validate all LIDs in catchment

Get value setter for the specified data quantity

Volume of water stored in catchment after previous time step.

Volume of water stored in catchment after previous time step.

Write current state of plugins

Write current state of module

Event that is triggered every time the catchment has finished a new time step

Actual evaporation Unit: [m/s]

Actual evaporation at time N, Unit: [m/s]

Actual infiltration, loss. Unit: [m/s]

Infiltration at time N. Unit: [m/s]

Actual rain depth. Unit: [m]

Actual rain intensity. Unit: [m/s]

Additional constant flow added to the total runoff Unit: [m3/s] Default: 0

Additional constant flow at start of time step

Total area of catchment. Type: Catchment area. Unit: [m2]. Default: 1e8 (100 km2).

True if infiltration shall occur also after rain, used in Horton infiltration depth calculation from INI file Default: True

Evaporation boundary source

Rainfall boundary source

Temperature boundary source

True if the snow module is activated.

The most recent check point time.

Time step used in the simulation, it may change. It is set in Prepare to _timeStep, and can be updated by individual catchment models when required, i.e. it may differ from _timeStep.

Return the end time of the catchment simulation. This is set during prepare, and the catchment must make sure not to run beyond this time.

Evaporation that must be applied during the calculation time step. unit: [m/s]

True if evaporation is enabled, and an evaporation boundary has been defined.

If set to false the initial recover rate is used during dry periods. Default: False

Global dry depth limit from INI file in Kinematic wave: used when InfiltrationAfterRain == true Default: 1e-6 Unit: [m]

Impervious area is a factor which defines the part of the catchment considered to contribute to the runoff. Unit: [-]

Maximum value of InitialLossStorageDepth Unit: [m] Default:

Initial loss recover rate Unit: [m/s] Default: 5e-5 m/h = 1.2 mm/day

Initial loss storage depth. Unit: [m]

Initial loss storage depth at time N. Unit: [m]

Loss, other than infiltration which goes into _actInfiltration (in another unit). Unit [m3/s]

Loss at time N. Unit: [m3/s]

Maximum flow

Minimum flow

Proteced MinTime

List of delegates, matching list of _offers

List of datatypes offered in GetValue

Potential evaporation Unit: [m/s]

Rainfall that must be applied during the calculation time step measured in m/s. unit: [m/s]

Rainfall that must be applied during the calculation time step measured in m/s, at time N. unit: [m/s]

Hydrological reduction is the runoff reduction factor, accounts for water losses caused by e.g evapo-transpiration, imperfect imperviousness, etc. on the contributing area. Unit: [-] Default: 0.90

Total runoff from catchment at present time step. Unit: [m^3/s]

Runoff at time N. Unit: [m3/s]

Diagnostics instance for a Catchment. Used during runtime.

Snow storage Unit: [m]

Snow storage at time N. Unit: [m]

Protected start time of catchment data - the earliest time for which the catchment can return data

List of Lids

Temperature that must be applied during the calculation time step. Note: the temperature is given in degrees Celsius, which is not SI unit! unit: [degCelcius]

Variable holding information on the latest calculated time

Last time the state of this catchment was updated (Update(DateTime) was called)

Time of maximum flow

Time of minimum flow

Variable holding information on the latest calculated time

Time step used in the simulation, or initial time step if the time step can change.

Total volume of additional inflow

Total volume of loss

Total volume of rain

Total volume of runoff

TSBuffer to use when accessing time series objects Set in Catchments.Add(). If not set, then the inheritors must create a TSBuffer before using it.

Flag telling if initial conditions is taken from a hotstart file Default: false

Volume on ground added after UpdateStorage

Volume on ground after routing

Volume on ground before routing

Dictionary of statistics as a function of year

List of catchment plugins