Text annotations in Matplotlib - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is a text annotation in matplotlib?

A text annotation is a label or note added to a plot to highlight or explain a specific point or area. It helps make the plot easier to understand.

beginner

Which matplotlib function is used to add text annotations to a plot?

The annotate() function is used to add text annotations to a plot in matplotlib.

intermediate

What are the key parameters of annotate() for positioning the text?

The key parameters are xy for the point to annotate, and xytext for the position of the text label. You can also use arrowprops to draw an arrow from the text to the point.

intermediate

How can you customize the arrow style in a matplotlib annotation?

You can customize the arrow style by passing a dictionary to the arrowprops parameter in annotate(). For example, {'arrowstyle': '->', 'color': 'red'} draws a red arrow with a simple head.

beginner

Why are text annotations useful in data visualization?

Text annotations help explain important points, trends, or outliers in the data. They make plots easier to read and understand, especially for people who are not familiar with the data.

Which matplotlib function adds text annotations to a plot?

A xlabel()

B plot()

C text()

D annotate()

The annotate() function is designed to add text annotations with optional arrows.

In annotate(), what does the xy parameter specify?

A The position of the text label

B The color of the arrow

C The point to annotate on the plot

D The font size of the text

xy is the coordinate of the point you want to highlight or annotate.

How do you add an arrow pointing from the text to the annotated point?

A Use the <code>arrowprops</code> parameter in <code>annotate()</code>

B Use the <code>arrow()</code> function separately

C Set <code>arrow=True</code> in <code>text()</code>

D Arrows are added automatically

The arrowprops dictionary controls the arrow style and presence.

Which of these is a valid arrow style in arrowprops?

A '->'

B '-->'

C 'arrowhead'

D 'line'

The style '->' is a common arrow style for annotations.

Why should you use text annotations in your plots?

A To decorate the plot with random text

B To explain key points or data features

C To change the plot background color

D To increase the plot size

Annotations help viewers understand important parts of the data.

Explain how to add a text annotation with an arrow pointing to a specific data point in matplotlib.

Think about the parameters that control where the text and arrow appear.

Describe why text annotations improve the clarity of data visualizations.

Consider the viewer's perspective when reading a plot.

Practice

1. What is the main purpose of adding text annotations in a matplotlib plot?

easy

A. To add labels or notes that explain or highlight data points

B. To change the color of the plot lines

C. To increase the size of the plot window

D. To save the plot as an image file

Solution

1. Step 1: Understand what text annotations do

   Text annotations add extra information like labels or notes on specific parts of a plot.

2. Step 2: Identify the correct purpose

   Changing colors or saving files are unrelated to annotations, which focus on explaining or highlighting data points.

3. Final Answer:

   To add labels or notes that explain or highlight data points -> Option A

4. Quick Check:

   Annotations = labels/notes [OK]

Hint: Annotations explain data points clearly on plots [OK]

Common Mistakes:

• Confusing annotations with plot styling
• Thinking annotations save or export plots
• Assuming annotations change plot size

2. Which of the following is the correct syntax to add a text annotation at point (2, 3) with the text 'Peak' in matplotlib?

easy

A. plt.annotate(xy=(2, 3), text='Peak')

B. plt.text('Peak', xy=(2, 3))

C. plt.annotate('Peak', xy=(2, 3))

D. plt.text(x=2, y=3, label='Peak')

Solution

1. Step 1: Recall the correct function and parameter order

   The function plt.annotate takes the text first, then the xy coordinate as a tuple.

2. Step 2: Check each option

   plt.annotate('Peak', xy=(2, 3)) uses plt.annotate('Peak', xy=(2, 3)) which is correct. Others misuse parameter names or functions.

3. Final Answer:

   plt.annotate('Peak', xy=(2, 3)) -> Option C

4. Quick Check:

   annotate(text, xy=point) = correct syntax [OK]

Hint: Use plt.annotate('text', xy=(x,y)) for annotations [OK]

Common Mistakes:

• Swapping text and xy parameters
• Using plt.text with wrong arguments
• Incorrect parameter names like label or text=

3. What will the following code display?

import matplotlib.pyplot as plt
plt.plot([1, 2, 3], [4, 5, 6])
plt.annotate('Max', xy=(3, 6), xytext=(2, 5), arrowprops=dict(facecolor='black'))
plt.show()

medium

A. A line plot with an annotation 'Max' at point (3,6) with an arrow pointing from (2,5)

B. A line plot with text 'Max' at (2,5) but no arrow

C. A line plot with an annotation 'Max' at (2,5) without arrow

D. Syntax error due to incorrect arrowprops usage

Solution

1. Step 1: Understand plt.annotate parameters

   xy is the point to annotate (3,6), xytext is where the text appears (2,5), arrowprops adds an arrow from text to point.

2. Step 2: Analyze the code output

   The plot shows a line, with 'Max' text at (2,5) and an arrow pointing to (3,6).

3. Final Answer:

   A line plot with an annotation 'Max' at point (3,6) with an arrow pointing from (2,5) -> Option A

4. Quick Check:

   annotate with xy, xytext, arrowprops = arrowed label [OK]

Hint: xy=point, xytext=text location, arrowprops=arrow [OK]

Common Mistakes:

• Confusing xy and xytext roles
• Expecting arrow without arrowprops
• Thinking arrowprops causes syntax error

4. Identify the error in this code snippet:

import matplotlib.pyplot as plt
plt.plot([1, 2, 3], [4, 5, 6])
plt.annotate('High', (3, 6), xytext=(2, 5), arrowprops='black')
plt.show()

medium

A. plt.plot arguments are incorrect

B. arrowprops should be a dictionary, not a string

C. The text 'High' should be passed as xytext

D. xytext parameter is missing

Solution

1. Step 1: Check arrowprops usage

   arrowprops must be a dictionary specifying arrow style, not a string.

2. Step 2: Verify other parameters

   xytext is present, text is first argument, plot args are correct.

3. Final Answer:

   arrowprops should be a dictionary, not a string -> Option B

4. Quick Check:

   arrowprops = dict(...) not string [OK]

Hint: arrowprops needs dict with arrow style, not string [OK]

Common Mistakes:

• Passing arrowprops as string
• Confusing text and xytext parameters
• Incorrect plot data format

5. You want to highlight the lowest point on a plot with an annotation that includes an arrow and custom text offset. Which code snippet correctly achieves this for data points x=[1,2,3], y=[5,3,6]?

hard

A. plt.annotate('Lowest', xy=(2, 3), xytext=(2, 3), arrowprops=dict(color='blue'))

B. plt.annotate('Lowest', xytext=(2, 3), xy=(1, 4), arrowprops='red')

C. plt.text('Lowest', xy=(2, 3), xytext=(1, 4), arrowprops=dict(facecolor='red'))

D. plt.annotate('Lowest', xy=(2, 3), xytext=(1, 4), arrowprops=dict(facecolor='red'))

Solution

1. Step 1: Identify the lowest point coordinates

   Lowest y is 3 at x=2, so xy=(2,3) is correct.

2. Step 2: Check annotation parameters

   xytext=(1,4) offsets text for clarity, arrowprops uses dict with facecolor for arrow color.

3. Step 3: Validate options

   plt.annotate('Lowest', xy=(2, 3), xytext=(1, 4), arrowprops=dict(facecolor='red')) matches correct syntax and logic. Others misuse parameters or functions.

4. Final Answer:

   plt.annotate('Lowest', xy=(2, 3), xytext=(1, 4), arrowprops=dict(facecolor='red')) -> Option D

5. Quick Check:

   Correct xy, xytext, arrowprops dict = plt.annotate('Lowest', xy=(2, 3), xytext=(1, 4), arrowprops=dict(facecolor='red')) [OK]

Hint: Use xy for point, xytext for label offset, arrowprops dict [OK]

Common Mistakes:

• Swapping xy and xytext
• Using plt.text instead of plt.annotate
• Passing arrowprops as string