modelReservoir

Model of the reservoir

Extends from OpenHPL.Icons.Reservoir (Reservoir icon).

Information

Reservoir Model

Simple model of the reservoir with different options for modeling the water source of a hydropower system.

Figure: Reservoir model schematic.

Model Variants
  • Default (Simple): Container with an initial water level of H_0. The water level will vary according to the outlet volume flow rate.
  • useLevel: The water level is determined by the level input signal, allowing external control of the (varying) reservoir levels.
  • useInflow: Reservoir starts with an initial water level of H_0 but uses the inflow input as additional water source (can also be negative to simulate evaporation or other losses).
Governing Equations

Simplified Model: In the simple case with constant or slowly varying reservoir level, the reservoir outlet pressure is simply:

$$ p_\mathrm{o} = p_\mathrm{atm} + \rho g H $$

Detailed Model: For a detailed model with dynamics and inflow, the mass and momentum balances are:

$$ H\frac{\mathrm{d}\dot{m}}{\mathrm{d}t} = \frac{\rho}{A}\dot{V}^2 + A(p_\mathrm{atm}-p_\mathrm{o}) + \rho gHA - F_\mathrm{f,r} $$

$$ \frac{\mathrm{d}m}{\mathrm{d}t} = \dot{m}_\mathrm{i} - \dot{m}_\mathrm{o} $$

where ṁ is the reservoir mass flow rate, A is the cross-sectional area, patm and po are atmospheric and outlet pressures, and Ff,r is the friction term (typically small for large reservoirs).

Parameters

TypeNameDefaultDescription
Setup
SI.Heighth_050Initial water level above intake
BooleanconstantLevelfalseIf checked, the reservoir keeps the constant water level h_0
BooleanuseLevelfalseIf checked, the "level" connector controls the water level of the reservoir
BooleanuseInflowfalseIf checked, the "inflow" connector is used
Geometry
BooleanfixElevationfalseIf true (fixed), z_0 is enforced as initial value; if false (derived), elevation is determined by connected topology
SI.Positionz_00Elevation of the reservoir outlet (sets absolute reference)
SI.LengthL500Length of the reservoir
SI.LengthW100Bed width of the reservoir
SI.Anglealpha0The angle of the reservoir walls (zero angle corresponds to vertical walls)
Realf0.0008Friction factor of the reservoir

Connectors

TypeNameDefaultDescription
OpenHPL.Interfaces.Contact_ooOutflow from reservoir
Modelica.Blocks.Interfaces.RealInputinflowVdot_iConditional input inflow of the reservoir
Modelica.Blocks.Interfaces.RealInputlevelhConditional input water level of the reservoir

Components

TypeNameDefaultDescription
Datadatausing standard class with constants
SI.Positionh_abs_ds (from Reservoir)Absolut height of watercolumn in the surge shaft (for DynamicSelect)
Booleanshow (from Reservoir)Show additional level info
SI.AreaAVertical cross section
SI.MassmWater mass
SI.MassFlowRatemdotWater mass flow rate
SI.VolumeFlowRateVdot_iInlet flow rate
SI.VolumeFlowRateVdot_oOutlet flow rate
SI.VolumeFlowRateVdotFlow rate through the reservoir
SI.VelocityvWater velocity
SI.MomentumMWater momentum
SI.ForceF_fFriction force
SI.HeighthWater level
SI.Positionh_absh + o.elevation.zAbsolute water level
SI.Pressurep_oOutlet pressure