Objects and Methods
Storage Reservoir
The Storage Reservoir is the least complicated of all the reservoirs modeled in RiverWare. The only process performed by the Storage Reservoir is the storage of water. No power production facilities exist on the Storage Reservoir.
General Slots
Canal Flow
Type: Series Slot
Units: FLOW
Description: Flow into (out of) the reservoir from (to) a canal
Information:
I/O: Output only
Links: May be linked to either the Flow 1 or Flow 2 slot of the Canal object. If not linked, the slot is set to zero.
Convergence Percentage
Type: Table
Units: NONE
Description: A percentage value ranging from 0 to 1 used for convergence in all iterative calculations
Information: See “Reservoir Convergence” for more information on the convergence algorithm.
I/O: Optional; defaults to 0.0001 if not input.
Links: Not linkable
Diversion
Type: Series
Units: FLOW
Description: Flow from the reservoir to a diverting object
Information: If not linked or input it is set to zero.
I/O: Optional; may be input or linked or neither
Links: May be linked to the Total Diversion slot on an Agg Diversion Site or the Total delivery Request slot on an AggDistribution Canal
Diversion Capacity
Type: Scalar Slot
Units: FLOW
Description: Used to hold the maximum diversion physically possible from the reservoir
Information: This slot is used in the accounting system for allocation purposes and can be used in Rulebased Simulation
I/O: Input only
Links: Not linkable
Elevation Volume Table
Type: Table
Units: LENGTH vs. VOLUME
Description: reservoir pool elevation vs. reservoir storage
Information:
I/O: Required input
Links: Not linkable
Flow FROM Pumped Storage
Type: Series Slot
Units: FLOW
Description: Flow into the reservoir from a pumped storage reservoir
Information:
I/O: Optional; usually linked if used.
Links: May be linked to the Outflow slot of a Pumped Storage object.
Flow TO Pumped Storage
Type: Series Slot
Units: FLOW
Description: Flow out of the reservoir into a pumped storage reservoir
Information:
I/O: Optional; usually linked if used.
Links: May be linked to the Pumped Flow slot of a Pumped Storage object.
Inflow
Type: Multi Slot
Units: FLOW
Description: inflow into the reservoir from upstream
Information:
I/O: Optional; if not input by the user, it is set through either mass balance computations or the propagation of values across the link.
Links: May be linked to one or more outflow slots of upstream objects.
Max Iterations
Type: Table
Units: NOUNITS
Description: maximum number of allowable iterations for iterative loops in the solution algorithms
Information: Used in conjunction with Convergence Percentage as a stopping criterion for iterative calculations.
I/O: Optional; defaults to 100 if not input.
Links: Not linkable
Max Release
Type: Table
Units: LENGTH vs. FLOW
Description: reservoir pool elevation vs. maximum release through controlled outlet-conduit of a reservoir (excluding spill)
Information:
I/O: Required input
Links: Not linkable
Outflow
Type: Series Slot
Units: FLOW
Description: outflow from reservoir
Information: The Outflow from a Storage Reservoir is equal to the sum of the Release and the Spill.
I/O: Optional; if not input by the user, it is set through either the mass balance computations or the propagation of values across the link.
Links: May be linked to the inflow slot of a downstream object.
Pool Elevation
Type: Series Slot
Units: LENGTH
Description: elevation of the water surface in the reservoir
Information: There must be an initial value for either Storage or Pool Elevation given by the user for the first timestep.
I/O: Optional; if not input by the user, it is solved by the mass balance computations. It may take a TARGET flag indicated by the user for target operation solution.
Links: May be linked to Tailwater Elevation or Tailwater Base Value of an upstream object or to Elevation 1 or Elevation 2 of a Canal object.
Release
Type: Series Slot
Units: FLOW
Description: Flow through the outlet-conduit of a storage reservoir (excluding spill)
Information:
I/O: Optional; solved for if not input.
Links: Usually not linked
Return Flow
Type: Multi Slot
Units: FLOW
Description: Flow returning from a diverting object
Information:
I/O: Optional; defaults to zero if not linked or input.
Links: May be linked to one or more Return Flow slots on Water User objects or the Total Return Flow slot on the Agg Diversion Site objects.
Spill
Type: Series Slot
Units: FLOW
Description: Sum of the regulated and unregulated spills and bypass
Information:
I/O: Optional; may be input or solved for by RiverWare (see spill calculation methods).
Links: Usually not linked
Storage
Type: Series Slot
Units: VOLUME
Description: volume of water stored in the reservoir
Information: This slot may be flagged as a TARGET storage value by the user. If flagged as a TARGET, a target operation solution is used.
I/O: Optional; if not input by the user, it is set through mass balance computations.
Links: Usually not linked
Total Inflows
Type: Series
Units: Flow
Description: Summary slot displaying the flows into and out of the reservoir excluding the flows through the outlet works
Information: Total Inflows is calculated. Any component that is not in use or is not valid defaults to zero.
I/O: Output only
Links: Not linkable
Inflow Sum
Type: Series
Units: Flow
Description: Sum of the total flows entering the reservoir at each timestep
Information: Inflow Sum is calculated.
I/O: Output only
Links: Not linkable
Note: Either the initial (Beginning of Run) value for Pool Elevation or Storage must be input by the user.
Revised: 11/11/2019