windrose

library1.10.0pypypi✓ verified 84d ago

Windrose is a Python library using Matplotlib and Numpy to manage wind data and draw windrose (polar rose) plots. It provides tools for wind direction and speed frequency visualization, with a simple interface for binned speed roses. Current version 1.10.0 requires Python >=3.10. Release cadence is intermittent, with occasional patches.

data observability

pip install windrose

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · WINDROSE

windrose

datapythonv1.10.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

WindroseAxes

✓ from windrose import WindroseAxes

✗ from windrose.windrose import WindroseAxes

Internal module path changed; direct package-level import is correct for v1.10.0

plot_windrose

✓ from windrose import plot_windrose

✗ from windrose import wr_plot

Function renamed in v1.6+; wr_plot was deprecated

Windrose

✓ from windrose import Windrose

Class for wind data processing and plotting

Basic windrose bar plot with random wind data. Use 'from_ax()' to attach the axes to a figure.

import numpy as np import matplotlib.pyplot as plt from windrose import WindroseAxes # Generate synthetic wind data ws = np.random.weibull(2, 100) * 10 # wind speed wd = np.random.uniform(0, 360, 100) # wind direction # Create windrose plot ax = WindroseAxes.from_ax() ax.bar(wd, ws, normed=True, opening=0.8, edgecolor='white') ax.set_legend() plt.show()

Debug

Known issues

deprecatedImporting from submodule 'windrose.windrose' is deprecated; directly import from 'windrose'.

fix

Use 'from windrose import WindroseAxes' instead of 'from windrose.windrose import WindroseAxes'.

affects: <1.10.0

breakingIn version 1.6, the function 'wr_plot' was renamed to 'plot_windrose' and the old name removed.

fix

Replace 'wr_plot' calls with 'plot_windrose'.

affects: >=1.6

gotchaWindroseAxes.bar() modifies the axes limits internally; calling plt.tight_layout() may distort the plot.

fix

Avoid automatic layout adjustment or apply after plotting with constrained layout.

affects: all

Errors

Common errors & fixes

AttributeError: module 'windrose' has no attribute 'WindroseAxes'

Importing from the wrong submodule after version 1.6. The package no longer exposes classes through the deprecated submodule path.

fix

Use 'from windrose import WindroseAxes' (not 'from windrose.windrose import WindroseAxes')

AttributeError: module 'windrose' has no attribute 'wr_plot'

Function was renamed in windrose 1.6. 'wr_plot' no longer exists.

fix

Use 'from windrose import plot_windrose' instead.

TypeError: bar() missing 1 required positional argument: 'direction'

Passing wind direction and speed as positional arguments in wrong order or omitting direction.

fix

Ensure you call ax.bar(direction, speed, ...) with direction (degrees) first, then speed.

Upgrade

Version history

1.10.0latest on PyPI · released Apr 10, 2026

Audit

Dependencies

matplotlibrequiredCore plotting backend

numpyrequiredNumerical operations on wind data

Agent activity

55 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/python-windrose/windrose ↗

packagehttps://pypi.org/project/windrose/ ↗

docshttps://python-windrose.github.io/windrose ↗