Etiqueta | Explicación | Tipo 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 |
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
SummarizeCategoricalRaster(in_raster, out_table, {dimension}, {aoi}, {aoi_id_field})
Nombre | Explicación | Tipo 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
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")
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)