Mit der Standard- oder Advanced-Lizenz verfügbar.
Zusammenfassung
Mit diesem Werkzeug können Sie in einem Versorgungsnetz eine Verfolgungskonfiguration erstellen.
Damit können Sie die Eigenschaften komplexer Verfolgungen zum Wiederverwenden und Freigeben konfigurieren und speichern. In einem Versorgungsnetz gespeicherte Verfolgungskonfigurationen können über das Werkzeug Verfolgen geladen und ausgeführt oder zur Verwendung in einer Webkarte oder mobilen App freigegeben werden.
Weitere Informationen zum Hinzufügen einer Verfolgungskonfiguration
Verwendung
Das Eingabe-Versorgungsnetz muss Version 5 oder höher sein.
Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss das Eingabe-Versorgungsnetz aus einem Versorgungsnetz-Service stammen.
Das verbundene Portal-Konto wurde als Ersteller der Verfolgungskonfiguration festgelegt.
Der Ersteller der Verfolgungskonfiguration wird mittels Betriebssystemauthentifizierung gespeichert, wenn er mit einem Versorgungsnetz in einer File-Geodatabase arbeitet.
Syntax
arcpy.un.AddTraceConfiguration(in_utility_network, trace_config_name, trace_type, {description}, {tags}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, {allow_indeterminate_flow}, {validate_locatability})| Parameter | Erklärung | Datentyp |
in_utility_network | Das Versorgungsnetz, das die neue Verfolgungskonfiguration enthält. | Utility Network; Utility Network Layer |
trace_config_name | Der Name für die Verfolgungskonfiguration. | String |
trace_type | Gibt den Typ der zu konfigurierenden Verfolgung an.
| String |
description (optional) | Die Beschreibung der Verfolgungskonfiguration. | String |
tags [tags,...] (optional) | Verschiedene Tags, die zur Kennzeichnung der Verfolgungskonfiguration verwendet werden. Die Tags können bei Suchvorgängen und zum Indizieren verwendet werden. | String |
domain_network (optional) | Der Name der Netzart, in der die Verfolgung ausgeführt wird. Dieser Parameter ist erforderlich, wenn die Verfolgungen vom Typ "Teilnetz", "Teilnetz-Controller", "Flussaufwärts" und "Flussabwärts" ausgeführt werden. | String |
tier (optional) | Der Name der Ebene, in der die Verfolgung gestartet werden soll. Dieser Parameter ist erforderlich, wenn die Verfolgungen vom Typ "Teilnetz", "Teilnetz-Controller", "Flussaufwärts" und "Flussabwärts" ausgeführt werden. | String |
target_tier (optional) | Der Name der Zielebene, in deren Richtung die Eingabeebene fließt. Wenn dieser Parameter in Verfolgungen vom Typ "Flussaufwärts" und "Flussabwärts" fehlt, enden diese Verfolgungen an der Grenze des Start-Teilnetzes. Dieser Parameter kann verwendet werden, um die Verfolgungen darüber hinaus fortzusetzen, also in der Hierarchie weiter nach oben oder weiter nach unten. | String |
subnetwork_name (optional) | Der Name des Teilnetzes, in dem die Verfolgung ausgeführt wird. Dieser Parameter kann zum Ausführen einer Teilnetz-Verfolgung verwendet werden. Wenn ein Teilnetzname angegeben wird, ist der Parameter für die Startpunkte (starting_points in Python) nicht erforderlich. | String |
shortest_path_network_attribute_name (optional) | Das Netzwerkattribut, das zum Berechnen des kürzesten Pfades verwendet wird. Bei der Ausführung einer Verfolgung vom Typ "Kürzester Pfad" wird der kürzeste Pfad mithilfe eines numerischen Netzwerkattributs wie etwa Shape-Länge berechnet. Es können sowohl kosten- als auch entfernungsbasierte Pfade ermittelt werden. Dieser Parameter ist für die Ausführung einer Verfolgung vom Typ "Kürzester Pfad" erforderlich. | String |
include_containers (optional) | Gibt an, ob die Container-Features in die Verfolgungsergebnisse einbezogen werden.
| Boolean |
include_content (optional) | Gibt an, ob bei der Verfolgung in den Ergebnissen Inhalte in Containern zurückgegeben werden.
| Boolean |
include_structures (optional) | Gibt an, ob Struktur-Features und Objekte in die Verfolgungsergebnisse einbezogen werden.
| Boolean |
include_barriers (optional) | Gibt an, ob die Barrieren-Features für die Durchlassfähigkeit in die Verfolgungsergebnisse einbezogen werden. Barrieren für die Durchlassfähigkeit sind optional, auch wenn sie in der Teilnetzdefinition voreingestellt wurden. Dieser Parameter gilt nicht für Bauteil-Features mit Anschlusspunkten.
| Boolean |
validate_consistency (optional) | Gibt an, ob ein Fehler ausgegeben wird, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die einzige Möglichkeit sicherzustellen, dass eine Verfolgung Features mit einem konsistenten Status im Netzwerk weitergibt. Um Dirty Areas zu entfernen, überprüfen Sie die Netzwerk-Topologie.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (optional) | Legt für Features eine Bedingungsbarriere für Durchlässigkeit basierend auf einem Vergleich mit einem Netzwerkattribut fest, oder führt eine Überprüfung der Kategoriezeichenfolge durch. Eine Bedingungsbarriere verwendet ein Netzwerkattribut, einen Operator und einen Typ sowie einen Attributwert. Halten Sie eine Verfolgung beispielsweise an, wenn das Attribut Device Status dem spezifischen Wert Open entspricht. Wenn ein Feature diese Bedingung erfüllt, wird die Verfolgung angehalten. Bei Verwendung mehrerer Attribute können Sie mit dem Parameter Kombination verwenden eine And- oder eine Or-Bedingung definieren. Die Komponenten der Bedingungsbarrieren sind folgende:
Die operator-Optionen für die Bedingungsbarrieren sind folgende:
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Bedingungsbarrieren sind folgende:
Die Combine Using-Optionen für die Bedingungsbarrieren sind folgende:
Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken | Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (optional) | Legt für Features eine Durchlässigkeitsbarriere basierend auf einer Funktion fest. Funktionsbarrieren können beispielsweise verwendet werden, um die Entfernung der Verfolgung vom Startpunkt einzuschränken oder einen Maximalwert zum Anhalten einer Verfolgung festzulegen. Die Länge der jeweils zurückgelegten Linie wird beispielsweise der bisher zurückgelegten Gesamtentfernung hinzugefügt. Wenn die zurückgelegte Gesamtlänge den angegebenen Wert erreicht hat, wird die Verfolgung angehalten. Die Komponenten der Funktionsbarrieren sind folgende:
Die function-Wertoptionen für die Funktionsbarriere lauten wie folgt:
Die operator-Wertoptionen für die Funktionsbarriere lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Die Use Local Values-Optionen für die Funktionsbarriere lauten wie folgt:
| Value Table |
traversability_scope (optional) | Der Typ der Durchlassfähigkeit, der umgesetzt werden soll. Der Umfang der Durchlassfähigkeit regelt, ob die Durchlassfähigkeit an Knoten, an Kanten oder an Knoten und an Kanten umgesetzt wird. Beispiel: Wenn eine Bedingungsbarriere definiert wurde, um die Verfolgung zu stoppen, wenn der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da der Bauteilstatus nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
| String |
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (optional) | Gibt an, wann eine Verfolgung aufgrund eines bestimmten Kategorie- oder Netzwerkattributs beendet wird. Beispiel: Eine Verfolgung bei Features beenden, die ein Attribut für den Lebenszyklusstatus aufweisen, das einem bestimmten Wert entspricht. Dieser Parameter wird verwendet, um ein abschließendes Feature basierend auf dem im System definierten Wert eines Netzwerkattributs festzulegen. Bei Verwendung mehrerer Attribute können Sie mit der Option Combine Using eine And- oder eine Or-Bedingung definieren. Die Komponenten der Filterbarrieren sind folgende:
Die operator-Optionen für die Filterbarrieren sind folgende:
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Filterbarrieren sind folgende:
Die Combine Using-Optionen für die Filterbarrieren sind folgende:
Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken | Value Table |
filter_function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (optional) | Diese filtern die Ergebnisse der Verfolgung entsprechend einer bestimmten Kategorie. Die Komponenten der Filterfunktionsbarrieren sind folgende:
Die function-Optionen für die Filterfunktionsbarrieren sind folgende:
Die operator-Optionen für die Filterfunktionsbarrieren sind folgende:
Weitere Informationen zu Bitwise-Operatoren Die Use Local Values-Optionen für die Filterfunktionsbarrieren sind folgende:
| Value Table |
filter_scope (optional) | Gibt an, ob der Filter für eine bestimmte Kategorie bei Knoten oder Kanten oder bei Knoten und Kanten angewendet wird. Beispiel: Wenn eine Filterbarriere definiert wurde, um die Verfolgung zu stoppen, wenn der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da der Bauteilstatus nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
| String |
filter_bitset_network_attribute_name (optional) | Der Name des Netzwerkattributs, das zum Filtern nach Bitset verwendet wird. Dieser Parameter kann nur für Verfolgungen vom Typ "Flussaufwärts", "Flussabwärts" oder "Schleifen" verwendet werden. Mit diesem Parameter kann während der Verfolgung eine spezielle Logik hinzugefügt werden, sodass mit der Verfolgung Szenarien realitätsgetreuer abgebildet werden. Bei einer Verfolgung vom Typ "Schleifen" kann das Netzwerkattribut "Phasenstrom" beispielsweise ermitteln, ob es sich bei einer Schleife um eine echte elektrische Schleife handelt (d. h. in der gesamten Schleife führt Phase A Strom), und nur diese als Verfolgungsergebnis zurückgeben. Ein Beispiel für eine Verfolgung vom Typ "Flussaufwärts" ist die Verfolgung eines Stromverteilungsnetzes durch Festlegen des Netzwerkattributs "Phasenstrom", wobei in den Verfolgungsergebnissen nicht alle Pfade, sondern nur im Netzwerkattribut angegebene gültige Pfade enthalten sind. | String |
filter_nearest (optional) | Gibt an, ob der Algorithmus "Nächster Nachbar (K)" verwendet werden soll, um eine Reihe von Features eines bestimmten Typs innerhalb einer angegebenen Entfernung zurückzugeben. Wenn dieser Parameter verwendet wird, können Sie Anzahl und Kosten sowie eine Sammlung von Kategorien und/oder einen Asset-Typ festlegen.
| Boolean |
nearest_count (optional) | Die Anzahl der zurückzugebenden Features, wenn filter_nearest den Wert FILTER_BY_NEAREST hat. | Long |
nearest_cost_network_attribute (optional) | Das numerische Netzwerkattribut, das zum Berechnen von Nähe, Kosten oder Entfernung verwendet werden soll, wenn filter_nearest den Wert FILTER_BY_NEAREST hat, zum Beispiel Shape-Länge. | String |
nearest_categories [nearest_categories,...] (optional) | Die Kategorien, die zurückgegeben werden sollen, wenn filter_nearest den Wert FILTER_BY_NEAREST hat, zum Beispiel Schutz. | String |
nearest_assets [nearest_assets,...] (optional) | Die Asset-Gruppen und Asset-Typen, die zurückgegeben werden sollen, wenn filter_nearest den Wert FILTER_BY_NEAREST hat, zum Beispiel ElectricDistributionDevice/Transformer/Step Down. | String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (optional) | Wendet eine Berechnungsfunktion auf Verfolgungsergebnisse an. Folgende Funktionskomponenten stehen zur Verfügung:
Die Function-Optionen für die Funktionen lauten wie folgt:
Ein Startpunkt-Feature weist beispielsweise den Wert 20 auf. Das nächste Feature hat den Wert 30. Wenn Sie die Funktion MINIMUM verwenden, ist das Ergebnis 20. MAXIMUM ist 30, ADD ist 50, AVERAGE ist 25, COUNT ist 2 und SUBTRACT ist -10. Die Filter Operator-Wertoptionen lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Die Filter Type-Optionen für die Funktionen lauten wie folgt:
| Value Table |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (optional) | Legt fest, welche Netzwerkattribute weitergegeben werden sollen und wie diese Weitergabe während einer Verfolgung durchgeführt wird. Weitergegebene Klassenattribute geben die Schlüsselwerte für Teilnetz-Controller an, die auf die restlichen Features im Teilnetz verteilt werden. In einem Stromversorgungsmodell können Sie beispielsweise die Phasenwerte weitergeben. Folgende Komponenten stehen bei den Weitergabemodulen zur Verfügung:
Die function-Optionen für die Verteilungsmodule lauten wie folgt:
Die operator-Optionen für die Verteilungsmodule lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Hinweis:Dieser Parameter ist nur über Python verfügbar. | Value Table |
output_assettypes [output_assettypes,...] (optional) | Filtert die Ausgabe-Asset-Typen, die in die Ergebnisse einbezogen werden sollen, z. B. nur Freileitungstransformatoren. | String |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (optional) | Gibt die Typen der Features an, die basierend auf einem Netzwerkattribut oder einer Netzwerkkategorie zurückgegeben werden sollen. Bei einer Verfolgung, die beispielsweise zum Herausfiltern aller Features außer Abzweigungs-Features konfiguriert wurde, sind in den Ergebnissen keine verfolgten Features enthalten, denen nicht die Kategorie "Abzweigung" zugewiesen wurde. Verfolgte Features, denen die Ablaufventil-Kategorie zugewiesen wurde, werden im Ergebnisauswahlsatz zurückgegeben. Bei Verwendung mehrerer Attribute können Sie mit der Option Combine Using eine And- oder eine Or-Bedingung definieren. Die Komponenten der Ausgabebedingungen sind folgende:
Die operator-Optionen für die Ausgabebedingungen lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Ausgabebedingungen lauten wie folgt:
Die Combine Using-Optionen für die Ausgabebedingungen lauten wie folgt:
Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken | Value Table |
include_isolated_features (optional) | Gibt an, ob die isolierten Features in die Verfolgungsergebnisse einbezogen werden. Dieser Parameter wird zum Ausführen einer Isolationsverfolgung verwendet.
Hinweis:Für die Isolationsverfolgung wird ArcGIS Enterprise 10.7 oder höher benötigt, wenn eine Enterprise-Geodatabase verwendet wird. | Boolean |
ignore_barriers_at_starting_points (optional) | Gibt an, ob dynamische Barrieren in der Verfolgungskonfiguration für Startpunkte ignoriert werden sollen. Dies kann nützlich sein, wenn eine Verfolgung der Schutzbauteile flussaufwärts durchgeführt wird und die ermittelten Schutzbauteile (Barrieren) als Startpunkte verwendet werden, um nachfolgende Schutzbauteile flussaufwärts zu finden.
| Boolean |
include_up_to_first_spatial_container (optional) | Gibt an, ob die zurückgegebenen Container begrenzt werden sollen, sodass nur Container bis einschließlich des ersten räumlichen Containers für jedes Netzwerkelement in die Verfolgungsergebnisse einbezogen werden. Wenn keine räumlichen Container erkannt werden, aber nichträumliche Container für ein bestimmtes Netzwerkelement vorhanden sind, werden alle nichträumlichen Container in die Ergebnisse einbezogen. Dieser Parameter kann nur verwendet werden, wenn Include Containers enabled ist.
| Boolean |
result_types [result_types,...] (optional) | Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden.
| String |
allow_indeterminate_flow (optional) | Gibt an, ob Features mit einer unbestimmbaren Fließrichtung verfolgt werden. Dieser Parameter wird nur bei der Ausführung einer Verfolgung flussaufwärts oder flussabwärts berücksichtigt.
| Boolean |
validate_locatability (optional) | Gibt an, ob ein Fehler zurückgegeben wird, wenn nichträumliche Knoten- oder Kantenobjekte ohne zugeordneten Container oder zugeordnete Struktur in der Zuordnungshierarchie für die durchquerten Features gefunden werden. Mit dieser Option wird sichergestellt, dass von einer Verfolgung zurückgegebene nichträumliche Objekte mit räumlichen Features verknüpft werden.
| Boolean |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_utility_network | Das aktualisierte Versorgungsnetz. | Utility Network |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs AddTraceConfiguration im Python-Fenster.
import arcpy
arcpy.AddTraceConfiguration_un(
r"SampleUNService\Elec Utility Network", "Upstream_RMT002", "UPSTREAM",
"Upstream trace on RMT002", "Upstream;RMT002", "ElectricDistribution",
"Medium Voltage", '', '', '', "EXCLUDE_CONTAINERS", "EXCLUDE_CONTENT",
"EXCLUDE_STRUCTURES", "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", None,
None, "BOTH_JUNCTIONS_AND_EDGES", None, None, "BOTH_JUNCTIONS_AND_EDGES",
'', "DO_NOT_FILTER", None, '', None, None, None, None, None, None,
"EXCLUDE_ISOLATED_FEATURES", "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS",
"DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER", None,
"TRACE_INDETERMINATE_FLOW", "DO_NOT_VALIDATE_LOCATABILITY")Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja