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

EtiquetaExplicaciónTipo 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.

  • NingunoLas tablas de atributos ráster existentes no se sobrescriben, y las ediciones se le incorporan. Esta es la opción predeterminada.
  • SobrescribirLa 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 colorEl mapa de color se convertirá en una nueva tabla de atributos de ráster.
  • NingunoEl mapa de color no se convertirá a una tabla de atributos de ráster. Esta es la opción predeterminada.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Ráster de entrada actualizado

El dataset ráster de salida.

Raster Layer

arcpy.management.BuildRasterAttributeTable(in_raster, {overwrite}, {convert_colormap})
NombreExplicaciónTipo 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.

  • NONELas tablas de atributos ráster existentes no se sobrescriben, y las ediciones se le incorporan. Esta es la opción predeterminada.
  • OverwriteLa 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.
  • ConvertColormapEl mapa de color se convertirá en una nueva tabla de atributos de ráster.
  • NONEEl mapa de color no se convertirá a una tabla de atributos de ráster. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo 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í

Temas relacionados