Geometrisches Netzwerk verfolgen

Zusammenfassung

Löst ein bestimmtes Netzwerk-Analyseproblem mithilfe von Flags, Barrieren und festgelegten Gewichtungseigenschaften.

Verwendung

• Dieses Werkzeug funktioniert nicht mit Netzwerk-Datasets (den Netzwerken, die von der Erweiterung "ArcGIS Network Analyst" verwendet werden).

• Mit diesem Werkzeug wird eine räumliche Suche mithilfe von Eingabe-Flags und Barrieren durchgeführt, um lagegleiche Features zu finden. Mit Flags wird angegeben, von welchen Features die Verfolgung ausgehen soll. Mit Barrieren wird dagegen festgelegt, welche Features die Verfolgung blockieren sollen. Die Position von Eingabe-Flags und Barrieren muss daher präzise angegeben werden. Wenn Sie sich nicht sicher sind, ob sich die Flags und Barrieren an der richtigen Position befinden, können Sie in ModelBuilder das Werkzeug Fangen verwenden, um festzulegen, mit welchen Features die Flags und Barrieren lagegleich sein sollen.

• Die Ausgabe dieses Werkzeugs ist ein Gruppen-Layer mit einem Layer für jede Feature-Class, die sich im geometrischen Eingabe-Netzwerk befindet. Alle im Rahmen der Verfolgung zurückgegebenen Features werden innerhalb des betreffenden Layers ausgewählt. Wenn die Eingabe-Layer in der Karte vorhanden sind, kann der Ausgabe-Gruppen-Layer auch Layer ohne Auswahl enthalten; dies sind leere Layer, die bei der Verfolgung keine Features zurückgegeben haben. In ModelBuilder können Sie das Werkzeug Daten auswählen verwenden, um spezifische Layer aus dem Gruppen-Layer zu extrahieren. Mit dem Werkzeug Feature-Layer erstellen können Sie einen Feature-Layer aus der Ausgabe des Werkzeugs Daten auswählen erstellen. Verwenden Sie das Werkzeug Anzahl erhalten, um zu bestimmen, ob irgendein Layer innerhalb des Gruppen-Layers leer ist. Dies ist vor allem beim Veröffentlichen des Modells in ArcGIS for Server hilfreich, da Gruppen-Layer nicht als Ausgabeparametertyp eines Geoverarbeitungs-Task unterstützt werden. Da sie nicht als direkte Ausgabe unterstützt werden, müssen Sie das Werkzeug Daten auswählen verwenden, um einen einzelnen Layer (keinen Gruppen-Layer) für die Ausgabe zu erstellen.

• Dieses Werkzeug kann nicht ausgeführt werden, während Sie ein geometrisches Netzwerk in einer Personal-Geodatabase bearbeiten.

• Im Gegensatz zu anderen Datasets, wie Topologie- oder Netzwerk-Datasets, haben geometrische Netzwerke keinen zugehörigen Layer; wenn dieses Werkzeug in ArcMap verwendet wird, muss das geometrische Netzwerk daher von einem Datenträger ausgewählt werden. In Layer-Dropdown-Listen ist keine Option zum Auswählen eines geometrischen Netzwerks als Eingabe vorhanden.

Syntax

arcpy.management.TraceGeometricNetwork(in_geometric_network, out_network_layer, in_flags, in_trace_task_type, {in_barriers}, {in_junction_weight}, {in_edge_along_digitized_weight}, {in_edge_against_digitized_weight}, {in_disable_from_trace}, {in_trace_ends}, {in_trace_indeterminate_flow}, {in_junction_weight_filter}, {in_junction_weight_range}, {in_junction_weight_range_not}, {in_edge_along_digitized_weight_filter}, {in_edge_against_digitized_weight_filter}, {in_edge_weight_range}, {in_edge_weight_range_not})

Parameter	Erklärung	Datentyp
in_geometric_network	Das geometrische Netzwerk, für das die Verfolgung ausgeführt wird.	Geometric Network
out_network_layer	Der Name des Gruppen-Layers, in dem die Ergebnisse der Verfolgung als ausgewählter Satz gespeichert werden.	Group Layer
in_flags	Punkt-Features, die eine Gruppe von Flags darstellen, die als Startpunkte für die Verfolgung dienen. Wenn Sie z. B. eine Verfolgung flussaufwärts durchführen, können Sie ein Flag verwenden, um festzulegen, wo diese Verfolgung beginnen soll. Flags können an einer beliebigen Position entlang von Kanten oder Knoten platziert werden; Knoten werden jedoch zuerst berücksichtigt, wenn sowohl ein Knoten als auch eine Kante an einer Position gefunden werden.	Feature Layer
in_trace_task_type	Verfolgungs-Task, der für das angegebene geometrische Netzwerk ausgeführt werden soll. FIND_COMMON_ANCESTORS — Suchen von ähnlichen Features, die sich flussaufwärts von einem Punkt-Set in Ihrem Netzwerk befinden. Dafür muss die Fließrichtung für das geometrische Netzwerk festgelegt sein. FIND_CONNECTED —Suchen von Features, die über Ihr Netzwerk mit einem bestimmten Punkt verbunden sind. FIND_LOOPS — Suchen von Schleifen innerhalb des Netzwerks. Diese werden wie folgt definiert: Es werden für jedes verbundene Feature, auf dem Sie ein Flag platziert haben, die Features ermittelt, die eine Schleife zurück zu sich selbst bilden (also nur aus einer Richtung erreicht werden können). FIND_DISCONNECTED — Suchen aller Features, die nicht über Ihr Netzwerk mit einem gegebenen Punkt verbunden sind. FIND_PATH_UPSTREAM — Suchen eines Pfads flussaufwärts von einem Punkt in Ihrem Netzwerk. Der gefundene Pfad kann zu einer Reihe von Pfaden gehören, je nachdem, ob Ihr Netzwerk Schleifen enthält. Die auf dem Netzwerk platzierten Flags können eine Mischung aus Kanten- und Knoten-Flags sein. Diese Einstellung erfordert, dass eine Gewichtung für die Verfolgung und eine Fließrichtung für das geometrische Netzwerk festgelegt ist. Ist keine Gewichtung angegeben, wird der kürzeste Pfad anhand der geringsten Anzahl an Features zwischen den beiden Punkten bestimmt. FIND_PATH — Suchen eines Pfads zwischen zwei oder mehr Flags im Netzwerk. Der gefundene Pfad kann zu einer Reihe von Pfaden zwischen den Flags gehören, je nachdem, ob Ihr Netzwerk Schleifen enthält. Die auf dem Netzwerk platzierten Flags müssen entweder ausschließlich Kanten- oder ausschließlich Knoten-Flags sein. Ist keine Gewichtung angegeben, wird der kürzeste Pfad anhand der geringsten Anzahl an Features zwischen den beiden Punkten bestimmt. TRACE_DOWNSTREAM —Suchen der Netzwerk-Features, die von einem gegebenen Punkt in Ihrem Netzwerk flussabwärts (in Fließrichtung) liegen. Dafür muss die Fließrichtung für das geometrische Netzwerk festgelegt sein. FIND_UPSTREAM_ACCUMULATION — Ermittelt die Gesamtkosten aller Netzwerk-Features, die von einem gegebenen Punkt in Ihrem Netzwerk flussaufwärts liegen. Diese Einstellung erfordert, dass eine Gewichtung für die Verfolgung und eine Fließrichtung für das geometrische Netzwerk festgelegt ist. TRACE_UPSTREAM — Suchen der Features, die von einem gegebenen Punkt in Ihrem Netzwerk flussaufwärts (entgegen der Fließrichtung) liegen. Dafür muss die Fließrichtung für das geometrische Netzwerk festgelegt sein.	String
in_barriers (optional)	Punkt-Features, die eine Gruppe von Barrieren darstellen. Barrieren definieren Punkte im Netz, durch die keine Verfolgung verlaufen kann. Wenn Sie nur einen bestimmten Teil des Netzwerks verfolgen möchten, können Sie Barrieren verwenden, um diesen Teil vom restlichen Netzwerk zu isolieren. Barrieren können an einer beliebigen Position entlang von Kanten oder Knoten platziert werden; Knoten werden jedoch zuerst berücksichtigt, wenn sowohl ein Knoten als auch eine Kante an einer Position gefunden werden. Das Feature wird als deaktiviert betrachtet und bei der Verfolgung nicht berücksichtigt, es sei denn, der Parameter in_trace_ends ist auf TRACE_ENDS eingestellt, wodurch gezielt nach Features gesucht wird, die die Verfolgung stoppen.	Feature Layer
in_junction_weight (optional)	Eine Knotengewichtung, die als Kostenfaktor für das Queren eines beliebigen Knotens verwendet wird. Die Gewichtung muss bereits für das gegebene geometrische Netzwerk definiert worden sein. Dieser Parameter wird deaktiviert oder ignoriert, wenn einer der folgenden kostenunabhängigen Verfolgungs-Task-Typen angegeben wurde: FIND_COMMON_ANCESTORS FIND_CONNECTED FIND_LOOPS FIND_DISCONNECTED TRACE_DOWNSTREAM TRACE_UPSTREAM	String
in_edge_along_digitized_weight (optional)	Eine Kantengewichtung, die als Kostenfaktor für das Queren einer Kante entlang der Digitalisierrichtung dieser Kante verwendet wird. Die Gewichtung muss bereits für das gegebene geometrische Netzwerk definiert worden sein. Dieser Parameter wird deaktiviert oder ignoriert, wenn einer der folgenden kostenunabhängigen Verfolgungs-Task-Typen angegeben wurde: FIND_COMMON_ANCESTORS FIND_CONNECTED FIND_LOOPS FIND_DISCONNECTED TRACE_DOWNSTREAM TRACE_UPSTREAM	String
in_edge_against_digitized_weight (optional)	Eine Kantengewichtung, die als Kostenfaktor für das Queren einer Kante entgegen der Digitalisierrichtung dieser Kante verwendet wird. Die Gewichtung muss bereits für das gegebene geometrische Netzwerk definiert worden sein. Dieser Parameter wird deaktiviert oder ignoriert, wenn einer der folgenden kostenunabhängigen Verfolgungs-Task-Typen angegeben wurde: FIND_COMMON_ANCESTORS FIND_CONNECTED FIND_LOOPS FIND_DISCONNECTED TRACE_DOWNSTREAM TRACE_UPSTREAM	String
in_disable_from_trace [in_disable_from_trace,...] (optional)	Liste der Feature-Classes, die aus der Verfolgung ausgeschlossen sind. Durch das Ausschließen einer Feature-Class werden alle Features in dieser Feature-Class so behandelt, als wären sie deaktiviert oder als würde sich eine Barriere auf ihnen befinden. Verwenden Sie diese Option, wenn Sie eine gesamte Feature-Class aus der Verfolgung ausschließen möchten. Beispiel: Durch Deaktivieren des Schalter-Layers in einem Stromversorgungsnetz, Festlegen des Parameters in_trace_ends auf TRACE_ENDS und Verfolgen von einem bestimmten Punkt im Netz aus können Sie Schalter finden, die ausgeschaltet werden müssen, um diesen Punkt vom Netz abzutrennen. An diesen Features wird die Verfolgung dann angehalten.	String
in_trace_ends (optional)	Legt fest, ob bei der Verfolgung alle Features einbezogen werden sollen, oder nur die Features, die die Verfolgung beenden. Verwenden Sie diese Option, wenn Sie herausfinden möchten, durch welche Features die Verfolgung beendet wird. Damit die Features im Rahmen des Verfolgungsvorgangs mithilfe dieser Option zurückgegeben werden, müssen sie in eine der folgenden Kategorien fallen: Das Feature ist nur mit einem anderen Feature des geometrischen Netzwerks verbunden. Das Feature ist deaktiviert (einschließlich Features in deaktivierten Feature-Classes). Auf dem Feature befindet sich eine Barriere. TRACE_ENDS —Features, durch die die Verfolgung beendet wird, werden einbezogen. NO_TRACE_ENDS —Alle Features werden einbezogen. Dies ist die Standardeinstellung.	Boolean
in_trace_indeterminate_flow (optional)	Legt fest, ob bei der Verfolgung alle Features einbezogen werden sollen, oder nur die Features, die die Verfolgung beenden. TRACE_INDETERMINATE_FLOW —Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden verfolgt. NO_TRACE_INDETERMINATE_FLOW —Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden nicht verfolgt. Dies ist die Standardeinstellung. Dies wird nur berücksichtigt, wenn ein fließabhängiger Verfolgungs-Task-Typ festgelegt ist: FIND_PATH_UPSTREAM TRACE_DOWNSTREAM FIND_UPSTREAM_ACCUMULATION TRACE_UPSTREAM	Boolean
in_junction_weight_filter (optional)	Die Gewichtung, die beim Erstellen des Knotengewichtungsfilters verwendet wird. Dieser Filter dient zum Filtern von Knoten-Features während der Verfolgung.	String
in_junction_weight_range (optional)	Gibt gültige oder ungültige Bereiche von Gewichtungswerten für die Netzwerk-Features an, die verfolgt werden können. Dies ist deaktiviert, wenn ein kostenunabhängiger Verfolgungs-Task-Typ festgelegt ist. Zum Erstellen eines Gewichtungsfilters müssen Sie gültige Gewichtungsbereiche für die Features angeben. Ein Gewichtungsfilter kann sich aus mehreren Bereichen zusammensetzen. Wenn Sie mehrere Gewichtungsbereiche angeben, müssen Sie diese durch Kommas voneinander trennen. Der niedrigste und der höchste Wert in einem Bereich werden durch einen Bindestrich getrennt. Bereiche, die aus einem einzelnen Wert bestehen, enthalten keinen Bindestrich und werden durch Kommas abgetrennt, z. B.: 0-2,3,6,7-10.	String
in_junction_weight_range_not (optional)	Wendet den logischen Operator NOT auf die angegebenen Gewichtungsbereiche an. Standardmäßig geben die von Ihnen eingegebenen Knotengewichtungsbereiche Knoten-Features an, die verfolgt werden können. Durch die Auswahl dieser Option legen Sie fest, dass Knoten-Features mit Gewichtungen in den von Ihnen eingegebenen Bereichen nicht verfolgt werden können. AS_IS —Durch die Gewichtungsbereiche werden Features angegeben, die verfolgt werden können. Dies ist die Standardeinstellung. NOT —Durch die Gewichtungsbereiche werden Features angegeben, die nicht verfolgt werden können.	Boolean
in_edge_along_digitized_weight_filter (optional)	Die Gewichtung, die beim Erstellen des Gewichtungsfilters entlang Kanten verwendet wird. Der Filter dient zum Filtern von Kanten-Features während der Verfolgung.	String
in_edge_against_digitized_weight_filter (optional)	Die Gewichtung, die beim Erstellen des Gewichtungsfilters entgegen Kanten verwendet wird. Der Filter dient zum Filtern von Kanten-Features während der Verfolgung.	String
in_edge_weight_range (optional)	Gibt gültige oder ungültige Bereiche von Gewichtungswerten für die Netzwerk-Features an, die verfolgt werden können. Dies ist deaktiviert, wenn ein kostenunabhängiger Verfolgungs-Task-Typ festgelegt ist. Zum Erstellen eines Gewichtungsfilters müssen Sie gültige Gewichtungsbereiche für die Features angeben. Ein Gewichtungsfilter kann sich aus mehreren Bereichen zusammensetzen. Wenn Sie mehrere Gewichtungsbereiche angeben, müssen Sie diese durch Kommas voneinander trennen. Der niedrigste und der höchste Wert in einem Bereich werden durch einen Bindestrich getrennt. Bereiche, die aus einem einzelnen Wert bestehen, enthalten keinen Bindestrich und werden durch Kommas abgetrennt, z. B.: 0-2,3,6,7-10.	String
in_edge_weight_range_not (optional)	Wendet den logischen Operator NOT auf die angegebenen Kantengewichtungsbereiche an. Standardmäßig geben die von Ihnen eingegebenen Kantengewichtungsbereiche Kanten-Features an, die verfolgt werden können. Durch die Auswahl dieser Option legen Sie fest, dass Kanten-Features mit Gewichtungen in den von Ihnen eingegebenen Bereichen nicht verfolgt werden können. AS_IS —Durch die Gewichtungsbereiche werden Features angegeben, die verfolgt werden können. Dies ist die Standardeinstellung. NOT —Durch die Gewichtungsbereiche werden Features angegeben, die nicht verfolgt werden können.	Boolean

Codebeispiel

TraceGeometricNetwork – Beispiel 1 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion "TraceGeometricNetwork" in Python-Skripten verwendet wird, um den Verfolgungs-Task "FIND_CONNECTED" für ein geometrisches Netzwerk mit Flags und ohne Barrieren auszuführen.

# Import arcpy module
import arcpy

# Local variables:
gnVersionFDS_Net = "C:/GeometricNetworks/GeometricNetwork.gdb/gnVersionFDS_with_GN/gnVersionFDS_1_Net"
Flags = "C:/GeometricNetworks/GeometricNetwork.gdb/gnVersionFDS_with_GN/Flags"
gnVersionFDS_1 = "gnVersionFDS_1_Net"

# Process: Trace Geometric Network
arcpy.TraceGeometricNetwork_management(gnVersionFDS_Net, gnVersionFDS_1, Flags, "FIND_CONNECTED", "", "", "", "", "", "NO_TRACE_ENDS", "", "", "", "AS_IS", "", "", "", "AS_IS")

TraceGeometricNetwork – Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion "TraceGeometricNetwork" in Python-Skripten verwendet wird, um den Verfolgungs-Task "FIND_PATH" für ein geometrisches Netzwerk mit Flags, ohne Barrieren und mit der Gewichtung "Friction_Factor" und einem Gewichtungsfilter von 1 bis 10 auszuführen.

# Import arcpy module
import arcpy

# Local variables:
Water_Net = "C:/GeometricNetworks/Montgomery.gdb/Water/Water_Net"
Flags = "C:/GeometricNetworks/Montgomery.gdb/Water/Flags"
Water_Net_2 = "Water_Net"

# Process: Trace Geometric Network
arcpy.TraceGeometricNetwork_management(Water_Net, Water_Net_2, Flags, "FIND_PATH", "", "", "Friction_Factor", "Friction_Factor", "", "NO_TRACE_ENDS", "", "", "", "AS_IS", "Friction_Factor", "Friction_Factor", "1-10", "AS_IS")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Nein
• Standard: Ja
• Advanced: Ja