Welcome to the windpowerlib documentation!¶
Contents:
Getting started¶
windpowerlib¶
The windpowerlib is designed to calculate feedin time series of wind power plants. The windpowerlib is an out-take from the feedinlib (windpower and pv) to build up a community concentrating on wind power models.
Introduction¶
Having weather data sets you can use the windpowerlib to calculate the electrical output of common wind turbines. Basic parameters for many manufacturers 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 weather data and basic example file and execute it:
https://github.com/wind-python/windpowerlib/tree/master/example
Documentation¶
Full documentation can be found at readthedocs. Use the project site of readthedocs to choose the version of the documentation.
Contributing¶
Clone/Fork: https://github.com/wind-python/windpowerlib
If you are interested in wind models and want to help improve the existing model do not hesitate to contact us. As the windpowerlib started with contributors from the oemof developer group we use the same developer rules.
Installation¶
Install the windpowerlib using pip3.
pip3 install windpowerlib
So far, the windpowerlib 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.
Optional Packages¶
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.
What’s New¶
These are new features and improvements of note in each release
v0.0.4 ()¶
New features¶
- cp-values database file is now part of the repository and will be installed using pip/setup.py. The former download server was down due to technical problems and it might be safer not to be reliant on an external server.
Documentation¶
Testing¶
Bug fixes¶
Other changes¶
Contributors¶
- Uwe Krien
v0.0.3 (November 18, 2016)¶
Other changes¶
Allow installation of windpowerlib for python versions >3.4 Import requests package instead of urllib5
Contributors¶
- Uwe Krien
- Stephen Bosch
- Birgit Schachler
Comment¶
Release of v0.0.2 has been skipped due to a mistake in the release process.
v0.0.1 (August 29, 2016)¶
The wind part of the feedinlib was transferd to the winpowerlib.
Contributors¶
- Uwe Krien
Classes¶
wind_turbine.WindTurbine(turbine_name, ...) |
Defines a standard set of wind turbine attributes. |
modelchain.Modelchain(wind_turbine[, ...]) |
Model to determine the output of a wind turbine |
Density¶
Functions for calculating air density at hub height.
density.temperature_gradient(temp_air, ...) |
Calculates the temperature at hub height using a linear temperature gradient. |
density.temperature_interpol(temp_air_1, ...) |
Calculates the temperature at hub height by inter- or extrapolation. |
density.rho_barometric(pressure, ...) |
Calculates the density of air at hub height using the barometric height equation. |
density.rho_ideal_gas(pressure, ...) |
Calculates the density of air at hub height using the ideal gas equation. |
Wind speed¶
Functions for calculating wind speed at hub height.
wind_speed.logarithmic_wind_profile(v_wind, ...) |
Calculates the wind speed at hub height using a logarithmic wind profile. |
wind_speed.v_wind_hellman(v_wind, ...[, ...]) |
Calculates the wind speed at hub height using the hellman equation. |
Wind turbine data¶
Functions and methods to obtain the nominal power as well as
power curve or power coefficient curve needed by the WindTurbine class.
wind_turbine.WindTurbine.fetch_turbine_data() |
Fetches data of the requested wind turbine. |
wind_turbine.get_turbine_types([print_out]) |
Get the names of all possible wind turbine types for which the power coefficient curve or power curve is provided in the data files in the directory windpowerlib/data. |
wind_turbine.read_turbine_data(**kwargs) |
Fetches power coefficient curve or power curve from a file. |
Power output¶
Functions for calculating power output of a wind turbine.
power_output.cp_curve(v_wind, rho_hub, ...) |
Calculates the turbine power output using a cp curve. |
power_output.cp_curve_density_corr(v_wind, ...) |
Calculates the turbine power output using a density corrected cp curve. |
power_output.p_curve(p_values, v_wind) |
Calculates the turbine power output using a power curve. |
power_output.p_curve_density_corr(v_wind, ...) |
Calculates the turbine power output using a density corrected power curve. |
Modelchain¶
Creating a Modelchain object.
modelchain.Modelchain(wind_turbine[, ...]) |
Model to determine the output of a wind turbine |
Running the modelchain.
modelchain.Modelchain.run_model(weather, ...) |
Runs the model. |
Methods of the Modelchain object.
modelchain.Modelchain.rho_hub(weather, ...) |
Calculates the density of air at hub height. |
modelchain.Modelchain.v_wind_hub(weather, ...) |
Calculates the wind speed at hub height. |
modelchain.Modelchain.turbine_power_output(...) |
Calculates the power output of the wind turbine. |