packageUsersGuide

Information

Documentation Structure: This User's Guide provides high-level information about the library, installation, examples, and guidance for model selection. Detailed technical documentation (equations, parameters, implementation details) is provided directly in each model class. Navigate to the specific model you're interested in (e.g., Pipe, Turbine) to see complete technical documentation.

OpenHPL is an open-source hydropower library that consists of hydropower unit models and is encoded in Modelica. Modelica is a multi-domain as well as a component-oriented modelling language that is suitable for complex system modelling. In order to develop the library, OpenModelica has been used as an open-source Modelica-based modelling and simulation environment.

This hydropower library, OpenHPL, provides the capability for the modelling of hydro- power systems of different complexity. The library includes the following units:

1. Various waterway units are modelled based on the mass and momentum balances, i.e., reservoirs, conduits, surge tank, fittings. A modern method for solving more detailed models (PDEs) is implemented in the library, and enables the modelling of the waterway with elastic walls and compressible water as well as open channel.
2. A hydrology model has been implemented and makes it possible to simulate the water inflow to the reservoirs.
3. Mechanistic models, as well as simple look-up table turbine models are implemented for the Francis and Pelton turbine types. The Francis turbine model also includes a turbine design algorithm that gives all of the needed parameters for the model, based on the turbine's nominal operating values.
4. The capability for multiphysics connections and work with other libraries is ensured, e.g., connecting with the Open-Instance Power System Library OpenIPSL makes it possible to model the electrical part for the hydropower system.

Acknowledgements

The very first version 1.0.0 of this library was created as part of the PhD thesis [Vytvytskyi2019], which was supported by the Norwegian Research Council under the project "Hydropower Systems Design and Analysis" (HydroCen Grant No. 257588).

Contents

Name	Description
ReleaseNotes	Release Notes
References	References