Entfernung berechnen (Raster Analysis)

Zusammenfassung

Berechnet die euklidische Entfernung von einer einzelnen Quelle oder mehreren Quellen.

Vorversion:

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

Die Werkzeuge Entfernungsakkumulation und Entfernungsallokation bieten erweiterte Funktionalität und Performance.

Abbildung

Abbildung des Werkzeugs "Entfernung berechnen"

Verwendung

  • Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise-Portal angemeldet sind, das über einen für Raster Analysis konfigurierten ArcGIS Image Server verfügt. Beim Ausführen 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 Quellpositionen 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.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Quell-Raster oder -Features

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
Name der Ausgabe-Entfernung

Der Name des Ausgabe-Entfernungs-Raster-Service.

String
Maximale Entfernung
(optional)

Die maximale Entfernung für die Berechnung.

Die Einheitenwerte lauten Kilometer, Meter, Meilen (Britisch), Yards (International), Fuß (International), Meilen (US Survey), Yards (US Survey) und Fuß (US Survey).

Die Standardeinheit ist Meter.

Linear Unit
Ausgabe-Zellengröße
(optional)

Legen Sie die Zellengröße und die Einheiten für das Ausgabe-Raster fest.

Die Einheitenwerte lauten Kilometer, Meter, Meilen (Britisch), Yards (International), Fuß (International), Meilen (US Survey), Yards (US Survey) und Fuß (US Survey).

Die Standardeinheit ist Meter.

Linear Unit
Name der Ausgabe-Wegbeschreibung
(optional)

Der Name des Ausgabe-Richtungs-Raster-Service.

String
Name der Ausgabe-Allokation
(optional)

Der Name des Ausgabe-Allokations-Raster-Service.

String
Allokationsfeld
(optional)

Ein Feld in der Quelleingabe mit den Werten, die jede Quelle definieren. Es muss eine ganze Zahl sein.

String
Entfernungsmethode
(optional)

Gibt an, ob die Entfernung mithilfe einer planaren (flache Erde) oder geodätischen (Ellipsoid) Methode berechnet werden soll.

  • PlanarDie Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung.
  • GeodätischDie Entfernungsberechnung erfolgt für das Ellipsoid. Deshalb ändern sich die Ergebnisse unabhängig von der Eingabe- oder Ausgabeprojektion nicht.
String
Eingabe-Barriere-Raster oder -Features
(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
Name der Ausgabe-Gegenrichtung
(optional)

Der Name des Ausgabe-Gegenrichtungs-Raster-Service.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Entfernungs-Raster

Das Ausgabe-Raster für die Entfernung.

Raster Layer
Ausgabe-Richtungs-Raster

Das Ausgabe-Raster für die Richtung.

Raster Layer
Ausgabe-Gegenrichtungs-Raster

Das Ausgabe-Gegenrichtungs-Raster.

Raster Layer
Ausgabe-Allokations-Raster

Das Allokations-Raster für die Ausgaben.

Raster Layer

arcpy.ra.CalculateDistance(inputSourceRasterOrFeatures, outputDistanceName, {maximumDistance}, {outputCellSize}, {outputDirectionName}, {outputAllocationName}, {allocationField}, {distanceMethod}, {inputBarrierRasterOrFeatures}, {outputBackDirectionName})
NameErläuterungDatentyp
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 Einheitenwerte lauten Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards und Feet.

Die Standardeinheit ist Meter.

Linear Unit
outputCellSize
(optional)

Legen Sie die Zellengröße und die Einheiten für das Ausgabe-Raster fest.

Die Einheitenwerte lauten Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards und Feet.

Die Standardeinheit ist Meter.

Linear Unit
outputDirectionName
(optional)

Der Name des Ausgabe-Richtungs-Raster-Service.

String
outputAllocationName
(optional)

Der Name des Ausgabe-Allokations-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.

  • PlanarDie Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung.
  • GeodesicDie Entfernungsberechnung erfolgt für das Ellipsoid. Deshalb ändern sich die Ergebnisse unabhängig von der Eingabe- oder Ausgabeprojektion nicht.
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

NameErläuterungDatentyp
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 Allokations-Raster für die Ausgaben.

Raster Layer

Codebeispiel

CalculateDistance: Beispiel 1 (Python-Fenster)

In diesem Beispiel wird die Euklidische Entfernung von einer einzelnen Quelle berechnet.

import arcpy
arcpy.ra.CalculateDistance('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
                           "outDistance", "5000", "10", "outDirection", "outAllocation", "siting")
CalculateDistance: Beispiel 2 (eigenständiges Skript)

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.ra.CalculateDistance(inSourceData, outDistanceName, maxDistance, cellSize, outDirectionName,
                           outAllocationName, allocationField)

Lizenzinformationen

  • Basic: Erfordert ArcGIS Image Server
  • Standard: Erfordert ArcGIS Image Server
  • Advanced: Erfordert ArcGIS Image Server

Verwandte Themen