Resumir ráster de categorías (Image Analyst)

Disponible con licencia de Image Analyst.

Resumen

Genera una tabla que contiene el recuento de píxeles de cada clase, en cada porción de un ráster de categorías de entrada.

Uso

  • Utilice esta herramienta para calcular el número de píxeles de cada categoría para cada segmento de un dataset ráster de categorías multidimensional. Por ejemplo, calcule el número de píxeles de cada clase de cobertura del suelo de un ráster multidimensional que contenga 30 años de datos de cobertura del suelo.

  • El dataset ráster de entrada debe ser un ráster de tipo entero. Si existe una tabla de atributos de ráster, la herramienta utilizará los valores únicos de la tabla para calcular el recuento de píxeles. Si no existe una tabla de atributos de ráster, la herramienta escaneará píxeles para encontrar valores únicos. Puede utilizar la herramienta Construir tabla de atributos de ráster para crear una tabla de atributos para el ráster de entrada.

  • Si el ráster de entrada tiene una tabla de atributos de ráster con un campo Class_Name o ClassName, la tabla de salida utilizará los nombres enumerados en ese campo. De lo contrario, la tabla de salida utilizará valores de clase del campo Class_Value o ClassValue. Los nombres de campo no distinguen entre mayúsculas y minúsculas.

  • Entre los datasets ráster multidimensionales admitidos se incluyen los archivos de formato ráster de nube (CRF), datasets de mosaico multidimensionales o capas ráster multidimensionales generados por archivos de formato netCDF, GRIB o HDF.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de categorías de entrada

El ráster multidimensional de entrada de tipo entero.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
Tabla de resumen de salida

Tabla de resumen de salida. Se admiten tablas de geodatabase, base de datos, texto, Microsoft Excel y de valores separados por comas (CSV).

Table
Dimensión
(Opcional)

Dimensión de entrada que se utilizará en el resumen. Si hay más de una dimensión y no se especifica ningún valor, todos los segmentos se resumirán utilizando todas las combinaciones de valores de dimensión.

String
Área de interés
(Opcional)

Capa de entidades poligonales que contiene el área o las áreas de interés que se van a utilizar al calcular el recuento de píxeles por categoría. Si no se especifica un área de interés, todo el dataset ráster se incluirá en el análisis.

Feature Layer
Campo Id. de áreas de interés
(Opcional)

Campo de la capa de entidades poligonales que define cada área de interés. Se admiten campos de texto y enteros.

Field

SummarizeCategoricalRaster(in_raster, out_table, {dimension}, {aoi}, {aoi_id_field})
NombreExplicaciónTipo de datos
in_raster

El ráster multidimensional de entrada de tipo entero.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
out_table

Tabla de resumen de salida. Se admiten tablas de geodatabase, base de datos, texto, Microsoft Excel y de valores separados por comas (CSV).

Table
dimension
(Opcional)

Dimensión de entrada que se utilizará en el resumen. Si hay más de una dimensión y no se especifica ningún valor, todos los segmentos se resumirán utilizando todas las combinaciones de valores de dimensión.

String
aoi
(Opcional)

Capa de entidades poligonales que contiene el área o las áreas de interés que se van a utilizar al calcular el recuento de píxeles por categoría. Si no se especifica un área de interés, todo el dataset ráster se incluirá en el análisis.

Feature Layer
aoi_id_field
(Opcional)

Campo de la capa de entidades poligonales que define cada área de interés. Se admiten campos de texto y enteros.

Field

Muestra de código

Ejemplo 1 de SummarizeCategoricalRaster (ventana de Python)

En este ejemplo se genera una tabla que contiene el recuento de píxeles para cada categoría de cobertura del suelo en 20 años de datos de cobertura del suelo en el área de Boston, dentro de un área de interés.

# Import system modules
import arcpy
from arcpy.ia import *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

arcpy.ia.SummarizeCategoricalRaster("BostonLandCover2000_2020.crf",
	"C:\Data\MyData.gdb\BostonLandCoverSummary", "StdTime", "C:\Data\MyData\AOI",
	"Districts")
Ejemplo 2 de SummarizeCategoricalRaster (script independiente)

En este ejemplo se genera una tabla que contiene el recuento de píxeles para cada clase de riesgo de incendio en datos anuales, dentro de un área de interés.

# Import system modules
import arcpy
from arcpy.ia import *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Define input parameters
inputRaster = "C:/Data/YearlyFireRisk.crf"
outputTable = "C:/Data/FireRiskSummary.csv"
dimension = "StdTime"
aoi = "C:/Data/MyData.gdb/SanBernardinoMountainRange"
aoi_id_field = "WATERSHEDS"

# Execute

arcpy.ia.SummarizeCategoricalRaster(inputRaster, outputTable, dimension, aoi, aoi_id_field)

Entornos

Información de licenciamiento

  • Basic: Requiere Image Analyst
  • Standard: Requiere Image Analyst
  • Advanced: Requiere Image Analyst

Temas relacionados