Skip to main content

Tidy API for statistical visualization with Plotly

Project description

Logo Dark Logo Light

Documentation PyPI - Python Version Black linting - Ruff mypy pre-commit CI PyPI - Package Version GitHub License


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.

statsplotly-demo

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 the poetry.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 and build-doc generates documentation from source code and builds it with Sphinx.
  • coverage generates code coverage report.
  • clean clears bytecode, poetry/pip caches and pre-commit hooks. Use with caution.

Requirements

Author

Benjamin Roland

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

statsplotly-0.2.4.tar.gz (51.0 kB view details)

Uploaded Source

Built Distribution

statsplotly-0.2.4-py3-none-any.whl (67.5 kB view details)

Uploaded Python 3

File details

Details for the file statsplotly-0.2.4.tar.gz.

File metadata

  • Download URL: statsplotly-0.2.4.tar.gz
  • Upload date:
  • Size: 51.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.7 Linux/6.5.0-1025-azure

File hashes

Hashes for statsplotly-0.2.4.tar.gz
Algorithm Hash digest
SHA256 a321a3d64d3b0b67fba7fd12d9490f519d9fd2c0959f1f667d27822e5d4f1a53
MD5 661202533fa950cd60d5cfedff1c1a25
BLAKE2b-256 95bcb79cd6c19bb9a362bc4dfa005f2873f21082faf5ab639c455d204c032d30

See more details on using hashes here.

File details

Details for the file statsplotly-0.2.4-py3-none-any.whl.

File metadata

  • Download URL: statsplotly-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 67.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.7 Linux/6.5.0-1025-azure

File hashes

Hashes for statsplotly-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 d37b19ef3380ba27ce141e0e24880ca27515cce23cd7b04a4398e10cad08fd76
MD5 6ed11c67d915551fb66044319747a104
BLAKE2b-256 aad77997516c937004bae2d96a694742664ead85002677b24b5bf7d812827e76

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