Construir tabla de atributos ráster (Administración de datos)

Resumen

Agrega una tabla de atributos de ráster a un dataset ráster o actualiza una existente. Esto se utiliza principalmente con datos discretos.

Uso

• Para eliminar una tabla existente y crear una nueva, active el parámetro Sobrescribir. Se creará una tabla de atributos ráster nueva, y se eliminará la existente.

• Si tiene una tabla existente y no activa el parámetro Sobrescribir, la tabla se actualizará. No se eliminarán campos, pero se actualizarán los valores en la tabla.

• No es posible construir una tabla de atributos ráster para un dataset ráster que presenta un tipo de píxel de punto flotante de 32 bits.

• Es posible generar una tabla de atributos para un dataset multidimensional. Al utilizar esta herramienta con un dataset de mosaico multidimensional o un ráster multidimensional, la tabla de salida contendrá el recuento de píxeles de cada clase de cada división. El campo Count_S0 contendrá el recuento de píxeles de cada clase de la primera división del dataset. El campo Count_S1 contendrá el recuento de píxeles de cada clase en la segunda división, etc. Las variables deben contener datos de categorías, tales como cobertura de suelo.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de entrada	El dataset ráster de entrada al que se agregará una tabla. Esta herramienta no se ejecutará si el tipo de píxel es de punto flotante o de doble precisión.	Raster Layer
Sobrescribir (Opcional)	Especifica si la tabla existente se sobrescribe. Ninguno—Las tablas de atributos ráster existentes no se sobrescriben, y las ediciones se le incorporan. Esta es la opción predeterminada. Sobrescribir—La tabla de atributos ráster existente se sobrescribe, y se crea una nueva tabla de atributos de ráster.	Boolean
Convertir mapa de color (Opcional)	Especifica si el mapa de color se convertirá a una tabla de atributos de ráster. La tabla de atributos de ráster de salida incluirá los campos Red, Green y Blue que contienen valores de color del mapa de color. Estos campos definen los colores de visualización para los valores de clase correspondientes. Este parámetro solo se aplica cuando el valor del parámetro Ráster de entrada incluye un mapa de color asociado. Convertir mapa de color—El mapa de color se convertirá en una nueva tabla de atributos de ráster. Ninguno—El mapa de color no se convertirá a una tabla de atributos de ráster. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Ráster de entrada actualizado	El dataset ráster de salida.	Raster Layer

Python

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

Nombre	Explicación	Tipo de datos
in_raster	El dataset ráster de entrada al que se agregará una tabla. Esta herramienta no se ejecutará si el tipo de píxel es de punto flotante o de doble precisión.	Raster Layer
overwrite (Opcional)	Especifica si la tabla existente se sobrescribe. NONE—Las tablas de atributos ráster existentes no se sobrescriben, y las ediciones se le incorporan. Esta es la opción predeterminada. Overwrite—La tabla de atributos ráster existente se sobrescribe, y se crea una nueva tabla de atributos de ráster.	Boolean
convert_colormap (Opcional)	Especifica si el mapa de color se convertirá a una tabla de atributos de ráster. La tabla de atributos de ráster de salida incluirá los campos Red, Green y Blue que contienen valores de color del mapa de color. Estos campos definen los colores de visualización para los valores de clase correspondientes. Este parámetro solo se aplica cuando el valor del parámetro Ráster de entrada incluye un mapa de color asociado. Activado: el mapa de color se convertirá en una nueva tabla de atributos de ráster. Desactivado: el mapa de color no se convertirá a una tabla de atributos de ráster. Esta es la opción predeterminada. ConvertColormap—El mapa de color se convertirá en una nueva tabla de atributos de ráster. NONE—El mapa de color no se convertirá a una tabla de atributos de ráster. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_raster	El dataset ráster de salida.	Raster Layer

Muestra de código

Ejemplo de BuildRasterAttributeTable (ventana de Python)

Esta es una muestra de Python para la función BuildRasterAttributeTable.

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

Ejemplo 2 de BuildRasterAttributeTable (script independiente)

Esta es una muestra de script de Python para la función BuildRasterAttributeTable.

##====================================
##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")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí