Zusammenfassung
Berechnet die euklidische Entfernung von einer einzelnen Quelle oder mehreren Quellen.
Abbildung
Verwendung
Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise
-Portal mit einem konfigurierten ArcGIS Image Server für die Raster Analysis angemeldet sind. Beim Aufruf des Werkzeugs dient ArcGIS Pro als Client. Die Verarbeitung erfolgt auf den Servern, die mit ArcGIS Enterprise verbunden sind. Das Portal-Werkzeug akzeptiert Layer aus dem Portal als Eingabe und erstellt die Ausgabe im Portal.Als Eingabe-Raster-Layer kann ein Layer aus dem Portal, ein URI bzw. eine URL zu einem Image-Service oder die Ausgabe des Werkzeugs Image Server-Layer erstellen verwendet werden. Bei dem Eingabe-Feature-Layer kann es sich um einen Layer aus dem Portal oder ein URI bzw. eine URL zu einem Feature-Service handeln. Lokale Raster-Daten oder -Layer werden von diesem Werkzeug nicht unterstützt. Obwohl Sie lokale Feature-Daten und Layer als Eingabe für dieses Portal verwenden können, empfiehlt es sich, Layer aus Ihrem Portal als Eingabe zu nutzen.
Ein Beispiel für die Anwendung dieses Werkzeugs ist die Ermittlung der Entfernung von einer Position zur nächsten Stadt.
Wenn es sich bei den Eingabequelldaten um einen Image-Service 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.
Liegen die Eingabequelldaten in Form eines Feature-Service vor, 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.
Syntax
arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})| Parameter | Erklärung | Datentyp |
inputSourceRasterOrFeatures | Der Layer, der die Quellen definiert, zu denen die Entfernung berechnet werden soll. Der Layer kann ein Image-Service oder ein Feature-Service sein. Bei einem Image-Service kann der Eingabetyp Ganze Zahl oder Gleitkomma sein. Bei einem Feature-Service kann die Eingabe ein Punkt, eine Linie oder ein Polygon sein. | Raster Layer; Image Service; Feature Layer; String |
outputDistanceName | Der Name des Ausgabe-Entfernungs-Raster-Service. | String |
maximumDistance (optional) | Die maximale Entfernung für die Berechnung. Die Einheiten können Kilometer, Meter, Meilen, Yard oder Fuß sein. Die Standardeinheiten lauten Meter. | Linear Unit |
outputCellSize (optional) | Legen Sie die Zellengröße und die Einheiten für das Ausgabe-Raster fest. Die Einheiten können Kilometer, Meter, Meilen, Yard oder Fuß sein. Die Standardeinheiten lauten Meter. | Linear Unit |
outputDirectionName (optional) | Der Name des Ausgabe-Richtungs-Raster-Service. | String |
outputAllocationName (optional) | Der Name des Ausgabe-Zuordnungs-Raster-Service. | String |
allocationField (optional) | Ein Feld in der Quelleingabe mit den Werten, die jede Quelle definieren. Es muss eine ganze Zahl sein. | String |
distanceMethod (optional) | Gibt an, ob die Entfernung mithilfe einer planaren (flache Erde) oder geodätischen (Ellipsoid) Methode berechnet werden soll.
| String |
inputBarrierRasterOrFeatures (optional) | Das Dataset, das die Barrieren definiert. Die Barrieren können durch ein Ganzzahl- oder Gleitkomma-Raster oder einen Feature-Layer definiert werden. | Raster Layer; Image Service; Feature Layer; String |
outputBackDirectionName (optional) | Der Name des Ausgabe-Gegenrichtungs-Raster-Service. | String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| outputDistanceRaster | Das Ausgabe-Raster für die Entfernung. | Raster-Layer |
| outputDirectionRaster | Das Ausgabe-Raster für die Richtung. | Raster-Layer |
| outputBackDirectionRaster | Das Ausgabe-Gegenrichtungs-Raster. | Raster-Layer |
| outputAllocationRaster | Das Zuordnungs-Raster für die Ausgaben. | Raster-Layer |
Codebeispiel
In diesem Beispiel wird die Euklidische Entfernung von einer einzelnen Quelle berechnet.
import arcpy
arcpy.CalculateDistance_ra('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
"outDistance", "5000", "10", "outDirection", "outAllocation", "siting")In diesem Beispiel wird die Euklidische Entfernung von mehreren Quellen berechnet.
# Name: CalculateDistance_Ex_02.py
# Description: Calculates for each cell the Euclidean distance, direction and allocation
# to the nearest source.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inSourceData = 'https://MyPortal.esri.com/server/rest/services/Hosted/reccenter/ImageServer'
outDistanceName = "eucdistance"
maxDistance = "4000"
cellSize = "10"
outDirectionName = "eucdirect"
outAllocationName = "eurallocation"
allocationField = "dataid"
# Execute EucDistance
arcpy.CalculateDistance_ra(inSourceData, outDistanceName, maxDistance, cellSize, outDirectionName,
outAllocationName, allocationField)Umgebungen
Lizenzinformationen
- Basic: Erfordert ArcGIS Image Server
- Standard: Erfordert ArcGIS Image Server
- Advanced: Erfordert ArcGIS Image Server