Résumer le raster catégorique (Outils Image Analyst)

Résumé

Générer une table contenant le nombre de pixels pour chaque classe, dans chaque tranche d’un raster catégorique en entrée.

Utilisation

Utilisez cet outil pour calculer le nombre de pixels dans chaque catégorie pour chaque tranche d’un jeu de données raster catégoriel multidimensionnel. Par exemple, calculez le nombre de pixels dans chaque classe d’occupation du sol pour un raster multidimensionnel contenant 30 ans de données d’occupation du sol.
Le jeu de données raster en entrée doit être un raster de type entier. En présence d’une table attributaire raster, l’outil utilise les valeurs uniques de la table pour calculer le nombre de pixels. En l’absence d’une table attributaire raster, l’outil analyse les pixels à la recherche de valeurs uniques. Vous pouvez utiliser l’outil Build Raster Attribute Table (Créer la table attributaire d’un raster) pour construire une table attributaire de raster en entrée.
Si le raster en entrée contient une table attributaire raster avec un champ Class_Name ou ClassName, la table en sortie utilise les noms figurant dans ce champ. Dans le cas contraire, la table en sortie utilise les valeurs de classe du champ Class_Value ou ClassValue. Les noms de champ ne sont pas sensibles à la casse.
Parmi les jeux de données raster multidimensionnel pris en charge se trouvent le format Cloud Raster Format (CRF), les mosaïques multidimensionnelles ou les couches raster multidimensionnelles générées par des fichiers au format netCDF, GRIB ou HDF.

Etiqueter	Explication	Type de données
Raster catégoriel en entrée	Raster multidimensionnel en entrée de type entier.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
Table de synthèse en sortie	Table de synthèse en sortie. Les tables de géodatabase, de base de données, texte, Microsoft Excel et de valeurs séparées par des virgules (CSV) sont prises en charge.	Table
Dimension (Facultatif)	Dimension en entrée à utiliser pour le résumé. S’il existe plusieurs dimensions et qu’aucune valeur n’est spécifiée, toutes les tranches sont synthétisées à l’aide de toutes les combinaisons de valeurs de dimension.	String
Zone d’intérêt (Facultatif)	Couche d’entités surfaciques contenant la ou les zones d’intérêt à utiliser pour calculer le nombre de pixels par catégorie. Si aucune zone d’intérêt n’est spécifiée, le jeu de données raster entier est inclus dans l’analyse.	Feature Layer
Champ ID de zone d’intérêt (Facultatif)	Champ dans la couche d’entités surfaciques qui définit chaque zone d’intérêt. Les champs de texte et entiers sont pris en charge.	Field

SummarizeCategoricalRaster(in_raster, out_table, {dimension}, {aoi}, {aoi_id_field})

Nom	Explication	Type de données
in_raster	Raster multidimensionnel en entrée de type entier.	Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String
out_table	Table de synthèse en sortie. Les tables de géodatabase, de base de données, texte, Microsoft Excel et de valeurs séparées par des virgules (CSV) sont prises en charge.	Table
dimension (Facultatif)	Dimension en entrée à utiliser pour le résumé. S’il existe plusieurs dimensions et qu’aucune valeur n’est spécifiée, toutes les tranches sont synthétisées à l’aide de toutes les combinaisons de valeurs de dimension.	String
aoi (Facultatif)	Couche d’entités surfaciques contenant la ou les zones d’intérêt à utiliser pour calculer le nombre de pixels par catégorie. Si aucune zone d’intérêt n’est spécifiée, le jeu de données raster entier est inclus dans l’analyse.	Feature Layer
aoi_id_field (Facultatif)	Champ dans la couche d’entités surfaciques qui définit chaque zone d’intérêt. Les champs de texte et entiers sont pris en charge.	Field

Exemple de code

Exemple 1 d’utilisation de la fonction SummarizeCategoricalRaster (fenêtre Python)

Cet exemple génère une table contenant le nombre de pixels pour chaque catégorie d’occupation du sol sur une période de 20 années de données d’occupation du sol dans la région de Boston, dans une zone d’intérêt.

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

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

Exemple 2 d’utilisation de la fonction SummarizeCategoricalRaster (script autonome)

Cet exemple génère une table contenant le nombre de pixels pour chaque classe de risque d’incendie dans des données annuelles, dans une zone d’intérêt.

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

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

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

Environnements

Etendue

Informations de licence