skip to main content
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: 12/01/2020