mplutils documentation
======================

Utility methods for `matplotlib <https://matplotlib.org/>`__ to layout figures and axes
with fine control over absolute dimensions.

mplutils provides a custom layout engine for matplotlib which fixes axes sizes instead
of figure sizes. See :class:`.FixedLayoutEngine`.

In addition, it provides methods that adjust the physical dimensions of axes and
colorbars. See :func:`.set_axes_size`, :func:`.set_colorbar_pad`, or
:func:`.set_colorbar_thickness`.

.. warning::

   This package should not be confused with `mplutils` provided on
   `PyPI <https://pypi.org/project/mplutils/>`__.

Contents
--------

.. toctree::
   :maxdepth: 1

   installation
   examples
   api_reference/index