Skip to main content

Interactive windrose diagrams using pandas and plotly

Project description

Interactive windroses using pandas and plotly

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

Documentation

Coming soon.

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 windrose 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 windrose 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 windrose 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.1.tar.gz (4.3 kB view hashes)

Uploaded Source

Built Distribution

Rosely-0.0.1-py2.py3-none-any.whl (5.5 kB view hashes)

Uploaded Python 2 Python 3

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