ArcPy栅格运算与Map Algebra
ArcPy 栅格运算的核心就是 Map Algebra(地图代数):用代数表达式直接调用 Spatial Analyst 的工具、运算符和函数,对栅格做逐像元计算。写法上,输出栅格写在等号左边,工具或运算符及其参数写在右边;执行前需检出 Spatial Analyst 或 Image Analyst 许可,输入一般要先转成 Raster 对象。返回的 Raster 默认是临时数据,会话结束或变量出作用域就会被删掉,必须调用 save 才能永久落盘。脚本里应直接写 Map Algebra,不要去调栅格计算器工具。

用 ArcPy 做栅格运算的基本步骤
要解决的问题很明确:在 Python 脚本或 Notebook 里对一张或多张栅格做加减、条件、地形分析等,并得到可复用的结果图层。可执行流程如下。
- 确认已安装 ArcGIS Pro(文档以 3.7 为准),并具备 Spatial Analyst 或 Image Analyst 许可。
- 导入模块并检出扩展:先 import arcpy,再 from arcpy import env,再 from arcpy.sa import *;然后执行 arcpy.CheckOutExtension(“Spatial”)(Image Analyst 则用 “ImageAnalyst”)。
- 设置环境:至少设好 env.workspace,按需设范围、像元大小、掩膜、捕捉栅格等,避免输出范围或分辨率和预期不一致。
- 把输入栅格转成 Raster 对象,再写 Map Algebra 表达式,例如 out = Raster(“r1.tif”) + Raster(“r2.tif”),或 outShade = Hillshade(“inelevation.tif”, 99, 33)。
- 对结果调用 save,写入工作空间或绝对路径;需要时再 CheckInExtension 归还许可。
验收标准:脚本无报错跑完;输出栅格存在且范围、像元大小符合环境设置;像元值与手工用同表达式在栅格计算器里算的结果一致。Map Algebra 的官方快速说明见 ArcGIS Pro Map Algebra 快速入门。
Raster 对象:创建、临时结果与保存
Raster 对象是脚本和 Map Algebra 表达式里引用栅格数据集的变量。常见来源有三种:用已有栅格路径创建、用 RasterInfo 创建,或作为某条 Map Algebra 语句的返回值。只有检出 Spatial Analyst 或 Image Analyst 后,Map Algebra 语句才能正常返回 Raster。
- 从路径创建:Raster(“某栅格路径或图层名”),之后才能参与加、减、逻辑与等运算;不转换时,运算符往往按 Python 标量逻辑处理,得不到逐像元结果。
- 临时性:Map Algebra 返回的 Raster 默认临时,变量被覆盖、出作用域或会话结束就会删除。
- 永久保存:对结果对象调用 save(“输出名或完整路径”);复杂中间结果若后面还要用,也应及时 save 或赋给仍在作用域内的变量。
更多构造与行为说明可对照 ArcPy Raster 对象说明。工具若输出的是要素或表而不是栅格,输出路径应写在工具参数里,而不是写在等号左边。

运算符类别与正确写法
要对栅格做逐像元运算,必须保证参与运算的是 Raster 对象;两个输入都是普通数字时,用的是 Python 自身运算符。运算符在 Spatial Analyst / Image Analyst 的 ArcPy 模块里做了重载,大致分四类:
| 类别 | 常见符号 | 栅格场景下的含义 |
|---|---|---|
| 算术 | 加、减、乘、除、幂、整除、取余 | 逐像元加减乘除、幂运算、整除、取余 |
| 关系 | 等于、不等于、大于、大于等于、小于、小于等于 | 逐像元比较,常得到 0/1 条件栅格 |
| 布尔 | 与、或、异或、非 | 逐像元逻辑与、或、异或、非 |
| 按位 | 左移、右移 | 逐像元按位移动 |
算术里常用的符号包括 +、-、*、/,以及幂、整除、取余对应的运算符;布尔常用 &、|、^、~。连续写关系或布尔运算时必须加括号,例如 (Raster(“a”) > 2) & (Raster(“a”) < 5);不要写成 a < b < c 这种 Python 链式比较,应改成 (a < b) & (b < c)。工具和运算符可以嵌套,用括号明确优先级。需要邻域、重分类等多参数输入时,先把 NbrCircle、RemapRange 等类赋给变量再传入,表达式会清晰很多。运算符总览见 Map Algebra 运算符概览,用法细节见 使用运算符说明。
环境设置与复杂表达式要注意什么
跑运算前先定环境,比事后改结果省事。优先检查:当前工作空间、处理范围、像元大小及像元大小投影方法、掩膜、捕捉栅格。范围和像元大小不一致时,输出往往对不齐或分辨率被意外重采样。
- 单行能写完的代数用 Map Algebra;栅格计算器适合在 Geoprocessing 窗格或 ModelBuilder 里点选,不进入 ArcPy Spatial Analyst 模块,脚本中应改用 sa 运算符和工具。
- 复杂类参数先变量化,再嵌进表达式,便于调试和复用。
- 同一会话里多次运算时,注意临时 Raster 是否仍被变量引用;不需要的中间结果及时删变量或显式 save,避免磁盘被临时数据占满。
- 许可:Basic 等较低许可下部分功能受限;浮动许可务必 CheckOut / CheckIn,避免占着扩展不放。
截至 2026 年 11 月,ArcGIS Pro 3.7 文档中的 Map Algebra 核心语法与上述写法一致;Spatial Analyst 在 3.7 有工具级更新,但不改变“表达式 + Raster 对象 + save”这一套用法。
常见问题
为什么写了 r1 + r2 却不像在做栅格运算?
多半是输入还没转成 Raster 对象。先写成 Raster(“r1”) + Raster(“r2”),并确认已 from arcpy.sa import * 且检出了 Spatial 扩展,才会走逐像元的 ArcPy 运算符。
结果栅格跑完找不到,是不是丢了?
Map Algebra 返回的默认是临时 Raster,变量被覆盖或脚本结束就会删。对结果调用 save,并确认 env.workspace 或传入的路径可写。
布尔条件一长串就报错,怎么改?
给每一段关系运算加括号,再用 & 或 | 连接,例如 (Raster(“a”) > 2) & (Raster(“a”) < 5)。不要依赖 Python 的 a < b < c 写法。
脚本里能调用栅格计算器工具吗?
官方定位是:栅格计算器给界面和 ModelBuilder 用,不用于替代脚本里的 Spatial Analyst 工具。脚本请直接写 Map Algebra 运算符和 sa 模块工具。
做 ArcPy 栅格处理时,先检出许可、设好环境和 Raster 转换,再写带括号的清晰表达式,最后务必 save。建议把常用邻域、重分类参数提成变量,并固定一套范围与像元大小模板,这样同一套 arcpy 栅格处理脚本换数据也能稳定复现。