Skip to main content

Interactive wind rose diagrams simplified

Project description

Interactive wind roses simplified using Plotly and pandas

Rosely leverages the polar bar char of Plotly and pandas to simplyfy the creation of beautiful and interactive wind rose diagrams. This package was inspired by the Plotly polar bar chart with hoverable tooltips, zoom, pan, and other interactive features. Rosely makes use of the Plotly polar bar chart for wind rose diagrams more accessable and efficient for custom workflows using pandas and a simple object-oriented implementation.

Documentation

ReadTheDocs

Installation

Rosely’s dependencies are Python 3.4+, NumPy, pandas, and Plotly.

You may install the dependencies using the conda virtual environment (recommended), the environment file can be downloaded here and installed and activated by

conda env create -f environment.yml
conda activate rosely

Once activated install with PIP:

pip install rosely

Quick start

Given arbitrary time series data that contains wind speed and direction (degrees) Rosely can quickly produce wind statistics and interactive wind rose diagrams once the data is loaded into a pandas.DataFrame.

This example uses the provided example CSV containing meterological data.

import pandas as pd
from rosely import WindRose
df = pd.read_csv('path/to/example_data.csv')
# make a WindRose object from the dataframe with "ws" and "wd" columns
WR = WindRose(df)
WR.plot(
    template='seaborn', colors='Plotly3',
    title='Twitchell Island, California'
)

The resulting wind rose diagram saved as a png (download this file for an interactive example):

https://raw.githubusercontent.com/JohnVolk/Rosely/master/docs/source/_static/quickstart.png

Details and examples of plot customization, output options, and wind rose calculation options can be found in the online documentation.

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

Rosely-0.0.2.post3.tar.gz (9.0 MB view details)

Uploaded Source

Built Distribution

Rosely-0.0.2.post3-py2.py3-none-any.whl (7.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file Rosely-0.0.2.post3.tar.gz.

File metadata

  • Download URL: Rosely-0.0.2.post3.tar.gz
  • Upload date:
  • Size: 9.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.3

File hashes

Hashes for Rosely-0.0.2.post3.tar.gz
Algorithm Hash digest
SHA256 99cac0b8115ddc20287dbe93a99c6d8b643ffa74f37dc71fd0ca935efd17f76e
MD5 8836b71ffd2751c5dabeb239a70df76f
BLAKE2b-256 970b3bbd9375b48a1ed35d82e7c10e02dd7d5ea902e2304df872bbcabf6e6f61

See more details on using hashes here.

File details

Details for the file Rosely-0.0.2.post3-py2.py3-none-any.whl.

File metadata

  • Download URL: Rosely-0.0.2.post3-py2.py3-none-any.whl
  • Upload date:
  • Size: 7.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.3

File hashes

Hashes for Rosely-0.0.2.post3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 3646db23f84aef0621e7f4df94152ff1fbb7cfbf80528e57cb8ff810cf3d7de9
MD5 6192ff77bc442ce7a164483141a0a4f4
BLAKE2b-256 1c392f591f05fb9c9fb3b3a15ca218e2d17a2e2c3a84945fb3cf863b0dee482d

See more details on using hashes here.

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