The hydropowerlib is designed to calculate feedin time series of run-of-the-river hydropower plants. The hydropowerlib is an out-take from the feedinlib (hydropower, windpower and pv) to build up a community concentrating on hydropower models.
Table of contents
Having water flow data sets you can use the hydropowerlib to calculate the electrical output of common hydropower turbines. Basic parameters for different types of turbine are provided with the library so that you can start directly using one of these parameter sets. Of course you are free to add your own parameter set. For a quick start download the example water flow data and basic example file and execute it:
https://github.com/hydro-python/hydropowerlib/tree/master/example
Full documentation can be found at readthedocs. Use the project site of readthedocs to choose the version of the documentation.
Clone/Fork: https://github.com/hydro-python/hydropowerlib
If you are interested in hydropower models and want to help improve the existing model do not hesitate to contact us. As the hydropowerlib started with contributors from the oemof developer group we use the same developer rules.
Install the hydropowerlib using pip3.
pip3 install hydropowerlibSo far, the hydropowerlib is mainly tested on python 3.4 but seems to work down to 2.7. Please see the installation page of the oemof documentation for complete instructions on how to install python on your operating system.
To see the plots of the example file you should install the matplotlib package.
Matplotlib can be installed using pip3 but some Linux users reported that it is easier and more stable to use the pre-built packages of your Linux distribution.