本教程详细阐述了如何在matplotlib图表中，使用绝对物理坐标绘制数据点的同时，为轴刻度生成并应用基于相对逻辑位置的自定义标签。通过利用`set_xticks()`、`set_yticks()`、`set_xticklabels()`和`set_yticklabels()`函数，开发者可以实现将复杂的物理坐标转换为用户友好的、具有实际意义的相对标识（如列/行号），从而显著提升图表的可读性和实用性，尤其适用于需要将工程图纸数据可视化为直观参考图的场景。
Matplotlib轴标签定制：在绝对坐标系中显示相对刻度
在数据可视化中，我们经常需要在图表上展示数据的物理位置（例如，毫米级的X/Y坐标），但同时希望轴的刻度能够以更具业务含义或逻辑结构的方式呈现（例如，列/行号）。Matplotlib提供了强大的功能来满足这种定制需求，允许我们在保持数据点准确位置的同时，完全自定义轴刻度及其标签。
挑战：绝对坐标与相对标签的冲突
考虑一个常见的场景：我们正在绘制一个制造零件上的引脚网格。每个引脚都有一个唯一的标识符，反映其在网格中的相对位置（例如，“C1:R2”表示第1列第2行）。然而，在绘图时，我们使用的是这些引脚在蓝图上的绝对物理坐标（例如，“-160.1mm, 974.9mm”）。
默认情况下，Matplotlib会根据绘制数据的绝对值来生成轴刻度及其标签。这意味着如果我们的数据点是基于毫米坐标绘制的，那么轴刻度也会显示这些毫米值。对于需要根据相对位置（如列/行号）来查找引脚的用户来说，这些绝对坐标的刻度是难以理解且不直观的。因此，挑战在于如何将绝对坐标的轴刻度替换为具有相对意义的自定义标签，同时不改变数据点的实际绘制位置。
解决方案核心：set_xticks与set_ticklabels
Matplotlib的Axes对象提供了set_xticks()、set_yticks()、set_xticklabels()和set_yticklabels()这四个关键函数，它们是解决上述问题的核心。
- set_xticks(locations) / set_yticks(locations): 这些函数用于指定X轴或Y轴刻度应该出现在哪些数据坐标位置。locations参数是一个列表或数组，包含刻度在数据空间中的绝对位置。
- set_xticklabels(labels) / set_yticklabels(labels): 这些函数用于为已经设置好的刻度位置分配自定义的文本标签。labels参数也是一个列表或数组，其中每个字符串对应一个刻度位置的标签。重要的是，labels列表的长度必须与locations列表的长度相匹配。
通过先使用set_xticks/set_yticks指定刻度的绝对位置，然后使用set_xticklabels/set_yticklabels为其赋予相对标签，我们就能实现绝对坐标绘图与相对标签显示的需求。
实现步骤详解
我们将通过一个具体的Python示例来演示如何实现这一目标。
1. 数据准备
首先，我们需要准备包含绝对坐标和相对标识的数据。这里我们使用Pandas DataFrame来组织数据，这有助于管理多列信息。
import pandas as pd
from matplotlib import pyplot as plt
# 模拟数据
ID = ['C1;R2', 'C2;R2', 'C1;R1', 'C2;R1'] # 引脚标识符
X = [-160.1, -110.1, -160.1, -110.1] # 绝对X坐标 (毫米)
Y = [974.9, 974.9, 924.9, 924.9] # 绝对Y坐标 (毫米)
COLUMN = ['1', '2', '1', '2'] # 相对列号
ROW = ['2', '2', '1', '1'] # 相对行号
# 合并列表并转换为DataFrame
list_of_tuples = list(zip(ID, X, Y, COLUMN, ROW))
Data = pd.DataFrame(list_of_tuples, columns=['ID', 'X', 'Y', 'COLUMN', 'ROW'])
print("DataFrame内容：")
print(Data)2. 初始绘图
使用绝对X和Y坐标绘制散点图，并为每个点添加其ID标签。
fig, ax = plt.subplots()
# 绘制散点图，使用绝对坐标
ax.scatter(Data['X'], Data['Y'])
# 为每个点添加ID标签
Data[['X','Y','ID']].apply(lambda row: ax.text(*row), axis=1)
# 设置图表标题
ax.set_title("引脚参考图", size=18)3. 定义自定义刻度位置
确定我们希望刻度出现在哪些绝对X和Y坐标上。这些位置通常对应于数据中存在的关键绝对坐标。
# 定义X轴刻度应该出现的绝对坐标位置 # 这里我们选择数据中X坐标的唯一值作为刻度位置 x_tick_locations = sorted(Data['X'].unique()) ax.set_xticks(x_tick_locations) # 定义Y轴刻度应该出现的绝对坐标位置 y_tick_locations = sorted(Data['Y'].unique()) ax.set_yticks(y_tick_locations)
4. 创建并应用自定义刻度标签
创建与上述刻度位置一一对应的相对标签列表。然后，使用set_xticklabels()和set_yticklabels()将这些相对标签应用到图表上。
# 创建X轴的自定义标签（对应相对列号） # 确保标签顺序与刻度位置的顺序一致 x_labels = sorted(Data['COLUMN'].unique()) ax.set_xticklabels(x_labels) # 创建Y轴的自定义标签（对应相对行号） y_labels = sorted(Data['ROW'].unique()) ax.set_yticklabels(y_labels)
5. 更新轴标题
由于轴刻度现在表示的是相对列号和行号，因此更新轴标题以反映这一变化，提高图表的整体清晰度。
plt.xlabel('列 (COLUMN)')
plt.ylabel('行 (ROW)')6. 完整示例代码
将上述所有步骤整合到一起，形成一个完整的、可运行的脚本。
import pandas as pd
from matplotlib import pyplot as plt
# 1. 数据准备
ID = ['C1;R2', 'C2;R2', 'C1;R1', 'C2;R1']
X = [-160.1, -110.1, -160.1, -110.1]
Y = [974.9, 974.9, 924.9, 924.9]
COLUMN = ['1', '2', '1', '2']
ROW = ['2', '2', '1', '1']
list_of_tuples = list(zip(ID, X, Y, COLUMN, ROW))
Data = pd.DataFrame(list_of_tuples, columns=['ID', 'X', 'Y', 'COLUMN', 'ROW'])
# 2. 初始绘图设置
fig, ax = plt.subplots()
ax.scatter(Data['X'], Data['Y'])
# 为每个点添加ID标签
Data[['X','Y','ID']].apply(lambda row: ax.text(*row), axis=1)
# 设置图表标题
ax.set_title("引脚参考图", size=18)
# 3. 定义自定义刻度位置（使用绝对坐标）
# 动态获取唯一的X, Y坐标作为刻度位置
ax.set_xticks(sorted(Data['X'].unique()))
ax.set_yticks(sorted(Data['Y'].unique()))
# 4. 创建并应用自定义刻度标签（使用相对标识）
# 动态获取唯一的COLUMN, ROW作为标签
x_labels = sorted(Data['COLUMN'].unique())
y_labels = sorted(Data['ROW'].unique())
ax.set_xticklabels(x_labels)
ax.set_yticklabels(y_labels)
# 5. 更新轴标题以反映新的标签含义
plt.xlabel('列 (COLUMN)')
plt.ylabel('行 (ROW)')
# 显示图表
plt.show()进阶考量与注意事项
-
动态生成刻度与标签: 在实际应用中，数据量可能很大，手动列出所有刻度位置和标签是不切实际的。我们可以利用Pandas DataFrame的.unique()方法来动态获取所有唯一的X/Y坐标和对应的COLUMN/ROW值，并进行排序，以确保刻度位置和标签列表的顺序是匹配的。
x_tick_locations = sorted(Data['X'].unique()) x_labels = sorted(Data['COLUMN'].unique()) # 假设COLUMN值与X坐标的唯一值一一对应 # 确保顺序匹配是关键。如果X坐标和COLUMN值的排序逻辑不同， # 需要更复杂的映射，例如创建一个字典 {X: COLUMN} x_mapping = Data.set_index('X')['COLUMN'].to_dict() x_labels = [x_mapping[loc] for loc in x_tick_locations] 刻度位置与标签数量匹配: 务必确保set_xticks()或set_yticks()中提供的刻度位置列表的长度，与set_xticklabels()或set_yticklabels()中提供的标签列表的长度完全一致。如果不匹配，Matplotlib会报错或产生意想不到的结果。
保持数据关联性: 当从原始数据中提取刻度位置和标签时，要确保它们之间的逻辑关联性是正确的。例如，如果X坐标-160.1对应的是COLUMN '1'，那么在set_xticks中包含-160.1时，set_xticklabels中对应位置的标签必须是'1'。
清晰的轴标题: 更改刻度标签后，同步更新plt.xlabel()和plt.ylabel()以反映新的含义，这对于最终用户的理解至关重要。
总结
通过灵活运用Matplotlib的set_xticks()、set_yticks()、set_xticklabels()和set_yticklabels()函数，我们能够成功地在以绝对坐标绘制数据点的图表中，实现自定义的、具有相对意义的轴刻度标签。这种方法极大地提升了图表的可读性和用户体验，尤其是在工程、制造或任何需要将精确物理数据与直观逻辑标识相结合的场景中。它提供了一种强大的机制，使得复杂的数据可视化变得更加易于理解和操作。
