Zonale Geometrie (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet das angegebene geometrische Maß (Fläche, Umfang, Stärke bzw. die Eigenschaften einer Ellipse) für jede Zone in einem Dataset.

Weitere Informationen zur Funktionsweise von "Zonale Geometrie"

Abbildung

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 Features können als Zoneneingabe verwendet werden.

• Der Parameter Ausgabe-Zellengröße kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wird die Zellengröße nicht explizit über den Parameterwert angegeben, wird sie aus der Umgebung Zellengröße abgeleitet, falls diese angegeben wurde. Wenn die Zellengröße nicht im Parameter oder in der Umgebung angegeben wurde, wird die standardmäßige Ausgabezellengröße basierend auf dem Typ des Eingabe-Datasets bestimmt. Dabei wird folgendermaßen vorgegangen:

  • Wenn es sich bei dem Eingabe-Dataset um ein Raster handelt, wird die Zellengröße des Datasets verwendet.
  • Wenn das Eingabe-Dataset ein Feature ist und die Umgebung Fang-Raster festgelegt wurde, wird die Zellengröße des Fang-Rasters verwendet. Wenn kein Fang-Raster festgelegt wurde, wird die Zellengröße aus der Breite oder Höhe der Ausdehnung (je nachdem was kürzer ist) berechnet, indem der Wert durch 250 dividiert wird. Dabei wird für die Ausdehnung das in der Umgebung angegebene Ausgabekoordinatensystem verwendet.

• Wenn die Zellengröße mit einem numerischen Wert angegeben ist, wird dieser direkt für das Ausgabe-Raster verwendet.

  Wenn die Zellengröße mit einem Raster-Dataset angegeben ist, wird für den Parameter anstelle des Wertes für die Zellengröße der Pfad des Raster-Datasets angezeigt. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, sofern der Raumbezug des Datasets mit dem des Ausgabe-Raumbezugs übereinstimmt. Wenn der Raumbezug des Datasets nicht mit dem Ausgabe-Raumbezug übereinstimmt, wird er basierend auf dem für Projektionsmethode für Zellengröße angegebenen Wert projiziert.

• Wenn der Wert Eingabe-Raster- oder Feature-Zonen-Daten überlappende Polygone aufweisen, wird die zonale Analyse nicht für jedes einzelne Polygon ausgeführt. Da die Feature-Eingabe in ein Raster konvertiert wird, kann jede Position über nur einen Wert verfügen.

  Eine alternative Methode besteht darin, die zonale Operation für jede der Polygonzonen iterativ zu verarbeiten und die Ergebnisse zu sortieren.

• Bei Angabe des Wertes Eingabe-Raster- oder Feature-Zonen-Daten entspricht das Standard-Zonenfeld dem ersten verfügbaren Ganzzahl- oder Textfeld. Sind keine anderen gültigen Felder vorhanden, wird das ObjectID-Feld als Standardfeld verwendet (z. B. OID oder FID).

• 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.

• Wenn das Ausgabe-Raster-Format .crf lautet, wird in diesem Werkzeug die Raster-Speicherumgebung Pyramide unterstützt. In der Ausgabe werden standardmäßig Pyramiden erstellt. Bei anderen Ausgabeformaten wird diese Umgebung nicht unterstützt, und es werden keine Pyramiden erstellt.

• Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster- oder -Feature-Zonen-Daten	Das Dataset, das die Zonen definiert. Die Zonen können durch ein Integer-Raster oder einen Feature-Layer festgelegt werden.	Raster Layer; Feature Layer
Zonenfeld	Das Feld, das die Werte enthält, die die einzelnen Zonen definieren. Es muss sich dabei um ein Ganzzahlfeld des Zonen-Datasets handeln.	Field
Geometrie-Typ (optional)	Gibt den Typ der Geometrie an, die berechnet werden soll. Fläche—Für jede Zone wird die Fläche berechnet. Umfang—Für jede Zone wird der Umfang berechnet. Stärke—Der tiefste (oder stärkste) Punkt von den umgebenden Zellen innerhalb der Zone wird berechnet. Schwerpunkt—Für jede Zone wird der Schwerpunkt berechnet.	String
Ausgabe-Zellengröße (optional)	Die Zellengröße des zu erstellenden Ausgabe-Rasters. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.	Analysis Cell Size

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Die Ausgabe-Raster für "Zonale Geometrie".	Raster

Python

ZonalGeometry(in_zone_data, zone_field, {geometry_type}, {cell_size})

Name	Erläuterung	Datentyp
in_zone_data	Das Dataset, das die Zonen definiert. Die Zonen können durch ein Integer-Raster oder einen Feature-Layer festgelegt werden.	Raster Layer; Feature Layer
zone_field	Das Feld, das die Werte enthält, die die einzelnen Zonen definieren. Es muss sich dabei um ein Ganzzahlfeld des Zonen-Datasets handeln.	Field
geometry_type (optional)	Gibt den Typ der Geometrie an, die berechnet werden soll. AREA—Für jede Zone wird die Fläche berechnet. PERIMETER—Für jede Zone wird der Umfang berechnet. THICKNESS—Der tiefste (oder stärkste) Punkt von den umgebenden Zellen innerhalb der Zone wird berechnet. CENTROID—Für jede Zone wird der Schwerpunkt berechnet.	String
cell_size (optional)	Die Zellengröße des zu erstellenden Ausgabe-Rasters. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.	Analysis Cell Size

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Die Ausgabe-Raster für "Zonale Geometrie".	Raster

Codebeispiel

ZonalGeometry – Beispiel 1 (Python-Fenster)

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")

ZonalGeometry – Beispiel 2 (eigenständiges Skript)

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

# Execute ZonalStatistics
outZonalGeometry = ZonalGeometry(inZoneData, zoneField, "AREA", cellSize)  

# Save the output 
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout2")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Pyramide, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzinformationen

• Basic: Erfordert Spatial Analyst
• Standard: Erfordert Spatial Analyst
• Advanced: Erfordert Spatial Analyst