Résumer le raster catégoriel (Image Analyst)

Disponible avec une licence Image Analyst.

Synthèse

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. S’il existe une table attributaire de raster, l’outil doit utiliser les valeurs uniques dans la table pour calculer le nombre de pixels. S’il n’existe pas de table attributaire de raster, l’outil analyse les pixels pour rechercher des 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 comporte une table attributaire de raster avec un champ Class_Name ou ClassName, la table en sortie utilise les noms répertoriés dans ce champ. Sinon, 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.

Paramètres

Boîte de dialogue

Étiquette	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é. Si plusieurs dimensions sont présentes et qu’aucune valeur n’est spécifiée, toutes les tranches sont synthétisées avec toutes les combinaisons des 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

Python

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é. Si plusieurs dimensions sont présentes et qu’aucune valeur n’est spécifiée, toutes les tranches sont synthétisées avec toutes les combinaisons des 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 *

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

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 *

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

Environnements

Étendue