Verfolgungspositionen hinzufügen (Utility Network)

Zusammenfassung

Erstellt eine Feature-Class, die als Eingabe für die Startpunkte und Barrieren für das Werkzeug Verfolgen verwendet wird.

Verwendung

  • Die Ausgabe-Feature-Class weist dasselbe Schema auf wie die Eingabestartpunkte und Barrieren, die als Eingabe für das Werkzeug Verfolgen erforderlich sind. Dadurch können Sie verschiedene Verfolgungspositionen über mehrere Verfolgungsvorgänge hinweg in ModelBuilder oder in einer Skriptumgebung festlegen.

  • Es ist nicht möglich, gleichzeitig Werte für die Parameter Ausgewählte Features laden und Verfolgungspositionen festzulegen, da sich diese gegenseitig ausschließen.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Eingabe-Versorgungsnetz, dem die Verfolgungspositionen hinzugefügt werden.

Utility Network; Utility Network Layer
Ausgabe-Feature-Class

Die Ausgabe-Feature-Class, die die Verfolgungspositionen enthält. Wenn Sie einen neuen Feature-Class-Namen angeben, wird eine neue Ausgabe-Feature-Class erstellt.

Um eine vorhandene Feature-Class zu verwenden, die zuvor mit diesem Werkzeug erstellt wurde, und die vorhandenen Positionen anzuhängen oder zu überschreiben, geben Sie den Namen der vorhandenen Feature-Class an.

Feature Class
Ausgewählte Features laden
(optional)

Gibt an, ob ausgewählte Features in der aktiven Karte als Verfolgungspositionen geladen werden.

  • Aktiviert: Verfolgungspositionen werden anhand der Auswahl in der Karte geladen.
  • Deaktiviert: Verfolgungspositionen werden nicht anhand der Auswahl in der Karte geladen. Dies ist die Standardeinstellung. Jedoch können die Verfolgungspositionen mit dem Parameter Verfolgungspositionen geladen werden.

Boolean
Verfolgungspositionen löschen
(optional)

Gibt an, ob vorhandene Verfolgungspositionen aus der Ausgabe-Feature-Class gelöscht werden.

  • Aktiviert: Vorhandene Verfolgungspositionen werden gelöscht.
  • Deaktiviert: Vorhandene Verfolgungspositionen werden nicht gelöscht, sondern beibehalten. Dies ist die Standardeinstellung.

Boolean
Verfolgungspositionen
(optional)

Die Verfolgungspositionen, die der Ausgabe-Feature-Class hinzugefügt werden. Wenn Sie den Parameter Ausgewählte Features laden nicht in einer aktiven Karte verwenden, können Sie mit diesem Parameter die Versorgungsnetz-Features festlegen, die als Verfolgungspositionen hinzugefügt werden sollen, indem Sie die erforderlichen Werte in der Wertetabelle angeben.

Die Eigenschaften der Verfolgungspositionen lauten wie folgt:

  • Layer-Name: Der Layer, der an dem Versorgungsnetz beteiligt ist, das einen Startpunkt oder eine Barrierenposition enthält, der bzw. die hinzugefügt werden soll. Wenn eine aktive Karte vorhanden ist, sind nur Layer aus der Karte zulässig.
  • Global-ID: Die Global-ID des Layer-Features für die hinzuzufügende Position.
  • Anschlusspunkt-ID: Die Anschlusspunkt-ID des Layer-Features für die hinzuzufügende Position.
  • Prozent (entlang einer Linie): Der Prozentwert (entlang einer Linie) des Layer-Features. Für Linien-Features beträgt der Standardwert 0,5.

Value Table
Filterbarriere

Gibt an, ob sich die Barrieren für die Verfolgungspositionen wie Filterbarrieren verhalten.

  • Aktiviert: Die Barrieren verhalten sich wie Filterbarrieren. Dies ist nützlich bei teilnetzbasierten Verfolgungen, in denen die Barriere zunächst die Auswertung des Teilnetzes ermöglicht und anschließend bei einem zweiten Durchlauf der Netzwerk-Features angewendet wird.
  • Deaktiviert: Die Barrieren verhalten sich nicht wie Filterbarrieren, sondern wie Barrieren für die Durchlassfähigkeit, in denen die Ausdehnung der Teilnetze definiert und beim ersten Durchlauf ausgewertet wird. Dies ist die Standardeinstellung.

Hinweis:

Für diesen Parameter ist This parameter requires ArcGIS Enterprise10.8.1 oder höher erforderlich.

Boolean

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)
NameErläuterungDatentyp
in_utility_network

Das Eingabe-Versorgungsnetz, dem die Verfolgungspositionen hinzugefügt werden.

Utility Network; Utility Network Layer
out_feature_class

Die Ausgabe-Feature-Class, die die Verfolgungspositionen enthält. Wenn Sie einen neuen Feature-Class-Namen angeben, wird eine neue Ausgabe-Feature-Class erstellt.

Um eine vorhandene Feature-Class zu verwenden, die zuvor mit diesem Werkzeug erstellt wurde, und die vorhandenen Positionen anzuhängen oder zu überschreiben, geben Sie den Namen der vorhandenen Feature-Class an.

Feature Class
load_selected_features
(optional)

Gibt an, ob ausgewählte Features in der aktiven Karte als Verfolgungspositionen geladen werden.

  • LOAD_SELECTED_FEATURESVerfolgungspositionen werden anhand der Auswahl in der Karte geladen.
  • DO_NOT_LOAD_SELECTED_FEATURESVerfolgungspositionen werden nicht anhand der Auswahl in der Karte geladen. Dies ist die Standardeinstellung. Jedoch können die Verfolgungspositionen mit dem Parameter trace_locations geladen werden.
Boolean
clear_trace_locations
(optional)

Gibt an, ob vorhandene Verfolgungspositionen aus der Ausgabe-Feature-Class gelöscht werden.

  • CLEAR_LOCATIONSVorhandene Verfolgungspositionen werden gelöscht.
  • KEEP_LOCATIONSVorhandene Verfolgungspositionen werden nicht gelöscht, sondern beibehalten. Dies ist die Standardeinstellung.
Boolean
trace_locations
[[Layer Name, Global ID, Terminal ID, Percent Along],...]
(optional)

Die Verfolgungspositionen, die der Ausgabe-Feature-Class hinzugefügt werden. Wenn Sie den Parameter load_selected_features nicht in einer aktiven Karte verwenden, können Sie mit diesem Parameter die Versorgungsnetz-Features festlegen, die als Verfolgungspositionen hinzugefügt werden sollen, indem Sie die erforderlichen Werte in der Wertetabelle angeben.

Die Eigenschaften der Verfolgungspositionen lauten wie folgt:

  • Layer Name: Der Layer oder die Feature-Class, der bzw. die an dem Versorgungsnetz beteiligt ist, das einen Startpunkt oder eine Barrierenposition enthält, der bzw. die hinzugefügt werden soll. Wenn eine aktive Karte vorhanden ist, sind nur Layer aus der Karte zulässig. Anderenfalls stellt dies den Feature-Class-Namen dar.
  • Global ID: Die Global-ID des Features für die hinzuzufügende Position.
  • Terminal ID: Die Anschlusspunkt-ID des Features für die hinzuzufügende Position.
  • Percent Along: Der Prozentwert (entlang einer Linie) des Features. Für Linien-Features beträgt der Standardwert 0,5.

Value Table
filter_barrier

Gibt an, ob sich die Barrieren für die Verfolgungspositionen wie Filterbarrieren verhalten.

Weitere Informationen zu Barrieren

  • FILTER_BARRIERDie Barrieren verhalten sich wie Filterbarrieren. Dies ist nützlich bei teilnetzbasierten Verfolgungen, in denen die Barriere zunächst die Auswertung des Teilnetzes ermöglicht und anschließend bei einem zweiten Durchlauf der Netzwerk-Features angewendet wird.
  • TRAVERSABILITY_BARRIERDie Barrieren verhalten sich wie Barrieren für die Durchlassfähigkeit, in denen die Ausdehnung der Teilnetze definiert und beim ersten Durchlauf ausgewertet wird. Dies ist die Standardeinstellung.
Hinweis:

Für diesen Parameter ist ArcGIS Enterprise10.8.1 oder höher erforderlich.

Boolean

Codebeispiel

AddTraceLocations – Beispiel 1 (Python-Fenster)

Mit diesem Beispielskript werden einer neuen Ausgabe-Feature-Class mit der Bezeichnung "TraceLocations" Verfolgungspositionen hinzugefügt, indem in der aktiven Karte ausgewählte Features geladen werden.

import arcpy
arcpy.env.outputZFlag = "Enabled"
arcpy.AddTraceLocations_un("Naperville Electric UN", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "LOAD_SELECTED_FEATURES")
AddTraceLocations – Beispiel (eigenständiges Skript)

Mit diesem Beispielskript werden einer vorhandenen Feature-Class mit der Bezeichnung "TraceLocations" Verfolgungspositionen ohne aktive Karte hinzugefügt.


import arcpy

# Set the outputZFlag environment to Enabled
arcpy.env.outputZFlag = "Enabled"

# AddTraceLocations
arcpy.AddTraceLocations_un(r"http://utilitynetwork.esri.com/server/rest/services/NapervilleElectric/FeatureServer/9", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "DO_NOT_LOAD_SELECTED_FEATURES",
                           "KEEP_LOCATIONS",
                           r"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' '';'Circuit Breaker' {4849D307-6413-40B7-B672-716AF50EE6E6} '(3/Load)' '' )

Lizenzinformationen

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

Verwandte Themen