Optimale Regionsverbindungen (Raster Analysis)—ArcGIS Pro

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 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.
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 Umgebungseinstellung 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-Raster oder Feature-Barrieren identifizierte Positionen 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.
Kosten-Raster-Werte, die negativ oder gleich Null sind, sind ungültig, werden jedoch als kleine positive Werte behandelt. Der Algorithmus für akkumulative Kosten ist ein multiplikativer Prozess, mit dem die akkumulativen Kosten nicht korrekt berechnet werden können, wenn Kostenwerte negativ oder Null sind. Wenn das Kosten-Raster diese Werte enthält und diese Positionen Gebiete darstellen, die aus der Analyse ausgeschlossen werden sollen, ändern Sie diese Zellen in NoData-Zellen, bevor Sie das Werkzeug ausführen. Verwenden Sie dazu das Werkzeug Auf NULL setzen der Erweiterung ArcGIS Spatial Analyst. Der NoData-Wert wird in dieser Analyse als Barriere behandelt, sodass Positionen, die in der Eingabe einen NoData-Wert aufweisen, im Ergebnis ebenfalls einen NoData-Wert aufweisen.
Wenn für den Parameter Name für Ausgabe der benachbarten Verbindungen 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.
Die Analyse-Umgebungseinstellung Maske kann auf ein Feature oder ein Raster-Dataset festgelegt werden. Wenn die Maske ein Feature ist, wird sie in ein Raster konvertiert. Die Zellen, die über einen Wert verfügen, definieren die Positionen, die im Maskenbereich liegen. NoData-Zellen definieren die Positionen, die sich außerhalb des Maskenbereichs befinden, und werden als Barriere behandelt.
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster- oder -Feature-Regionen	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
Name für Ausgabe der optimalen Verbindungslinien	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: PATHID: die eindeutige Kennung für den Layer PATHCOST: die akkumulative Gesamtentfernung oder die akkumulativen Gesamtkosten für den Pfad REGION1: die erste Region, die der Pfad verbindet REGION2: die andere Region, die der Pfad verbindet 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
Eingabe-Raster oder Feature-Barrieren (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. Bei einem Feature-Service kann der Eingabetyp ein Punkt, eine Linie oder ein Polygon 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
Eingabe-Kosten-Raster	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 des Kosten-Rasters können Ganzzahl- oder Gleitkommawerte sein. Kosten-Raster-Werte, die negativ oder gleich Null sind, sind ungültig, werden jedoch als kleine positive Kostenwerte behandelt.	Raster Layer; Image Service; String
Name für Ausgabe der benachbarten Verbindungen (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: PATHID: die eindeutige Kennung für den Layer PATHCOST: die akkumulative Gesamtentfernung oder die akkumulativen Gesamtkosten für den Pfad REGION1: die erste Region, die der Pfad verbindet REGION2: die andere Region, die der Pfad verbindet 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
Entfernungsmethode (optional)	Gibt an, ob die Berechnung mit einer planaren Methode (flache Erde) oder einer geodätischen Methode (Ellipsoid) erfolgt. Planar—Die Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung. Geodätisch—Die Entfernungsberechnung erfolgt für das Ellipsoid. Unabhängig von der Eingabe- oder Ausgabeprojektion ändern sich die Ergebnisse nicht.	String
Verbindungen innerhalb von Regionen (optional)	Gibt an, ob die Pfade fortgesetzt werden und innerhalb der Eingabe-Regionen verbunden werden. Verbindungen generieren—Pfade werden innerhalb der Eingabe-Regionen fortgesetzt, um alle Pfade zu verbinden, die in eine Region hineinführen. Keine Verbindungen—Pfade werden an den Kanten der Eingabe-Regionen beendet und nicht fortgesetzt bzw. nicht in den Regionen verbunden.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe der optimalen Verbindungslinien	Die Linien, mit denen die Regionen optimal verbunden werden.	Feature Class
Ausgabe benachbarter Verbindungen	Die Ausgabe-Nachbarverbindungs-Features.	Feature Class

arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})

Name	Erläuterung	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: PATHID: die eindeutige Kennung für den Layer PATHCOST: die akkumulative Gesamtentfernung oder die akkumulativen Gesamtkosten für den Pfad REGION1: die erste Region, die der Pfad verbindet REGION2: die andere Region, die der Pfad verbindet 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. Bei einem Feature-Service kann der Eingabetyp ein Punkt, eine Linie oder ein Polygon 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 des Kosten-Rasters können Ganzzahl- oder Gleitkommawerte sein. Kosten-Raster-Werte, die negativ oder gleich Null sind, sind ungültig, werden jedoch als kleine positive Kostenwerte behandelt.	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: PATHID: die eindeutige Kennung für den Layer PATHCOST: die akkumulative Gesamtentfernung oder die akkumulativen Gesamtkosten für den Pfad REGION1: die erste Region, die der Pfad verbindet REGION2: die andere Region, die der Pfad verbindet 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 Berechnung mit einer planaren Methode (flache Erde) oder einer geodätischen Methode (Ellipsoid) erfolgt. PLANAR—Die Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung. GEODESIC—Die Entfernungsberechnung erfolgt für das Ellipsoid. Unabhängig von der Eingabe- oder Ausgabeprojektion ändern sich die Ergebnisse nicht.	String
connectionsWithinRegions (optional)	Gibt an, ob die Pfade fortgesetzt werden und innerhalb der Eingabe-Regionen verbunden werden. GENERATE_CONNECTIONS—Pfade werden innerhalb der Eingabe-Regionen fortgesetzt, um alle Pfade zu verbinden, die in eine Region hineinführen. NO_CONNECTIONS—Pfade werden an den Kanten der Eingabe-Regionen beendet und nicht fortgesetzt bzw. nicht in den Regionen verbunden.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
outputOptimalLinesFeatures	Die Linien, mit denen die Regionen optimal verbunden werden.	Feature Class
outputNeighborConnectionFeatures	Die Ausgabe-Nachbarverbindungs-Features.	Feature Class

Codebeispiel

Optimal Region Connections: Beispiel 1 (Python-Fenster)

Dieses Beispiel berechnet die optimalen Verbindungen zwischen Regionen.

import arcpy

arcpy.ra.OptimalRegionConnections(
    "https://myserver/rest/services/regions/ImageServer", "outOptimalConnections",
    "https://myserver/rest/services/barriers/ImageServer",
    "https://myserver/rest/services/cost/ImageServer",
    "outNeighborConnections")

Optimal Region Connections: Beispiel 2 (eigenständiges Skript)

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.ra.OptimalRegionConnections(inputRegionsLayer, outputName, inputBarriersLayer,
                                  inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)

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

Zusammenfassung

Abbildung

Verwendung

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema