skip to main content
Sequential Structure Methods
* Solve Sequential given Total Diversion Requested
Required Known Slots
Required Unknown Slots
Method Details  
Following is a eneral description of the interaction among the Agg Diversion Site, Water Users, and Reach/Reservoir.
1. Reach/Reservoir Available For Diversion is set.
2. Value propagates to Agg Diversion Site: Total Available Water.
3. Solve Sequential given Total Diversion Requested on Agg Diversion Site object dispatches. Total Diversion is calculated as the lower value of Total Available Water and the amount of water needed to satisfy the Diversion Requested on all Water User elements.
Note:  Because the return flows may be available to downstream elements, this value may be less than the Total Diversion Requested.
4. Total Diversion propagates to Incoming Available Water on the first Water User.
5. The Water User solves for Diversion, Outgoing Available Water and Return Flow.
6. Return Flow is propagated to reach/reservoir (if link has been established) or it is sent to the next Water User via the Outgoing Available Water slot.
7. Outgoing Available Water value propagates to Incoming Available Water of second Water User.
8. Outgoing Available Water from last Water User propagates to Agg Diversion Site: Total Unused Water (including Return Flow from the last Water User if it is not linked to the Reach/Reservoir).
9. Total Surface Return Flow is set equal to the Surface Return Flow on the last element.
10. Solve Sequential given Total Diversion Requested on Agg Diversion Site object redispatches.
11. Total Depletion, Total Diversion Shortage, and Total Depletion Shortage are calculated.
12. Total Unused Water is propagated to the Return Flow on the Reach/Reservoir.
13. Conjunctive Use calculations are performed if selected.
* Solve Sequential given Total Diversion
This method is executed when Total Diversion is specified by the user. The value of Total Diversion cannot be greater than the Total Available Water.
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. The input value of Total Diversion propagates to Incoming Available Water on the first Water User.
2. The Water User solves for Diversion, Outgoing Available Water and Return Flow.
3. Return Flow is propagated to reach/reservoir (if link has been established) or it is sent to the next Water User via the Outgoing Available Water slot.
4. Outgoing Available Water value propagates to Incoming Available Water of second Water User.
5. Outgoing Available Water from last Water User propagates to Agg Diversion Site: Total Unused Water (including Return Flow from the last Water User if it is not linked to the Reach/Reservoir).
6. Total Surface Return Flow is set equal to the Surface Return Flow on the last element.
7. Solve Sequential given Total Diversion on the Agg Diversion Site object dispatches.
8. Total Depletion, Total Diversion Shortage, and Total Depletion Shortage are calculated.
9. Total Unused Water is propagated to the Return Flow on the Reach/Reservoir.
10. Conjunctive Use calculations are performed if selected.
* Solve Sequential given Total Depletion Requested
This method is used only when all the member elements are modeling Soil Moisture to compute the requests; see Irrigation Requests with Soil Moisture.
The member water users compute the Depletion Requested at the beginning of the timestep for the current timestep and some number of future timesteps; see Irrigation Requests with Soil Moisture.
These Depletion Requested values propagate to the aggregate and, together with Total Available Water, cause this dispatch method to be used.
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. At the beginning of the timestep, Depletion Requested is set on the member element’s slots and is then propagated to the Agg Diversion Site.Total Depletion Requested.
2. Reach/Reservoir Available For Diversion is set and the value propagates to Agg Diversion Site.Total Available Water.
3. Solve Sequential given Total Depletion Requested on the Agg Diversion Site object dispatches. Total Diversion Requested is computed by solving each water user element without setting any slots. If the previous soil moisture is unknown because it is solving at future timesteps, the soil moisture is assumed to be full so that only Depletion Requests for Crops will be met. (This will iterate once the soil moisture is known) On the aggregate, the Total Diversion is calculated as the lower value of Total Available Water and the amount of water needed to satisfy the Diversion Requested on all water user elements.
Note:  Because the return flows may be available to downstream elements, this value may be less than the Total Diversion Requested.
4. Total Diversion propagates to Incoming Available Water on the first Water User.
5. The Water User solves for Diversion, Outgoing Available Water and Return Flow.
6. Return Flow is propagated to reach/reservoir (if link has been established) or it is sent to the next Water User via the Outgoing Available Water slot.
7. Outgoing Available Water value propagates to Incoming Available Water of second Water User.
8. Outgoing Available Water from last Water User propagates to Agg Diversion Site: Total Unused Water (including Return Flow from the last Water User if it is not linked to the Reach/Reservoir).
9. Total Surface Return Flow is set equal to the Surface Return Flow on the last element.
10. Solve Sequential given Total Depletion Requested on the Agg Diversion Site object redispatches.
11. Total Depletion, Total Diversion Shortage, and Total Depletion Shortage are calculated.
12. Total Unused Water is propagated to the Return Flow on the Reach/Reservoir.
13. Conjunctive Use calculations are performed if selected.
Revised: 08/02/2021