Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Generiert eine Version des Rasters mit reduzierter Auflösung. Jede Ausgabezelle enthält die Summe, Minimum, Maximum, Mittelwert oder Medianwert der Eingabezellen, die von der Ausdehnung dieser Zelle umfasst werden.
Weitere Informationen zur Funktionsweise des Werkzeugs "Aggregieren"
Abbildung
Verwendung
Wenn die Werte des Eingabe-Rasters ganzzahlig sind und irgendeine andere Statistiktypoption als "Mean" verwendet wird, ist das Ausgabe-Raster ganzzahlig. Wenn es sich bei den Werten des Eingabe-Rasters um Gleitkommazahlen handelt oder der Statistiktyp "Mean" ist, handelt es sich beim Ausgabe-Raster ebenfalls um Gleitkommazahlen.
Die Geoverarbeitungsanalyseumgebungen Ausdehnung und Zellengröße werden von diesem Werkzeug erkannt. Um die Auflösung des Ausgabe-Rasters zu bestimmen, wenn eine ganzzahlige Zellengröße angegeben wurde, multiplizieren Sie die Zellenauflösung der Analyseumgebung mit dem Faktorparameter der Eingabezellen. Wenn die Zellengröße für die Analyseumgebung auf das Minimum oder Maximum der Eingaben festgelegt wird, ist die Auflösung des Ausgabe-Rasters das Produkt aus der Auflösung des Eingabe-Rasters und dem angegebenen Zellenfaktor.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
Aggregate (in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
Parameter | Erläuterung | Datentyp |
in_raster | Das zu aggregierende Eingabe-Raster. Das Raster kann ein Ganzzahl- oder Gleitkomma-Raster sein. | Raster Layer |
cell_factor | Der Faktor, mit dem die Zellengröße des Eingabe-Rasters multipliziert werden muss, um die gewünschte Auflösung für das Ausgabe-Raster zu erhalten. Der Zellenfaktorwert 3 würde z. B. zu einer Ausgabe-Zellengröße führen, die dreimal so groß ist wie die des Eingabe-Rasters. Der Wert muss ein Ganzzahlwert größer als 1 sein. | Long |
aggregation_type (optional) | Legt fest, wie der Wert für jede Ausgabezelle bestimmt wird. Die Werte der Eingabezellen, die von der gröberen Ausgabezelle umfasst werden, werden durch eine der folgenden Statistiken aggregiert:
| String |
extent_handling (optional) | Definiert, wie die Grenzen zum Eingabe-Raster behandelt werden, wenn seine Zeilen oder Spalten kein Vielfaches des Zellenfaktors sind.
Wenn die Anzahl der Zeilen und Spalten im Eingabe-Raster ein Vielfaches von cell_factor beträgt, werden diese Schlüsselwörter nicht verwendet. | Boolean |
ignore_nodata (optional) | Gibt an, ob NoData-Werte bei der Aggregationsberechnung ignoriert werden.
| Boolean |
Rückgabewert
Name | Erläuterung | Datentyp |
out_raster | Das aggregierte Ausgabe-Raster. Dabei handelt es sich um eine Version des Eingabe-Rasters mit reduzierter Auflösung. | Raster |
Codebeispiel
Aggregate – Beispiel 1 (Python-Fenster)
In diesem Beispiel wird ein Raster aggregiert, indem der Durchschnitt der Werte mit einem Zellenfaktor von 3 ermittelt wird, und es wird ein TIFF-Raster ausgegeben.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outAggreg = Aggregate("highres", 3, "MAXIMUM", "TRUNCATE", "DATA")
outAggreg.save("C:/sapyexamples/output/aggregate.tif")
Aggregate – Beispiel 2 (eigenständiges Skript)
In diesem Beispiel wird ein Raster aggregiert, indem der Durchschnitt der Werte mit einem Zellenfaktor von 3 ermittelt wird, und es wird ein Grid-Raster ausgegeben.
# Name: Aggregate_Ex_02.py
# Description: Generates a reduced resolution version of a raster.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "highres"
cellFactor = 3
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")
# Save the output
outAggreg.save("C:/sapyexamples/output/aggregate02")
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Erfordert Spatial Analyst
- ArcGIS Desktop Standard: Erfordert Spatial Analyst
- ArcGIS Desktop Advanced: Erfordert Spatial Analyst