Beschriftung | Erläuterung | Datentyp |
Kategorisiertes Eingabe-Raster | Das multidimensionale Eingabe-Raster vom Typ "Integer". | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String |
Ausgabe-Summentabelle | Die Ausgabe-Summentabelle. Geodatabase-, Datenbank-, Text-, Microsoft Excel- und CSV-Tabellen werden unterstützt. | Table |
Dimension (optional) | Die für die Zusammenfassung verwendete Eingabe-Dimension. Wenn mehr als eine Dimension vorhanden ist und kein Wert angegeben wurde, werden alle Ausschnitte unter Verwendung aller Kombinationen aus Dimensionswerten zusammengefasst. | String |
Interessenbereich (optional) | Der Polygon-Feature-Layer, in dem die Interessenbereiche, die beim Berechnen der Pixelanzahl pro Kategorie verwendet werden sollen, enthalten sind. Wenn kein Interessenbereich angegeben wurde, wird das gesamte Raster-Dataset in die Analyse einbezogen. | Feature Layer |
Interessenbereich-ID-Feld (optional) | Das Feld im Polygon-Feature-Layer, das jeden Interessenbereich definiert. Textfelder und ganzzahlige Felder werden unterstützt. | Field |
Mit der Image Analyst-Lizenz verfügbar.
Zusammenfassung
Generiert eine Tabelle, die die Pixelanzahl für jede Klasse der einzelnen Ausschnitte eines kategorisierten Eingabe-Rasters enthält.
Verwendung
Verwenden Sie dieses Werkzeug, um die Anzahl der Pixel in jeder Kategorie für jeden Ausschnitt in einem multidimensionalen kategorisierten Raster-Dataset zu berechnen. Beispielsweise können Sie die Anzahl der Pixel in jeder Landbedeckungskategorie für ein multidimensionales Raster mit Daten zur Landbedeckung aus 30 Jahren berechnen.
Das Eingabe-Raster-Dataset muss ein Raster vom Typ "Integer" sein. Wenn eine Raster-Attributtabelle vorhanden ist, verwendet das Werkzeug die Einzelwerte in der Tabelle, um die Pixelanzahl zu berechnen. Wenn keine Raster-Attributtabelle vorhanden ist, scannt das Werkzeug die Pixel, um Einzelwerte zu finden. Sie können das Werkzeug Raster-Attributtabelle erstellen verwenden, um eine Attributtabelle für das Eingabe-Raster zu erstellen.
Wenn das Eingabe-Raster eine Raster-Attributtabelle mit einem Feld Class_Name oder ClassName enthält, werden in der Ausgabetabelle die in diesem Feld aufgelisteten Namen verwendet. Andernfalls werden in der Ausgabetabelle Klassenwerte aus dem Feld Class_Value oder ClassValue verwendet. Bei den Feldnamen wird nicht zwischen Groß-/Kleinschreibung unterschieden.
Zu den unterstützten multidimensionalen Raster-Datasets gehören solche im Cloud-Raster-Format (CRF), multidimensionale Mosaik-Datasets oder multidimensionale Raster-Layer, die von netCDF-, GRIB- oder HDF-Dateien generiert werden.
Parameter
SummarizeCategoricalRaster(in_raster, out_table, {dimension}, {aoi}, {aoi_id_field})
Name | Erläuterung | Datentyp |
in_raster | Das multidimensionale Eingabe-Raster vom Typ "Integer". | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; String |
out_table | Die Ausgabe-Summentabelle. Geodatabase-, Datenbank-, Text-, Microsoft Excel- und CSV-Tabellen werden unterstützt. | Table |
dimension (optional) | Die für die Zusammenfassung verwendete Eingabe-Dimension. Wenn mehr als eine Dimension vorhanden ist und kein Wert angegeben wurde, werden alle Ausschnitte unter Verwendung aller Kombinationen aus Dimensionswerten zusammengefasst. | String |
aoi (optional) | Der Polygon-Feature-Layer, in dem die Interessenbereiche, die beim Berechnen der Pixelanzahl pro Kategorie verwendet werden sollen, enthalten sind. Wenn kein Interessenbereich angegeben wurde, wird das gesamte Raster-Dataset in die Analyse einbezogen. | Feature Layer |
aoi_id_field (optional) | Das Feld im Polygon-Feature-Layer, das jeden Interessenbereich definiert. Textfelder und ganzzahlige Felder werden unterstützt. | Field |
Codebeispiel
In diesem Beispiel wird eine Tabelle generiert, die die Pixelanzahl für jede Landbedeckungskategorie in den Daten zur Landbedeckung aus 20 Jahren im Gebiet von Boston innerhalb eines Interessenbereichs enthält.
# 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")
In diesem Beispiel wird eine Tabelle generiert, die die Pixelanzahl für jede Brandgefahrenklasse in den jährlichen Daten innerhalb eines Interessenbereichs enthält.
# 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)