Erstellt eine Feature-Class, die als Eingabe für die Startpunkte, Endpunkte 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 Python 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.
Das Eingabe-Versorgungsnetz, dem die Verfolgungspositionen hinzugefügt werden.
Wichtig
Wenn das für das Eingabe-Versorgungsnetz angegebene Versorgungsnetz eine Telekommunikationsnetzart enthält, enthalten die Ausgabe-Verfolgungspositionen drei zusätzliche Felder: FIRSTUNIT, LASTUNIT und COLORSCHEME. Diese Felder müssen in der Ausgabe-Feature-Class manuell geändert werden, um die Einheitenkennungen in den gruppierten Objekten anzugeben, auf die die Verfolgungsposition angewendet wird.
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. Sie können den Namen einer vorhandenen Feature-Class angeben und wählen, dass an beliebige vorhandene Verfolgungspositionen in der Feature-Class angehängt wird, oder Sie können diese mit dem Parameter Verfolgungspositionen löschen überschreiben.
Hinweis:
Bei Verwendung von Utility Network-Version 7 oder höher muss die Ausgabe-Feature-Class in einer Mobile-, File- oder Enterprise-Geodatabase erstellt werden.
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 angegeben 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, und an sie wird angehängt. 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.
Spalten der Wertetabelle:
Layer Name—The layer that contains the locations to add.
Global ID—The Global ID of the feature for the location to add.
Terminal—The terminal ID of the feature for the location to add.
Percent Along—The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
Filterbarriere
Gibt an, ob sich die Verfolgungspositionen wie Filterbarrieren verhalten, wenn sie als Barrieren verwendet werden.
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 wie Barrieren für die Durchlassfähigkeit, in denen die Ausdehnung der Teilnetze definiert und beim ersten Durchlauf ausgewertet wird. Dies ist die Standardeinstellung.
Das Eingabe-Versorgungsnetz, dem die Verfolgungspositionen hinzugefügt werden.
Wichtig
Wenn das für den Parameter in_utility_network angegebene Versorgungsnetz eine Telekommunikationsnetzart enthält, enthalten die Ausgabe-Verfolgungspositionen drei zusätzliche Felder: FIRSTUNIT, LASTUNIT und COLORSCHEME. Diese Felder müssen in der Ausgabe-Feature-Class manuell geändert werden, um die Einheitenkennungen in den gruppierten Objekten anzugeben, auf die die Verfolgungsposition angewendet wird.
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. Sie können den Namen einer vorhandenen Feature-Class angeben und wählen, dass an beliebige vorhandene Verfolgungspositionen in der Feature-Class angehängt wird, oder Sie können diese mit dem Parameter clear_trace_locations löschen überschreiben.
Hinweis:
Bei Verwendung von Utility Network-Version 7 oder höher muss die Ausgabe-Feature-Class in einer Mobile-, File- oder Enterprise-Geodatabase erstellt werden.
Feature Class
load_selected_features
(Optional)
Gibt an, ob ausgewählte Features in der aktiven Karte als Verfolgungspositionen geladen werden.
LOAD_SELECTED_FEATURES—Verfolgungspositionen werden anhand der Auswahl in der Karte geladen.
DO_NOT_LOAD_SELECTED_FEATURES—Verfolgungspositionen werden nicht anhand der Auswahl in der Karte geladen. Dies ist die Standardeinstellung. Jedoch können die Verfolgungspositionen mit dem Parameter trace_locations angegeben werden.
Boolean
clear_trace_locations
(Optional)
Gibt an, ob vorhandene Verfolgungspositionen aus der Ausgabe-Feature-Class gelöscht werden.
CLEAR_LOCATIONS—Vorhandene Verfolgungspositionen werden gelöscht.
KEEP_LOCATIONS—Vorhandene Verfolgungspositionen werden nicht gelöscht, sondern beibehalten, und an sie wird angehängt. 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.
Spalten der Wertetabelle:
Layer Name—The layer that contains the locations to add.
Global ID—The Global ID of the feature for the location to add.
Terminal—The terminal ID of the feature for the location to add.
Percent Along—The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
filter_barrier
Gibt an, ob sich die Verfolgungspositionen wie Filterbarrieren verhalten, wenn sie als Barrieren verwendet werden.
FILTER_BARRIER—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.
TRAVERSABILITY_BARRIER—Die 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.
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.un.AddTraceLocations("Naperville Electric UN",
r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
"LOAD_SELECTED_FEATURES")
'AddTraceLocations': Beispiel 2 (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.un.AddTraceLocations(r"http://landbase.mydomain.com/server/rest/services/NapervilleElectric/FeatureServer/9",
r"C:\Project\MyUNProject.gdb\TraceLocations",
"DO_NOT_LOAD_SELECTED_FEATURES",
"KEEP_LOCATIONS",
"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' #;'ElecDist Line' {67C0534B-A80D-4E5F-8926-5FB5F887A5F2} # 0.25",
"TRAVERSABILITY_BARRIER")