Erweitern (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Erweitert angegebene Zonen eines Rasters um eine angegebene Zellenzahl.

Weitere Informationen zur Funktionsweise von "Erweitern"

Abbildung

Abbildung: Erweitern
OutRas = Expand(InRas1, 1, [5])

Verwendung

  • Die angegebenen Zonenwerte werden als Vordergrundzonen betrachtet, während die verbleibenden Zonenwerte als Hintergrundzonen betrachtet werden. Mit diesem Werkzeug ist es möglich, die Vordergrundzonen auf die Hintergrundzonen zu erweitern.

  • Wenn zwei Vordergrundzonen um die Erweiterung auf dieselbe Hintergrundzone konkurrieren, wird der Konflikt anhand des Wertes der Mehrzahl der umgebenden Zellen gelöst.

  • NoData-Zellen gelten immer als Hintergrundzellen. Daher können benachbarte Zellen mit jedem beliebigen Wert auf NoData-Zellen erweitert werden. NoData-Zellen werden nie auf ihre Nachbarn erweitert.

  • Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Raster, für das die identifizierten Zonen erweitert werden sollen

Die Eingabe muss den Typ "Ganzzahl" aufweisen.

Raster Layer
Anzahl der Zellen

Die Anzahl der Zellen, um die jede angegebene Zone erweitert werden soll.

Der Wert muss ein Ganzzahlwert größer als 1 sein.

Long
Zonenwerte

Die Liste der zu erweiternden Zonenwerte.

Die Zonenwerte müssen Ganzzahlwerte sein. Die Reihenfolge ist irrelevant.

Long
Erweiterungsmethode
(optional)

Die verwendete Methode für die Erweiterung der ausgewählten Zonen.

Die Option Entfernung unterstützt parallele Verarbeitung und kann mit der Umgebungseinstellung Faktor für parallele Verarbeitung gesteuert werden.

  • MorphologischVerwendet eine Methode mit mathematischer Morphologie für die Erweiterung der Zonen. Dies ist die Standardeinstellung.
  • EntfernungVerwendet eine entfernungsbasierte Methode für die Erweiterung der Zonen.
String

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das generalisierte Ausgabe-Raster.

Die angegebenen Zonen des Eingabe-Rasters werden um die angegebene Anzahl an Zellen erweitert.

Die Ausgabe ist immer ganzzahlig.

Raster

Expand(in_raster, number_cells, zone_values, {expand_method})
NameErläuterungDatentyp
in_raster

Das Eingabe-Raster, für das die identifizierten Zonen erweitert werden sollen

Die Eingabe muss den Typ "Ganzzahl" aufweisen.

Raster Layer
number_cells

Die Anzahl der Zellen, um die jede angegebene Zone erweitert werden soll.

Der Wert muss ein Ganzzahlwert größer als 1 sein.

Long
zone_values
[zone_value,...]

Die Liste der zu erweiternden Zonenwerte.

Die Zonenwerte müssen Ganzzahlwerte sein. Die Reihenfolge ist irrelevant.

Long
expand_method
(optional)

Die verwendete Methode für die Erweiterung der ausgewählten Zonen.

  • MORPHOLOGICALVerwendet eine Methode mit mathematischer Morphologie für die Erweiterung der Zonen. Dies ist die Standardeinstellung.
  • DISTANCEVerwendet eine entfernungsbasierte Methode für die Erweiterung der Zonen.

Die Option DISTANCE unterstützt parallele Verarbeitung und kann mit der Umgebungseinstellung parallelProcessingFactor gesteuert werden.

String

Rückgabewert

NameErläuterungDatentyp
out_raster

Das generalisierte Ausgabe-Raster.

Die angegebenen Zonen des Eingabe-Rasters werden um die angegebene Anzahl an Zellen erweitert.

Die Ausgabe ist immer ganzzahlig.

Raster

Codebeispiel

Expand – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird die durch eine Liste von Werten angegebene Zone um zwei Zellen erweitert.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExpand = Expand("filter", 2, [0, 6, -3])
outExpand.save("C:/sapyexamples/output/outexpand.img")
Expand – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird die durch eine Liste von Werten angegebene Zone um zwei Zellen erweitert.

# Name: Expand_Ex_02.py
# Description: Expands specified zones of a raster 
#              by a specified number of cells.
# 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 = "filter"
numberCells = 2
zoneValues = [0, 6, -3]

# Execute Expand
outExpand = Expand(inRaster, numberCells, zoneValues)

# Save the output 
outExpand.save("C:/sapyexamples/output/outexpand")

Lizenzinformationen

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

Verwandte Themen