ArcPy调用分析工具完成叠加分析
用 ArcPy 调用分析工具箱 Overlay 工具集中的 Intersect、Union、Erase 等工具,就能脚本化完成要素叠加,把多组输入要素按空间关系合并并写出新要素类。推荐使用模块化写法如 arcpy.analysis.Intersect(in_features, out_feature_class, join_attributes=”ALL”),可配合工作空间与并行处理环境批量跑土地利用与土壤、宗地与洪泛区一类问题。截至 2026 年 11 月,这些工具随 ArcGIS Pro 3.7 提供,Advanced 许可输入数量无限制,Basic/Standard 对 Intersect、Union 通常限两个输入。导入 arcpy 后设置环境即可执行,无需额外安装。

叠加分析要解决什么问题
Overlay 工具集的核心是把两组或多组要素合并成一组,识别它们之间的空间关系并保留或更新属性。典型问题包括:某类土地利用落在哪些土壤类型上、哪些宗地位于百年一遇洪泛区、道路缓冲区内有哪些植被斑块。工具输出始终是新要素类,原数据不变。这与 Spatial Analyst 的栅格加权叠加不同,这里处理的是矢量要素(点、线、面)。
常用工具包括 Intersect(相交)、Union(联合)、Erase(擦除)、Identity(标识)、Symmetrical Difference(交集取反)和 Update(更新)。还有 Pairwise Intersect、Pairwise Erase 等替代工具,在大数据或性能敏感场景下可优先考虑。门户版 Overlay Layers 与 GeoAnalytics 版主要用于在线或大数据服务,本地脚本日常叠加仍以 arcpy.analysis 模块为主。
怎么选合适的叠加工具
选工具先看输入几何类型和业务目标:要保留重叠部分就用 Intersect,要全部合并用 Union,要挖掉某区域用 Erase。下表按常见场景整理(以 ArcGIS Pro 3.7 官方许可与几何要求为准)。
| 工具 | 主要作用 | 输入几何要求 | 许可要点 |
|---|---|---|---|
| Intersect | 计算几何交集,只输出重叠部分 | 点、多点、线、面均可,支持多图层 | Basic/Standard 通常限 2 个输入;Advanced 无限制 |
| Union | 计算几何并集,输出全部要素及属性 | 全部必须是面 | 同上,Basic/Standard 输入数量受限 |
| Erase | 擦除与擦除要素重叠的部分,只保留外部 | 擦除要素几何类型需匹配或高于输入 | Basic 及以上可用 |
| Identity | 交集部分获得标识要素属性 | 输入与标识要素兼容 | 仅 Advanced |
| Symmetrical Difference | 返回不重叠部分 | 输入与更新要素 | 仅 Advanced |
| Update | 用更新要素更新输入几何与属性 | 输入与更新要素 | 仅 Advanced |
若数据量大或需要更好并行表现,可改用对应 Pairwise 工具。属性连接方式常用 ALL(保留所有字段)、NO_FID 或 ONLY_FID。输出类型默认为最低维度,也可显式指定。
ArcPy 调用叠加工具的具体步骤
面向可执行脚本,按下面顺序操作即可验收结果。建议在 ArcGIS Pro Python 窗口、Notebook 或配置了 arcgispro-py3 的独立环境中运行。
- 导入 arcpy,并确认许可已初始化。详细导入方式可参考 ArcPy 导入官方说明。
- 设置工作空间与覆盖选项:arcpy.env.workspace 指向文件地理数据库或文件夹;arcpy.env.overwriteOutput = True 避免输出已存在报错;需要时可设 parallelProcessingFactor 与输出坐标系。
- 准备输入要素列表或图层名。Intersect、Union 可接受多个要素类组成的列表;确保几何类型符合工具要求,必要时先做 Check Geometry。
- 调用工具。例如 Intersect:arcpy.analysis.Intersect([“vegetation_stands”, “road_buffer200m”], “mysites”, “ALL”)。Union 与 Erase 语法类似,参数顺序以官方帮助为准,推荐使用关键字参数写清 join_attributes、cluster_tolerance、output_type。
- 检查输出:用 arcpy.Exists 或添加图层到地图,核对要素数量与属性字段是否符合预期;大结果建议输出到文件地理数据库而非 shapefile。
验收标准:脚本无报错退出、输出要素类存在且几何类型正确、重叠区域属性按 join_attributes 规则保留、无效几何已提前修复。批量时可把上述步骤包进循环或函数,并对每次调用包 try-except arcpy.ExecuteError,打印 arcpy.GetMessages(2)。

参数、环境与许可要注意什么
- cluster_tolerance:一般留空使用默认 XY 容差,随意改动易引发拓扑错误。
- join_attributes:ALL 最常用;只关心 FID 时用 ONLY_FID 可减小输出体积。
- output_type:默认跟随最低维度输入,需要强制面或线时显式指定合法关键字。
- 并行与切片:面-面、线-面、点-面叠加可启用 Parallel Processing Factor(最多约 10 核);超大范围会自动切片,避免网络路径与 shapefile。
- 许可限制:Basic/Standard 下 Intersect、Union 输入通常限 2 个,超出需分步处理或升级 Advanced;Identity、Update、Symmetrical Difference 仅 Advanced。Erase、多数 Pairwise 工具 Basic 即可。
- 几何预处理:复杂要素、注记不支持;多部件可用 Multipart To Singlepart 拆分;坏几何先 Repair Geometry。
环境设置优先于工具参数。输出坐标系、XY 容差、地理变换等在 env 中统一配置,保证多工具链式调用一致。
常见问题
Basic 或 Standard 许可下 Intersect 只能输入两个图层怎么办?
官方限制下可先两两相交,把中间结果再与第三个图层相交,或升级到 Advanced。也可用 Pairwise Intersect 分步处理,注意中间结果及时清理。
报 ERROR 000732 或 000210 找不到数据集、无法创建输出怎么处理?
检查路径是否绝对、工作空间是否正确设置、输出是否已存在且被锁。先 arcpy.Exists 验证输入,设 overwriteOutput=True,关闭其他占用该数据的 ArcGIS 会话,优先输出到文件地理数据库。
出现 Invalid Topology 或 Topoengine 错误是什么原因?
输入含无效几何。先用 Check Geometry 检查,再用 Repair Geometry 修复;不要随意修改默认 cluster_tolerance。修复后再跑叠加。
大数据叠加很慢或结果不完整怎么优化?
改用文件地理数据库、启用并行处理因子、避免网络盘与 shapefile、必要时改用 Pairwise 工具或按范围切片处理。属性字段过多时可只保留必要字段。
叠加分析的核心是选对工具、控制输入几何与许可限制,再用 arcpy.analysis 模块写成可重复脚本。建议先用小范围数据验证参数与输出字段,确认无误后再放大到全库;同时把 Check/Repair Geometry 与 Exists 检查固化进脚本,减少后期返工。