https://github.com/invia-flights/blitzly
Lightning-fast way to get plots with Plotly ⚡️
https://github.com/invia-flights/blitzly
data-analysis data-science plotly plotting-in-python python visualization
Last synced: 22 days ago
JSON representation
Lightning-fast way to get plots with Plotly ⚡️
- Host: GitHub
- URL: https://github.com/invia-flights/blitzly
- Owner: invia-flights
- License: mit
- Archived: true
- Created: 2022-12-16T09:21:31.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-02-03T20:19:26.000Z (about 1 year ago)
- Last Synced: 2025-12-28T00:59:05.854Z (about 1 month ago)
- Topics: data-analysis, data-science, plotly, plotting-in-python, python, visualization
- Language: Python
- Homepage: https://invia-flights.github.io/blitzly/
- Size: 1.75 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: docs/README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# blitzly ⚡️
***Lightning-fast way to get plots with Plotly***
[](https://github.com/invia-flights/blitzly/actions/workflows/deploy-package.yml)
[](https://github.com/invia-flights/blitzly/actions/workflows/testing.yml)
[](https://codecov.io/gh/invia-flights/blitzly)
[](https://pypi.org/project/blitzly/)
[](https://pypistats.org/packages/blitzly)
[](https://www.python.org/downloads/)
[](https://invia-flights.github.io/blitzly/)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/invia-flights/blitzly/blob/main/LICENSE)
[](https://github.com/PyCQA/isort)
[](https://github.com/psf/black)
[](https://github.com/python/mypy)
[](https://github.com/PyCQA/pylint)
## Introduction 🎉
Plotly is great and powerful. But with great power comes great responsibility 🕸. And sometimes you just want to get a plot up and running as fast as possible. That's where blitzly ⚡️ comes in. It provides a set of functions that allow you to create plots with Plotly in a lightning-fast way. It's not meant to replace Plotly, but rather to complement it.
Check out some examples in the [Jupyter notebook](https://github.com/invia-flights/blitzly/blob/main/examples/playground.ipynb).
[](https://colab.research.google.com/github/invia-flights/blitzly/blob/main/examples/playground.ipynb)
## Install the package 📦
If you are using [pip](https://pip.pypa.io/en/stable/), you can install the package with the following command:
```bash
pip install blitzly
```
If you are using [Poetry](https://python-poetry.org/), you can install the package with the following command:
```bash
poetry add blitzly
```
## installing dependencies 🧑🔧
With [pip](https://pip.pypa.io/en/stable/):
```bash
pip install -r requirements.txt
```
With [Poetry](https://python-poetry.org/):
```bash
poetry install
```
## Available plots (so far 🚀)
| Module | Method | Description |
| ------ | ------ | ----------- |
| [`bar`](https://invia-flights.github.io/blitzly/plots/bar/) | [`model_feature_importances`](https://invia-flights.github.io/blitzly/plots/bar/#blitzly.plots.bar.model_feature_importances) | Creates a bar chart with the feature importance of a model. |
| [`bar`](https://invia-flights.github.io/blitzly/plots/bar/) | [`multi_chart`](https://invia-flights.github.io/blitzly/plots/bar/#blitzly.plots.bar.multi_chart) | Creates a bar chart with multiple groups. |
| [`dumbbell`](https://invia-flights.github.io/blitzly/plots/dumbbell/) | [`simple_dumbbell`](https://invia-flights.github.io/blitzly/plots/dumbbell/#blitzly.plots.dumbbell.simple_dumbbell) | Plots a dumbbell plot. This can be used to compare two columns of data to visualize changes. |
| [`histogram`](https://invia-flights.github.io/blitzly/plots/histogram/) | [`simple_histogram`](https://invia-flights.github.io/blitzly/plots/histogram/#blitzly.plots.histogram.simple_histogram) | Plots a histogram with one ore more distributions. |
| [`matrix`](https://invia-flights.github.io/blitzly/plots/matrix/) | [`binary_confusion_matrix`](https://invia-flights.github.io/blitzly/plots/matrix/#blitzly.plots.matrix.binary_confusion_matrix) | Plots a confusion matrix for binary classification data. |
| [`matrix`](https://invia-flights.github.io/blitzly/plots/matrix/) | [`cramers_v_corr_matrix`](https://invia-flights.github.io/blitzly/plots/matrix/#blitzly.plots.matrix.cramers_v_corr_matrix) | Cramer's V correlation for categorical features. |
| [`matrix`](https://invia-flights.github.io/blitzly/plots/matrix/) | [`pearson_corr_matrix`](https://invia-flights.github.io/blitzly/plots/matrix/#blitzly.plots.matrix.pearson_corr_matrix) | Plots a Pearson product-moment correlation coefficients matrix. |
| [`scatter`](https://invia-flights.github.io/blitzly/plots/scatter/) | [`scatter_matrix`](https://invia-flights.github.io/blitzly/plots/scatter/#blitzly.plots.scatter.scatter_matrix) | Plots a scatter matrix. |
| [`scatter`](https://invia-flights.github.io/blitzly/plots/scatter/) | [`multi_scatter`](https://invia-flights.github.io/blitzly/plots/scatter/#blitzly.plots.scatter.multi_scatter) | Create a multi scatter plot. It can be used to visualize the relationship between multiple variables from the same Pandas DataFrame. |
| [`scatter`](https://invia-flights.github.io/blitzly/plots/scatter/) | [`dimensionality_reduction`](https://invia-flights.github.io/blitzly/plots/scatter/#blitzly.plots.scatter.dimensionality_reduction) | Creates a plot to visualize higher dimensionality reduced data using matrix decomposition |
### Subplots 👩👩👧👦
| Module | Method | Description |
| ------ | ------ | ----------- |
| [`subplots`](https://invia-flights.github.io/blitzly/plots/subplots/) | [`make_subplots`](https://invia-flights.github.io/blitzly/plots/subplots/#blitzly.subplots.make_subplots) | Create subplots using figure objects created with any of the above available plots. |
## Usage 🤌
Here are some examples. You can also open the [playground notebook](https://github.com/invia-flights/blitzly/blob/main/examples/playground.ipynb) 📒.
**[`dimensionality_reduction`](https://invia-flights.github.io/blitzly/plots/scatter/#blitzly.plots.scatter.dimensionality_reduction):**
```python
from blitzly.plots.scatter import dimensionality_reduction
import plotly.express as px
df = px.data.iris()
dimensionality_reduction(
df,
n_components=2,
target_column="species",
reduction_funcs=["PCA", "TNSE"],
)
```
Gives you this:
**[`multi_bar`](https://invia-flights.github.io/blitzly/plots/bar/#blitzly.plots.bar.multi_bar):**
```python
from blitzly.plots.bar import multi_bar
import numpy as np
data = np.array([[8, 3, 6], [9, 7, 5]])
error_array = np.array([[0.1, 0.2, 0.3], [0.4, 0.5, 0.6]])
multi_bar(
data,
x_labels=["Vienna", "Berlin", "Lisbon"],
group_labels=["Personal rating", "Global rating"],
errors=error_array,
title="City ratings 🏙",
mark_x_labels=["Lisbon"],
write_html_path="see_the_blitz.html",
)
```
Gives you this:
**[`scatter matrix`](https://invia-flights.github.io/blitzly/plots/scatter/#blitzly.plots.scatter.scatter_matrix):**
```python
from blitzly.plots.scatter import scatter_matrix
import numpy as np
import pandas as pd
foo = np.random.randn(1000)
bar = np.random.randn(1000) + 1
blitz = np.random.randint(2, size=1000)
licht = np.random.randint(2, size=1000)
data = np.array([foo, bar, blitz, licht])
df = pd.DataFrame(data.T, columns=["foo", "bar", "blitz", "licht"])
scatter_matrix(
df,
dimensions=["foo", "bar", "blitz"],
color_dim=df["licht"],
title="My first scatter matrix 🙃",
show_upper_half=True,
diagonal_visible=False,
marker_color_scale="Rainbow",
marker_line_color="blue",
size=(500, 500),
)
```
Gives you this:
## Contributing 👩💻
Please check out the [guide](https://invia-flights.github.io/blitzly/CONTRIBUTING/) on how to contribute to this project.