.. _sphx_glr_gallery_transforms:

Transforms
==========

.. |Transform| replace:: ``Transform``
.. _Transform: https://matplotlib.org/stable/tutorials/advanced/transforms_tutorial.html

Mpltern is implemented as a new
`projection <https://matplotlib.org/stable/api/projections_api.html>`__
of Matplotlib by implementing several new |Transform|_ classes for ternary
plots.
This allows us to auto-position tick markers, tick labels, and axis labels with
reasonable paddings consistent with Matplotlib.

The examples below show how to use such |Transform|_ classes in mpltern.



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In mpltern, the x- and y-limits are initially [−3\ −1/2, +3\ −1/2] and [0, 1], respectively. Th...">

.. only:: html

  .. image:: /gallery/transforms/images/thumb/sphx_glr_00.cartesian_thumb.svg
    :alt:

  :ref:`sphx_glr_gallery_transforms_00.cartesian.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Cartesian coordinates</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In mpltern, tick markers, tick labels, and grid lines are plotted based on ax.get_{t,l,r}axis_t...">

.. only:: html

  .. image:: /gallery/transforms/images/thumb/sphx_glr_01.ticks_thumb.svg
    :alt:

  :ref:`sphx_glr_gallery_transforms_01.ticks.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Ticks</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="You can plot onto the fixed positions of the triangle by specifying tranform=ax.transTernaryAxe...">

.. only:: html

  .. image:: /gallery/transforms/images/thumb/sphx_glr_06.plot_fixed_onto_triangle_thumb.svg
    :alt:

  :ref:`sphx_glr_gallery_transforms_06.plot_fixed_onto_triangle.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Plot fixed onto triangle</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Arrows along the axes can be put in barycentric coordinates using transforms for TernaryAxes in...">

.. only:: html

  .. image:: /gallery/transforms/images/thumb/sphx_glr_99.arrows_along_axes_thumb.svg
    :alt:

  :ref:`sphx_glr_gallery_transforms_99.arrows_along_axes.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Arrows along axes</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /gallery/transforms/00.cartesian
   /gallery/transforms/01.ticks
   /gallery/transforms/06.plot_fixed_onto_triangle
   /gallery/transforms/99.arrows_along_axes