arviz-plots

library1.2.0pypypi✓ verified 85d ago

ArviZ-plots is a new Python library (v1.0.0) designed to provide ready-to-use and composable plots specifically for Bayesian workflow. It offers a flexible and modular plotting interface, building upon ArviZ's `InferenceData` object for modern visualization needs. As a `1.0.0` release, it aims for API stability in future patch versions.

data ai-ml

pip install arviz-plots

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · ARVIZ-PLOTS

arviz-plots

datapythonv1.2.0

Install

13.3s avg

Import

5170ms

Disk

355MB

Pass rate

7/ 10

Env Coverage7 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 15.88s

py 3.11

✓ —

✓ 12.18s

py 3.12

✓ —

✓ 12.6s

py 3.13

✓ —

✓ 12.63s

py 3.9

✕ build_error

355MB installed

● package 355MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

plot_pair

✓ from arviz_plots import plot_pair

plot_trace

✓ from arviz_plots import plot_trace

Plot

✓ from arviz_plots.base import Plot

Represents a composable plot object, typically returned by plotting functions.

This example loads sample Bayesian inference data using ArviZ and then generates a pair plot using ArviZ-plots, demonstrating the core `plot_pair` function.

import arviz as az from arviz_plots import plot_pair # Load example InferenceData from ArviZ idata = az.load_arviz_data("centered_eight") # Create a basic pair plot plot_pair(idata)

Debug

Known issues

gotchaArviZ-plots is designed to work exclusively with `arviz.InferenceData` objects. Providing other data structures will lead to errors.

fix

Ensure your data is loaded or converted into an `arviz.InferenceData` object before passing it to ArviZ-plots functions. Use `arviz.InferenceData` or `arviz.from_pymc`/`from_stan` etc.

affects: >=1.0.0

gotchaArviZ-plots is not a direct, drop-in replacement for *all* `arviz.plot_*` functions. While it offers similar plots, its API is different and focuses on composability. Not all ArviZ plots are yet implemented in arviz-plots, or they may have different parameters.

fix

Consult the `arviz-plots` documentation for available functions and their specific usage. Do not assume a 1:1 migration path from `arviz.plot`.

affects: >=1.0.0

breakingArviZ-plots requires Python 3.12 or newer. Installing or running the library on older Python versions will fail.

fix

Upgrade your Python environment to version 3.12 or newer. Use `pyenv` or `conda` to manage multiple Python versions if necessary.

affects: >=1.0.0

breakingAs a new `1.0.0` release, while patch releases will aim for API stability, future *major* versions (e.g., `2.0.0`) are likely to introduce significant API changes to refine the composable plotting interface and integrate new features.

fix

Pin your `arviz-plots` dependency to `~1.0` if strict API stability is required for a production environment. Review migration guides for future major versions.

affects: <2.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'arviz_plots'

The arviz-plots library is not installed in your current Python environment.

fix

Run `pip install arviz-plots` to install the package.

TypeError: plot_pair() missing 1 required positional argument: 'data'

A plotting function like `plot_pair` was called without providing the necessary `InferenceData` object.

fix

Pass an `arviz.InferenceData` object as the first argument, e.g., `plot_pair(idata)`.

ERROR: Package 'arviz-plots' requires a different Python version: 3.12 or later but 'X.Y' is specified.

Your current Python version does not meet the minimum requirement (Python 3.12).

fix

Upgrade your Python environment to version 3.12 or newer. Consider using a virtual environment with the correct Python version.

Upgrade

Version history

1.2.0latest on PyPI · released Jun 12, 2026

Audit

Dependencies

arvizrequiredProvides the core InferenceData structure for Bayesian data.

matplotlibrequiredUnderlying plotting library for rendering visualizations.

numpyrequiredFundamental package for numerical computing.

scipyrequiredUsed for scientific computing functionalities.

pandasrequiredProvides data structures for internal data handling.

seabornoptionalOptional for enhanced styling and specific plot types.

Agent activity

39 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/arviz-devs/arviz-plots ↗

packagehttps://pypi.org/project/arviz-plots/ ↗

docshttps://arviz-plots.readthedocs.io ↗