Zusammenfassung
Berechnet die Verbindung von Pfaden zwischen mindestens zwei Eingabe-Regionen.
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.
In einem Raster ist eine Region eine Gruppe von Zellen mit identischem Wert, die zusammenhängen (benachbart sind). Wenn Ihre Eingabe-Regionen durch ein Raster identifiziert sind und Zonen (Zellen mit demselben Wert) vorhanden sind, die aus mehreren Regionen bestehen, führen Sie als Vorverarbeitungsschritt zunächst das Spatial Analyst-Werkzeug Gruppierung zu Regionen aus, um jeder Region Einzelwerte zuzuweisen. Verwenden Sie das resultierende Raster als Eingabe-Regionen für das Werkzeug Optimale Regionsverbindungen.
Wenn die Eingabe-Regionen Raster sind und der Bereich der Zeilen-IDs sehr groß ist, kann dies (auch wenn es nur wenige Regionen gibt) negative Auswirkungen auf die Performance des Werkzeugs haben.
Wenn die Regionseingabe ein Feature-Service ist, werden die Regionen intern in ein Raster konvertiert, bevor die Analyse ausgeführt wird.
Die Auflösung des Rasters kann mithilfe der Umgebung der Zellengröße gesteuert werden. Wenn im Werkzeug keine anderen Raster angegeben sind, entspricht die Auflösung der Breite oder Höhe (der jeweils kleinere Wert) standardmäßig der Ausdehnung des Eingabe-Features im Eingabe-Raumbezug, dividiert durch 250.
Wenn es sich bei der Regionseingabe um ein Feature handelt, wird das Feld ObjectID als Regionsidentifikator verwendet.
Anhand des Parameters Eingabe-Barriere-Raster- oder -Feature-Daten identifizierte Position oder Zellenpositionen mit NoData-Werten im Parameter Eingabe-Kosten-Raster fungieren als Barrieren.
Die standardmäßige Verarbeitungsausdehnung entspricht der des Eingabe-Kosten-Rasters, sofern angegeben; anderenfalls wird die Ausdehnung der Eingabe-Regionen verwendet.
Das Eingabe-Kosten-Raster darf keine Null-Werte enthalten, da der Algorithmus ein multiplikativer Prozess ist. Wenn das Kosten-Raster Werte von 0 enthält und diese Werte Gebiete mit niedrigsten Kosten darstellen, ändern Sie diese Zellen in einen kleinen positiven Wert (z. B. 0,01), bevor Sie dieses Werkzeug ausführen.
Wenn für den Parameter Name der Ausgabe-Nachbarverbindungen keine Kostenoberfläche angegeben wurde, werden die Nachbarn anhand der euklidischen Entfernung identifiziert. Der nächste Nachbar einer Region ist dann die Region in der kürzesten Entfernung. Wenn jedoch eine Kostenoberfläche angegeben wurde, werden die Nachbarn anhand der Kostenentfernung identifiziert. Der nächste Nachbar einer Region ist dann die Region, die auf die kostengünstigste Weise erreicht werden kann. Es wird ein Kostenzuordnungsvorgang durchgeführt, um zu ermitteln, welche Regionen benachbart sind.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})| Parameter | Erklärung | Datentyp |
inputRegionRasterOrFeatures | Die Eingabe-Regionen, die durch das optimale Netzwerk verbunden werden sollen. Regionen können nach Raster oder Feature-Daten definiert werden. Wenn die Region-Eingabe "Raster" ist, werden die Regionen nach Gruppen zusammenhängender (benachbarter) Zellen mit identischem Wert definiert. Jede Region muss eindeutig nummeriert sein. Die Zellen, die nicht Teil einer Region sind, müssen vom Typ "NoData" sein. Der Rastertyp muss ein Ganzzahlwert sein, und die Werte können positiv oder negativ sein. Wenn die Region-Eingabe "Feature-Daten" ist, kann es sich um Polygone, Linien oder Punkte handeln. Polygon-Feature-Regionen dürfen nicht aus Multipart-Polygonen bestehen. | Raster Layer; Image Service; Feature Layer; String |
outputOptimalLinesName | Der Name des Ausgabelinien-Feature-Service, der die einzelnen Eingaberegionen verbindet. Jeder Pfad (oder jede Linie) ist eindeutig nummeriert und spezifische Informationen zu dem Pfad werden in zusätzlichen Feldern in der Attributtabelle gespeichert. Dabei handelt es sich um folgende Felder:
Diese Informationen geben Aufschluss über die Pfade innerhalb des Netzwerks. Da jeder Pfad durch eine eindeutige Linie dargestellt wird, weisen Positionen, an denen Pfade an derselben Route verlaufen, mehrere Linien auf. | String |
inputBarrierRasterOrFeatures (optional) | Das Dataset, das die Barrieren definiert. Die Barrieren können durch einen Ganzzahl- oder Gleitkomma-Image-Service oder durch einen Feature-Service definiert sein. Für eine Image-Service-Barriere muss die Barriere einen gültigen Wert, einschließlich Null, aufweisen, und die Flächen, die keine Barrieren sind, müssen NoData-Flächen sein. | Raster Layer; Image Service; Feature Layer; String |
inputCostRaster | Ein Image-Service, der die Impedanz oder die Kosten für eine planimetrische Bewegung durch jede Zelle definiert. 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 |
outputNeighborConnectionsName (optional) | Die Ausgabe-Polyline-Feature-Class, die alle Pfade von jeder Region zu jeder ihrer nächstgelegenen Nachbarn identifiziert. Jeder Pfad (oder jede Linie) ist eindeutig nummeriert und spezifische Informationen zu dem Pfad werden in zusätzlichen Feldern in der Attributtabelle gespeichert. Dabei handelt es sich um folgende Felder:
Mit diesen Angaben erhalten Sie nähere Informationen über die im Netzwerk enthaltenen Pfade. Dies ist nützlich, wenn Entscheidungen über zu entfernende Pfade getroffen werden sollen. Da jeder Pfad durch eine eindeutige Linie dargestellt wird, weisen Positionen, an denen Pfade an derselben Route verlaufen, mehrere Linien auf. | String |
distanceMethod (optional) | Gibt an, ob die Entfernung mithilfe einer planaren (flache Erde) oder geodätischen (Ellipsoid) Methode berechnet werden soll.
| String |
connectionsWithinRegions (optional) | Gibt an, ob die Pfade fortgesetzt und innerhalb der Eingaberegionen verbunden werden.
| String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| outputOptimalLinesFeatures | Die Linien, mit denen die Regionen optimal verbunden werden. | Feature-Class |
| outputNeighborConnectionFeatures | Die Ausgabe-Nachbarverbindungs-Features. | Feature-Class |
Codebeispiel
Dieses Beispiel berechnet die optimalen Verbindungen zwischen Regionen.
import arcpy
arcpy.OptimalRegionConnections_ra(
"https://myserver/rest/services/regions/ImageServer", "outOptimalConnections",
"https://myserver/rest/services/barriers/ImageServer",
"https://myserver/rest/services/cost/ImageServer",
"outNeighborConnections")Dieses Beispiel berechnet die optimalen Verbindungen zwischen Regionen.
#-------------------------------------------------------------------------------
# Name: OptimalRegionConnections_Ex_02.py
# Description: Calculates the optimal connections between regions.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inputRegionsLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/regions/ImageServer'
outputName = 'outOptimalConnections'
inputBarriersLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/barriers/ImageServer'
inputCostLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
outputName02 = 'outNeighborConnections'
distanceMethod = 'GEODESIC'
connectionsWithinRegions = 'GENERATE_CONNECTIONS'
arcpy.OptimalRegionConnections_ra(inputRegionsLayer, outputName, inputBarriersLayer,
inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)Umgebungen
Lizenzinformationen
- Basic: Erfordert ArcGIS Image Server
- Standard: Erfordert ArcGIS Image Server
- Advanced: Erfordert ArcGIS Image Server