{"id":8838,"library":"arviz-plots","title":"ArviZ-plots","description":"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.","status":"active","version":"1.0.0","language":"en","source_language":"en","source_url":"https://github.com/arviz-devs/arviz-plots","tags":["bayesian","plotting","arviz","visualization","mcmc","statistical-modeling"],"install":[{"cmd":"pip install arviz-plots","lang":"bash","label":"Install stable release"}],"dependencies":[{"reason":"Provides the core InferenceData structure for Bayesian data.","package":"arviz","optional":false},{"reason":"Underlying plotting library for rendering visualizations.","package":"matplotlib","optional":false},{"reason":"Fundamental package for numerical computing.","package":"numpy","optional":false},{"reason":"Used for scientific computing functionalities.","package":"scipy","optional":false},{"reason":"Provides data structures for internal data handling.","package":"pandas","optional":false},{"reason":"Optional for enhanced styling and specific plot types.","package":"seaborn","optional":true}],"imports":[{"symbol":"plot_pair","correct":"from arviz_plots import plot_pair"},{"symbol":"plot_trace","correct":"from arviz_plots import plot_trace"},{"note":"Represents a composable plot object, typically returned by plotting functions.","symbol":"Plot","correct":"from arviz_plots.base import Plot"}],"quickstart":{"code":"import arviz as az\nfrom arviz_plots import plot_pair\n\n# Load example InferenceData from ArviZ\nidata = az.load_arviz_data(\"centered_eight\")\n\n# Create a basic pair plot\nplot_pair(idata)","lang":"python","description":"This example loads sample Bayesian inference data using ArviZ and then generates a pair plot using ArviZ-plots, demonstrating the core `plot_pair` function."},"warnings":[{"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.","message":"ArviZ-plots is designed to work exclusively with `arviz.InferenceData` objects. Providing other data structures will lead to errors.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Consult the `arviz-plots` documentation for available functions and their specific usage. Do not assume a 1:1 migration path from `arviz.plot`.","message":"ArviZ-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.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade your Python environment to version 3.12 or newer. Use `pyenv` or `conda` to manage multiple Python versions if necessary.","message":"ArviZ-plots requires Python 3.12 or newer. Installing or running the library on older Python versions will fail.","severity":"breaking","affected_versions":">=1.0.0"},{"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.","message":"As 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.","severity":"breaking","affected_versions":"<2.0.0"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Run `pip install arviz-plots` to install the package.","cause":"The arviz-plots library is not installed in your current Python environment.","error":"ModuleNotFoundError: No module named 'arviz_plots'"},{"fix":"Pass an `arviz.InferenceData` object as the first argument, e.g., `plot_pair(idata)`.","cause":"A plotting function like `plot_pair` was called without providing the necessary `InferenceData` object.","error":"TypeError: plot_pair() missing 1 required positional argument: 'data'"},{"fix":"Upgrade your Python environment to version 3.12 or newer. Consider using a virtual environment with the correct Python version.","cause":"Your current Python version does not meet the minimum requirement (Python 3.12).","error":"ERROR: Package 'arviz-plots' requires a different Python version: 3.12 or later but 'X.Y' is specified."}]}