ArcMap

区域分组

需要 Spatial Analyst 许可。

描述

记录输出中每个像元所属的连接区域的标识。系统将会为每个区域分配唯一编号。

了解有关使用“区域分组”创建单独区域的详细信息

插图

区域分组插图
OutRas = RegionGroup(InRas1)

使用

  • 扫描的第一个区域接收值为 1，第二个区域接收值为 2，依此类推，直到所有区域均已赋值。扫描将按从左至右、从上至下的顺序进行。分配给输出分区的值取决于系统对其进行扫描的时间。

  • 默认情况下，为输出数据增加链接字段（Python 中的 ADD_LINK）选项已启用。这将在输出栅格的属性表中创建名为 LINK 的项，其保留输入栅格的每个像元的原始值。

  • LINK 字段用于追踪每个新创建的查询或分析区域的来源。

    例如，上图所示的输出栅格的属性表如下：

    属性表中 LINK 项的示例

  • 如果不创建 LINK 字段，它将会显著加速处理过程。如果不再需要每个区域的原始值，请取消选中此选项。

  • 利用环境掩膜设置，可改变输出栅格中的空间配置和区域数。

  • 对区域 (region) 而非区域 (zone) 进行分析时，区域分组特别有用。由于维护输入分区值，因此在分析中也可使用原始分区分类。

  • 输出时，包含排除值的像元位置会接收零，因此，这些区域便不会与现有 NoData 像元位置相混淆。由于区域分组的编号从值 1 开始，因此被排除在重新分组操作之外的像元将被视为背景。这些背景像元可被重新分类或处理为任何其他值。使用条件函数工具，可将包含排除值的位置轻松地转换为 NoData。

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

语法

RegionGroup(in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})
参数说明数据类型
in_raster

将标识唯一连接区域的输入栅格。

必须为整型。

Raster Layer
number_neighbors
（可选）

在评估像元间的连接时使用的相邻像元数。

  • FOUR —仅当具有相同值的像元与上下左右四个最邻近像元中的每一个像元直接连接时，才会定义这些像元之间的连通性。如果两个具有相同值的像元彼此只是对角线连接，则其不会被视为相连接。这是默认设置。
  • EIGHT —仅当具有相同值的像元位于彼此最近的 8 像元邻域内（8 个最邻近像元）时，才会定义这些像元间的连通性。其中包括彼此之间的上下左右或对角线连接。
String
zone_connectivity
（可选）

定义在进行连通性测试时应考虑的像元值。

  • WITHIN —测试同一区域内相同输入值间的连通性。只能对满足空间连通性要求（由四向或八向 number_neighbors 参数指定）的同一区域（值）中的像元进行分组。这是默认设置。
  • CROSS —对于具有值（不包括由 number_neighbors 参数排除的值）的像元，按照由 excluded_value 参数指定的空间要求测试像元间的连通性。使用 CROSS 时，必须输入 {excluded_value} 参数的值。
String
add_link
（可选）

指定是否将链接字段添加到输出的表中。

  • ADD_LINK —将一个 LINK 项添加到输出栅格的表中。该项为重新分组之前的输入栅格的不相连区域中的每个新创建区域存储原始值。这是默认设置。
  • NO_LINK —输出栅格的属性表仅包含 Value 和 Count 项。
Boolean
excluded_value
（可选）

标识一个值，这样一来，如果像元位置包含该值，则不管将邻近像元数指定为多少（FOUR 或 EIGHT），都不会评估空间连通性。

具有排除的值的像元将被视为 NoData，并被从计算中排除。在输出栅格上，包含排除的值的像元位置将接收 0。

排除的值类似于背景值或在工具的单一运行环境中设置掩膜的概念。如果关键字指定为 CROSS，则必须为此参数指定值。

Long

返回值

名称说明数据类型
out_raster

输出区域分组栅格。

输出始终为整型。

Raster

代码示例

RegionGroup 示例 1（Python 窗口）

此示例使用八向连接方法为输入栅格的每个区域分配一个唯一编号。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRgnGrp = RegionGroup("land", "EIGHT", "", "", 5)
outRgnGrp.save("c:/sapyexamples/output/reggrp_ex5")
RegionGroup 示例 2（独立脚本）

此示例使用具有排除的值的八向连接方法为输入栅格的每个区域分配一个唯一编号。

# Name: RegionGroup_Ex_02.py
# Description: Records, for each cell in the output, the
#              identity of the connected region to which 
#              it belongs within the Analysis window. A 
#              unique number is assigned to each region.
# 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
inRaster = "land"
valToIgnore = 5

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS", 
                           "NO_LINK", valToIgnore)

# Save the output 
outRegionGrp.save("C:/sapyexamples/output/reggrpout")

环境

许可信息

  • Basic: 需要 Spatial Analyst
  • Standard: 需要 Spatial Analyst
  • Advanced: 需要 Spatial Analyst

相关主题