Secondary axes in Matplotlib

Introduction

Secondary axes let you show two different scales on the same plot. This helps compare data that have different units or ranges.

You want to compare temperature and sales on the same chart.

You have data in kilometers and miles and want to show both scales.

You want to display revenue and profit margin together but they use different units.

You want to add a percentage scale alongside a count scale on a graph.

Syntax

Matplotlib

ax.secondary_xaxis(location, functions=(forward, inverse))
ax.secondary_yaxis(location, functions=(forward, inverse))

location is where the secondary axis appears (e.g., 'top' or 'right').

functions are two functions: one to convert from primary to secondary axis, and one to convert back.

Examples

Adds a secondary y-axis on the right side with the same scale as the primary y-axis.

Matplotlib

secax = ax.secondary_yaxis('right')

Adds a secondary x-axis on top converting kilometers to miles and back.

Matplotlib

secax = ax.secondary_xaxis('top', functions=(lambda x: x*1.6, lambda x: x/1.6))

Sample Program

This code plots y = x² on the primary y-axis. It adds a secondary y-axis on the right side that shows the values scaled down by 10. This helps compare the same data in a different scale.

Matplotlib

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)
y1 = x ** 2  # primary y-axis data

def forward(x):
    return x / 10  # convert primary y to secondary y

def inverse(x):
    return x * 10  # convert secondary y back to primary y

fig, ax = plt.subplots()
ax.plot(x, y1, label='y = x^2')
ax.set_ylabel('Primary Y axis (x^2)')

secax = ax.secondary_yaxis('right', functions=(forward, inverse))
secax.set_ylabel('Secondary Y axis (scaled)')

ax.set_xlabel('X axis')
ax.legend()
plt.show()

Important Notes

Secondary axes need conversion functions if scales differ.

Without functions, the secondary axis matches the primary axis scale.

Use secondary axes to make complex data easier to understand.

Summary

Secondary axes show two scales on one plot.

Use conversion functions to link primary and secondary axes.

They help compare different units or ranges clearly.

Practice

1. What is the main purpose of using secondary_xaxis or secondary_yaxis in matplotlib?

easy

A. To add a new axis with a different scale on the same plot

B. To create a separate figure window

C. To change the color of the existing axis

D. To remove the original axis from the plot

Solution

1. Step 1: Understand the concept of secondary axes

   Secondary axes allow adding a new axis that shares the same plot but has a different scale or units.

2. Step 2: Identify the purpose of secondary_xaxis or secondary_yaxis

   These functions add a secondary axis to the existing plot to compare data with different units clearly.

3. Final Answer:

   To add a new axis with a different scale on the same plot -> Option A

4. Quick Check:

   Secondary axes = different scale on same plot [OK]

Hint: Secondary axes add a new scale on the same plot [OK]

Common Mistakes:

• Thinking it creates a new figure
• Confusing axis color change with adding axes
• Assuming it removes original axes

2. Which of the following is the correct way to add a secondary y-axis in matplotlib?

easy

A. ax.add_secondary_yaxis('right', functions=(forward, inverse))

B. ax.add_secondary_axis('right', functions=(forward, inverse))

C. ax.secondary_yaxis('right', functions=(forward, inverse))

D. ax.secondary_axis('right', functions=(forward, inverse))

Solution

1. Step 1: Recall the matplotlib method for secondary y-axis

   The correct method is secondary_yaxis called on the axes object.

2. Step 2: Match the exact syntax

   The method is ax.secondary_yaxis('right', functions=(forward, inverse)) where 'right' is the position and functions are conversion functions.

3. Final Answer:

   ax.secondary_yaxis('right', functions=(forward, inverse)) -> Option C

4. Quick Check:

   Correct method name = secondary_yaxis [OK]

Hint: Use ax.secondary_yaxis with conversion functions [OK]

Common Mistakes:

• Using incorrect method names like add_secondary_axis
• Missing the functions parameter
• Using secondary_axis instead of secondary_yaxis

3. What will be the output of this code snippet?

import matplotlib.pyplot as plt
fig, ax = plt.subplots()
ax.plot([0, 1, 2], [0, 10, 20])

forward = lambda x: x / 10
inverse = lambda x: x * 10
secax = ax.secondary_yaxis('right', functions=(forward, inverse))
print(secax.get_ylim())

medium

A. [0.0, 2.0]

B. [0, 20]

C. [0.0, 200.0]

D. [0, 10]

Solution

1. Step 1: Understand the original y-axis limits

   The original y-axis data ranges from 0 to 20, so default limits are approximately (0, 20).

2. Step 2: Apply the forward function to original limits for secondary axis

   The forward function divides by 10, so 0 becomes 0.0 and 20 becomes 2.0 on the secondary axis.

3. Final Answer:

   [0.0, 2.0] -> Option A

4. Quick Check:

   Secondary axis limits = original limits / 10 [OK]

Hint: Secondary axis limits = apply forward function to original limits [OK]

Common Mistakes:

• Confusing forward and inverse functions
• Expecting original limits instead of transformed
• Assuming inverse function applies to limits

4. Identify the error in this code that tries to add a secondary x-axis:

import matplotlib.pyplot as plt
fig, ax = plt.subplots()
ax.plot([0, 1, 2], [0, 1, 4])

forward = lambda x: x * 2
inverse = lambda x: x / 2
secax = ax.secondary_xaxis('top', functions=(inverse, forward))

medium

A. The lambda functions should not be used

B. The order of functions in the tuple is reversed

C. The position 'top' is invalid for secondary_xaxis

D. The method name should be secondary_yaxis instead

Solution

1. Step 1: Check the order of conversion functions

   The first function should convert from primary to secondary axis (forward), the second from secondary to primary (inverse).

2. Step 2: Identify the mistake in the code

   The code uses (inverse, forward) instead of (forward, inverse), so the order is reversed causing incorrect scaling.

3. Final Answer:

   The order of functions in the tuple is reversed -> Option B

4. Quick Check:

   Functions order = (forward, inverse) [OK]

Hint: First function forward, second inverse in tuple [OK]

Common Mistakes:

• Swapping forward and inverse functions
• Using invalid axis position
• Confusing secondary_xaxis with secondary_yaxis

5. You have temperature data in Celsius and want to add a secondary y-axis in Fahrenheit on the right side. Which of these code snippets correctly creates the secondary axis with proper conversion?

hard

A. forward = lambda f: (f - 32) * 5/9
inverse = lambda c: (c * 9/5) + 32
ax.secondary_yaxis('right', functions=(inverse, forward))

B. forward = lambda c: (c * 5/9) + 32
inverse = lambda f: (f - 32) * 9/5
ax.secondary_yaxis('right', functions=(forward, inverse))

C. forward = lambda c: (c - 32) * 5/9
inverse = lambda f: (f * 9/5) + 32
ax.secondary_yaxis('left', functions=(forward, inverse))

D. forward = lambda c: (c * 9/5) + 32
inverse = lambda f: (f - 32) * 5/9
ax.secondary_yaxis('right', functions=(forward, inverse))

Solution

1. Step 1: Recall Celsius to Fahrenheit conversion formulas

   Celsius to Fahrenheit: F = (C * 9/5) + 32; Fahrenheit to Celsius: C = (F - 32) * 5/9.

2. Step 2: Match the forward and inverse functions correctly

   Forward converts primary (C) to secondary (F), inverse converts secondary (F) back to primary (C). Position 'right' is correct for secondary y-axis.

3. Final Answer:

   forward = lambda c: (c * 9/5) + 32 inverse = lambda f: (f - 32) * 5/9 ax.secondary_yaxis('right', functions=(forward, inverse)) -> Option D

4. Quick Check:

   Correct conversion and axis position = forward = lambda c: (c * 9/5) + 32 inverse = lambda f: (f - 32) * 5/9 ax.secondary_yaxis('right', functions=(forward, inverse)) [OK]

Hint: Forward: C to F; Inverse: F to C; position 'right' for y-axis [OK]

Common Mistakes:

• Swapping forward and inverse functions
• Using wrong conversion formulas
• Placing secondary axis on 'left' instead of 'right'