skip to main content
General Slots
 Backwater Elevation
Type: Series Slot
Units: LENGTH
Description: Water surface elevation at the upstream end of a slope power reservoir
Information:  
I/O: Optional; can be input or linked.
 Canal Flow
Type: Series Slot
Units: FLOW
Description: Flow into, or out of, the reservoir from, or to, a canal
Information: 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.
I/O: Output only
 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.
 Diversion
Type: SeriesSlot
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
 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
 Elevation Volume Table
Type: Table
Units: LENGTH vs. VOLUME
Description: Reservoir Pool Elevation vs. Reservoir Storage
Information:  
I/O: Required input
 Energy
Type: Series Slot
Units: ENERGY
Description: product of the power generated by flow through the turbines and the length of the timestep
Information: This slot may also take the BEST_EFFICIENCY or MAX_CAPACITY flags, which allow Energy to act as input for dispatching, but solve for the value of energy assuming the generators are operating at best efficiency or maximum capacity.
I/O: Optional; if not input by the user, Energy is computed in the power calculations.
 Flow FROM Pumped Storage
Type: Series Slot
Units: FLOW
Description: Flow into the reservoir from a pumped storage reservoir
Information: May be linked to the Outflow slot of a Pumped Storage object.
I/O: Optional; usually linked if used.
 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
 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.
 Inflow 2
Type: Series Slot
Units: FLOW
Description: additional inflow slot for upstream inflows that do not contribute to the wedge storage
Information:  
I/O: Optional; defaults to zero if not input and not linked
 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.
 Operating Head
Type: Series Slot
Units: LENGTH
Description: Elevation difference between the average Pool Elevation and the average Tailwater Elevation during a timestep
Information:  
I/O: Output only
 Outflow
Type: Series Slot
Units: FLOW
Description: Outflow from reservoir
Information: The outflow from a is equal to the sum of the Turbine Release and the Spill. May be linked to the inflow slot of a downstream object. If not input by the user, it is set through either the mass balance computations or the propagation of values across the link.
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.
 Pool Elevation
Type: Series Slot
Units: LENGTH
Description: Elevation of the water surface of 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.
 Power
Type: Series Slot
Units: POWER
Description: power generated by flow through the turbines
Information: Calculated by the power methods and cannot be input by the user.
I/O: Output only
 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.
 Spill
Type: Series Slot
Units: FLOW
Description: Sum of the regulated and unregulated spills and bypass
Information: May be input or solved for by RiverWare (see spill calculation methods).
I/O: Optional; may be input or solved for by RiverWare (see spill calculation methods).
 Storage
Type: Series Slot
Units: VOLUME
Description: Volume of water stored in the reservoir
Information: May be flagged as a TARGET Storage value by the user. There must be an initial value for either Storage or Pool Elevation given by the user for the first timestep. 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.
 Tailwater Elevation
Type: SeriesSlot
Units: LENGTH
Description: Water surface elevation on the downstream side of the dam
Information: It can be linked to the Pool Elevation or Backwater Elevation of a downstream reservoir if the Linked or Input method is selected for the Tailwater category. Otherwise, it is calculated by the user method selected. It is used to compute the Operating Head used in the power calculations.
I/O: Optional; can be input, linked or calculated.
 Total Inflows
Type: SeriesSlot
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 using the following equation. Any component that is not in use or is not valid defaults to zero.
    
I/O: Output only
 Inflow Sum
Type: Series
Units: Flow
Description: Sum of the total flows entering the reservoir at each timestep
Information: Inflow Sum is calculated using the following equation.
    
I/O: Output only
 Turbine Release
Type: Series Slot
Units: FLOW
Description: Flow through the turbines of a power reservoir (excluding spill)
Information:  
I/O: Optional; solved for if not input.
Note:  The initial (Beginning of Run) value for either Pool Elevation or Storage must be input by the user.
Revised: 07/03/2024