Zusammenfassung
Berechnet den kostengünstigsten Pfad zwischen Quellen und Zielen als Polylinie.
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.
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.
Syntax
arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
Parameter | Erklärung | 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 ganzzahlige 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.
| 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 | Erklärung | Datentyp |
outputPolylineFeatures | Die Ausgabe-Polylinien-Features. | Feature-Class |
Codebeispiel
In diesem Beispiel werden die Reisekosten zu Zielen berechnet.
import arcpy
arcpy.DetermineTravelCostPathAsPolyline_ra(
"https://myserver/rest/services/sources/ImageServer",
"https://myserver/rest/services/costsurface/ImageServer",
"https://myserver/rest/services/destination/ImageServer",
"outpath", "BEST_SINGLE")
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.DetermineTravelCostPathAsPolyline_ra(inputSourceLayer, inputCostLayer,
inputDestinationLayer, outputName, pathType)
Umgebungen
Lizenzinformationen
- Basic: Erfordert ArcGIS Image Server
- Standard: Erfordert ArcGIS Image Server
- Advanced: Erfordert ArcGIS Image Server