skip to main content
Objects and Methods : Diversion Object : Dispatch Methods
Dispatch Methods
Used to solve for Diversion and call the user method functions. The active dispatch methods are dependent on the user method selected in the Diversion Object Solution Direction category, the Available Flow category, and the Diversion Request category.
* Solve given Diversion Request, Intake Elevation
Solves for Diversion when Gravity Diversion or Pumped Diversion is selected in the Available Flow category and Input Diversion Request is selected in the Diversion Request category. The Solve for Outflow method must also be selected.
Required Known Slots
Required Unknown Slots
• None
Method Details  
If the Diversion Intake Elevation is less than or equal to Diversion Base Elevation, Available For Diversion, Diversion, and Outflow are set to zero. In this case, the water surface is at or below the Diversion Base Elevation so it is impossible for water to enter the Diversion Object.
If the Diversion Intake Elevation is greater than the Diversion Base Elevation, Available for Diversion is calculated based on the method selected in the Available Flow category. Then, if Available for Diversion is less than Diversion Request, Diversion is set equal to Available for Diversion. Otherwise, Diversion is set equal to Diversion Request. Outflow is then set equal to Diversion. Finally, the Diversion Pump Energy method, if selected, is executed.
* Solve given Diversion Request, Available
Solves for Diversion when Available Flow Diversion is selected in the Available Flow category and Input Diversion Request is selected in the Diversion Request category. The Solve for Outflow method must also be selected.
Required Known Slots
Required Unknown Slots
• None
Method Details  
1. The user method selected in the Available Flow category is executed.
2. A temporary variable, tempRequest, is assigned the value of Diversion Request. Alternatively, if Diversion Request is less than the Min Diversion Request, it is assigned the value of Min Diversion.
3. Diversion is set as the minimum value of tempRequest, Available For Diversion, and Max Diversion.
4. Outflow is set equal to Diversion.
* Solve given Percent Available, Intake Elevation
Solves for Diversion when Gravity Diversion or Pumped Diversion is selected in the Available Flow category and Percent of Available is selected in the Diversion Request category. The Solve for Outflow method must also be selected.
Required Known Slots
Required Unknown Slots
Method Details  
If the Diversion Intake Elevation is less than or equal to Diversion Base Elevation, Available For Diversion, Diversion, and Outflow are set to zero. In this case, the water surface is at or below the Diversion Base Elevation so it is impossible for water to enter the Diversion Object.
If the Diversion Intake Elevation is greater than the Diversion Base Elevation, Available for Diversion is calculated based on the method selected in the Available Flow category. Then, if Available for Diversion is less than Diversion Request, Diversion is set equal to Available for Diversion. Otherwise, Diversion is set equal to Diversion Request. Outflow is then set equal to Diversion. Finally, the Diversion Pump Energy method, if selected, is executed.
* Solve given Percent Available, Available
Solves for Diversion when Available Flow Diversion is selected in the Available Flow category and Percent of Available is selected in the Diversion Request category. The Solve for Outflow method must also be selected.
Required Known Slots
Required Unknown Slots
Method Details  
1. The user method selected in the Available Flow category is executed.
2. Diversion Request is calculated according to the selected Diversion Request method.
3. A temporary variable, tempRequest, is assigned the value of Diversion Request. Alternatively, if Diversion Request is less than the Min Diversion Request, it is assigned the value of Min Diversion.
4. Diversion is set as the minimum value of tempRequest, Available For Diversion, and Max Diversion.
5. Outflow is set equal to Diversion.
* Solve given Multi Outflow
This method solves for Diversion and Diversion Request when Outflow is known. This dispatch method is only available when you have selected the Solve Given Outflow method in the Diversion Object Solution Direction category. Also, the Input Diversion Request method must be selected in the Diversion Request category, and the Available Flow Diversion method must be selected in the Available Flow category.
This dispatch method sets Diversion and Diversion Request equal to the known Multi Outflow value. The Diversion is also constrained by the Min Diversion and Max Diversion values.
Required Known Slots
Required Unknown Slots
 
Revised: 08/02/2021