将栅格属性表添加至栅格数据集或者更新现有数据集。 此方法主要用于离散数据。
要删除现有表并创建一个新表，请选中覆盖参数。 将创建一个新的栅格属性表，并删除现有的栅格属性表。
如果您现已有一个表并且未选中覆盖参数，则将对该表进行更新。 不会删除任何字段，但会更新表中的值。
不能为 32 位浮点像素类型的栅格数据集构建栅格属性表。
可以为多维数据集生成属性表。 针对多维镶嵌数据集或多维栅格使用此工具时，输出表将包含每个切片中每个类的像素计数。 Count_S0 字段将包含数据集第一个切片中每个类的像素计数。 Count_S1 字段将包含第二个切片中每个类的像素计数，依此类推。 变量必须包含类别数据，例如土地覆被。
| 标注 | 说明 | 数据类型 |
输入栅格 | 将向其添加表格的输入栅格数据集。 如果像素类型为浮点型或双精度，此工具则不会运行。 | Raster Layer |
覆盖 (可选) | 指定现有表是否将被覆盖。
| Boolean |
转换色彩映射表 (可选) | 指定是否将色彩映射表转换为栅格属性表。 输出栅格属性表将具有包含色彩映射表中颜色值的 Red、Green 和 Blue 字段。 这些字段定义了相应类值的显示颜色。 此参数仅在输入栅格参数值包含关联的色彩映射表时适用。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 更新的输入栅格 | 输出栅格数据集。 | Raster Layer |
arcpy.management.BuildRasterAttributeTable(in_raster, {overwrite}, {convert_colormap})| 名称 | 说明 | 数据类型 |
in_raster | 将向其添加表格的输入栅格数据集。 如果像素类型为浮点型或双精度，此工具则不会运行。 | Raster Layer |
overwrite (可选) | 指定现有表是否将被覆盖。
| Boolean |
convert_colormap (可选) | 指定是否将色彩映射表转换为栅格属性表。 输出栅格属性表将具有包含色彩映射表中颜色值的 Red、Green 和 Blue 字段。 这些字段定义了相应类值的显示颜色。 此参数仅在输入栅格参数值包含关联的色彩映射表时适用。
| Boolean |
| 名称 | 说明 | 数据类型 |
| out_raster | 输出栅格数据集。 | Raster Layer |
这是 BuildRasterAttributeTable 函数的 Python 示例。
import arcpy
arcpy.BuildRasterAttributeTable_management("c:/data/image.tif", "Overwrite")这是 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")