Skip to content

Latest commit

 

History

History
85 lines (60 loc) · 3.83 KB

paper.md

File metadata and controls

85 lines (60 loc) · 3.83 KB
title tags authors affiliations date bibliography nocite
Windrose: A Python Matplotlib, Numpy library to manage wind and pollution data, draw windrose
windrose
windspeed
wind
speed
plot
python
matplotlib
numpy
pandas
name orcid affiliation
Lionel Roubeyrie
0000-0001-6017-4385
1
name orcid affiliation
Sébastien Celles
0000-0001-9987-4338
2
name index
LIMAIR
1
name index
Université de Poitiers - IUT de Poitiers (Poitiers Institute of Technology)
2
11 may 2018
paper.bib
@wiki:xxx, @doi:10.1109/MCSE.2007.58, @doi:10.1109/MCSE.2011.36, @Walt:2011:NAS:1957373.1957466, @doi:10.1109/MCSE.2007.55, @mckinney-proc-scipy-2010, @doi:10.1109/MCSE.2007.53, @oliphant2001scipy, @oliphant2006guide, @munn1969pollution, @nrcs, @garver2016, @quick2017optimization, @harris2014parent, @horel2016summer

Summary

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 informations 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.

Examples

  • The bar plot wind rose is the most common plot

-Windrose (bar) example

  • Contour plots are also possible

-Windrose (contourf-contour) example

  • Several windroses can be plotted using subplots to provide a plot per year with for example subplots per month

-Windrose subplots

  • Probability density functions (PDF) may be plotted. Fitting Weibull distribution is enabled by Scipy. The Weibull distribution is used in weather forecasting and the wind power industry to describe wind speed distributions, as the natural distribution of wind speeds often matches the Weibull shape

-Probability density function (PDF) example

More advanced usages and contributing

Full documentation of library is available at http://windrose.readthedocs.io/.

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

List of contributors and/or notable users can be found at CONTRIBUTORS.md.

Future

Windrose is still an evolving library which still need care from its users and developers.

  • Map overlay is a feature that could help some users.
  • A better API for video exporting could be an interesting improvement.
  • Add the capability to make wind roses based on the Weibull shape and scale factors could be considered.
  • Make windroses from an histogram table rather than from two arrays of wind speed and wind direction is also a requested feature.

References