Description

This function computes the Turbine Release necessary to meet the specified Energy.

Type

LIST {NUMERIC, BOOLEAN}

Arguments

1

OBJECT

the reservoir object for which to calculate

(must be a LevelPowerReservoir)

2

NUMERIC

the energy value

3

NUMERIC

the inflow value

4

DATETIME

the timestep at which to calculate

Evaluation

This function behaves like the solution of the LevelPowerReservoir in simulation. If the given energy can be met by the turbine release, TRUE is returned in the list boolean. If the given energy cannot be met, the turbine release is calculated to be maximum release as computed by GetMaxReleaseGivenInflow and FALSE is returned in the list boolean.

This function uses the same algorithm as the SolveOutflowGivenEnergyInflow but returns only the turbine release portion of the outflow.

Comments

This function assumes that the LevelPowerReservoir has solved for all the timesteps prior to the date specified in argument 4. This is necessary because the solution requires previous Storage. This information is retrieved from slots on the object at timesteps prior to the date specified in argument 4. If any of this information is missing, an error is posted and the rule fails. If this function is called on the first timestep, the initial input data are used. These data are already required for the LevelPowerReservoir to dispatch in simulation mode.

Side flows are automatically considered by this function. These including: Hydrologic Inflow Net , Diversion , Return Flow , Canal Flow , Pumped Storage Inflow , Pumped Storage Outflow , and specified Spills . These slots are automatically added as dependencies to the calling rule.

Also, if there are Unregulated Spills, the unregulated spill is limited to be no greater than the max unregulated spill. This is described in the Unregulated Spill documentation on the Level Power Reservoir.