You are reading an old version of the documentation (v3.0.3). For the latest version see https://matplotlib.org/stable/gallery/shapes_and_collections/arrow_guide.html
Version 3.0.3
matplotlib
Fork me on GitHub

Table of Contents

Related Topics

Arrow guide

Adding arrow patches to plots.

Arrows are often used to annotate plots. This tutorial shows how to plot arrows that behave differently when the data limits on a plot are changed. In general, points on a plot can either be fixed in "data space" or "display space". Something plotted in data space moves when the data limits are altered - an example would the points in a scatter plot. Something plotted in display space stays static when data limits are altered - an example would be a figure title or the axis labels.

Arrows consist of a head (and possibly a tail) and a stem drawn between a start point and and end point, called 'anchor points' from now on. Here we show three use cases for plotting arrows, depending on whether the head or anchor points need to be fixed in data or display space:

  1. Head shape fixed in display space, anchor points fixed in data space
  2. Head shape and anchor points fixed in display space
  3. Entire patch fixed in data space

Below each use case is presented in turn.

import matplotlib.patches as mpatches
import matplotlib.pyplot as plt
x_tail = 0.1
y_tail = 0.1
x_head = 0.9
y_head = 0.9
dx = x_head - x_tail
dy = y_head - y_tail

Head shape fixed in display space and anchor points fixed in data space

This is useful if you are annotating a plot, and don't want the arrow to to change shape or position if you pan or scale the plot. Note that when the axis limits change

In this case we use patches.FancyArrowPatch

Note that when the axis limits are changed, the arrow shape stays the same, but the anchor points move.

fig, axs = plt.subplots(nrows=2)
arrow = mpatches.FancyArrowPatch((x_tail, y_tail), (dx, dy),
                                 mutation_scale=100)
axs[0].add_patch(arrow)

arrow = mpatches.FancyArrowPatch((x_tail, y_tail), (dx, dy),
                                 mutation_scale=100)
axs[1].add_patch(arrow)
axs[1].set_xlim(0, 2)
axs[1].set_ylim(0, 2)
../../_images/sphx_glr_arrow_guide_001.png

Head shape and anchor points fixed in display space

This is useful if you are annotating a plot, and don't want the arrow to to change shape or position if you pan or scale the plot.

In this case we use patches.FancyArrowPatch, and pass the keyword argument transform=ax.transAxes where ax is the axes we are adding the patch to.

Note that when the axis limits are changed, the arrow shape and location stays the same.

fig, axs = plt.subplots(nrows=2)
arrow = mpatches.FancyArrowPatch((x_tail, y_tail), (dx, dy),
                                 mutation_scale=100,
                                 transform=axs[0].transAxes)
axs[0].add_patch(arrow)

arrow = mpatches.FancyArrowPatch((x_tail, y_tail), (dx, dy),
                                 mutation_scale=100,
                                 transform=axs[1].transAxes)
axs[1].add_patch(arrow)
axs[1].set_xlim(0, 2)
axs[1].set_ylim(0, 2)
../../_images/sphx_glr_arrow_guide_002.png

Head shape and anchor points fixed in data space

In this case we use patches.Arrow

Note that when the axis limits are changed, the arrow shape and location changes.

fig, axs = plt.subplots(nrows=2)

arrow = mpatches.Arrow(x_tail, y_tail, dx, dy)
axs[0].add_patch(arrow)

arrow = mpatches.Arrow(x_tail, y_tail, dx, dy)
axs[1].add_patch(arrow)
axs[1].set_xlim(0, 2)
axs[1].set_ylim(0, 2)
../../_images/sphx_glr_arrow_guide_003.png

Keywords: matplotlib code example, codex, python plot, pyplot Gallery generated by Sphinx-Gallery