Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Für jede Zelle in der Ausgabe wird die Zugehörigkeit der Zelle zu einer verbundenen Region ermittelt. Jeder Region wird eine eindeutige Nummer zugewiesen.
Weitere Informationen zum Erstellen von einzelnen Zonen mit "Gruppierung zu Regionen"
Abbildung
Verwendung
Generell erhält die erste gescannte Region den Wert 1, die zweite den Wert 2 usw., bis allen Regionen ein Wert zugewiesen wurde. Der Scan erfolgt von links nach rechts, von oben nach unten. Die den Ausgabe-Zonen zugewiesenen Werte hängen davon ab, wann sie im Scanvorgang gefunden wurden.
Es sind zwei Parameter verfügbar, mit denen gesteuert wird, wie die Konnektivität zwischen Regionen hergestellt wird. Mit dem Parameter Anzahl der berücksichtigten Nachbarn wird die Geometrie der Konnektivität festgelegt: nur orthogonal (vier Nachbarn) oder diagonal und orthogonal (acht Nachbarn). Mit dem Parameter Methode zur Zonen-Bildung wird festgelegt, welche Zellenwerte bei der Auswertung der Konnektivität berücksichtigt werden.
Der Parameter Link-Feld zur Ausgabe hinzufügen (ADD_LINK in Python) ist standardmäßig aktiviert. Dadurch wird in der Attributtabelle des Ausgabe-Rasters ein Feld mit dem Namen LINK erstellt, worin der ursprüngliche Wert für jede Zone aus dem Eingabe-Raster beibehalten wird.
Dieser Parameter findet nur Anwendung, wenn der Parameter Methode zur Zonen-Bildung (zone_connectivity in Python) auf Innerhalb festgelegt ist. Wurde Übergreifend festgelegt, enthält die Attributtabelle des Ausgabe-Rasters wie gewohnt lediglich die Felder Value und Count.
Mit dem Feld LINK, falls verfügbar, können Sie die Abstammung der einzelnen neu erstellten Regionen zu den ursprünglichen Eingabezonenwerten nachverfolgen und für zusätzliche Analysen verwenden.
Beispielsweise lautet die Attributtabelle für das in der oben stehenden Abbildung dargestellte Ausgabe-Raster wie folgt:
Mit der Umgebungseinstellung Maske können die räumliche Konfiguration und die Anzahl der Regionen im Ausgabe-Raster geändert werden.
Zellenpositionen, die den ausgeschlossenen Wert enthalten, erhalten in der Ausgabe den Wert 0, damit diese Zonen nicht mit bestehenden Zellenpositionen mit dem Wert "NoData" verwechselt werden. Da die Nummerierung mit dem Wert 1 beginnt, werden die aus der Neugruppierung ausgeschlossenen Zellen als Hintergrund betrachtet. Die Hintergrundzellen können wie jeder andere Wert reklassifiziert oder bearbeitet werden.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
RegionGroup(in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})| Parameter | Erklärung | Datentyp |
in_raster | Das Eingabe-Raster, in dem eindeutige verbundene Zellenregionen identifiziert werden Die Eingabe muss den Typ "Ganzzahl" aufweisen. | Raster Layer |
number_neighbors (optional) | Gibt die Anzahl der Nachbarzellen an, die bei der Auswertung der Konnektivität zwischen Zellen einer Region verwendet werden sollen.
| String |
zone_connectivity (optional) | Definiert, welche Zellenwerte beim Testen der Konnektivität berücksichtigt werden.
| String |
add_link (optional) | Gibt an, ob der Tabelle der Ausgabe ein Link-Feld hinzugefügt wird, wenn der Parameter zone_connectivity auf WITHIN festgelegt ist. Er wird ignoriert, wenn der Parameter auf CROSS festgelegt ist.
| Boolean |
excluded_value (optional) | Ein Wert, mit dem alle Zellen der Zone aus der Konnektivitätsauswertung ausgeschlossen werden. Wenn eine Zellenposition den Wert enthält, wird keine räumliche Konnektivität ausgewertet, unabhängig von der Angabe für Anzahl der Nachbarn. Zellen mit dem ausgeschlossenen Wert werden ähnlich wie NoData-Zellen verarbeitet und im Vorgang nicht berücksichtigt. Eingabezellen, die den ausgeschlossenen Wert enthalten, erhalten den Wert "0" im Ausgabe-Raster. Das Konzept eines ausgeschlossenen Wertes ist mit dem Konzept eines Hintergrundwertes vergleichbar. Standardmäßig ist kein Wert für diesen Parameter festgelegt, sodass alle Eingabezellen im Vorgang berücksichtigt werden. | Long |
Rückgabewert
| Name | Erklärung | Datentyp |
| out_raster | Das Ausgabe-Raster für "Gruppierung zu Regionen". Die Ausgabe ist immer ganzzahlig. | Raster |
Codebeispiel
In diesem Beispiel wird jeder Region des Eingabe-Rasters mithilfe der Achtfach-Konnektivität eine eindeutige Zahl zugewiesen.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRgnGrp = RegionGroup("land", "EIGHT", "", "", 5)
outRgnGrp.save("c:/sapyexamples/output/reggrp_ex5")In diesem Beispiel wird jeder Region des Eingabe-Rasters mithilfe der Achtfach-Konnektivität mit einem ausgeschlossenen Wert eine eindeutige Zahl zugewiesen.
# Name: RegionGroup_Ex_02.py
# Description: Records, for each cell in the output, the
# identity of the connected region to which
# it belongs within the Analysis window. A
# unique number is assigned to each region.
# 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 = "land"
valToIgnore = 5
# Execute RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS",
"NO_LINK", valToIgnore)
# Save the output
outRegionGrp.save("C:/sapyexamples/output/reggrpout")Umgebungen
Lizenzinformationen
- Basic: Erfordert Spatial Analyst
- Standard: Erfordert Spatial Analyst
- Advanced: Erfordert Spatial Analyst