ArcPy 分式标注图层怎么做

ArcPy
Dr.GIS
wowwwai GIS研习社 · 工具流程与项目排障

要用 ArcPy 做分式标注图层,核心做法是写带文本格式化标签的标注表达式:用 <UND> 给分子字段加下划线当分数线,再换行接分母字段,并可加居中对齐;然后通过 Layer.createLabelClass 创建标注类并开启图层标注。若需要把动态标注固化成可编辑图层,再调用 ConvertLabelsToAnnotation 生成注记要素类即可。整个流程在 ArcGIS Pro(当前最新为 3.7)的 Python 窗口、Notebook 或独立脚本中完成,推荐 Arcade 或 Python 表达式语言。

分式标注效果示意:分子下划线+换行分母

分式标注表达式怎么写

分式标注没有专用工具,完全靠标注表达式里的文本格式化标签实现。官方支持的标签包括 <UND></UND>(下划线)、<ALIGN horizontal=’center’>(水平居中)以及换行。Arcade 里换行用 TextFormatting.NewLine,Python 里用 “\n”,VBScript 里用 vbNewLine。标签必须成对闭合,可嵌套。写好后务必取消勾选“移除额外空格”,否则分数线或换行会异常。

下面是三种常用语言的基础写法(假设分子字段为 MIN、分母字段为 MAX):

语言 表达式示例 备注
Arcade var numerator = $feature.MIN; var denominator = $feature.MAX; return `<align horizontal =’center’><UND>${numerator}</UND>${TextFormatting.NewLine}${denominator}</align>`; 推荐,跨平台稳定
Python “<und>” + [MIN] + “</und>” + “\n” + [MAX] 字段用方括号,简单直接
VBScript “<und>” & [MIN] & “</und>” & vbNewLine & [MAX] Windows 11 新版本可能需额外启用

若分子分母长度差较大,分数线会显得过短。可用自定义函数比较长度(中文字符按双倍宽度计算),在较短一侧补空格后再加 <UND>,让下划线匹配较长一侧。Maplex 标注引擎对多行堆叠支持更好,建议开启。

用 ArcPy 创建标注类的具体步骤

先确保图层已加载到地图,字段存在且类型合适(文本或数值均可)。如果你对 ArcPy 还不熟,建议先过一遍ArcPy入门学习指南(含:arcpy库的详细解答),再回来写脚本。完整操作如下:

  1. 打开 ArcGIS Pro 项目,在 Python 窗口或脚本里 import arcpy。
  2. 获取当前项目、地图和目标图层:aprx = arcpy.mp.ArcGISProject(“CURRENT”);m = aprx.listMaps()[0];lyr = m.listLayers(“你的图层名”)[0]。
  3. 开启标注显示:lyr.showLabels = True。
  4. 创建标注类并写入分式表达式:lc = lyr.createLabelClass(name=”分式标注”, expression=你的表达式字符串, labelclass_language=”Arcade”)(或 “Python”)。把旧标注类的 visible 设为 False,新类设为 True。
  5. 可选:通过 CIM 进一步改字体、大小、颜色。用 lyr.getDefinition(‘V3’) 拿到定义,修改后再 setDefinition 回去,并刷新视图。
  6. 保存项目或直接看地图效果。表达式无效时标签会显示成纯文本,方便排查。

批量给多个图层加同一套分式标注时,可把上述逻辑包进循环。相关代码模板和批量写法可参考ArcPy批量处理怎么做?代码模板哪里找?以及ArcPy自动化脚本怎么写?批量处理如何做?。

用ArcPy设置分式标注类的工作场景

如何把标注转成注记图层

动态标注会随比例尺变化,若要固定位置、可编辑或发布服务,就转成注记要素类(annotation feature class)。官方工具是 arcpy.cartography.ConvertLabelsToAnnotation。主要参数:

  • input_map:传入 Map 对象(不是字符串名称)。
  • conversion_scale:转换时的参考比例尺。
  • output_geodatabase:输出地理数据库路径。
  • 可选择创建标准注记或要素关联注记,也可分组输出图层。

大量标注时优先用 TiledLabelsToAnnotation,配合面索引图层分块处理,性能更好。调用前建议设 arcpy.env.addOutputsToMap = True,输出会自动加到地图。转换后原标注类可关闭,注记图层即可独立调整位置和样式。

操作时要注意的配置与验收

ArcGIS Pro 3.7 系统要求大致为 Windows 11 或 Server 2019/2022/2025(带 Desktop Experience),最低 8 GB 内存(推荐 32 GB)、4 核以上 CPU、足够 SSD 空间,具体以官网最新页为准,可核对ArcGIS Pro 系统要求。需有效 Pro 许可,且制图工具箱可用。数据方面,分子分母字段必须存在,输出注记需要文件地理数据库或企业库。

验收标准很简单:地图上能看到居中分式标签,分数线长度合理;缩放后位置稳定;转注记后要素可单独选中编辑。中文标注注意宽度计算,必要时自定义 strlen 函数。表达式里少写闭合标签或留多余空格,是最常见的显示失败原因。

常见问题

分数线太短,只盖住分子怎么办?

用高级表达式比较分子分母显示宽度(中文按 2 计),在较短一侧补空格后再包 <UND>,并加 <ALIGN> 居中。取消“移除额外空格”后重新应用。

标注类创建了但不显示?

检查 lyr.showLabels = True 和新 LabelClass.visible = True;旧类设为 False;刷新地图或重新打开项目。表达式语法错误时会原样显示文本,对照官方格式化标签检查。

ConvertLabelsToAnnotation 报参数错误?

input_map 必须传 Map 对象而不是名称字符串;确认输出路径可写且有许可。大量数据改用 TiledLabelsToAnnotation 并指定索引图层。

VBScript 表达式在 Windows 11 失效?

直接改用 Arcade 或 Python。若必须用 VBScript,需在系统可选功能里启用相关组件,但长期建议迁移。

总结:分式标注图层 = 正确的 <UND>+换行表达式 + ArcPy 的 createLabelClass 开启 +(可选)ConvertLabelsToAnnotation 固化。先在 Label Class 窗格手动验证表达式,再写成脚本批量应用;需要持久化就转注记。建议从简单 Arcade 居中版本开始,确认效果后再加长度匹配逻辑,并善用本站已有的 ArcPy 入门与批量模板加速开发。