How to access axis label object in Matplotlib?

To access axis label objects in Matplotlib, you can use the get_label() method on the axis object, which returns the label text object. This is useful when you need to retrieve or manipulate axis labels programmatically.

Basic Syntax

The main methods for accessing axis labels are ?

# Get X-axis label text
x_label_text = ax.xaxis.get_label().get_text()

# Get Y-axis label text  
y_label_text = ax.yaxis.get_label().get_text()

# Get the label object itself
x_label_obj = ax.xaxis.get_label()
y_label_obj = ax.yaxis.get_label()

Example: Accessing Axis Label Objects

Here's a complete example showing how to set and retrieve axis labels ?

import numpy as np
import matplotlib.pyplot as plt

# Set figure parameters
plt.rcParams["figure.figsize"] = [7.50, 3.50]
plt.rcParams["figure.autolayout"] = True

# Create figure and subplot
fig, ax = plt.subplots()

# Generate sample data
N = 100
x = np.random.rand(N)
y = np.random.rand(N)

# Plot data
ax.plot(x, y, 'bo-', alpha=0.7)

# Set axis labels
ax.set_xlabel("X-axis Data Points")
ax.set_ylabel("Y-axis Values")

# Access label objects and text
x_label_obj = ax.xaxis.get_label()
y_label_obj = ax.yaxis.get_label()

x_label_text = x_label_obj.get_text()
y_label_text = y_label_obj.get_text()

print("X-axis label:", x_label_text)
print("Y-axis label:", y_label_text)

plt.show()

X-axis label: X-axis Data Points
Y-axis label: Y-axis Values

Manipulating Label Properties

Once you have the label object, you can modify its properties ?

import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots(figsize=(8, 4))

# Sample data
x = np.linspace(0, 10, 50)
y = np.sin(x)
ax.plot(x, y)

# Set initial labels
ax.set_xlabel("Time (seconds)")
ax.set_ylabel("Amplitude")

# Get label objects
x_label = ax.xaxis.get_label()
y_label = ax.yaxis.get_label()

# Modify label properties
x_label.set_color('blue')
x_label.set_fontsize(14)
x_label.set_weight('bold')

y_label.set_color('red')
y_label.set_fontsize(12)
y_label.set_style('italic')

# Print current label properties
print("X-label text:", x_label.get_text())
print("X-label color:", x_label.get_color())
print("X-label fontsize:", x_label.get_fontsize())

plt.show()

X-label text: Time (seconds)
X-label color: blue
X-label fontsize: 14.0

Common Use Cases

Conclusion

Use ax.xaxis.get_label().get_text() to retrieve axis label text and ax.xaxis.get_label() to access the full label object for property manipulation. This approach provides programmatic control over axis labels in your matplotlib plots.