合并 (空间分析)

摘要

合并多个栅格,以便为每个唯一的输入值组合分配唯一的输出值。

插图

“合并”图示
OutRas = Combine([InRas1, InRas2])

使用情况

  • 合并工具可用于处理整数值及其关联属性表。 如果输入上的值为浮点型,则将自动对其进行截断,并测试与其他输入的唯一性,然后将其发送到输出属性表。

  • 将多波段栅格指定为输入栅格参数值(Python 中的 in_rasters)之一时,将使用所有波段。

    要处理一系列来自多波段栅格的波段,请首先使用波段合成工具创建由这些特定波段组成的栅格数据集;然后在输入栅格参数(Python 中的 in_rasters)中使用列表中的结果。

  • 输出栅格始终为整型。

  • 每个栅格输入由输出栅格属性表 (RAT) 中的字段表示,其中输出中的字段顺序与输入栅格的顺序相匹配。

    如果存在多波段输入,则输出将每个波段标识为单个栅格,并且将创建相应数量的字段。

    如果多次使用同一栅格,则会将其视为单个输入;但是,将会返回警告。

  • 输出 RAT 中的字段名称基于栅格数据集名称。 如果字段名太长,则将对其进行截断以符合字段名长度限制。 数据库不支持的栅格名称中的任何特殊字符都将替换为下划线。

    对于多波段输入,字段名将由以下划线分隔的两部分组成。 第一部分源自栅格名称,后跟波段索引,从 1 开始。

    对于重复字段名称,通过使用从 1 开始的索引修改栅格名称,可使每个后续字段名唯一。

  • 有关适用于此工具的地理处理环境的详细信息,请参阅分析环境和 Spatial Analyst

参数

标注说明数据类型
输入栅格

要合并的输入栅格列表。

Raster Layer

返回值

标注说明数据类型
输出栅格

输出已合并栅格。

将为输入值的每个唯一组合分配唯一整数值。

Raster

Combine(in_rasters)
名称说明数据类型
in_rasters
[in_raster,...]

要合并的输入栅格列表。

Raster Layer

返回值

名称说明数据类型
out_raster

输出已合并栅格。

将为输入值的每个唯一组合分配唯一整数值。

Raster

代码示例

Combine 示例 1(Python 窗口)

本示例将使用不同格式(Grid、IMG 和 TIFF)的多个输入栅格,并将唯一组合值输出为 Grid 栅格。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCombine = Combine(["filter", "zone", "source.img", "dec.tif"])
outCombine.save("C:/sapyexamples/output/outcombine2")
Combine 示例 2(独立脚本)

本示例将使用不同格式(Grid、IMG 和 TIFF)的多个输入栅格,并将唯一组合值输出为 Grid 栅格。

# Name: Combine_Ex_02.py
# Description: Combines multiple rasters such that a unique value is
#              assigned to each unique combination of input values
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster01 = "filter"
inRaster02 = "zone"
inRaster03 = "source.img"
inRaster04 = "dec.tif"

# Execute Combine
outCombine = Combine([inRaster01,inRaster02,inRaster03,inRaster04])

# Save the output 
outCombine.save("C:/sapyexamples/output/outcombine")