Description

Minimum diversion required to meet all Water Users’ requests.

Type

NUMERIC

Arguments

Type

Meaning

1

OBJECT

the aggregate diversion site object

2

DATETIME

the timestep

Evaluation

If the Aggregate Diversion Site is linked with the noStructure or lumpedStructure , this function evaluates to the current value of the Total Diversion Requested slot.

If the Aggregate Diversion Site is linked with the sequentialStrucure , the function sets a total diversion requirement equal to the topmost Water User’s Diversion Requested and then loops over the remaining Water Users. The water available at each element is calculated based on the upstream elements’ diversions and their return flows. If this water is enough to satisfy the Water User’s Diversion Requested , the total diversion requirement is not modified. If this water is not enough to satisfy the Water User’s Diversion Requested , the total diversion requirement is increased to satisfy this Water User.

Mathematical Expression

Comments

This function exits with an early termination if any of the required data used to solve the diversion is unknown. The required data is the same as that needed for the objects to fully dispatch, except Total/Incoming Available Water , which need not be known. For sequentially linked Agg Diversion Sites, the function takes into account whether Return Flow, or Surface Return Flow are linked to another object, or unlinked and available to the next Water User in the diversion.