General Slots
Canal Flow
Type: Series Slot
Units: FLOW
Description: flow into (out of) the reservoir from (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
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 details 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
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.
Links: Usually not linked
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.
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
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
Links: Usually not linked
Outflow
Type: Series Slot
Units: FLOW
Description: outflow from reservoir
Information: The outflow from a Level Power Reservoir 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.
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 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.
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.
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
Links: Not linkable
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: 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).
Links: Usually not linked
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.
Links: Usually not linked
Tailwater Elevation
Type: Series
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.
Links: 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.
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
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.
Links: Usually not linked
Revised: 07/09/2023