Etiqueta | Explicación | Tipo de datos |
Ráster de categorías de entrada | Ráster de categorías multidimensional de entrada. | 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 tener una tabla de atributos de ráster. Para generar una tabla de atributos de ráster, utilice la herramienta Construir tabla de atributos ráster.
Si el ráster de entrada tiene 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 netCDF, GRIB o HDF.
Parámetros
SummarizeCategoricalRaster(in_raster, out_table, {dimension}, {aoi}, {aoi_id_field})
Nombre | Explicación | Tipo de datos |
in_raster | Ráster de categorías multidimensional de entrada. | 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)
Entornos
Información de licenciamiento
- Basic: Requiere Image Analyst
- Standard: Requiere Image Analyst
- Advanced: Requiere Image Analyst