标注 | 说明 | 数据类型 |
输入分类栅格 | 整数类型的输入多维栅格。 | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String |
输出汇总表 | 输出汇总表。 支持地理数据库、数据库、文本、Microsoft Excel 和逗号分隔值 (CSV) 表。 | Table |
尺寸注记 (可选) | 用于汇总的输入维度。 如果存在多个维度,并且未指定任何值,则将使用维度值的所有组合来汇总所有切片。 | String |
感兴趣区域 (可选) | 包含要在计算每个类别的像素计数时使用的一个或多个感兴趣区域的面要素图层。 如果未指定感兴趣区域,则整个栅格数据集将包含在分析中。 | Feature Layer |
感兴趣区域 ID 字段 (可选) | 面要素图层中用于定义每个感兴趣区域的字段。 支持文本和整数字段。 | Field |
获得 Image Analyst 许可后可用。
摘要
在输入分类栅格的每个剖切中生成包含每个类的像素计数的表。
使用情况
使用此工具可为多维分类栅格数据集中的每个切片计算每个类别中的像素数。 例如,对于包含 30 年土地覆被数据的多维栅格,计算每个土地覆被类别中的像素数。
输入栅格数据集必须是整数类型栅格。 如果存在栅格属性表,该工具将使用表中的唯一值来计算像素数。 如果栅格属性表不存在,该工具将扫描像素以查找唯一值。 您可以使用构建栅格属性表工具来构建输入栅格的属性表。
如果输入栅格具有带有 Class_Name 或 ClassName 字段的栅格属性表,则输出表将使用该字段中列出的名称。 否则,输出表将使用来自 Class_Value 或 ClassValue 字段的类值。 字段名称不区分大小写。
受支持的多维栅格数据集包括云栅格格式 (CRF)、多维镶嵌数据集或者由 netCDF、GRIB 或 HDF 格式文件生成的多维栅格图层。
参数
SummarizeCategoricalRaster(in_raster, out_table, {dimension}, {aoi}, {aoi_id_field})
名称 | 说明 | 数据类型 |
in_raster | 整数类型的输入多维栅格。 | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String |
out_table | 输出汇总表。 支持地理数据库、数据库、文本、Microsoft Excel 和逗号分隔值 (CSV) 表。 | Table |
dimension (可选) | 用于汇总的输入维度。 如果存在多个维度,并且未指定任何值,则将使用维度值的所有组合来汇总所有切片。 | String |
aoi (可选) | 包含要在计算每个类别的像素计数时使用的一个或多个感兴趣区域的面要素图层。 如果未指定感兴趣区域,则整个栅格数据集将包含在分析中。 | Feature Layer |
aoi_id_field (可选) | 面要素图层中用于定义每个感兴趣区域的字段。 支持文本和整数字段。 | Field |
代码示例
本示例将生成一个表,其中包含感兴趣区域内波士顿地区 20 年的土地覆被数据中每个土地覆被类别的像素计数。
# Import system modules
import arcpy
from arcpy.ia import *
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
arcpy.ia.SummarizeCategoricalRaster("BostonLandCover2000_2020.crf",
"C:\Data\MyData.gdb\BostonLandCoverSummary", "StdTime", "C:\Data\MyData\AOI",
"Districts")
本示例生成一个表,其中包含感兴趣区域内年度数据中每个火灾风险类的像素计数。
# Import system modules
import arcpy
from arcpy.ia import *
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Define input parameters
inputRaster = "C:/Data/YearlyFireRisk.crf"
outputTable = "C:/Data/FireRiskSummary.csv"
dimension = "StdTime"
aoi = "C:/Data/MyData.gdb/SanBernardinoMountainRange"
aoi_id_field = "WATERSHEDS"
# Execute
arcpy.ia.SummarizeCategoricalRaster(inputRaster, outputTable, dimension, aoi, aoi_id_field)
环境
许可信息
- Basic: 需要 Image Analyst
- Standard: 需要 Image Analyst
- Advanced: 需要 Image Analyst