Statsplotly

=============
**2024-12-09**

The 0.2.5 release adds support for `pyarrow <https://arrow.apache.org/docs/python/data.html>`_ data type hinting.

=============
**2024-11-06**
The 0.2.4 release increases performance of 2D scatter plots.

🎨 Use :class:`plotly.graph_objects.Scattergl` for :class:`~statsplotly.plot_objects.trace.ScatterTrace` traces.

=============
**2024-08-26**

The 0.2.3 release cleans dependencies.

➖ Drop dependency on `jupyter <https://jupyter.org/>`_.

=============
**2024-08-04**

The 0.2.2 release fixes bugs with discrete colormaps and aggregation barplots.

🐛 Bug fixes
************
- Fix a bug in :class:`~statsplotly.plot_specifiers.color.ColorSpecifier` with discrete colormaps.
- Fix a bug in :class:`~statsplotly.plot_specifiers.trace.OrientedPlotSpecifier` with default orientation of aggregation barplots.

👕 Update linting and type checking parameters.

📚 Improve documentation with `autodoc-pydantic <https://github.com/mansenfranzen/autodoc_pydantic>`_.

=============
**2024-05-08**

The 0.2.1 release fixes a bug in color specification with "0" and "1" color identifiers.

🐛 Fix a bug in :class:`~statsplotly.plot_specifiers.color.ColorSpecifier` due to "0" and "1" color strings being interpreted as valid color specifications by `matplotlib`.

🎨 Expose :class:`~statsplotly.utils.rgb_string_array_from_colormap` in the :mod:`~statsplotly.utils` module.

=============
**2024-05-01**

The 0.2.0 release introduces new methods enhancing subplots management, and improves plotting features.

✨ New features
***************
- Add the :class:`~statsplotly.utils.SubplotGridFormatter` class, exposing methods to manage the subplot grid :
- :meth:`~statsplotly.utils.SubplotGridFormatter.set_common_coloraxis` manages coloraxis and colorbar display across multiple heatmap subplots.
- :meth:`~statsplotly.utils.SubplotGridFormatter.set_common_axis_limit` manages axis limits across a subplot grid.
- :meth:`~statsplotly.utils.SubplotGridFormatter.tidy_subplots` manages post-processing of a subplot grid.

- Enhance the color specification option of the main plotting module : the `color` argument now accepts reference to :obj:`~datetime.datetime` and arbitrary `string` color data.
- Support :obj:`~statsplotly.plot_specifiers.data.AggregationType.GEO_MEAN` and :obj:`~statsplotly.plot_specifiers.data.ErrorBarType.GEO_STD` options in :func:`~statsplotly.barplot` for `aggregation_fct` and `error_bar` arguments.
- Support Empirical Cumulative Distribution Function option in :func:`~statsplotly.distplot` and :func:`~statsplotly.jointplot`.

🎨 Feature improvements
***********************
- Improve :func:`~statsplotly.heatmap` axis formatting when `axis = "equal"`.
- Improve :func:`~statsplotly.jointplot` trace visibility group consistency.
- Add `color` specification option for :func:`~statsplotly.jointplot` scatter traces.
- Preserve original data ordering in :func:`~statsplotly.barplot` aggregations.
- Automatic detection of plot orientation for :func:`~statsplotly.barplot` and :func:`~statsplotly.catplot`.
- Improve colorbar management in layout.
- Support discrete color mapping in :func:`~statsplotly.heatmap`.
- Improve :obj:`~datetime.datetime` data handling in :func:`~statsplotly.catplot`.
- Correct bar layout in multi-trace histograms.
- Improve step histogram line aesthetics.
- Display slice name on color-coded bar charts.
- Integrate statsplotly template with plotly theming framework.

🐛 Bug fixes
************
- Fix data slice visibility inconsistencies in :func:`~statsplotly.heatmap`.
- Fix :obj:`~statsplotly.plot_specifiers.layout.AxesSpecifier.scaleratio` for `axis="id_line"`.
- Fix cumulative histograms when `cumulative=True` and `step=True`.