.. _sphx_glr_gallery_text_labels_and_annotations:

.. _text_labels_and_annotations:

Text, labels and annotations
============================



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Matplotlib supports accented characters via TeX mathtext or Unicode.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_accented_text_thumb.png
    :alt: Using accented text in Matplotlib

  :ref:`sphx_glr_gallery_text_labels_and_annotations_accented_text.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Using accented text in Matplotlib</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to create a scale invariant angle annotation. It is often useful to mark...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_angle_annotation_thumb.png
    :alt: Scale invariant angle label

  :ref:`sphx_glr_gallery_text_labels_and_annotations_angle_annotation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Scale invariant angle label</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The following examples show how it is possible to annotate plots in Matplotlib. This includes h...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_annotation_demo_thumb.png
    :alt: Annotating Plots

  :ref:`sphx_glr_gallery_text_labels_and_annotations_annotation_demo.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Three ways of drawing arrows to encode arrow &quot;strength&quot; (e.g., transition probabilities in a Ma...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_arrow_demo_thumb.png
    :alt: Arrow Demo

  :ref:`sphx_glr_gallery_text_labels_and_annotations_arrow_demo.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Matplotlib can wrap text automatically, but if it&#x27;s too long, the text will be displayed slight...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_autowrap_thumb.png
    :alt: Auto-wrapping text

  :ref:`sphx_glr_gallery_text_labels_and_annotations_autowrap.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Auto-wrapping text</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Composing custom legends piece-by-piece.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_custom_legends_thumb.png
    :alt: Composing Custom Legends

  :ref:`sphx_glr_gallery_text_labels_and_annotations_custom_legends.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Composing Custom Legends</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Matplotlib date plotting is done by converting date instances into days since an epoch (by defa...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_date_thumb.png
    :alt: Date tick labels

  :ref:`sphx_glr_gallery_text_labels_and_annotations_date.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Date tick labels</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip=".AnnotationBbox creates an annotation using an .OffsetBox, and provides more fine-grained contr...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_demo_annotation_box_thumb.png
    :alt: AnnotationBbox demo

  :ref:`sphx_glr_gallery_text_labels_and_annotations_demo_annotation_box.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="~matplotlib.textpath.TextPath creates a .Path that is the outline of the characters of a text. ...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_demo_text_path_thumb.png
    :alt: Using a text as a Path

  :ref:`sphx_glr_gallery_text_labels_and_annotations_demo_text_path.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Using a text as a Path</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example illustrates the effect of rotation_mode on the positioning of rotated text.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_demo_text_rotation_mode_thumb.png
    :alt: Text Rotation Mode

  :ref:`sphx_glr_gallery_text_labels_and_annotations_demo_text_rotation_mode.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text Rotation Mode</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="In this example, the differences between the \\dfrac and \\frac TeX macros are illustrated; in ...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_dfrac_demo_thumb.png
    :alt: The difference between \\dfrac and \\frac

  :ref:`sphx_glr_gallery_text_labels_and_annotations_dfrac_demo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">The difference between \\dfrac and \\frac</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Use of the engineering Formatter.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_engineering_formatter_thumb.png
    :alt: Labeling ticks using engineering notation

  :ref:`sphx_glr_gallery_text_labels_and_annotations_engineering_formatter.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Labeling ticks using engineering notation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Overview of the arrow styles available in ~.Axes.annotate.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_fancyarrow_demo_thumb.png
    :alt: Annotation arrow style reference

  :ref:`sphx_glr_gallery_text_labels_and_annotations_fancyarrow_demo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Annotation arrow style reference</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to style text boxes using *bbox* parameters.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_fancytextbox_demo_thumb.png
    :alt: Styling text boxes

  :ref:`sphx_glr_gallery_text_labels_and_annotations_fancytextbox_demo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Styling text boxes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Instead of plotting a legend on each axis, a legend for all the artists on all the sub-axes of ...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_figlegend_demo_thumb.png
    :alt: Figure legend demo

  :ref:`sphx_glr_gallery_text_labels_and_annotations_figlegend_demo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Figure legend demo</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="You can explicitly set which font family is picked up, either by specifying family names of fon...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_font_family_rc_thumb.png
    :alt: Configuring the font family

  :ref:`sphx_glr_gallery_text_labels_and_annotations_font_family_rc.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Configuring the font family</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Although it is usually not a good idea to explicitly point to a single ttf file for a font inst...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_font_file_thumb.png
    :alt: Using a ttf font file in Matplotlib

  :ref:`sphx_glr_gallery_text_labels_and_annotations_font_file.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Using a ttf font file in Matplotlib</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Matplotlib&#x27;s font support is provided by the FreeType library.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_font_table_thumb.png
    :alt: Font table

  :ref:`sphx_glr_gallery_text_labels_and_annotations_font_table.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Set font properties using setters.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_fonts_demo_thumb.png
    :alt: Fonts demo (object-oriented style)

  :ref:`sphx_glr_gallery_text_labels_and_annotations_fonts_demo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Fonts demo (object-oriented style)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Set font properties using keyword arguments.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_fonts_demo_kw_thumb.png
    :alt: Fonts demo (keyword arguments)

  :ref:`sphx_glr_gallery_text_labels_and_annotations_fonts_demo_kw.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Fonts demo (keyword arguments)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Labelling subplots is relatively straightforward, and varies, so Matplotlib does not have a gen...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_label_subplots_thumb.png
    :alt: Labelling subplots

  :ref:`sphx_glr_gallery_text_labels_and_annotations_label_subplots.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Defining legend labels with plots.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_legend_thumb.png
    :alt: Legend using pre-defined labels

  :ref:`sphx_glr_gallery_text_labels_and_annotations_legend.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Legend using pre-defined labels</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Plotting legends in Matplotlib.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_legend_demo_thumb.png
    :alt: Legend Demo

  :ref:`sphx_glr_gallery_text_labels_and_annotations_legend_demo.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Override basic methods so an artist can contain another artist.  In this case, the line contain...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_line_with_text_thumb.png
    :alt: Artist within an artist

  :ref:`sphx_glr_gallery_text_labels_and_annotations_line_with_text.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Artist within an artist</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Convert texts to images">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_mathtext_asarray_thumb.png
    :alt: Convert texts to images

  :ref:`sphx_glr_gallery_text_labels_and_annotations_mathtext_asarray.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Convert texts to images</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Use Matplotlib&#x27;s internal LaTeX parser and layout engine.  For true LaTeX rendering, see the te...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_mathtext_demo_thumb.png
    :alt: Mathtext

  :ref:`sphx_glr_gallery_text_labels_and_annotations_mathtext_demo.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Selected features of Matplotlib&#x27;s math rendering engine.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_mathtext_examples_thumb.png
    :alt: Mathtext Examples

  :ref:`sphx_glr_gallery_text_labels_and_annotations_mathtext_examples.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A simple example showcasing the new *math_fontfamily* parameter that can be used to change the ...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_mathtext_fontfamily_example_thumb.png
    :alt: Math fontfamily

  :ref:`sphx_glr_gallery_text_labels_and_annotations_mathtext_fontfamily_example.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Multiline">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_multiline_thumb.png
    :alt: Multiline

  :ref:`sphx_glr_gallery_text_labels_and_annotations_multiline.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="When decorating axes with text boxes, two useful tricks are to place the text in axes coordinat...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_placing_text_boxes_thumb.png
    :alt: Placing text boxes

  :ref:`sphx_glr_gallery_text_labels_and_annotations_placing_text_boxes.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Placing text boxes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The example shows how to string together several text objects.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_rainbow_text_thumb.png
    :alt: Rainbow text

  :ref:`sphx_glr_gallery_text_labels_and_annotations_rainbow_text.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Demonstration of `STIX Fonts &lt;https://www.stixfonts.org/&gt;`_ used in LaTeX rendering.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_stix_fonts_demo_thumb.png
    :alt: STIX Fonts

  :ref:`sphx_glr_gallery_text_labels_and_annotations_stix_fonts_demo.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="You can use TeX to render all of your Matplotlib text by setting text.usetex to True.  This req...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_tex_demo_thumb.png
    :alt: Rendering math equations using TeX

  :ref:`sphx_glr_gallery_text_labels_and_annotations_tex_demo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Rendering math equations using TeX</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Texts are aligned relative to their anchor point depending on the properties horizontalalignmen...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_text_alignment_thumb.png
    :alt: Text alignment

  :ref:`sphx_glr_gallery_text_labels_and_annotations_text_alignment.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to share parameters across many text objects and labels by creating a di...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_text_fontdict_thumb.png
    :alt: Controlling style of text and labels using a dictionary

  :ref:`sphx_glr_gallery_text_labels_and_annotations_text_fontdict.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Controlling style of text and labels using a dictionary</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The way Matplotlib does text layout by default is counter-intuitive to some, so this example is...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_text_rotation_thumb.png
    :alt: Default text rotation demonstration

  :ref:`sphx_glr_gallery_text_labels_and_annotations_text_rotation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Default text rotation demonstration</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Text objects in matplotlib are normally rotated with respect to the screen coordinate system (i...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_text_rotation_relative_to_line_thumb.png
    :alt: Text Rotation Relative To Line

  :ref:`sphx_glr_gallery_text_labels_and_annotations_text_rotation_relative_to_line.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text Rotation Relative To Line</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Matplotlib can display plot titles centered, flush with the left side of a set of axes, and flu...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_titles_demo_thumb.png
    :alt: Title positioning

  :ref:`sphx_glr_gallery_text_labels_and_annotations_titles_demo.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="By default, tick labels at negative values are rendered using a `Unicode minus`__ (U+2212) rath...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_unicode_minus_thumb.png
    :alt: Unicode minus

  :ref:`sphx_glr_gallery_text_labels_and_annotations_unicode_minus.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Comparison of text baselines computed for mathtext and usetex.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_usetex_baseline_test_thumb.png
    :alt: Usetex Baseline Test

  :ref:`sphx_glr_gallery_text_labels_and_annotations_usetex_baseline_test.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Usetex Baseline Test</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This script demonstrates that font effects specified in your pdftex.map are now supported in us...">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_usetex_fonteffects_thumb.png
    :alt: Usetex Fonteffects

  :ref:`sphx_glr_gallery_text_labels_and_annotations_usetex_fonteffects.py`

.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="A watermark effect can be achieved by drawing a semi-transparent text.">

.. only:: html

  .. image:: /gallery/text_labels_and_annotations/images/thumb/sphx_glr_watermark_text_thumb.png
    :alt: Text watermark

  :ref:`sphx_glr_gallery_text_labels_and_annotations_watermark_text.py`

.. raw:: html

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


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /gallery/text_labels_and_annotations/accented_text
   /gallery/text_labels_and_annotations/angle_annotation
   /gallery/text_labels_and_annotations/annotation_demo
   /gallery/text_labels_and_annotations/arrow_demo
   /gallery/text_labels_and_annotations/autowrap
   /gallery/text_labels_and_annotations/custom_legends
   /gallery/text_labels_and_annotations/date
   /gallery/text_labels_and_annotations/demo_annotation_box
   /gallery/text_labels_and_annotations/demo_text_path
   /gallery/text_labels_and_annotations/demo_text_rotation_mode
   /gallery/text_labels_and_annotations/dfrac_demo
   /gallery/text_labels_and_annotations/engineering_formatter
   /gallery/text_labels_and_annotations/fancyarrow_demo
   /gallery/text_labels_and_annotations/fancytextbox_demo
   /gallery/text_labels_and_annotations/figlegend_demo
   /gallery/text_labels_and_annotations/font_family_rc
   /gallery/text_labels_and_annotations/font_file
   /gallery/text_labels_and_annotations/font_table
   /gallery/text_labels_and_annotations/fonts_demo
   /gallery/text_labels_and_annotations/fonts_demo_kw
   /gallery/text_labels_and_annotations/label_subplots
   /gallery/text_labels_and_annotations/legend
   /gallery/text_labels_and_annotations/legend_demo
   /gallery/text_labels_and_annotations/line_with_text
   /gallery/text_labels_and_annotations/mathtext_asarray
   /gallery/text_labels_and_annotations/mathtext_demo
   /gallery/text_labels_and_annotations/mathtext_examples
   /gallery/text_labels_and_annotations/mathtext_fontfamily_example
   /gallery/text_labels_and_annotations/multiline
   /gallery/text_labels_and_annotations/placing_text_boxes
   /gallery/text_labels_and_annotations/rainbow_text
   /gallery/text_labels_and_annotations/stix_fonts_demo
   /gallery/text_labels_and_annotations/tex_demo
   /gallery/text_labels_and_annotations/text_alignment
   /gallery/text_labels_and_annotations/text_fontdict
   /gallery/text_labels_and_annotations/text_rotation
   /gallery/text_labels_and_annotations/text_rotation_relative_to_line
   /gallery/text_labels_and_annotations/titles_demo
   /gallery/text_labels_and_annotations/unicode_minus
   /gallery/text_labels_and_annotations/usetex_baseline_test
   /gallery/text_labels_and_annotations/usetex_fonteffects
   /gallery/text_labels_and_annotations/watermark_text