Gruppierung zu Regionen (Spatial Analyst)

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

Abbildung: Gruppierung zu Regionen
OutRas = RegionGroup(InRas1, FOUR, WITHIN, #, #)

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:

    Beispiel für LINK-Feld in der Attributtabelle

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Raster, in dem eindeutige verbundene Zellenregionen identifiziert werden

Die Eingabe muss den Typ "Ganzzahl" aufweisen.

Raster Layer
Anzahl der berücksichtigten Nachbarn
(optional)

Gibt die Anzahl der Nachbarzellen an, die bei der Auswertung der Konnektivität zwischen Zellen einer Region verwendet werden sollen.

  • VierDie Konnektivität wird für die vier nächsten Nachbarn (orthogonal) jeder Eingabezelle ausgewertet. Nur Zellen, die denselben Wert und mindestens eine gemeinsame Seite aufweisen, sind an einer einzelnen Region beteiligt. Wenn zwei Zellen mit dem gleichen Wert diagonal zueinander liegen, gelten sie nicht als verbunden. Dies ist die Standardeinstellung.
  • AchtDie Konnektivität wird für die acht nächsten Nachbarn (orthogonal und diagonal) jeder Eingabezelle ausgewertet. Zellen, die denselben Wert aufweisen und entlang einer gemeinsamen Kante oder Ecke verbunden sind, sind an einer einzelnen Region beteiligt.
String
Methode zur Zonen-Bildung
(optional)

Definiert, welche Zellenwerte beim Testen der Konnektivität berücksichtigt werden.

  • InnerhalbDie Konnektivität für eine Region wird für Eingabezellen, die Teil derselben Zone (Zellenwert) sind, ausgewertet. Es können nur Zellen aus der gleichen Zone gruppiert werden, die die räumlichen Anforderungen hinsichtlich der Konnektivität erfüllen, die durch den Parameter Anzahl der berücksichtigten Nachbarn (vier oder acht) angegeben werden. Dies ist die Standardeinstellung.
  • ÜbergreifendDie Konnektivität für eine Region wird mit Ausnahme der im Parameter Ausgeschlossener Wert für den Ausschluss festgelegten Zonenzellen zwischen Zellen eines beliebigen Wertes ausgewertet. Zudem werden bei der Auswertung die im Parameter Anzahl der berücksichtigten Nachbarn angegebenen räumlichen Voraussetzungen berücksichtigt. Gruppierungen von Eingaberegionen, die durch einen Puffer aus NoData-Zellen von anderen Gruppierungen getrennt werden, werden unabhängig voneinander verarbeitet.
String
Link-Feld zur Ausgabe hinzufügen
(optional)

Gibt an, ob der Tabelle der Ausgabe ein Link-Feld hinzugefügt wird, wenn der Parameter Methode zur Zonen-Bildung auf Innerhalb festgelegt ist. Er wird ignoriert, wenn der Parameter auf Übergreifend festgelegt ist.

  • Aktiviert: Der Tabelle des Ausgabe-Rasters wird ein Feld mit dem Namen LINK hinzugefügt. In dem Feld wird der Wert der Zone, zu der die Zellen der einzelnen Region in der Ausgabe gehören, entsprechend der im Parameter Anzahl der berücksichtigten Nachbarn festgelegten Konnektivitätsregel gespeichert. Dies ist die Standardeinstellung.
  • Deaktiviert: Es wird keine Feld mit dem Namen LINK hinzugefügt. Die Attributtabelle für das Ausgabe-Raster enthält nur die Felder Value und Count.
Boolean
Ausgeschlossener Wert
(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

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster für "Gruppierung zu Regionen".

Die Ausgabe ist immer ganzzahlig.

Raster

RegionGroup(in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})
NameErläuterungDatentyp
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.

  • FOURDie Konnektivität wird für die vier nächsten Nachbarn (orthogonal) jeder Eingabezelle ausgewertet. Nur Zellen, die denselben Wert und mindestens eine gemeinsame Seite aufweisen, sind an einer einzelnen Region beteiligt. Wenn zwei Zellen mit dem gleichen Wert diagonal zueinander liegen, gelten sie nicht als verbunden. Dies ist die Standardeinstellung.
  • EIGHTDie Konnektivität wird für die acht nächsten Nachbarn (orthogonal und diagonal) jeder Eingabezelle ausgewertet. Zellen, die denselben Wert aufweisen und entlang einer gemeinsamen Kante oder Ecke verbunden sind, sind an einer einzelnen Region beteiligt.
String
zone_connectivity
(optional)

Definiert, welche Zellenwerte beim Testen der Konnektivität berücksichtigt werden.

  • WITHINDie Konnektivität für eine Region wird für Eingabezellen, die Teil derselben Zone (Zellenwert) sind, ausgewertet. Es können nur Zellen aus der gleichen Zone gruppiert werden, die die räumlichen Anforderungen hinsichtlich der Konnektivität erfüllen, die durch den Parameter number_neighbors (vier oder acht) angegeben werden. Dies ist die Standardeinstellung.
  • CROSSDie Konnektivität für eine Region wird mit Ausnahme der im Parameter excluded_value für den Ausschluss festgelegten Zonenzellen zwischen Zellen eines beliebigen Wertes ausgewertet. Zudem werden bei der Auswertung die im Parameter number_neighbors angegebenen räumlichen Voraussetzungen berücksichtigt. Gruppierungen von Eingaberegionen, die durch einen Puffer aus NoData-Zellen von anderen Gruppierungen getrennt werden, werden unabhängig voneinander verarbeitet.
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.

  • ADD_LINKDer Tabelle des Ausgabe-Rasters wird ein Feld mit dem Namen LINK hinzugefügt. In dem Feld wird der Wert der Zone, zu der die Zellen der einzelnen Region in der Ausgabe gehören, entsprechend der im Parameter number_neighbors festgelegten Konnektivitätsregel gespeichert. Dies ist die Standardeinstellung.
  • NO_LINKEs wird kein Feld mit dem Namen LINK hinzugefügt. Die Attributtabelle für das Ausgabe-Raster enthält nur die Felder Value und Count.
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

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster für "Gruppierung zu Regionen".

Die Ausgabe ist immer ganzzahlig.

Raster

Codebeispiel

RegionGroup – Beispiel 1 (Python-Fenster)

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")
RegionGroup – Beispiel 2 (eigenständiges Skript)

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

Lizenzinformationen

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

Verwandte Themen