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

Disponible avec une licence Image Analyst.

Synthèse

Génère 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 comporter une table attributaire de raster. Pour générer la table attributaire d’un raster, utilisez l’outil Créer la table attributaire d’un raster.

  • Si le raster en entrée comporte 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.

  • Les jeux de données raster multidimensionnelles pris en charge incluent des fichiers CRF (Cloud Raster Format), des jeux de données mosaïque multidimensionnelles, ou des couches raster multidimensionnelles générées par des fichiers netCDF, GRIB ou HDF.

Paramètres

ÉtiquetteExplicationType de données
Raster catégoriel en entrée

Raster catégoriel multidimensionnel en entrée.

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

SummarizeCategoricalRaster(in_raster, out_table, {dimension}, {aoi}, {aoi_id_field})
NomExplicationType de données
in_raster

Raster catégoriel multidimensionnel en entrée.

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

Informations de licence

  • Basic: Nécessite Image Analyst
  • Standard: Nécessite Image Analyst
  • Advanced: Nécessite Image Analyst

Rubriques connexes