Mit der Spatial Analyst-Lizenz verfügbar.
Zusammenfassung
Berechnet für jede Zelle die nächstgelegene Quelle auf Basis der euklidischen Entfernung.
Bild
Verwendung
Die Eingabequelldaten können eine Feature-Class oder ein Raster 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 problemlos mit den Extraktionswerkzeugen erstellt werden.
Wenn die Eingabequelldaten eine Feature-Class sind, werden die Quellenpositionen intern in ein Raster konvertiert, bevor die Analyse ausgeführt wird. Die Auflösung des Rasters kann mithilfe des Parameters Ausgabe-Zellengröße oder der Zellengröße-Umgebung gesteuert werden. Standardmäßig entspricht die Auflösung der Breite oder Höhe (der jeweils kleinere Wert) der Ausdehnung des Eingabe-Features im Eingabe-Raumbezug, dividiert durch 250.
Bei der Verwendung von Polygon-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 greift auf dieselbe Standardmethode für den Zellenzuweisungstyp zu wie das Werkzeug Polygon in Raster, nämlich CELL_CENTER. Das bedeutet, dass Daten, die sich nicht am Zellmittelpunkt befinden, nicht in die vorläufige, gerasterte Quellausgabe aufgenommen und folglich nicht in den Entfernungsberechnungen dargestellt werden. Wenn Ihre Quellen beispielsweise aus einer Serie kleiner Polygone bestehen, wie etwa Gebäudegrundrisse, die in Relation zur Ausgabe-Zellengröße klein sind, kann es sein, dass nur einige von ihnen 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 Polygon in Raster rastern, ein Prioritätsfeld festlegen und die sich ergebende Ausgabe als Eingabe für das Entfernungswerkzeug verwenden. Alternativ können Sie eine Zellengröße auswählen, die so klein ist, dass der jeweilige Detaillierungsgrad von den Eingabe-Features erfasst wird.
Die Maximale Entfernung wird in den gleichen Karteneinheiten wie die Eingabequelldaten angegeben.
Das Eingabewert-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 Funktionen gehen die ursprünglichen, mit den Quellzellenpositionen verknüpften Zonenwerte verloren. Das Eingabe-Wert-Raster kann diese Werte entweder wiederherstellen oder die Analyse für zusätzliche Kombinationen von Zonenwerten innerhalb der Quellzellen berücksichtigen.
Wenn ein Eingabe-Wert-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.
Wenn in der Umgebung eine Maske festgelegt wurde und die relevanten Zellen eine Quelle maskieren, werden die euklidischen Berechnungen nur für die verbleibenden Quellenzellen ausgeführt. Die maskierten Quellenzellen werden bei den Berechnungen nicht berücksichtigt. Diesen Zellenpositionen wird in den Ausgabe-Rastern der Wert "NoData" zugewiesen.
Die von den maskierten Zellen erzeugten NoData-Werte werden in den Berechnungen für andere als die Zellenpositionen der Quelle ignoriert. Die euklidische Entfernung für die den NoData-Werten zugrunde liegenden Zellen wird so berechnet, als wäre der NoData-Wert nicht vorhanden. Jede Zellenposition, der aufgrund der Maske auf der Eingabe-Oberfläche der Wert "NoData" zugewiesen ist, erhält auf allen Ausgabe-Rastern den Wert "NoData".
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
EucAllocation (in_source_data, {maximum_distance}, {in_value_raster}, {cell_size}, {source_field}, {out_distance_raster}, {out_direction_raster})
Parameter | Erläuterung | Datentyp |
in_source_data | Die Eingabequellenpositionen. Dies ist ein Raster oder ein Feature-Dataset, das die Zellen oder Positionen identifiziert, für die die euklidische Entfernung jeder Ausgabezellenposition berechnet wird. Bei Rastern kann der Eingabetyp ein Ganzzahl- oder Gleitkomma-Raster sein. Ist das Eingabequellen-Raster ein Gleitkomma-Raster, muss ein Eingabewert-Raster ({in_value_raster}) vom Typ "Ganzzahl" angegeben werden. Das Wert-Raster hat Vorrang gegenüber einer beliebigen Einstellung im {source_field}. | Raster Layer | Feature Layer |
maximum_distance (optional) | Definiert den 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 Eingabe-Ganzzahl-Raster, das die Zonenwerte identifiziert, die für jede Eingabequellenposition verwendet werden sollen. Für jede Quellenposition (Zelle oder Feature) wird der durch das Eingabewert-Raster ({in_value_raster}) definierte Wert allen Zellen zugewiesen, die der Quellenposition für die Berechnung zugeordnet sind. Das Wert-Raster hat Vorrang gegenüber einer beliebigen Einstellung für das {source_field}. | Raster Layer |
cell_size (optional) | Die Zellengröße im zu erstellenden Ausgabe-Raster. Dies ist der Wert in der Umgebungseinstellung, sofern die Zellengröße explizit festgelegt wurde. Wenn die Standardzellengröße in der Umgebung nicht festgelegt ist, hängt diese davon ab, ob es sich bei den Eingabequelldaten um ein Raster oder ein Feature handelt:
| Analysis Cell Size |
source_field (optional) | Das Feld für die Zuweisung von Werten zu den Quellenpositionen. Es muss den Typ "Ganzzahl" aufweisen. Wenn {in_value_raster} festgelegt wurde, haben die Werte in dieser Eingabe Vorrang gegenüber allen Einstellungen in {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 |
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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute EucAllocation
eucAllocate = EucAllocation(inSource, maxDist, valRaster, cellSize,
sourceField, optOutDist, optOutDir)
# Save the output
eucAllocate.save("c:/sapyexamples/output/eucalloc02")
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert Spatial Analyst
- ArcGIS for Desktop Standard: Erfordert Spatial Analyst
- ArcGIS for Desktop Advanced: Erfordert Spatial Analyst