Zonale Geometrie (Spatial Analyst)
Zusammenfassung
Berechnet für jede Zone in einem Dataset das angegebene Geometriemaß (Fläche, Umfang, Stärke bzw. die Eigenschaften der Ellipse).
Weitere Informationen zur Funktionsweise von "Zonale Geometrie"
Bild
 |
OutRas = ZonalGeometry(InRas1,"VALUE","AREA") |
Verwendung
-
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 Feature-Datasets können als Zoneneingabe verwendet werden.
Beim Festlegen der Daten für die Eingabezone entspricht das Standardzonenfeld dem ersten gültigen Feld. Sind keine anderen gültigen Felder vorhanden, wird das ObjectID-Feld als Standardfeld verwendet (z. B. OID oder FID).
Wenn ein reserviertes Feld (z. B. OBECTID, FID oder OID) für das Zonenfeld ausgewählt wird, kann dies ein mehrdeutiges Ergebnis zur Folge haben. Das Ergebnis beinhaltet nicht nur den Namen des konkreten reservierten Feldes, das für den jeweiligen Ausgabeformattyp notwendig ist, sondern auch das angegebene Zonenfeld. Wenn das angegebene Feld den gleichen Namen wie das reservierte Feld für das jeweilige Ausgabeformat aufweist, wird der Name für das Zonenfeld in der Ausgabe so geändert, dass alle Feldnamen im Ergebnis eindeutig sind.
Hinweis:Um ein Feld mit eindeutigen Werten zu erstellen, das keinen reservierten Namen hat, verwenden Sie die Geoverarbeitungswerkzeuge Feld hinzufügen und Feld berechnen.
-
Im Ausgabe-Raster werden für alle Geometrietypen Gleitkommadaten verwendet.
Wenn eine bestimmte Zone aus nur einer Zelle besteht oder wenn die Zone ein einzelner quadratischer Block von Zellen ist, wird die Ausrichtung der Ellipse (in diesem Fall ein Kreis) auf 90 Grad festgelegt.
Syntax
| Parameter | Erläuterung | Datentyp |
in_zone_data |
Das Dataset, das die Zonen definiert. Die Zonen können durch ein Ganzzahl-Raster oder einen Feature-Layer definiert werden. | Raster Layer | Feature Layer |
zone_field | Feld mit den Werten, die jede Zone definieren. Es muss sich dabei um ein Ganzzahlfeld des Zonen-Datasets handeln. | Field |
geometry_type (optional) |
Zu berechnender Geometrietyp.
| String |
cell_size (optional) | Die Verarbeitungszellengröße für den zonalen Vorgang. Dies ist der Wert in der Umgebung, wenn dieser ausdrücklich festgelegt wurde. Wenn die Umgebungsvariable nicht festgelegt wird, wird die Standardeinstellung für die Zellengröße wie folgt anhand des Typs der Zonendaten bestimmt:
| Analysis Cell Size |
Rückgabewert
| Name | Erläuterung | Datentyp |
| out_raster |
Die Ausgabe-Raster für "Zonale Geometrie". | Raster |
Codebeispiel
In diesem Beispiel wird die Fläche für jede vom Eingabe-Polygon-Shapefile definierte Zone ermittelt.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalGeometry = ZonalGeometry("zones.shp", "Classes", "AREA", 0.2)
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout3")
In diesem Beispiel wird die Fläche für jede vom Eingabe-Polygon-Shapefile definierte Zone ermittelt.
# Name: ZonalGeometry_Ex_02.py
# Description:Calculates for each zone in a dataset the specified geometry
# measure (area, perimeter, thickness, or the characteristics
# of ellipse).
# 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
inZoneData = "zones.shp"
zoneField = "Classes"
cellSize = 0.2
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ZonalStatistics
outZonalGeometry = ZonalGeometry(inZoneData, zoneField, "AREA", cellSize)
# Save the output
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout2")