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

Abbildung zum Werkzeug "Reisekostenpfad als Polylinie ermitteln"

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

BeschriftungErläuterungDatentyp
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 ZelleFü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 ZoneFü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 BesteFü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

BeschriftungErläuterungDatentyp
Ausgabe-Polylinien-Features

Die Ausgabe-Polylinien-Features.

Feature Class

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
NameErläuterungDatentyp
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_CELLFü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_ZONEFü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_SINGLEFü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

NameErläuterungDatentyp
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)

Lizenzinformationen

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

Verwandte Themen