Description

The maximum release of a reservoir, through outlet works or turbine release.

Type

NUMERIC

Arguments

Type

Meaning

1

OBJECT

the reservoir object for which to calculate

2

NUMERIC

the average inflow over the timestep

3

DATETIME

the timestep at which to calculate

Evaluation

This function calls the getMaxRelGivenIn() function on the given reservoir object at the given timestep, and provides it with the average inflow over the timestep. A convergence algorithm is used in this function and is detailed .The function iterates to convergence by computing the end of timestep storage and pool elevation, the average HW over the timestep, and the release:

• release (if the object is a StorageReservoir): The maximum release is determined from a table interpolation in the Max Release table using the average HW as the lookup in the Pool Elevation column.

Evaluation (continued)

• turbine release (if the object is a LevelPowerReservoir or SlopePowerReservoir): The maximum turbine release is determined based on the selected PowerCalculationCategory Method. This calculation is iterative, since the maximum outflow impacts the reservoir tailwater elevation and operating head, which affect the maximum turbine release. The selected tailwaterCalculationCategory Method is used to determine the tailwater elevation.
• No Power Turbine Flow : The turbine release is determined from a table interpolation in the Max Flow Through Turbines table using the average HW as the lookup in the Reservoir Elevation column.
• plantPowerCalc : The turbine release is determined from a table interpolation in the Max Turbine Q table using the operating head as the lookup in the Operating Head column. If the average HW is less than the Minimum Power Elevation , the turbine release is zero.
• unitGeneratorPowerCalc : The turbine release is the sum of the maximum releases for each available turbine, as specified in the Generators Available and Limit table. Each turbine’s maximum release is determined from a table interpolation in the Full Generator Flow table using the operating head as the lookup in the appropriate unit type’s Head for Type n column. If the average HW is less than the Minimum Power Elevation, the turbine release is zero.
• PeakPowerCalc and PeakBasePowerCalc : The turbine release is the peak flow over the entire timestep. This is calculated by iterating the selected tailwaterCalculationCategory Method and operating head calculation with a table interpolation in the Best Generator Flow table using the operating head as the lookup in the Head for Type 1 column.
• Peak Power Equation with Off Peak Spill : The turbine release is the peak release over the entire timestep. This is calculated by iterating the selected tailwaterCalculationCategory Method and operating head calculation with a table interpolation in the Operating Head vs. Generator Capacity table.
• LCRPowerCalc : Because this power Method has no turbine release limit, a maximum Outflow cannot be calculated. RiverWare issues an error message and aborts the execution of this rule.

Mathematical Expression

Comments

The Tailwater Base Value , Hydrologic Inflow Net , Diversion , Return Flow , Canal Flow , Pumped Storage Inflow , and Pumped Storage Outflow are automatic dependencies of this function. Since the function evaluation depends on these slots, any change to their values, may impact the function result.