38. Annotations, Arrows & Callouts (plt.annotate)

Data storytelling requires guiding the viewer's attention to peak outliers, regime shifts, or inflection points. `plt.annotate()` anchors an arrow pointing exactly at a data coordinate $(x, y)$ while placing text nearby.

Mental Model Intuition

A comic book dialogue balloon with an arrow pointing directly to the speaker.

Core Concepts & Mechanics

`xy` vs `xytext`Coordinates

`xy=(x, y)` is the exact tip of the arrow pointing at the data mark. `xytext=(x, y)` is where the annotation text box is positioned.

Matplotlib automatically draws an arrow connecting `xytext` to `xy`.

ax.annotate('Event', xy=(5, 20), xytext=(6, 25), arrowprops=dict(facecolor='teal'))

Common Beginner Mistakes & Pro Fixes

Avoid the top errors and bad plotting practices that trip up new Python developers

Troubleshooting

Quick Lesson Takeaways

`ax.annotate()` links descriptive text to coordinate points via pointers.
`xy` is the point of interest; `xytext` is the text label location.
`arrowprops` formats arrow color, head width, and thickness.

Topic 38 • Python IDE

Python 3.12 • Matplotlib

Presets:

Ctrl + Enter to run

Run Python code to inspect terminal output.

Real-World Datasets (1-Click Switcher)

Switch from abstract numbers to relatable Cricket, Cinema & Business charts

5 Curated Datasets

Hands-on Challenge: Add an Arrow Annotation

+50 XP

Write Matplotlib code to solve the objective and see your live plot render

Objective Instructions:

Plot `x=[1, 2, 3]` and `y=[10, 30, 20]`, annotate the point `xy=(2, 30)` with text 'Max Value' using `plt.annotate()`.

Required Keywords:✓ annotate✓ xy

Challenge Code Editor

Challenge Output GraphLive Vector Preview

Write code on the left to render live challenge plot

End of Lesson Knowledge Check

Quick Mini Quiz: 2 Concept Questions

Test your understanding to unlock the lesson completion badge

Which Matplotlib function is used to create a standard continuous 2D line plot?

What must you call after specifying label='...' so that the legend actually appears on the canvas?

0 of 2 answered

Logarithmic & Symmetrical Scales (yscale('log'))

Next Lesson

Text Boxes & LaTeX Mathematical Equations