Skip to main content

Python Matplotlib, Numpy library to manage wind data, draw windrose (also known as a polar rose plot)

Project description

Latest Version Supported Python versions Wheel format License Development Status Tests DOI JOSS


A wind rose is a graphic tool used by meteorologists to give a succinct view of how wind speed and direction are typically distributed at a particular location. It can also be used to describe air quality pollution sources. The wind rose tool uses Matplotlib as a backend. Data can be passed to the package using Numpy arrays or a Pandas DataFrame.

Windrose is a Python library to manage wind data, draw windroses (also known as polar rose plots), and fit Weibull probability density functions.

The initial use case of this library was for a technical report concerning pollution exposure and wind distributions analyzes. Data from local pollution measures and meteorologic information from various sources like Meteo-France were used to generate a pollution source wind rose.

It is also used by some contributors for teaching purpose.

Map overlay

Some others contributors have used it to make figures for a wind power plant control optimization study.

Some academics use it to track lightning strikes during high intensity storms. They are using it to visualize the motion of storms based on the relative position of the lightning from one strike to the next.

Try windrose on




Optional libraries:

Install latest release version via pip

A package is available and can be downloaded from PyPi and installed using:

$ pip install windrose

Install latest development version

$ pip install git+


$ git clone
$ python install


Full documentation of library is available at

Community guidelines

You can help to develop this library.

Code of Conduct

If you are using Python Windrose and want to interact with developers, others users... we encourage you to follow our code of conduct.


If you discover issues, have ideas for improvements or new features, please report them. explains how to contribute to this project.

List of contributors and/or notable users

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

windrose-1.9.0.tar.gz (27.0 kB view hashes)

Uploaded source

Built Distribution

windrose-1.9.0-py3-none-any.whl (12.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page