.. _whats-new:

##########
What's New
##########

.. _whats-new.2026.07.0:

v2026.07.0 (2026-07-03)
===================

- Removed workaround for matplotlib colorbar padding issue with ``cbar_mode``
  equal to ``"single"`` and ``cbar_location`` equal to ``"left"`` or
  ``"bottom"`` for matplotlib versions greater than or equal to ``3.10.0``,
  since it was fixed upstream in `matplotlib#28525
  <https://github.com/matplotlib/matplotlib/pull/28525>`_.

.. _whats-new.0.2.1:

v0.2.1 (2021-09-11)
===================

- Defaults for the ``width``, ``height``, and ``aspect`` are now chosen if fewer
  than two of those are specified in :py:meth:`faceted.faceted`.  This restores
  the old defaults from version 0.1 without changing the function signature
  introduced to provide an interface to more varieties of constrained figures in
  version 0.2.  E.g. calls like ``faceted(1, 1)`` or ``faceted(1, 1, width=5.0)``
  are now allowed again.

.. _whats-new.0.2:

v0.2 (2020-12-06)
=================

- :py:meth:`faceted.faceted` now supports three types of constrained figures:
  width-and-aspect constrained (as before), height-and-aspect constrained, and
  width-and-height constrained.  Note the you must provide exactly two of the
  ``width``, ``height``, and ``aspect`` arguments in your call.  A minor
  breaking change is that defaults are no longer provided for ``width`` and
  ``aspect`` (it would be cumbersome to have to override one of them with
  ``None`` in the case of creating a height-and-aspect constrained or
  width-and-height constrained figure).
- A new convenience function for creating single-axis figures called
  :py:meth:`faceted.faceted_ax`.  It takes the same keyword arguments as the
  full :py:meth:`faceted.faceted` function, except automatically returns
  scalar ``Axes`` objects.

.. _whats-new.0.1:

v0.1 (2019-03-07)
=================

- Initial release.  Note the name has changed since the development version from
  ``facets`` to ``faceted``.
- Default ``cbar_short_side_pad`` is now 0.0 instead of 0.5 inches.