Optimale Regionsverbindungen (Raster Analysis)

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 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.

• 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.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Regionen-Raster oder -Features	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 der optimalen Ausgabe-Konnektivitätslinien	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-Barriere-Raster oder -Features (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 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
Name der Ausgabe-Nachbarverbindungen (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 und innerhalb der Eingaberegionen verbunden werden. Verbindungen generieren—Pfade werden innerhalb der Eingaberegionen fortgesetzt, um alle Pfade zu verbinden, die in eine Region hineinführen. Keine Verbindungen—Pfade werden an den Kanten der Eingaberegionen beendet und nicht fortgesetzt bzw. nicht in den Regionen verbunden.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Optimale Ausgabe-Konnektivitätslinien	Die Linien, mit denen die Regionen optimal verbunden werden.	Feature-Class
Ausgabe-Nachbarverbindungen	Die Ausgabe-Nachbarverbindungs-Features.	Feature-Class

Python

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 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
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 und innerhalb der Eingaberegionen verbunden werden. GENERATE_CONNECTIONS—Pfade werden innerhalb der Eingaberegionen fortgesetzt, um alle Pfade zu verbinden, die in eine Region hineinführen. NO_CONNECTIONS—Pfade werden an den Kanten der Eingaberegionen 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

Optimale Regionsverbindungen – 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")

Optimale Regionsverbindungen – 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