Tidy API for statistical visualization with Plotly
Project description
Statsplotly is a Python data visualization library based on Plotly. It provides a high-level interface for drawing interactive statistical data visualization plots with a tidy, declarative API.
Philosophy
I began to work on this library during my first job outside academia, a few months before the fantastic plotly.express API was launched. I was looking for a solution to generate visually appealing statistical plots that adapt well to diverse communication mediums, such as web applications, Jupyter Notebooks, presentations, and printed reports.
There are multiple declarative visualization library in the Python ecosystem, each with their own strengths, but none really fit my needs at the time.
Further, I discovered that real-world data analysis, whether in academia or industry, is rarely about creating facet plots. Instead, it revolves around crafting the most effective graphical representation to achieve one of two primary objectives:
- Exploratory data visualization: the ideal tool should facilitate effortless immersion into the data to uncover valuable insights.
- Explanatory data visualization: the ideal tool should enable rapid creation of polished, visually appealing plots that effectively support a hypothesis derived from the preceding analysis.
There is no reason these two endeavours should require different workflows. On the contrary, working towards both ends using the same tool should increase both analysis and communication efficiency.
I thus set out to design a library combining :
-
a high level interface with graphical representation entities (e.g., plot, barplot, distplot, etc) as entrypoint functions. As intellectually satisfying the Grammar of Graphics may be, I find this framework to be quite convoluted for expressing pragmatic visualization needs one has when performing real-world data analysis.
-
a mainly declarative, yet chainable and customizable by imperative workflow, API. Assembling the appropriate data visualization units across a flexible combination of facets requires keeping control over the different layers of the graphical representations.
-
A genuinely interactive plotting interface: In the realm of data visualization beyond scientific publishing, the primary objectives are to explore and convey insights about a phenomenon, business metrics, or a model's performance. This requires a responsive graphic engine allowing for dynamic visualization.
statsplotly
key standout features are :
- an independent processing of color coding scheme, data slicer and plot dimensions.
- a high level interface for seaborn-like visualization of data distributions.
- statistical data processing under the hood.
- leveraging of the tidy DataFrame structure for easy styling of plot cues (e.g., marker color, symbol, size, and opacity).
- sensible cartesian and coloraxis coordinates management across figure subplots.
In summary, statsplotly
seeks to take advantage of the powerful interactivity offered by plotly.js
without compromising statistical intelligibility for aesthetic choices, or vice-versa.
Documentation
Main features and details of the public API can be found in the documentation.
Installation
Using Pip
pip install statsplotly
Development
Using Poetry
First make sure you have Poetry installed on your system (see instruction).
Then, assuming you have a Unix shell with make, create and set up a new Poetry environment :
make init
To make the Poetry-managed kernel available for a globally installed Jupyter :
poetry run python -m ipykernel install --user --name=<KERNEL_NAME>
jupyter notebook
On the Jupyter server, select the created kernel in “Kernel” -> “Change kernel”.
Dissecting Makefile
The Makefile provides several targets to assist in development and code quality :
init
creates a project-specific virtual environment and installs the dependencies of thepoetry.lock
file.ci
launches Black, Ruff, mypy and pytest on your source code.pre-commit
set up and run pre-commit hooks (see pre-commit documentation).update-doc
andbuild-doc
generates documentation from source code and builds it with Sphinx.clean
clears bytecode, poetry/pip caches. Use with caution.
Requirements
Author
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for statsplotly-0.2.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cced69ffe6e3d03fccadb464a7e692b3eafa77409af3a5d50502e89204fe79ab |
|
MD5 | 107346ab1b276f423ff6df9bfc27160f |
|
BLAKE2b-256 | ee66ee8f6afe3d35a743a99b9754564b0d0c642b9c41be921d91f04b4b63426e |