设置刻度线和刻度标签

Matplotlib - 设置刻度和刻度标签

刻度 (Ticks) 是沿着坐标轴（x 轴和 y 轴）标记特定数据点或间隔的标记。刻度标签 (Tick labels) 是与这些刻度关联的文本字符串。

虽然 Matplotlib 的默认刻度定位器 (tick locators) 和格式化器 (formatters) 通常会自动产生不错的结果，但您经常需要自定义刻度位置和标签，以提高清晰度、突出特定信息或进行非数值标签设置。

控制刻度位置

使用 ax.set_xticks() 和 ax.set_yticks() 方法可以显式地设置刻度应该出现在各自轴上的位置。这些方法接受一个数值位置列表或数组。

# 示例：在位置 0, pi, 2*pi 设置 x 轴刻度
ax.set_xticks([0, np.pi, 2 * np.pi])

# 示例：以 0.5 为步长设置 y 轴刻度范围从 -1 到 1
ax.set_yticks(np.arange(-1, 1.1, 0.5))

控制刻度标签

使用 ax.set_xticklabels() 和 ax.set_yticklabels() 方法为您设置的刻度（或在未手动设置位置时为默认刻度）提供自定义标签。这些方法接受一个字符串列表。

重要提示： 设置自定义标签时，您通常应该先使用 set_xticks/set_yticks 设置刻度位置。提供给 set_xticklabels/set_yticklabels 的标签列表与刻度位置列表顺序对应。

# 示例：为之前设置的 x 轴刻度设置自定义标签
ax.set_xticklabels(['Start', 'Middle', 'End'])

# 示例：将 y 轴刻度标签格式化为百分比
y_tick_locations = ax.get_yticks() # 获取当前刻度位置
y_tick_labels = [f'{val * 100:.0f}%' for val in y_tick_locations]
ax.set_yticklabels(y_tick_labels)

示例：为正弦波设置自定义刻度和标签

import matplotlib.pyplot as plt
import numpy as np

# 数据
x = np.linspace(0, 2 * np.pi, 100)
y = np.sin(x)

fig, ax = plt.subplots(figsize=(8, 5))
ax.plot(x, y)

ax.set_title('Sine Wave with Custom Ticks/Labels')
ax.set_xlabel('Angle (Radians)')
ax.set_ylabel('Value')

# --- 自定义刻度和标签 ---

# 1. 设置 X 轴刻度位置
x_tick_locations = [0, np.pi / 2, np.pi, 3 * np.pi / 2, 2 * np.pi]
ax.set_xticks(x_tick_locations)

# 2. 使用 LaTeX 设置相应的 X 轴刻度标签（包含 pi 符号）
x_tick_labels = ['0', r'$\pi/2$', r'$\pi$', r'$3\pi/2$', r'$2\pi$']
ax.set_xticklabels(x_tick_labels, fontsize=12)

# 3. 设置 Y 轴刻度位置
y_tick_locations = [-1, 0, 1]
ax.set_yticks(y_tick_locations)

# 4. 设置相应的 Y 轴刻度标签
y_tick_labels = ['Min (-1)', 'Zero (0)', 'Max (+1)']
ax.set_yticklabels(y_tick_labels)

# --- 可选：自定义刻度外观 ---
ax.tick_params(axis='x', direction='in', length=6, width=1, colors='blue')
ax.tick_params(axis='y', labelrotation=45) # 旋转 y 轴标签

ax.grid(True, linestyle='--')
plt.tight_layout()
plt.show()

这段代码生成了一个正弦波图，其中 x 轴刻度位于 pi/2 的倍数位置，并使用数学符号（包括通过 LaTeX 渲染的 pi 符号）进行标记。y 轴刻度位于 -1、0 和 1，并给出了描述性字符串标签。还使用 ax.tick_params() 自定义了刻度的外观参数，例如方向、大小、颜色和标签旋转。

高级控制：定位器和格式化器

对于更复杂的场景（例如，对数刻度、日期轴、自动查找合适的刻度间隔），Matplotlib 提供了一套强大的系统，包括定位器 (Locators) 用于确定刻度位置，以及格式化器 (Formatters) 用于确定标签字符串。这些都在 matplotlib.ticker 模块中。

您可以为轴分配特定的 Locator 和 Formatter 对象：

from matplotlib.ticker import MultipleLocator, FormatStrFormatter, AutoMinorLocator

# 在 x 轴上每隔 1 个单位设置主刻度
ax.xaxis.set_major_locator(MultipleLocator(1))
# 将 x 轴主刻度格式化为保留 1 位小数的浮点数
ax.xaxis.set_major_formatter(FormatStrFormatter('%.1f'))

# 自动添加次刻度
ax.xaxis.set_minor_locator(AutoMinorLocator(5)) # 在主刻度之间添加 5 个次刻度间隔

# 为主刻度和次刻度自定义网格线
ax.grid(which='major', linestyle='-', linewidth='0.5', color='red')
ax.grid(which='minor', linestyle=':', linewidth='0.5', color='black')

掌握刻度、定位器和格式化器，您将能够完全控制坐标轴如何传达信息。