Reisekostenpfad als Polylinie ermitteln (Raster Analysis)

Zusammenfassung

Berechnet den kostengünstigsten Pfad zwischen Quellen und Zielen als Polylinie.

Tipp:

Die Werkzeuge Entfernungsakkumulation und Optimaler Pfad als Linie bieten erweiterte Funktionalität und Performance.

Abbildung

Verwendung

• Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise-Portal mit einem für Raster Analysis konfigurierten ArcGIS Image Server 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.

• Das Werkzeug Reisekostenpfad als Polylinie ermitteln erzeugt ein Ausgabe-Feature für die kostengünstigsten Routen von Quellen zu Zielen.

• Wenn die Quell- oder Zieleingabe ein Image-Service ist, müssen Zellen, die keine Quellen oder Ziele sind, den Wert "NoData" aufweisen. Alle Zellen in einer dieser Eingaben, die einen Wert einschließlich Null aufweisen, werden als gültige Quellen oder Ziele verwendet.

• Die Eingabekostenoberfläche darf keine Nullwerte oder negativen Werte aufweisen.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Quell-Raster oder -Features	Ein Image-Service oder Feature-Service, der diejenigen Zellen identifiziert, von denen die kostengünstigste Route zu den Zielen ermittelt wird. Wenn die Eingabe ein Image-Service ist, besteht die Eingabe aus Zellen mit gültigen Werten (0 ist ein gültiger Wert), und den restlichen Zellen muss "NoData" zugewiesen werden.	Raster Layer; Image Service; Feature Layer; String
Eingabe-Kosten-Raster	Der Name eines Image-Service für Kosten-Raster, der verwendet werden soll, um die kostengünstigste Route von den Quellen zu den Zielen zu ermitteln. Der Wert an jeder Zellenposition stellt die Kosten pro Einheitenentfernung für die Bewegung durch die Zelle dar. Jeder Zellenpositionswert wird mit der Zellenauflösung multipliziert, und gleichzeitig werden diagonale Bewegungen ausgeglichen, um die Gesamtkosten für die Bewegung durch die Zelle zu erhalten. Die Werte im Kosten-Raster können Ganzzahl- oder Gleitkommawerte sein, sie dürfen jedoch nicht negativ oder 0 sein (negative oder keine Kosten sind nicht zulässig).	Raster Layer; Image Service; String
Eingabe-Ziel-Raster oder -Features	Ein Image-Service oder Feature-Service, mit dem diejenigen Zellen identifiziert werden, für die die kostengünstigste Route berechnet wird.	Raster Layer; Image Service; Feature Layer; String
Name der Ausgabe-Polylinie	Der Name des Feature-Service für die Ausgabe-Polylinie. Der Polylinien-Feature-Service für die optimalen (kostengünstigsten) Routen zum Verbinden von Quellen und Zielen. Jede Route (bzw. Linie) ist eindeutig nummeriert und weist ein zusätzliches Feld in der Attributtabelle mit der Bezeichnung DestID auf. Darüber erfolgt die Rückverbindung zur eindeutigen Kennung auf dem Ziel-Raster. Da jeder Pfad durch eine eindeutige Linie dargestellt wird, weisen Positionen, an denen Pfade entlang derselben Route verlaufen, mehrere Linien auf.	String
Pfadtyp (optional)	Gibt an, auf welche Weise die Werte und Zonen der Eingabezieldaten in den Kostenpfadberechnungen interpretiert werden. Zu jeder Zelle—Für jede Zelle oder Position mit gültigen Werten in den Eingabezieldaten wird die kostengünstigste Route ermittelt und in der Ausgabe gespeichert. Mit dieser Option wird jede Zelle oder Position der Eingabezieldaten separat behandelt und die kostengünstigste Route für jede Ausgangszelle ermittelt. Zu jeder Zone—Für jede Zone in den Eingabezieldaten wird eine kostengünstigste Route ermittelt und in der Ausgabe gespeichert. Bei dieser Option beginnt die kostengünstigste Route für jede Zone bei der Position mit der niedrigsten Kostenentfernungsgewichtung in der Zone. Der Beste—Für alle Positionen in den Eingabezieldaten wird die kostengünstigste Route aus der Position mit der kostengünstigsten Route aus allen entsprechenden Routen zu Quellenpositionen abgeleitet. Dies ist die Standardeinstellung.	String
Zielfeld (optional)	Das Feld, das verwendet wird, um Werte für die Zielpositionen zu erhalten. Eingabe-Feature-Daten müssen mindestens ein gültiges ganzzahliges Feld enthalten.	Field

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Polylinien-Features	Die Ausgabe-Polylinien-Features.	Feature Class

Python

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})

Name	Erläuterung	Datentyp
inputSourceRasterOrFeatures	Ein Image-Service oder Feature-Service, der diejenigen Zellen identifiziert, von denen die kostengünstigste Route zu den Zielen ermittelt wird. Wenn die Eingabe ein Image-Service ist, besteht die Eingabe aus Zellen mit gültigen Werten (0 ist ein gültiger Wert), und den restlichen Zellen muss "NoData" zugewiesen werden.	Raster Layer; Image Service; Feature Layer; String
inputCostRaster	Der Name eines Image-Service für Kosten-Raster, der verwendet werden soll, um die kostengünstigste Route von den Quellen zu den Zielen zu ermitteln. Der Wert an jeder Zellenposition stellt die Kosten pro Einheitenentfernung für die Bewegung durch die Zelle dar. Jeder Zellenpositionswert wird mit der Zellenauflösung multipliziert, und gleichzeitig werden diagonale Bewegungen ausgeglichen, um die Gesamtkosten für die Bewegung durch die Zelle zu erhalten. Die Werte im Kosten-Raster können Ganzzahl- oder Gleitkommawerte sein, sie dürfen jedoch nicht negativ oder 0 sein (negative oder keine Kosten sind nicht zulässig).	Raster Layer; Image Service; String
inputDestinationRasterOrFeatures	Ein Image-Service oder Feature-Service, mit dem diejenigen Zellen identifiziert werden, für die die kostengünstigste Route berechnet wird.	Raster Layer; Image Service; Feature Layer; String
outputPolylineName	Der Name des Feature-Service für die Ausgabe-Polylinie. Der Polylinien-Feature-Service für die optimalen (kostengünstigsten) Routen zum Verbinden von Quellen und Zielen. Jede Route (bzw. Linie) ist eindeutig nummeriert und weist ein zusätzliches Feld in der Attributtabelle mit der Bezeichnung DestID auf. Darüber erfolgt die Rückverbindung zur eindeutigen Kennung auf dem Ziel-Raster. Da jeder Pfad durch eine eindeutige Linie dargestellt wird, weisen Positionen, an denen Pfade entlang derselben Route verlaufen, mehrere Linien auf.	String
pathType (optional)	Gibt an, auf welche Weise die Werte und Zonen der Eingabezieldaten in den Kostenpfadberechnungen interpretiert werden. EACH_CELL—Für jede Zelle oder Position mit gültigen Werten in den Eingabezieldaten wird die kostengünstigste Route ermittelt und in der Ausgabe gespeichert. Mit dieser Option wird jede Zelle oder Position der Eingabezieldaten separat behandelt und die kostengünstigste Route für jede Ausgangszelle ermittelt. EACH_ZONE—Für jede Zone in den Eingabezieldaten wird eine kostengünstigste Route ermittelt und in der Ausgabe gespeichert. Bei dieser Option beginnt die kostengünstigste Route für jede Zone bei der Position mit der niedrigsten Kostenentfernungsgewichtung in der Zone. BEST_SINGLE—Für alle Positionen in den Eingabezieldaten wird die kostengünstigste Route aus der Position mit der kostengünstigsten Route aus allen entsprechenden Routen zu Quellenpositionen abgeleitet. Dies ist die Standardeinstellung.	String
destinationField (optional)	Das Feld, das verwendet wird, um Werte für die Zielpositionen zu erhalten. Eingabe-Feature-Daten müssen mindestens ein gültiges ganzzahliges Feld enthalten.	Field

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
outputPolylineFeatures	Die Ausgabe-Polylinien-Features.	Feature Class

Codebeispiel

DetermineTravelCostPathAsPolyline – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Reisekosten zu Zielen berechnet.

import arcpy

arcpy.ra.DetermineTravelCostPathAsPolyline(
    "https://myserver/rest/services/sources/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/destination/ImageServer", 
    "outpath", "BEST_SINGLE")

DetermineTravelCostPathAsPolyline – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden die Reisekosten zu Zielen berechnet.

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathAsPolyline_Ex_02.py
# Description: Calculates the optimum travel cost path.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
inputCostLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputDestinationLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/destinationras/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceLayer, inputCostLayer,
                                           inputDestinationLayer, outputName, pathType)

Umgebungen

Zellengröße, Ausdehnung, Maske, Ausgabe-Koordinatensystem, Fang-Raster

Lizenzinformationen

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