adjustText实践——调整matplotlib散点图标签，避免重复
简介
博主需要在全球地图上标注出化石点数据，由于化石产出点一样或很近，导致呈现的效果不理想，如果自动添加标签，又会重叠。近期看到adjustText库可以自动调整标签，避免重复。本文记录学习过程，并将在最后展示博主的图示，期待一下效果。
原始效果
不加标签
加上标签
手动调整注释位置也不可能
adjustText认识
1. 简介
学习资料来自adjustText官网——https://adjusttext.readthedocs.io/en/latest/
adjustText帮助用于调整matplotlib绘图中的注释文本布局，尽可能避免或减少注释文件间的重叠。
通过检测文本的边界重叠，尝试移动它们以减少重叠来实现功能。本库受到用于R/gglot2的ggrepel启发。
2. 函数
该库仅有1个函数：
adjustText.adjust_text(texts, x=None, y=None, objects=None, avoid_self=True, force_text: tuple[float, float] = (0.1, 0.2), force_static: tuple[float, float] = (0.1, 0.2), force_pull: tuple[float, float] = (0.01, 0.01), force_explode: tuple[float, float] = (0.01, 0.02), expand: tuple[float, float] = (1.05, 1.1), explode_radius='auto', ensure_inside_axes=True, expand_axes=False, only_move={'explode': 'xy', 'pull': 'xy', 'static': 'xy', 'text': 'xy'}, ax=None, min_arrow_len=5, time_lim=0.5, *args, **kwargs)
反复地、迭代地调整文本的位置
在绘图完成后再调用adjust_text()函数。
3. 参数解读
| 参数 | 传参类型 | 含义 |
|---|---|---|
| text | 列表 | matplotlib.text.Text对象组成的列表 |
| x | 类似数组 | 文本注释的坐标x值；如若没有即用文本坐标 |
| y | 同上 | 同上 |
| objects | 列表或PathCollection | 需要避开的matplotlib对象；这些对象必须有get_window_extent()方法；或是一个PathCollection或一组Bbox对象 |
| avoid_self | 布尔值，默认True | 是否让文本避开原始位置 |
| force_text | 元组，默认(0.1, 0.2) | 文本的调整空间就是两值乘积的面积 |
| force_static | 元组，默认(0.05, 0.1) | 散点和其他对象之间的调整空间 |
| force_pull | 浮点数，default (0.001, 0.0001) | 也是调整空间，将文本拉向原始位置 |
| force_explode | 浮点数，default (0.001, 0.0001) | 也是调整空间，文本间保持的距离 |
| expand | 类似数组，default (1.05, 1.2) | 有两个值的列表或元组(x, y)，将文本拉开的距离控制 |
| explode_radius | 浮点数或"auto"，默认"auto" | 在一开始的显示单位中，检查离文本最近的对象移动多远，那么在100的数量级上“auto”使用的是最大文本的大小 |
| ensure_inside_axes | 布尔值，默认True | 是否强制文本停留在坐标轴内 |
| expand_axes | 布尔值，默认Default | 在调整位置之前，是否扩展坐标轴以适应所有文本 |
| only_move | 字典，默认{‘points’:‘xy’, ‘text’:‘xy’, ‘objects’:‘xy’} | 对于某些类型的重叠，将文本移动限制在某些轴上的字典。有效的键是points、text和objects。有效值有’ ‘、’ x ‘、’ y ‘和’ xy ‘。例如，only_move={’ points ': ’ y '， ’ text ': ’ xy '， ’ objects ': ’ xy '}禁止文本沿x轴移动，因为它们与点重叠。 |
| ax | matplotlib axe，默认当前axe (plt.gca()) | ax object with the plot |
| min_arrow_len | 浮点数，默认5 | 如果文本比这个距离目标点更近，则不要添加箭头(以显示单位为单位)。 |
| time_lim | 浮点数，默认0.1 | 调整需要多少时间，以秒为单位 |
| kwargs | 在所有优化完成后，任何参数都将被输入obj:FancyArrowPatch，以便在需要时绘制连接的箭头。 |
尝试解决
后记
没有很好地解决。而且该库作者早已停更。官方文档和脚本有出入，应该是后续有人优化过。有时间仔细研究研究。