| Beschriftung | Erläuterung | Datentyp |
Eingabe-Raster- oder -Feature-Zonen | Das Dataset, das die Zonen definiert. Die Zonen können durch ein Integer-Raster oder einen Feature-Layer festgelegt werden. | Raster Layer; Feature Layer |
Eingabewerte-Raster | Die Sammlung von Rastern, deren Werte jeweils durch eine Statistik zusammengefasst werden. Dieser Parameter hat die folgenden Eigenschaften.
Für alle Zellen in jedem Eingabewerte-Raster, die zur gleichen Zone wie die Zelle der Ausgabe gehören, wird eine Statistik berechnet. Es stehen die folgenden Statistiktypen zur Verfügung:
Die Feldnamen in der Ausgabe-Statistiktabelle werden standardmäßig aus dem Werte-Raster-Namen und dem Statistiktyp abgeleitet. | Value Table |
Ausgabe-Statistiktabelle | Die Ausgabetabelle, die die Zusammenfassung der Werte in jeder Zone für alle Werte-Raster enthält. Das Format der Tabelle wird durch das Ausgabeverzeichnis und den Ausgabepfad bestimmt. Standardmäßig handelt es sich bei der Ausgabe um eine Geodatabase-Tabelle in einem Geodatabase-Workspace bzw. um eine dBASE-Tabelle in einem Datei-Workspace. | Table |
Ausgabe-Statistics-Feature-Class (optional) | Der Ausgabe-Feature-Class, die durch Verbinden der Ausgabetabelle mit den Eingabezonendaten erstellt werden soll. | Feature Class |
Zonenfeld (optional) | Das Feld, das die Werte enthält, die die einzelnen Zonen definieren. Es kann sich dabei um ein Ganzzahl- oder ein Zeichenfolgefeld des Zonen-Datasets handeln. | Field |
NoData-Werte in Berechnungen ignorieren (optional) | Gibt an, ob NoData-Werte in der Werteingabe in den Ergebnissen der Zone, in der sie liegen, ignoriert werden.
| Boolean |
Perzentilwerte (optional) | Das Perzentil wird berechnet. Der Standardwert ist 90 und steht für das 90. Perzentil. Zulässige Werte können zwischen 0 und 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen dem Minimum und der Perzentilwert 100 dem Maximum. Der Wert 50 ergibt im Wesentlichen dasselbe Ergebnis wie der Medianwert der Statistik. Dieser Parameter ist nur verfügbar, wenn für den Parameter Statistiktyp die Option Perzentil oder Alle festgelegt wurde. | Double |
Perzentil-Interpolationstyp (optional) | Gibt die Interpolationsmethode an, die verwendet wird, wenn der Perzentilwert zwischen zwei Zellenwerte aus dem Eingabe-Werte-Raster fällt.
| String |
Zirkuläre Statistiken berechnen (optional) | Gibt an, wie das Eingabe-Raster für zirkuläre Daten verarbeitet wird.
| Boolean |
Umbruchwert für Verteilung auf Einheitskreis (optional) | Der Wert, der verwendet wird, um einen linearen Wert auf den Bereich einer bestimmten zirkulären Statistik zu runden. Der Wert muss als positive Ganzzahl oder als Gleitkommawert vorliegen. Der Standardwert beträgt 360 Grad. Dieser Parameter wird nur unterstützt, wenn der Parameter Zirkuläre Statistiken berechnen aktiviert ist. | Double |
Als multidimensional verarbeiten (optional) | Gibt an, wie die Eingabe-Raster berechnet werden, wenn sie multidimensional sind.
| Boolean |
Zonenattribute an die Ausgabe-Features anhängen (optional) | Gibt an, ob zusätzliche Zonenattribute aus den Eingabezonen an die Ausgabe-Feature-Class angehängt werden.
| Boolean |
Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Fasst die Werte mehrerer Raster innerhalb der Zonen eines anderen Datasets zusammen und gibt die Ergebnisse als Tabelle aus.
Weitere Informationen zur Funktionsweise der Werkzeuge für Zonenstatistiken
Verwendung
Im Folgenden werden beispielhaft einige Anwendungsbereiche des Werkzeugs vorgestellt:
- Berechnen des mittleren Niederschlags, der maximalen Temperatur und der Bevölkerungszahl in verschiedenen Ökosystemzonen als Grundlage für die Einschätzung nachhaltiger landwirtschaftlicher Nutzungsformen.
- Abschätzung der mittleren Höhe, der mittleren Neigung und der Summe der NDVI-Werte für jedes Feld, um Gebiete zu finden, die sich für die Anpflanzung von Schattenbäumen eignen.
Eine Zone wird durch alle Flächen in der Eingabe definiert, die den gleichen Wert aufweisen. Die Flächen müssen nicht zusammenhängend sein. Sowohl Raster als auch Features können als Zoneneingabe verwendet werden.
Wenn der Parameterwert von Eingabe-Feature- oder Raster-Zonen (in_zone_raster_or_features in Python) ein Raster ist, muss es sich um ein ganzzahliges Raster handeln.
Wenn der Parameterwert Eingabe-Raster- oder -Feature-Zonen ein Feature ist, wird dieses intern in ein Raster umgewandelt, wobei die Zellengröße, die Zellenausrichtung und der Raumbezug aus dem Parameterwert Eingabewerte-Raster (in_value_rasters_statistics in Python) mit der kleinsten Zellengröße verwendet werden, sofern in der Analyseumgebung nichts anderes angegeben ist. Dies löst ein internes Resampling aus, bevor die zonale Operation ausgeführt wird.
Wenn es sich bei dem Parameterwert Eingabe-Raster- oder -Feature-Zonen um ein Feature handelt, werden Zonen, bei denen die Zonen-Features keinen der Zellenmittelpunkte eines Werte-Rasters überlappen, nicht in das interne Zonen-Raster konvertiert. Diese Zonen sind daher nicht in der Ausgabe dargestellt. Dies können Sie verwalten, indem Sie einen angemessenen Wert für die Umgebung "Zellengröße" festlegen, wodurch die gewünschte Detaillierungsebene der Feature-Zonen beibehalten werden kann. Geben Sie dies in der Analyseumgebung an.
Wenn der Wert Eingabe-Raster- oder -Feature-Zonen ein Punkt-Feature ist, kann mehr als ein Punkt in einer bestimmten Zelle der Eingabewerte-Raster enthalten sein. Für derartige Zellen wird der Zonenwert durch den Punkt mit dem niedrigsten ObjectID-Feld (z. B. OID oder FID) bestimmt.
Wenn der Wert Eingabe-Feature- oder Raster-Zonen überlappende Features enthält, wird die zonale Analyse für jedes einzelne Feature ausgeführt.
Wenn die Zellengröße der Parameterwerte Eingabe-Feature- oder Raster-Zonen und Eingabewerte-Raster unterschiedlich sind, werden die Zellengröße, die Zellenausrichtung und der Raumbezug aus dem Parameterwert Eingabewert-Raster mit der kleinsten Zellengröße verwendet, sofern in der Analyseumgebung nichts anderes angegeben ist. Dies löst ein internes Resampling aus, bevor die zonale Operation ausgeführt wird.
Wenn die Zonen- und Werteingaben nur Raster mit derselben Zellengröße sind und die Zellen ausgerichtet sind, werden sie direkt in dem Werkzeug verwendet. Während der Werkzeugverarbeitung wird dann kein internes Resampling durchgeführt.
Bei Angabe des Wertes Eingabe-Raster- oder -Feature-Zonen entspricht der Standardparameterwert Zonenfeld (zone_field in PythonPython) dem ersten verfügbaren Ganzzahlfeld (z. B. OID oder FID) für Features und dem Feld VALUE für das Raster. Das Zonenfeld kann eine ganze Zahl oder ein Zeichenfolgentyp sein.
Der unterstützte Statistikwert hängt von dem Datentyp des Parameterwerts Eingabewerte-Raster und dem Typ der Statistikberechnung ab, der durch den Parameterwert Zirkuläre Statistiken berechnen angegeben wird.
Wenn der Datentyp "Integer" ist, unterstützt die Berechnung von arithmetischen Statistiken die Optionen Mittelwert, Mehrheit, Mehrheit als Anzahl, Mehrheit als Prozentsatz, Maximum, Medianwert, Minimum, Minderheit, Minderheit als Anzahl, Minderheit als Prozentsatz, Perzentil, Bereich, Standardabweichung, Summe und Varianz. Die Berechnung von zirkulären Statistiken unterstützt die Optionen Mittelwert, Mehrheit, Minderheit, Standardabweichung und Varianz.
Wenn der Datentyp "Float" ist, unterstützt die Berechnung von arithmetischen Statistiken die Optionen Mittelwert, Maximum, Medianwert, Minimum, Perzentil, Bereich, Standardabweichung und Summe. Die Berechnung von zirkulären Statistiken unterstützt die Optionen Mittelwert und Standardabweichung.
Bei Mehrheits- und Minderheitsberechnungen wird bei einem Gleichstand der niedrigste der beiden Werte ausgegeben.
Um mehr als einen Statistiktyp pro Werte-Raster zu berechnen, muss dasselbe Werte-Raster mehrmals angegeben werden. Wenn dieselbe Kombination aus Werte-Raster und Statistiktyp dupliziert wird, generiert das Werkzeug einen Fehler.
Aktivieren Sie zur Berechnung von zirkulären Statistiken den Parameter Zirkuläre Statistiken berechnen (circular_calculation = "CIRCULAR" in Python), und geben Sie einen Wert für den Parameter Umbruchwert für Verteilung auf Einheitskreis (circular_wrap_value in Python) an.
Wenn der Parameter Zirkuläre Statistiken berechnen aktiviert ist, wird die zirkuläre Statistik für alle Werte-Raster mit dem angegebenen Umbruchwert für die Verteilung auf dem Einheitskreis berechnet.
Zu den unterstützten Typen von multidimensionalen Raster-Datasets zählen multidimensionale Raster-Layer, Mosaik, Image-Service und das Cloud-Raster-Format (CRF) von Esri.
Der Parameter Ausgabe-Statistiktabelle (out_statistics_table in Python) hat die folgenden Eigenschaften:
- Die Anzahl der Zeilen in der Ausgabetabelle entspricht der Anzahl der Zonen innerhalb der Ausdehnung der Analyse.
- In der Ausgabe werden zur Darstellung der Zonen mehrere Felder erstellt, mit den Zähl- und Statistikwerten für jeden Eingabewerte-Raster-Wert.
- Die Namen der Felder werden standardmäßig aus dem Namen des Werte-Rasters und dem Statistiktyp abgeleitet, sofern im Parameter Feldname nichts anderes angegeben ist. Bei zirkulären Statistiken wird vor der angegebenen Statistik C_ in den Feldnamen eingefügt. Zum Beispiel lautet der Feldname für die Statistik "Arithmetisches Mittel" ValueRasterName_MEAN und für die Statistik "Zirkuläres Mittel" ValueRasterName_C_MEAN.
- Die maximale Länge der Feldnamen in der Ausgabe hängt vom Workspace ab.
- Der Datentyp für jeden Wert der Elemente in der Ausgabetabelle ist abhängig von der durchgeführten zonalen Berechnung. Unter Funktionsweise von Werkzeugen für Zonenstatistiken finden Sie Informationen zum konkreten Verhalten einer Statistik.
Für den Parameterwert Ausgabe-Statistics-Feature-Class (out_statistics_features in Python) gilt: Wenn es sich bei der Zonen-Eingabe um ein Raster handelt, wird die Ausgabe-Feature-Class in Features konvertiert, ohne Generalisierung und unter Berücksichtigung der Analyseumgebung.
Dieses Werkzeug verwendet die folgenden Umgebungseinstellungen:
- Das Werte-Raster mit der kleinsten Zellengröße wird standardmäßig als Zellengröße für die Analyse, als Koordinatensystem für die Ausgabe und als Raster zum Fangen verwendet.
- Die standardmäßige Ausdehnung ist die Schnittmenge der Zone mit der Vereinigung aller Werte-Raster.
Dieses Werkzeug verwendet standardmäßig Mehrkernprozessoren, wenn diese verfügbar sind. Maximal können vier Kerne genutzt werden.
Verwenden Sie die Umgebungseinstellung Faktor für parallele Verarbeitung, um weniger Kerne zu nutzen.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Parameter
ZonalCharacterization(in_zone_raster_or_features, in_value_rasters_statistics, out_statistics_table, {out_statistics_features}, {zone_field}, {ignore_nodata}, {percentile_values}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value}, {process_as_multidimensional}, {add_zone_attributes})| Name | Erläuterung | Datentyp |
in_zone_raster_or_features | Das Dataset, das die Zonen definiert. Die Zonen können durch ein Integer-Raster oder einen Feature-Layer festgelegt werden. | Raster Layer; Feature Layer |
in_value_rasters_statistics [in_value_rasters_statistics,...] | Die Sammlung von Rastern, deren Werte jeweils durch eine Statistik zusammengefasst werden. Dieser Parameter hat die folgenden Eigenschaften.
Für alle Zellen in jedem Eingabewerte-Raster, die zur gleichen Zone wie die Zelle der Ausgabe gehören, wird eine Statistik berechnet. Es stehen die folgenden Statistiktypen zur Verfügung:
Die Feldnamen in der Ausgabe-Statistiktabelle werden standardmäßig aus dem Werte-Raster-Namen und dem Statistiktyp abgeleitet. | Value Table |
out_statistics_table | Die Ausgabetabelle, die die Zusammenfassung der Werte in jeder Zone für alle Werte-Raster enthält. Das Format der Tabelle wird durch das Ausgabeverzeichnis und den Ausgabepfad bestimmt. Standardmäßig handelt es sich bei der Ausgabe um eine Geodatabase-Tabelle in einem Geodatabase-Workspace bzw. um eine dBASE-Tabelle in einem Datei-Workspace. | Table |
out_statistics_features (optional) | Der Ausgabe-Feature-Class, die durch Verbinden der Ausgabetabelle mit den Eingabezonendaten erstellt werden soll. | Feature Class |
zone_field (optional) | Das Feld, das die Werte enthält, die die einzelnen Zonen definieren. Es kann sich dabei um ein Ganzzahl- oder ein Zeichenfolgefeld des Zonen-Datasets handeln. | Field |
ignore_nodata (optional) | Gibt an, ob NoData-Werte in der Werteingabe in den Ergebnissen der Zone, in der sie liegen, ignoriert werden.
| Boolean |
percentile_values [percentile_values,...] (optional) | Das Perzentil wird berechnet. Der Standardwert ist 90 und steht für das 90. Perzentil. Zulässige Werte können zwischen 0 und 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen dem Minimum und der Perzentilwert 100 dem Maximum. Der Wert 50 ergibt im Wesentlichen dasselbe Ergebnis wie der Medianwert der Statistik. Dieser Parameter wird nur unterstützt, wenn der Parameter statistics_type auf PERCENTILE oder ALL festgelegt wurde. | Double |
percentile_interpolation_type (optional) | Gibt die Interpolationsmethode an, die verwendet wird, wenn der Perzentilwert zwischen zwei Zellenwerte aus dem Eingabe-Werte-Raster fällt.
| String |
circular_calculation (optional) | Gibt an, wie das Eingabe-Raster für zirkuläre Daten verarbeitet wird.
| Boolean |
circular_wrap_value (optional) | Der Wert, der verwendet wird, um einen linearen Wert auf den Bereich einer bestimmten zirkulären Statistik zu runden. Der Wert muss als positive Ganzzahl oder als Gleitkommawert vorliegen. Der Standardwert beträgt 360 Grad. Dieser Parameter wird nur unterstützt, wenn der Parameter circular_calculation auf CIRCULAR festgelegt wurde. | Double |
process_as_multidimensional (optional) | Gibt an, wie die Eingabe-Raster berechnet werden, wenn sie multidimensional sind.
| Boolean |
add_zone_attributes (optional) | Gibt an, ob zusätzliche Zonenattribute aus den Eingabezonen an die Ausgabe-Feature-Class angehängt werden.
| Boolean |
Codebeispiel
In diesem Beispiel werden die Werte mehrerer Raster innerhalb der von einem Polygon-Shapefile definierten Zonen zusammengefasst und die Ergebnisse in einer Tabelle und einer Feature-Class aufgezeichnet.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTable = ZonalCharacterization("zones.shp",
"ValueRas1.tif MEAN ValueRas1_MEAN;ValueRas2.tif MAXIMUM ValueRas2_MAX;ValueRas3.tif STD ValueRas3_STD",
"zonalcharacterout.dbf","featurestatout.shp","Id","DATA","",
"AUTO_DETECT","ARITHMETIC","","CURRENT_SLICE","ZONE_FIELD_ONLY")In diesem Beispiel werden die Werte mehrerer Raster innerhalb der von einem Zonen-Raster definierten Zonen zusammengefasst und die Ergebnisse in einer Tabelle und einer Feature-Class aufgezeichnet.
# Name: ZonalCharacterization_Ex_standalone.py
# Description: Summarizes the values of multiple rasters within the zones
# of another dataset and reports the results as a table.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inZoneData = "zones.tif"
zoneField = "Value"
inValueRas1 = "ValueRas1.tif"
inValueRas2 = "ValueRas2.tif"
inValueRas3 = "ValueRas3.tif"
outTable = "zonalcharactereizationout.dbf"
outFeatureClass = "featurestatout.shp"
# Execute ZonalCharacterization
outzonalchar = ZonalCharacterization(inZoneData, [[inValueRas1, "MEAN",
"ValueRas1_MEAN"], [inValueRas2, "STD", "ValueRas2_STD"],
[inValueRas3, "SUM", "ValueRas3_SUM"]], outTable, outFeatureClass,
zoneField, "NODATA", "", "", "ARITHMETIC", "", "CURRENT_SLICE", "ALL")Umgebungen
Lizenzinformationen
- Basic: Erfordert Spatial Analyst
- Standard: Erfordert Spatial Analyst
- Advanced: Erfordert Spatial Analyst