分区几何统计 (空间分析)

需要 Spatial Analyst 许可。

摘要

为数据集中的各个区域计算指定的几何测量值(面积、周长、厚度或者椭圆的特征值)。

了解有关“分区几何统计”工作原理的详细信息

插图

分区几何图解
OutRas = ZonalGeometry(InRas1,"VALUE","AREA")

使用情况

  • 区域定义为输入中具有相同值的所有区域。 各区域无需相连。 栅格和要素都可用于区域输入。

  • 输出像元大小参数可以通过数值进行定义,也可以从现有栅格数据集获取。 如果没有将像元大小明确指定为参数值,则将从像元大小环境获取相应值(前提是已指定环境)。 如果参数像元大小和环境像元大小均未指定,则默认的输出像元大小会根据输入数据集的类型,按照如下所示方式进行确定。

    • 如果输入数据集是栅格,则使用数据集的像元大小。
    • 如果输入数据集为要素,且设置了捕捉栅格环境,则使用捕捉栅格的像元大小。 如果未设置捕捉栅格,则像元大小会通过使用范围的宽度或高度中的较小值除以 250 来计算,其中范围位于在环境中指定的输出坐标系内。
  • 如果使用数值指定像元大小,则工具会直接将其用于输出栅格。

    如果使用栅格数据集指定像元大小,则该参数将显示栅格数据集的路径而不是像元大小的值。 如果数据集的空间参考与输出空间参考相同,则栅格数据集的像元大小将直接用于分析。 如果数据集的空间参考与输出空间参考不同,则将基于所选的像元大小投影方法进行投影。

  • 如果输入栅格或要素区域数据的值具有重叠面,则无法为每一个单独的面执行区域分析。 因为要素输入已转换为栅格,所以每个位置只能拥有一个值。

    另一种方法就是要为每个面区域反复进行区域操作并核对结果。

  • 在指定输入栅格或要素区域数据值时,默认区域字段将为第一个可用的整型或文本字段。 如果不存在其他有效字段,则 ObjectID 字段(如 OIDFID)将成为默认字段。

  • 各几何类型的输出栅格的数据类型将为浮点型。

  • 如果特定区域仅由一个像元组成,或者该区域是单个方形像元块,则椭圆(在本例中为圆)的方向设置为 90 度。

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

参数

标注说明数据类型
输入栅格数据或要素区域数据

定义区域的数据集。

可通过整型栅格或要素图层来定义区域。

Raster Layer; Feature Layer
区域字段

包含定义每个区域的值的字段。

必须是区域数据集的整型字段。

Field
几何类型
(可选)

要计算的几何类型。

  • 面积各个区域的面积。
  • 周长各个区域的周长。
  • 厚度区域中最深(或最厚)的点距其周围像元的距离。
  • 质心定位每个分区的质心。
String
输出像元大小
(可选)

将创建的输出栅格的像元大小。

此参数可以通过数值进行定义,也可以从现有栅格数据集获取。 如果未将像元大小明确指定为参数值,则将使用环境像元大小值(如果已指定);否则,将使用其他规则通过其他输出计算像元大小。 有关详细信息,请参阅用法部分。

Analysis Cell Size

返回值

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

输出分区几何栅格。

Raster

ZonalGeometry(in_zone_data, zone_field, {geometry_type}, {cell_size})
名称说明数据类型
in_zone_data

定义区域的数据集。

可通过整型栅格或要素图层来定义区域。

Raster Layer; Feature Layer
zone_field

包含定义每个区域的值的字段。

必须是区域数据集的整型字段。

Field
geometry_type
(可选)

要计算的几何类型。

  • AREA各个区域的面积。
  • PERIMETER各个区域的周长。
  • THICKNESS区域中最深(或最厚)的点距其周围像元的距离。
  • CENTROID定位每个分区的质心。
String
cell_size
(可选)

将创建的输出栅格的像元大小。

此参数可以通过数值进行定义,也可以从现有栅格数据集获取。 如果未将像元大小明确指定为参数值,则将使用环境像元大小值(如果已指定);否则,将使用其他规则通过其他输出计算像元大小。 有关详细信息,请参阅用法部分。

Analysis Cell Size

返回值

名称说明数据类型
out_raster

输出分区几何栅格。

Raster

代码示例

ZonalGeometry 示例 1(Python 窗口)

本示例为输入面要素定义的各个区域确定面积。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalGeometry = ZonalGeometry("zones.shp", "Classes", "AREA", 0.2)
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout3")
ZonalGeometry 示例 2(独立脚本)

本示例为输入面要素定义的各个区域确定面积。

# Name: ZonalGeometry_Ex_02.py
# Description:Calculates for each zone in a dataset the specified geometry 
#   measure (area, perimeter, thickness, or the characteristics 
#   of ellipse).
# 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
inZoneData = "zones.shp"
zoneField = "Classes"
cellSize = 0.2

# Execute ZonalStatistics
outZonalGeometry = ZonalGeometry(inZoneData, zoneField, "AREA", cellSize)  

# Save the output 
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout2")