ArcPy 逻辑判断代码怎么写

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

ArcPy 逻辑判断代码用 Python 的 if、elif、else,配合 arcpy.Exists、Describe、ListFields、GetCount_management 等函数返回的布尔值或属性做分支;栅格条件必须用 arcpy.sa.Con(或栅格计算器),不能直接对 Raster 对象写 Python 布尔运算。独立脚本直接写 if;ModelBuilder 可用内置逻辑工具或 Calculate Value / 脚本工具输出布尔值控制流程。

ArcPy 逻辑判断代码编写与分支流程示意

独立脚本里常用条件怎么写

先明确要解决的问题:数据是否存在、字段是否齐全、要素类型或坐标系是否符合预期、行数是否大于 0。再把判断写进 if,避免盲目跑工具报错。

  1. 检查数据是否存在:用 arcpy.Exists(dataset),返回 True/False。典型写法:if arcpy.Exists(“roadbuffer”): arcpy.management.Delete(“roadbuffer”)。支持要素类、表、shapefile、工作空间、图层、文件等。
  2. 按数据类型或几何类型分支:用 arcpy.Describe(或 arcpy.da.Describe)。例如 desc = arcpy.Describe(fc);if desc.shapeType == “Polygon”: 执行面相关工具,elif desc.dataType == “FeatureClass”: 继续其他处理。
  3. 检查字段是否存在:用 arcpy.ListFields(dataset, wild_card, field_type)。判断示例:if len(arcpy.ListFields(fc, “ST_NAME”)) != 1: 提示字段缺失并跳过或添加字段。
  4. 按行数或选择集判断:result = arcpy.management.GetCount(fc);if int(result[0]) > 0: 才做后续分析。也可结合 Describe 的 FIDSet 判断选择集是否为空。

以上写法在 ArcGIS Pro 自带的 arcgispro-py3 环境中直接可用。更完整的 Exists 说明见 arcpy.Exists 官方文档。

函数 主要用途 典型判断写法
Exists 数据是否存在 if arcpy.Exists(path):
Describe 类型、坐标系、几何 if desc.shapeType == “Polygon”:
ListFields 字段是否存在/类型 if len(ListFields(fc, “NAME”)) == 1:
GetCount 行数是否大于 0 if int(result[0]) > 0:

栅格条件判断怎么正确写

栅格不能直接写 if elev > 1000,会触发 “truth value of a raster is ambiguous” 错误。正确做法是用 Spatial Analyst 的 Con(或 Image Analyst 同类工具)以及 Test、栅格计算器。

  • 单条件:Con(Raster(“elev”) > 1000, 0, 1),满足条件赋 0,否则赋 1。
  • 多条件(模拟 if-elif):嵌套 Con,或先用多个条件栅格再组合。
  • 带 where_clause 的 Con 也可按属性表达式筛选。

验收标准:输出栅格无 NoData 异常扩大,且像元值符合预期条件;运行前确认 Spatial Analyst 扩展已 CheckOut。

ModelBuilder 里怎么做 if-then-else

ModelBuilder 提供现成逻辑工具,输出布尔值控制下游是否执行,也可用 Calculate Value 或自定义脚本工具返回 True/False。

  • 常用逻辑工具:如果数据已存在、如果字段已存在、如果选择已存在、如果坐标系为、如果数据类型为、如果要素类型为、如果字段值为、如果行计数为、如果空间关系为、如果值为、如果表达式为,以及合并分支、停止等。
  • 自定义方式:在 Calculate Value 里写短 Python 函数测试 arcpy 条件并返回布尔;或做成脚本工具,内部用 Describe / Exists 判断后 arcpy.SetParameterAsText 输出布尔参数。

官方对分支与逻辑工具的说明见 ArcGIS Pro if-then-else 分支与逻辑工具帮助。截至 2026 年 11 月,ArcGIS Pro 一般为 3.7 系列(3.8 计划同期发布),具体逻辑工具列表以当前安装版本帮助为准。

ArcGIS Pro 官方 if-then-else 分支与逻辑工具帮助页面
ArcGIS Pro 官方 if-then-else 分支与逻辑工具帮助页面(截图来源:pro.arcgis.com)

写逻辑判断时要注意什么、出错怎么办

优先用 if 做前置检查,再配合 try/except,减少半途失败。

  1. 删除或覆盖前先 Exists,避免 “不存在” 报错。
  2. 对工具调用包 try: … except arcpy.ExecuteError: 打印 arcpy.GetMessages(2);需要时再 except Exception。
  3. 扩展工具用完后在 finally 里 CheckInExtension。
  4. 路径、工作空间、图层名大小写和引号要一致;相对路径依赖当前环境设置。

验收标准:条件为假时跳过正确分支且不抛未捕获异常;条件为真时工具成功执行并写出预期结果;消息窗口能看到自定义 AddMessage 提示。

常见问题

为什么不能对栅格直接写 if Raster > 1000?

Python 无法对整个栅格求单一真假值,会报 truth value of a raster is ambiguous。改用 Con、Test 或栅格计算器表达条件。

Exists 和 ListFields 哪个适合查字段?

查字段是否存在用 ListFields(可按名称、类型过滤);Exists 用于整个数据集/图层/文件是否存在,两者常配合使用。

脚本工具如何把判断结果传给模型分支?

在脚本里根据条件调用 arcpy.SetParameterAsText 输出 True 或 False 布尔参数,模型用该参数连接下游工具或合并分支。

GetCount 结果怎么转成可比较的整数?

result = arcpy.management.GetCount(fc) 后使用 int(result[0]) 再与阈值比较;不要直接拿 Result 对象做数值运算。

总结:ArcPy 逻辑判断的核心是把 Exists、Describe、ListFields、GetCount 等结果放进 if/elif,栅格一律走 Con;模型里优先用官方逻辑工具,复杂条件再写脚本。建议先从 “存在则删除再创建” 的 Exists 判断练起,再对照当前 Pro 版本帮助验证 Describe 属性和逻辑工具名称。