构建栅格属性表 (数据管理)

摘要

使用有关栅格数据集中各个类的信息创建或更新表。此方法主要用于离散数据。

使用情况

• 要删除现有表并创建一个新表，请选中覆盖（Python 中为 overwrite = "OVERWRITE"）。将创建新的栅格属性表并删除原有表。

• 如果您现已具有一个表并且未选中覆盖，则将对该表进行更新。不会删除任何字段，但是表中的值将更改为最新值。

• 不能为 32 位浮点像素类型的栅格数据集构建栅格属性表。

• 可以为多维数据集生成属性表。针对多维镶嵌数据集或多维栅格使用此工具时，输出表将包含每个切片中每个类的像素计数。Count_S0 字段将包含数据集第一个切片中每个类的像素计数。Count_S1 字段将包含第二个切片中每个类的像素计数，依此类推。变量必须包含类别数据，例如土地覆被。

参数

对话框

标注	说明	数据类型
输入栅格	将向其添加表格的输入栅格数据集。如果像素类型为浮点型或双精度，此工具则不会运行。	Raster Layer
覆盖 (可选)	指定现有表是否将被覆盖。 无—现有的栅格属性表将不会被覆盖，所有编辑都将追加到当前表中。这是默认设置。 覆盖—现有的栅格属性表将被覆盖，并将创建一个新的栅格属性表。	Boolean

派生输出

标注	说明	数据类型
更新的输入栅格	输出栅格数据集。	栅格图层

Python

arcpy.management.BuildRasterAttributeTable(in_raster, {overwrite})

名称	说明	数据类型
in_raster	将向其添加表格的输入栅格数据集。如果像素类型为浮点型或双精度，此工具则不会运行。	Raster Layer
overwrite (可选)	指定是否要覆盖现有表。 NONE—现有的栅格属性表将不会被覆盖，所有编辑都将追加到当前表中。这是默认设置。 Overwrite—现有的栅格属性表将被覆盖，并将创建一个新的栅格属性表。	Boolean

派生输出

名称	说明	数据类型
out_raster	输出栅格数据集。	栅格图层

代码示例

BuildRasterAttributeTable 示例（Python 窗口）

这是 BuildRasterAttributeTable 工具的 Python 示例。

import arcpy
arcpy.BuildRasterAttributeTable_management("c:/data/image.tif", "Overwrite")

BuildRasterAttributeTable 示例 2（独立脚本）

这是 BuildRasterAttributeTable 工具的 Python 脚本示例。

##====================================
##Build Raster Attribute Table
##Usage: BuildRasterAttributeTable_management in_raster {NONE | Overwrite}
    
import arcpy
arcpy.env.workspace = "C:/Workspace"

##Build attribute table for single band raster dataset
##Overwrite the existing attribute table file
arcpy.BuildRasterAttributeTable_management("image.tif", "Overwrite")

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是