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

摘要

将栅格属性表添加至栅格数据集或者更新现有数据集。 此方法主要用于离散数据。

使用情况

  • 要删除现有表并创建一个新表,请选中覆盖参数。 将创建一个新的栅格属性表,并删除现有的栅格属性表。

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

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

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

参数

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

将向其添加表格的输入栅格数据集。 如果像素类型为浮点型或双精度,此工具则不会运行。

Raster Layer
覆盖
(可选)

指定现有表是否将被覆盖。

  • 现有的栅格属性表将不会被覆盖,所有编辑都将追加到此表中。 这是默认设置。
  • 覆盖现有的栅格属性表将被覆盖,并将创建一个新的栅格属性表。
Boolean
转换色彩映射表
(可选)

指定是否将色彩映射表转换为栅格属性表。 输出栅格属性表将具有包含色彩映射表中颜色值的 RedGreenBlue 字段。 这些字段定义了相应类值的显示颜色。

此参数仅在输入栅格参数值包含关联的色彩映射表时适用。

  • 转换色彩映射表将色彩映射表转换为栅格属性表。
  • 不将色彩映射表转换为栅格属性表。 这是默认设置。
Boolean

派生输出

标注说明数据类型
更新的输入栅格

输出栅格数据集。

Raster Layer

arcpy.management.BuildRasterAttributeTable(in_raster, {overwrite}, {convert_colormap})
名称说明数据类型
in_raster

将向其添加表格的输入栅格数据集。 如果像素类型为浮点型或双精度,此工具则不会运行。

Raster Layer
overwrite
(可选)

指定现有表是否将被覆盖。

  • NONE现有的栅格属性表将不会被覆盖,所有编辑都将追加到此表中。 这是默认设置。
  • Overwrite现有的栅格属性表将被覆盖,并将创建一个新的栅格属性表。
Boolean
convert_colormap
(可选)

指定是否将色彩映射表转换为栅格属性表。 输出栅格属性表将具有包含色彩映射表中颜色值的 RedGreenBlue 字段。 这些字段定义了相应类值的显示颜色。

此参数仅在输入栅格参数值包含关联的色彩映射表时适用。

  • 选中 - 将色彩映射表转换为栅格属性表。
  • 未选中 - 不将色彩映射表转换为栅格属性表。 这是默认设置。
  • ConvertColormap将色彩映射表转换为栅格属性表。
  • NONE不将色彩映射表转换为栅格属性表。 这是默认设置。
Boolean

派生输出

名称说明数据类型
out_raster

输出栅格数据集。

Raster Layer

代码示例

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: 是

相关主题