Euklidische Zuordnung (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet für jede Zelle die nächstgelegene Quelle auf Basis der euklidischen Entfernung.

Vorversion:

Dieses Werkzeug ist veraltet und wird in einer zukünftigen Version entfernt.

Das Werkzeug Entfernungsallokation bietet eine erweiterte Funktionalität und Performance.

Weitere Informationen zur euklidischen Entfernungsanalyse

Abbildung

Euc_Alloc = EucAllocation(Source_Ras)

Verwendung

• Die Eingabequelldaten können eine Feature-Class oder ein Raster sein. Die Feature-Class kann ein Punkt, eine Linie oder ein Polygon sein.

• Wenn es sich bei den Eingabequelldaten um ein Raster handelt, besteht die Menge der Quellzellen aus allen Zellen im Quell-Raster, die über gültige Werte verfügen. Zellen mit NoData-Werten sind nicht in der Quellmenge enthalten. Der Wert 0 wird als legitime Quelle verwendet. Ein Quell-Raster kann mit den Extraktionswerkzeugen erstellt werden.

• Wenn es sich bei den Eingabequelldaten um eine Feature-Class handelt, werden die Quellenpositionen intern in ein Raster konvertiert, bevor die Analyse ausgeführt wird.

• Bei der Verwendung von Feature-Daten als Eingabequelldaten muss auf den Umgang mit der Größe der Ausgabezelle geachtet werden, wenn diese, relativ zu dem in der Eingabe vorhandenen Detail, grob ist. Der interne Rasterungsprozess verwendet den gleichen Wert für den Zellenzuweisungstyp wie das Werkzeug Feature in Raster, nämlich die Methode "Zellenmittelpunkt". Das bedeutet, dass Daten, die sich nicht am Zellenmittelpunkt befinden, nicht in die vorläufige, gerasterte Quellausgabe aufgenommen und folglich nicht in den Entfernungsberechnungen dargestellt werden. Wenn die Quellen beispielsweise aus einer Serie kleiner Polygone bestehen (z. B. Gebäudegrundrisse), die in Relation zur Ausgabezellengröße klein sind, kann es sein, dass nur einige an den Mittelpunkten der Ausgabe-Raster-Zellen liegen und scheinbar dazu führen, dass die meisten anderen Polygone in der Analyse nicht enthalten sind.

  Um dies zu vermeiden, können Sie die Eingabe-Features in einem Zwischenschritt direkt mit dem Werkzeug Feature in Raster rastern und den Parameter Feld festlegen. Verwenden Sie anschließend die resultierende Ausgabe als Eingabe in das jeweilige Entfernungswerkzeug, das Sie verwenden möchten. Alternativ können Sie eine kleine Zellengröße auswählen, damit der jeweilige Detaillierungsgrad aus den Eingabe-Features erfasst wird.

• Der Wert Maximale Entfernung wird in den gleichen Karteneinheiten wie die Eingabequelldaten angegeben.

• Das Eingabe-Werte-Raster ist nützlich, wenn die Eingabe-Raster- oder Feature-Quelldaten ein Raster sind, das von einer Funktion abgeleitet wurde, die entweder 1 oder 0 ergibt. Bei diesen gehen die ursprünglichen, mit den Quellzellenpositionen verknüpften Zonenwerte verloren. Das Eingabe-Werte-Raster kann diese Werte entweder wiederherstellen oder die Analyse für zusätzliche Kombinationen von Zonenwerten innerhalb der Quellzellen berücksichtigen.

• Wenn ein Eingabe-Werte-Raster verwendet wird, ändert es möglicherweise die Konfiguration und die Ergebnisse der Ausgabe der euklidischen Zuordnung. Auf die optionalen Ergebnisse der euklidischen Entfernung oder Richtung bestehen keine Auswirkungen.

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

• Die standardmäßige Verarbeitungsausdehnung für dieses Werkzeug ist der Wert Vereinigungsmenge der Eingaben. Dabei wird die kombinierte Ausdehnung beider Eingabe-Datasets verarbeitet.

• Dieses Werkzeug unterstützt die parallele Verarbeitung. Wenn Ihr Computer mit mehreren Prozessoren oder mit Prozessoren, die mehrere Kerne haben, ausgestattet ist, kann eine höhere Leistung erzielt werden, vor allem bei größeren Datasets. Weitere Informationen zu dieser Funktion sowie zu den Konfigurationsmöglichkeiten finden Sie im Hilfethema Parallele Verarbeitung mit Spatial Analyst.

  Beim Einsatz von paralleler Verarbeitung werden für die Verwaltung der zu verarbeitenden Daten-Chunks temporäre Daten generiert. Der Standardordner für temporäre Daten befindet sich auf dem lokalen Laufwerk C:. Sie können den Speicherort ändern, indem Sie eine Systemumgebungsvariable mit dem Namen "TempFolders" einrichten und den Pfad zum gewünschten Ordner angeben (z. B. E:\RasterCache). Wenn Sie über Admin-Berechtigungen für Ihren Computer verfügen, können Sie dies auch mit einem Registrierungsschlüssel (z. B. [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]) tun.

  Das Werkzeug verwendet standardmäßig 50 % der verfügbaren Kerne. Wenn die Eingabedaten aus weniger als 5.000 mal 5.000 Zellen bestehen, können weniger Kerne verwendet werden. Sie können die Anzahl der Kerne, die das Werkzeug verwendet, mit der Umgebung Faktor für parallele Verarbeitung ändern.

• 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-Quelldaten	Die Eingabequellenpositionen. Dies ist ein Raster oder Feature, das die Zellen oder Positionen identifiziert, die zum Berechnen der euklidischen Entfernung für jede Ausgabezellenposition verwendet werden. Bei Rastern kann der Eingabetyp ein ganzzahliges oder Gleitkomma-Raster sein. Ist das Eingabequellen-Raster ein Gleitkomma-Raster, muss der Parameter Eingabewert-Raster vom Typ "Ganzzahl" angegeben werden. Das Wert-Raster hat Vorrang gegenüber der Einstellung im Parameter Quellfeld.	Raster Layer; Feature Layer
Maximale Entfernung (optional)	Der Schwellenwert, den die akkumulativen Entfernungswerte nicht überschreiten dürfen. Wenn ein akkumulativer euklidischer Entfernungswert diesen Wert überschreitet, lautet der Ausgabewert für die Zellenposition "NoData". Die Standardentfernung ist bis zur Kante des Ausgabe-Rasters.	Double
Eingabe-Werte-Raster (optional)	Das ganzzahlige Eingabe-Raster, das die Zonenwerte identifiziert, die für jede Eingabequellenposition verwendet werden. Für jede Quellenposition (Zelle oder Feature) wird der Wert Eingabewert-Raster allen Zellen zugewiesen, die der Quellenposition für die Berechnung zugeordnet sind. Das Wert-Raster hat Vorrang gegenüber der Einstellung im Parameter Quellfeld.	Raster Layer
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
Quellfeld (optional)	Das Feld für die Zuweisung von Werten zu den Quellenpositionen. Die Eingabe muss den Typ "Ganzzahl" aufweisen. Wenn der Parameter Eingabe-Werte-Raster festgelegt wurde, haben die Werte in dieser Eingabe Vorrang gegenüber der Einstellung im Parameter Quellfeld.	Field
Ausgabe-Entfernungs-Raster (optional)	Das Ausgabe-Raster für die euklidische Entfernung: Das Entfernungs-Raster gibt für jede Zelle die euklidische Entfernung zur nächsten Quellenzelle, zum nächsten Satz von Quellenzellen oder zur nächsten Quellenposition an. Das Ausgabe-Raster ist ein Gleitkomma-Raster.	Raster Dataset
Ausgabe-Richtungs-Raster (optional)	Das Ausgabe-Raster für die euklidische Richtung. Das Richtungs-Raster enthält die berechnete Richtung in Grad, in der sich jeder Zellenmittelpunkt von dem Mittelpunkt der nächsten Quellenzelle befindet. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden). Das Ausgabe-Raster ist ganzzahlig.	Raster Dataset
Entfernungsmethode (optional)	Gibt an, ob die Berechnung mit einer planaren Methode (flache Erde) oder einer geodätischen Methode (Ellipsoid) erfolgt. Planar—Die Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung. Geodätisch—Die Entfernungsberechnung erfolgt für das Ellipsoid. Unabhängig von der Eingabe- oder Ausgabeprojektion ändern sich die Ergebnisse nicht.	String
Eingabe-Raster oder Feature-Barriere-Daten (optional)	Das Dataset, das die Barrieren definiert. Die Barrieren können durch ein Ganzzahl- oder Gleitkomma-Raster oder durch ein Punkt-, Linien- oder Polygon-Feature definiert sein.	Raster Layer; Feature Layer
Ausgabe-Gegenrichtungs-Raster (optional)	Das Ausgabe-Raster für die euklidische Gegenrichtung. Das Gegenrichtungs-Raster enthält die berechnete Richtung in Grad. Die Richtung identifiziert die nächste Zelle entlang der kürzesten Route zurück zur nächstgelegenen Quelle, wobei Barrieren vermieden werden. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden). Das Ausgabe-Raster ist ein Gleitkomma-Raster.	Raster Dataset

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Zuordnungs-Raster	Das Ausgabe-Raster für "Euklidische Zuordnung". Die Zellenwerte (Zonen) geben die nächstgelegene Quellenposition an. Das Ausgabe-Raster ist ganzzahlig.	Raster

Python

EucAllocation(in_source_data, {maximum_distance}, {in_value_raster}, {cell_size}, {source_field}, {out_distance_raster}, {out_direction_raster}, {distance_method}, {in_barrier_data}, {out_back_direction_raster})

Name	Erläuterung	Datentyp
in_source_data	Die Eingabequellenpositionen. Dies ist ein Raster oder Feature, das die Zellen oder Positionen identifiziert, die zum Berechnen der euklidischen Entfernung für jede Ausgabezellenposition verwendet werden. Bei Rastern kann der Eingabetyp ein ganzzahliges oder Gleitkomma-Raster sein. Wenn das Eingabequellen-Raster ein Gleitkomma-Raster ist, muss der Parameter in_value_raster vom Typ "Ganzzahl" angegeben werden. Das Wert-Raster hat Vorrang gegenüber der Einstellung im Parameter source_field.	Raster Layer; Feature Layer
maximum_distance (optional)	Der Schwellenwert, den die akkumulativen Entfernungswerte nicht überschreiten dürfen. Wenn ein akkumulativer euklidischer Entfernungswert diesen Wert überschreitet, lautet der Ausgabewert für die Zellenposition "NoData". Die Standardentfernung ist bis zur Kante des Ausgabe-Rasters.	Double
in_value_raster (optional)	Das ganzzahlige Eingabe-Raster, das die Zonenwerte identifiziert, die für jede Eingabequellenposition verwendet werden. Für jede Quellenposition (Zelle oder Feature) wird der Wert in_value_raster allen Zellen zugewiesen, die der Quellenposition für die Berechnung zugeordnet sind. Das Wert-Raster hat Vorrang gegenüber der Einstellung im Parameter source_field.	Raster Layer
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
source_field (optional)	Das Feld für die Zuweisung von Werten zu den Quellenpositionen. Die Eingabe muss den Typ "Ganzzahl" aufweisen. Wenn der Parameter in_value_raster festgelegt wurde, haben die Werte in dieser Eingabe Vorrang gegenüber der Einstellung im Parameter source_field.	Field
out_distance_raster (optional)	Das Ausgabe-Raster für die euklidische Entfernung: Das Entfernungs-Raster gibt für jede Zelle die euklidische Entfernung zur nächsten Quellenzelle, zum nächsten Satz von Quellenzellen oder zur nächsten Quellenposition an. Das Ausgabe-Raster ist ein Gleitkomma-Raster.	Raster Dataset
out_direction_raster (optional)	Das Ausgabe-Raster für die euklidische Richtung. Das Richtungs-Raster enthält die berechnete Richtung in Grad, in der sich jeder Zellenmittelpunkt von dem Mittelpunkt der nächsten Quellenzelle befindet. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden). Das Ausgabe-Raster ist ganzzahlig.	Raster Dataset
distance_method (optional)	Gibt an, ob die Berechnung mit einer planaren Methode (flache Erde) oder einer geodätischen Methode (Ellipsoid) erfolgt. PLANAR—Die Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung. GEODESIC—Die Entfernungsberechnung erfolgt für das Ellipsoid. Unabhängig von der Eingabe- oder Ausgabeprojektion ändern sich die Ergebnisse nicht.	String
in_barrier_data (optional)	Das Dataset, das die Barrieren definiert. Die Barrieren können durch ein Ganzzahl- oder Gleitkomma-Raster oder durch ein Punkt-, Linien- oder Polygon-Feature definiert sein.	Raster Layer; Feature Layer
out_back_direction_raster (optional)	Das Ausgabe-Raster für die euklidische Gegenrichtung. Das Gegenrichtungs-Raster enthält die berechnete Richtung in Grad. Die Richtung identifiziert die nächste Zelle entlang der kürzesten Route zurück zur nächstgelegenen Quelle, wobei Barrieren vermieden werden. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden). Das Ausgabe-Raster ist ein Gleitkomma-Raster.	Raster Dataset

Rückgabewert

Name	Erläuterung	Datentyp
out_allocation_raster	Das Ausgabe-Raster für "Euklidische Zuordnung". Die Zellenwerte (Zonen) geben die nächstgelegene Quellenposition an. Das Ausgabe-Raster ist ganzzahlig.	Raster

Codebeispiel

EucAllocation: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht die Verwendung des Werkzeugs EuclideanAllocation.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
eucAllocate = EucAllocation("observers", 50000, "elevation", 25, "FID", 
                            "c:/sapyexamples/output/outeucdist", 
                            "c:/sapyexamples/output/outeucdir")
eucAllocate.save("c:/sapyexamples/output/eucalloc")

EucAllocation: Beispiel 2 (eigenständiges Skript)

Berechnet für jede Zelle die Zone der nächstgelegenen Quellenposition als euklidische Entfernung.

# Name: EucAllocation_Ex_02.py
# Description: Calculates, for each cell, the zone of the closest 
#              source location in Euclidean distance.
# 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
inSource = "observers.shp"
maxDist = 50000
valRaster = "elevation"
cellSize = 25
sourceField = "FID"
optOutDist = "c:/sapyexamples/output/outeucdist02"
optOutDir = "c:/sapyexamples/output/outeucdir02"

# Execute EucAllocation
eucAllocate = EucAllocation(inSource, maxDist, valRaster, cellSize,
                             sourceField, optOutDist, optOutDir)

# Save the output 
eucAllocate.save("c:/sapyexamples/output/eucalloc02")

Umgebungen

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

Lizenzinformationen

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