modelReservoir
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 thelevelinput signal, allowing external control of the (varying) reservoir levels.useInflow: Reservoir starts with an initial water level ofH_0but uses theinflowinput 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
| Type | Name | Default | Description |
|---|---|---|---|
| Setup | |||
| SI.Height | h_0 | 50 | Initial water level above intake |
| Boolean | constantLevel | false | If checked, the reservoir keeps the constant water level h_0 |
| Boolean | useLevel | false | If checked, the "level" connector controls the water level of the reservoir |
| Boolean | useInflow | false | If checked, the "inflow" connector is used |
| Geometry | |||
| Boolean | fixElevation | false | If true (fixed), z_0 is enforced as initial value; if false (derived), elevation is determined by connected topology |
| SI.Position | z_0 | 0 | Elevation of the reservoir outlet (sets absolute reference) |
| SI.Length | L | 500 | Length of the reservoir |
| SI.Length | W | 100 | Bed width of the reservoir |
| SI.Angle | alpha | 0 | The angle of the reservoir walls (zero angle corresponds to vertical walls) |
| Real | f | 0.0008 | Friction factor of the reservoir |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| OpenHPL.Interfaces.Contact_o | o | Outflow from reservoir | |
| Modelica.Blocks.Interfaces.RealInput | inflow | Vdot_i | Conditional input inflow of the reservoir |
| Modelica.Blocks.Interfaces.RealInput | level | h | Conditional input water level of the reservoir |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Data | data | using standard class with constants | |
| SI.Position | h_abs_ds (from Reservoir) | Absolut height of watercolumn in the surge shaft (for DynamicSelect) | |
| Boolean | show (from Reservoir) | Show additional level info | |
| SI.Area | A | Vertical cross section | |
| SI.Mass | m | Water mass | |
| SI.MassFlowRate | mdot | Water mass flow rate | |
| SI.VolumeFlowRate | Vdot_i | Inlet flow rate | |
| SI.VolumeFlowRate | Vdot_o | Outlet flow rate | |
| SI.VolumeFlowRate | Vdot | Flow rate through the reservoir | |
| SI.Velocity | v | Water velocity | |
| SI.Momentum | M | Water momentum | |
| SI.Force | F_f | Friction force | |
| SI.Height | h | Water level | |
| SI.Position | h_abs | h + o.elevation.z | Absolute water level |
| SI.Pressure | p_o | Outlet pressure |