Lumped Structure Methods

Solve Lumped given Total Diversion Requested

Required Known Slots

Required Unknown Slots

Method Details

Following is a general description of the interaction among the Agg Diversion Site, Water Users, and Reach/Reservoir.

1. Reach/Reservoir Available For Diversion is set.

2. This value propagates to Agg Diversion Site: Total Available Water.

3. Solve Lumped given Total Diversion Requested dispatches on the Agg Diversion Site object.

4. Within the dispatch method, Total Diversion and Total Return Flow are calculated.

5. The values propagate to the reach or reservoir.

6. Conjunctive Use and Aggregate Max Supplemental Request calculations are performed if selected.

If Total Depletion Requested is not specified, it is set equal to the Total Diversion Requested.

If Total Diversion Requested is greater than the Total Available Water:

Total Diversion = Total Available Water

If the Total Diversion Requested is less than Total Available Water:

Total Diversion = Total Diversion Requested

Total Return Flow = Total Diversion - Total Depletion Requested

Then, Total Depletion is set as the difference between Total Diversion and Total Return Flow.

Total Depletion Shortage is computed as Total Depletion Requested minus Total Depletion.

The totalDepletionFraction is computed as Total Depletion divided by Total Depletion Requested. This value is not shown to the user. The agg then loops over each member water user (WU) and computes and sets the element’s Depletion Shortage. It is computed as

Essentially, any shortage is shared by each water user element proportional to its Depletion Requested. See Depletion Shortage for more information.

When Specify Scheduled Requests (see Specify Scheduled Requests) is selected on the element, additional shortage terms are computed as follows:

Solve Lumped given Total Diversion

Required Known Slots

Required Unknown Slots

Method Details

Following is a general description of the interaction among the Agg Diversion Site, Water Users, and Reach/Reservoir.

1. Solve Lumped given Total Diversion dispatches on the Agg Diversion Site object.

2. Within the dispatch method, Total Depletion and Total Return Flow are calculated.

3. The values propagate to the reach or reservoir.

4. Conjunctive Use and Aggregate Max Supplemental Request calculations are performed if selected.

If Total Depletion Requested is not specified, it is set equal to the Total Diversion Requested.

If Total Diversion is less than the Total Diversion Requested:

If the Total Diversion is equal to the Total Diversion Requested:

Total Return Flow = Total Diversion - Total Depletion Requested

Then, Total Depletion is set as the difference between Total Diversion and Total Return Flow.

Total Depletion Shortage is computed as Total Depletion Requested minus Total Depletion.

The totalDepletionFraction is computed as Total Depletion divided by Total Depletion Requested. This value is not shown to the user. The agg then loops over each member water user element and computes and sets the element’s Depletion Shortage. It is computed as follows.

Essentially, any shortage is shared by each water user element proportional to its Depletion Requested. See Depletion Shortage for more information.

When Specify Scheduled Requests (see Specify Scheduled Requests) is selected on the element, additional shortage terms are computed as follows:

Revised: 01/11/2023