windrose

A graphic tool used by meteorologists to give a succinct view of how wind speed and direction are typically distributed at a particular location.
https://github.com/python-windrose/windrose

matplotlib numpy pandas python speed wind windrose

Last synced: about 10 hours ago
JSON representation

Repository metadata

A Python Matplotlib, Numpy library to manage wind data, draw windrose (also known as a polar rose plot), draw probability density function and fit Weibull distribution

• Host: GitHub
• URL: https://github.com/python-windrose/windrose
• Owner: python-windrose
• License: other
• Created: 2015-06-16T18:42:14.000Z (almost 9 years ago)
• Default Branch: main
• Last Pushed: 2024-05-07T05:09:05.000Z (5 days ago)
• Last Synced: 2024-05-09T07:06:21.282Z (3 days ago)
• Topics: matplotlib, numpy, pandas, python, speed, wind, windrose
• Language: Python
• Homepage: https://python-windrose.github.io/windrose
• Size: 71.2 MB
• Stars: 327
• Watchers: 23
• Forks: 129
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Code of conduct: CODE_OF_CONDUCT.md

README

        
[![Latest Version](https://img.shields.io/pypi/v/windrose.svg)](https://pypi.python.org/pypi/windrose/)

[![Supported Python versions](https://img.shields.io/pypi/pyversions/windrose.svg)](https://pypi.python.org/pypi/windrose/)

[![Wheel format](https://img.shields.io/pypi/wheel/windrose.svg)](https://pypi.python.org/pypi/windrose/)

[![License](https://img.shields.io/pypi/l/windrose.svg)](https://pypi.python.org/pypi/windrose/)

[![Development Status](https://img.shields.io/pypi/status/windrose.svg)](https://pypi.python.org/pypi/windrose/)

[![Tests](https://github.com/python-windrose/windrose/actions/workflows/tests.yml/badge.svg)](https://github.com/python-windrose/windrose/actions/workflows/tests.yml)

[![DOI](https://zenodo.org/badge/37549137.svg)](https://zenodo.org/badge/latestdoi/37549137)

[![JOSS](https://joss.theoj.org/papers/10.21105/joss.00268/status.svg)](https://joss.theoj.org/papers/10.21105/joss.00268)

# Windrose

A [wind rose](https://en.wikipedia.org/wiki/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](https://raw.githubusercontent.com/python-windrose/windrose/main/paper/screenshots/overlay.png)

Some others contributors have used it to make figures for a [wind power plant control optimization study](https://www.nrel.gov/docs/fy17osti/68185.pdf).

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 mybinder.org

[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/python-windrose/windrose/HEAD?labpath=notebooks)

## Install

### Requirements

- matplotlib http://matplotlib.org/

- numpy http://www.numpy.org/

- and naturally python https://www.python.org/ :-P

Optional libraries:

- Pandas http://pandas.pydata.org/ (to feed plot functions easily)

- Scipy http://www.scipy.org/ (to fit data with Weibull distribution)

- ffmpeg https://www.ffmpeg.org/ (to output video)

- click http://click.pocoo.org/ (for command line interface tools)

- seaborn https://seaborn.pydata.org/ (for easy subplots)

### Install latest release version via pip

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

```bash

$ pip install windrose

```

### Install latest development version

```bash

$ pip install git+https://github.com/python-windrose/windrose

```

or

```bash

$ git clone https://github.com/python-windrose/windrose

$ python setup.py install

```

## Documentation

Full documentation of library is available at https://python-windrose.github.io/windrose/

## 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](https://github.com/python-windrose/windrose/blob/master/CODE_OF_CONDUCT.md).

### Contributing

If you discover issues, have ideas for improvements or new features, please report them.

[CONTRIBUTING.md](https://github.com/python-windrose/windrose/blob/master/CONTRIBUTING.md) explains

how to contribute to this project.

### List of contributors and/or notable users

https://github.com/python-windrose/windrose/blob/main/CONTRIBUTORS.md

      

---

Owner metadata

• Name: python-windrose
• Login: python-windrose
• Email:
• Kind: organization
• Description:
• Website:
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/28726174?v=4
• Repositories: 1
• Last ynced at: 2023-03-02T11:35:18.831Z
• Profile URL: https://github.com/python-windrose

---

GitHub Events

Total

• Fork event: 114
• Create event: 67
• Commit comment event: 12
• Release event: 14
• Issues event: 181
• Watch event: 305
• Delete event: 49
• Member event: 2
• Issue comment event: 381
• Push event: 201
• Pull request review comment event: 8
• Pull request review event: 10
• Pull request event: 202

Last Year

• Create event: 15
• Delete event: 12
• Fork event: 8
• Issue comment event: 30
• Issues event: 9
• Pull request event: 34
• Pull request review comment event: 4
• Pull request review event: 5
• Push event: 23
• Release event: 1
• Watch event: 30

---

Committers metadata

Last synced: 2 days ago

Name	Email	Commits
scls19fr	s****s@g****m	189
Filipe Fernandes	o****f@g****m	53
pre-commit-ci[bot]	6****]	24
dependabot[bot]	4****]	16
Jonas Kittner	j****r@r****e	8
kilojoules	j****8@h****u	7
Samuël Weber/GwendalD	s****r@u****r	7
Samuël Weber/GwendalD	s****r@n****g	6
Pete Bachant	p****e@w****m	3
xmn	i****a@g****m	3
strawberry beach sandals	3****3	3
Joonatan Partanen	j****n@i****i	2
Fabien Maussion	f****n@u****t	2
Leonardo Uieda	l****a@g****m	1
Jørgen Kvalsvik	j****a@s****m	1
Jonas Kittner	5****3	1
Miguel Rodas	m****s	1
Sam P Raj	6****7	1
Stas	s****v@g****m	1
mccannjb	m****t@g****m	1
sspagnol	s****l@g****m	1

Committer domains:

• statoil.com: 1
• uibk.ac.at: 1
• iceye.fi: 1
• windesco.com: 1
• normalesup.org: 1
• univ-grenoble-alpes.fr: 1
• humboldt.edu: 1
• rub.de: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/python-windrose/windrose

---

---

---

Package metadata

• Total packages: 2
• Total downloads:
  • pypi: 9,613 last-month
• Total docker downloads: 6,594
• Total dependent packages: 7 (may contain duplicates)
• Total dependent repositories: 44 (may contain duplicates)
• Total versions: 23
• Total maintainers: 2

---

Dependencies

Score: 18.59642667865257