skip to main content
Objects and Methods : Water User : Dispatch Methods : Sequential Structure Linking
Sequential Structure Linking
The Water User dispatches using these methods when the Sequential Structure linking method is selected on the aggregate diversion site that contains these water user elements.
* Solve Sequential given Diversion Requested
Required Known Slots
Required Unknown Slots
Method Details  
If Incoming Available Water is greater than Diversion Requested, then Diversion is set equal to Diversion Requested and a temporary variable, unusedFlow, is the difference between Incoming Available Water and Diversion. If Incoming Available Water is less than Diversion Requested, Diversion is set equal to Incoming Available Water and unusedFlow is zero.
The Depletion Shortage is calculated as the difference between Depletion Requested and Depletion. Diversion Shortage is calculated as the difference between Diversion and Diversion Requested.
The Return Flow and Depletion are calculated based on the selected user method in the Return Flow category.
When the Specify Scheduled Requests method is selected, the Depletion Schedule Cutback and Depletion Schedule Shortage are computed. See Specify Scheduled Requests for details.
If selected, the Conjunctive Use calculations are then performed.
Next, the total return flow (Return Flow plus Supplement Return Flow, when in use) are split using the selected Return Flow Split method and/or routed, using the selected Return Flow Routing methods.
Next, the portion of the outgoing water that is from Return Flow is computed, using a temporary variable called outgoingFromRF. This computation depends on the selected Return Flow Split method and Return Flow Routing. Basically, if the return flow slot (Surface Return Flow, Return Flow, Total Return Flow or Routed Return Flow) is linked, it is going elsewhere and not available to the next element, so it is not included in the outgoingFromRF. If the flow components are not linked, it is considered outgoingFromRF.
Finally, the Outgoing Available Water is computed as
    
The Outgoing Available Water propagates across a link to the Incoming Available Water for the next Water User or the Total Unused Water of the Agg Diversion Site.
* Solve Sequential given Diversion
Required Known Slots
Required Unknown Slots
Method Details  
If Incoming Available Water is greater than Diversion, then a temporary variable, unusedFlow, is the difference between Incoming Available Water and Diversion. If Incoming Available Water is less than Diversion, unusedFlow is zero.
If Depletion Requested is valid, the Depletion Shortage is calculated as the difference between Depletion Requested and Depletion. Diversion Shortage is calculated as the difference between Diversion and Diversion Requested.
The Return Flow and Depletion are calculated based on the selected user method in the Return Flow category. If the return flow is split and neither Return Flow nor Surface Return Flow are linked, the value of Surface Return Flow is added to the existing Outgoing Available Water. If the return flow is not split and Return Flow is not linked, the value of Return Flow is added to the existing Outgoing Available Water.
When the Specify Scheduled Requests method is selected, the Depletion Schedule Cutback and Depletion Schedule Shortage are computed. See Specify Scheduled Requests for details.
If selected, the Conjunctive Use calculations are then performed.
Next, the total return flow (Return Flow plus Supplement Return Flow, when in use) are split using the selected Return Flow Split method and/or routed, using the selected Return Flow Routing methods.
Next, the portion of the outgoing water that is from Return Flow is computed, using a temporary variable called outgoingFromRF. This computation depends on the selected Return Flow Split method and Return Flow Routing. Basically, if the return flow slot (Surface Return Flow, Return Flow, Total Return Flow or Routed Return Flow) is linked, it is going elsewhere and not available to the next element, so it is not included in the outgoingFromRF. If the flow components are not linked, it is considered outgoingFromRF.
Finally, the Outgoing Available Water is computed.
    
The Outgoing Available Water propagates across a link to the Incoming Available Water for the next Water User or the Total Unused Water of the Agg Diversion Site.
* Solve Sequential given Depletion Requested
This method is available if the water user has the Irrigation Requests with Soil Moisture method selected.
Required Known Slots
Required Unknown Slots
Method Details  
The algorithm is used to determine Diversion, Depletion, Return Flow, Diversion Shortage and Depletion Shortage when the Sequential linking method is used.
If Irrigation Requests with Soil Moisture is selected, compute the Diversion Requested, Diversion Request for Crops, and Diversion Request for Soil Moisture. If Soil Moisture at the previous timestep is unknown, exit and wait for it to become known.
If Incoming Available Water is greater than Diversion Requested, then Diversion is set equal to Diversion Requested and a temporary variable unusedFlow is the difference between Incoming Available Water and Diversion. If Incoming Available Water is less than Diversion Requested, Diversion is set equal to Incoming Available Water and unusedFlow is zero.
The Depletion Shortage is calculated as the difference between Depletion Requested and Depletion. Diversion Shortage is calculated as the difference between Diversion and Diversion Requested.
If selected, the Conjunctive Use calculations are then performed.
Next, the total return flow (Return Flow plus Supplement Return Flow, when in use) are split using the selected Return Flow Split method and/or routed, using the selected Return Flow Routing methods.
Next, the portion of the outgoing water that is from Return Flow is computed, using a temporary variable called outgoingFromRF. This computation depends on the selected Return Flow Split method and Return Flow Routing. Basically, if the return flow slot (Surface Return Flow, Return Flow, Total Return Flow or Routed Return Flow) is linked, it is going elsewhere and not available to the next element, so it is not included in the outgoingFromRF. If the flow components are not linked, it is considered outgoingFromRF.
Finally, the Outgoing Available Water is computed.
    
The Outgoing Available Water propagates across a link to the Incoming Available Water for the next Water User or the Total Unused Water of the Agg Diversion Site.
 
Revised: 07/09/2023