| Name | Erläuterung | Datentyp |
in_utility_network | Das Versorgungsnetz, in dem die Verfolgung ausgeführt wird. Bei Verwendung einer Enterprise-Geodatabase muss ein Eingabe-Versorgungsnetz von einem Feature-Service stammen. Ein Versorgungsnetz von einer Datenbankverbindung wird nicht unterstützt. | Utility Network; Utility Network Layer |
trace_type | Gibt den Typ der auszuführenden Verfolgung an. - CONNECTED—Eine Verbindungsverfolgung, die an mindestens einem Startpunkt beginnt und sich entlang der verbundenen Features nach außen erstreckt, wird verwendet. Dies ist die Standardeinstellung.
- SUBNETWORK—Eine Teilnetz-Verfolgung, die an mindestens einem Startpunkt beginnt und sich nach außen erstreckt, um die Ausdehnung des Teilnetzes zu umschließen, wird verwendet.
- SUBNETWORK_CONTROLLERS—Eine Verfolgung von Teilnetz-Controllern, die Quellen und Senken in Teilnetz-Controllern verortet, die mit einem Teilnetz verknüpft sind.
- UPSTREAM—Eine Verfolgung flussaufwärts, bei der Features ermittelt werden, die sich flussaufwärts von einer Position im Netzwerk befinden, wird verwendet.
- DOWNSTREAM—Eine Verfolgung flussabwärts, bei der Features ermittelt werden, die sich flussabwärts von einer Position im Netzwerk befinden, wird verwendet.
- LOOPS—Schleifen sind Bereiche des Netzwerks, in denen die Fließrichtung unklar ist. Eine Schleifenverfolgung, die sich basierend auf der Konnektivität vom Startpunkt aus nach außen erstreckt.
- SHORTEST_PATH—Eine Verfolgung des kürzesten Pfads, die den kürzesten Pfad zwischen zwei Startpunkten ermittelt.
- ISOLATION—Eine Isolationsverfolgung, die Features ermittelt, die die Fläche eines Netzwerks isolieren.
| String |
starting_points (optional) | Eine Tabelle oder Feature-Class, die mindestens einen Datensatz enthält, der die Startpunkte der Verfolgung darstellt. Diese Feature-Class oder Tabelle muss das Feld FEATUREGLOBALID enthalten, damit Informationen aus dem verknüpften Netzwerk-Feature gespeichert werden können. Um das Format zu sehen, erstellen Sie Startpunkte mit dem Werkzeug Startpunkte im Bereich Verfolgungspositionen, und schauen Sie sich dann das Schema der Feature-Class "UN_Temp_Starting_Points" in Ihrer Standard-Geodatabase an. | Feature Layer; Table View |
barriers (optional) | Eine Tabelle oder Feature-Class mit einem oder mehreren Features, die die Barrieren darstellen, die verhindern, dass die Verfolgung über diesen Punkt hinaus ausgeführt wird. Diese Feature-Class oder Tabelle muss das Feld FEATUREGLOBALID enthalten, damit Informationen aus dem verknüpften Netzwerk-Feature gespeichert werden können. Um das Format zu sehen, erstellen Sie Barrieren mit dem Werkzeug Barrieren im Bereich Verfolgungspositionen, und schauen Sie sich dann das Schema der Feature-Class "UN_Temp_Barriers" in Ihrer Standard-Geodatabase an. | Feature Layer; Table View |
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 der kürzesten Route verwendet wird. Bei der Ausführung einer Verfolgung vom Typ "Kürzeste Route" wird die kürzeste Route 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. - INCLUDE_CONTAINERS—Container-Features werden in die Verfolgungsergebnisse einbezogen.
- EXCLUDE_CONTAINERS—Container-Features werden in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.
| Boolean |
include_content (optional) | Gibt an, ob bei der Verfolgung in den Ergebnissen Inhalte in Containern zurückgegeben werden. - INCLUDE_CONTENT—Inhalt in Container-Features wird in die Verfolgungsergebnisse einbezogen.
- EXCLUDE_CONTENT—Inhalt in Container-Features wird in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.
| Boolean |
include_structures (optional) | Gibt an, ob Struktur-Features und Objekte in die Verfolgungsergebnisse einbezogen werden. - INCLUDE_STRUCTURES—Struktur-Features und Objekte werden in die Verfolgungsergebnisse einbezogen.
- EXCLUDE_STRUCTURES—Struktur-Features und Objekte werden nicht in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.
| 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. - INCLUDE_BARRIERS—Barrieren-Features für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.
- EXCLUDE_BARRIERS—Barrieren-Features für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.
| 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. - VALIDATE_CONSISTENCY—Bei der Verfolgung wird ein Fehler ausgegeben, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die Standardeinstellung.
- DO_NOT_VALIDATE_CONSISTENCY—Die Verfolgungsergebnisse werden ausgegeben, auch wenn in den durchlaufenen Features Dirty Areas gefunden werden.
| 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: - Name: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Type: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der im Parameter name angegeben ist, wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
- Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden.
Die operator-Optionen für die Bedingungsbarrieren sind folgende: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Bedingungsbarrieren sind folgende: - SPECIFIC_VALUE—Nach einem bestimmten Wert filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
Die Combine Using-Optionen für die Bedingungsbarrieren sind folgende: - AND—Die Bedingungsbarrieren kombinieren.
- OR—Verwenden, wenn eine der Bedingungsbarrieren erfüllt ist.
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: - Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
- Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
- Use Local Values: Hier können Sie Werte in jeder Richtung berechnen, im Gegensatz zu einem allgemeinen globalen Wert. Beispiel sei eine Funktionsbarriere, die die Summe von "Shape-Länge" berechnet, wobei die Verfolgung beendet wird, wenn der Wert größer als oder gleich 4 ist. Wenn Sie im globalen Fall zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da Sie bereits die Shape-Länge 4 erreicht haben. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern.
Die function-Wertoptionen für die Funktionsbarriere lauten wie folgt: - AVERAGE—Der Durchschnitt der Eingabewerte.
- COUNT—Die Anzahl der Features.
- MAX—Das Maximum der Eingabewerte.
- MIN—Das Minimum der Eingabewerte.
- ADD—Die Summe der Werte.
- SUBTRACT—Die Differenz der Werte. Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.
Die operator-Wertoptionen für die Funktionsbarriere lauten wie folgt: - IS_EQUAL_TO—Das Funktionsergebnis ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Funktionsergebnis ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Funktionsergebnis ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Funktionsergebnis ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Funktionsergebnis ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Funktionsergebnis ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Weitere Informationen zu Bitwise-Operatoren Die Use Local Values-Optionen für die Funktionsbarriere lauten wie folgt: - TRUE—Lokale Werte werden verwendet.
- FALSE—Globale Werte werden verwendet. Dies ist die Standardeinstellung.
| Value Table |
traversability_scope (optional) | Gibt den Typ der Durchlassfähigkeit an, der angewendet wird. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit auf Knoten, auf Kanten oder auf Knoten und auf Kanten angewendet 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. - BOTH_JUNCTIONS_AND_EDGES—Die Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
- JUNCTIONS_ONLY—Die Durchlassfähigkeit wird nur auf Knoten angewendet.
- EDGES_ONLY—Die Durchlassfähigkeit wird nur auf Kanten angewendet.
| String |
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (optional) | Legt fest, 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: - Name: Legen Sie die Filterung nach einer Kategorie oder einem beliebigen im System definierten Netzwerkattribut fest.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Type: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der im Parameter name angegeben ist, wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
- Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden.
Die operator-Optionen für die Filterbarrieren sind folgende: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES NOT INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INLCUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Filterbarrieren sind folgende: - SPECIFIC_VALUE—Nach einem bestimmten Wert filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
Die Combine Using-Optionen für die Filterbarrieren sind folgende: - AND—Die Bedingungsbarrieren kombinieren.
- OR—Verwenden, wenn eine der Bedingungsbarrieren erfüllt ist.
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: - Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
- Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
- Use Local Values: Hier können Sie Werte in jeder Richtung berechnen, im Gegensatz zu einem allgemeinen globalen Wert. Beispiel sei eine Funktionsbarriere, die die Summe von Shape-Länge berechnet, wobei die Verfolgung beendet wird, wenn der Wert größer als oder gleich 4 ist. Wenn Sie im globalen Fall zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da Sie bereits die Shape-Länge 4 erreicht haben. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern.
Die function-Optionen für die Filterfunktionsbarrieren sind folgende: - AVERAGE—Der Durchschnitt der Eingabewerte.
- COUNT—Die Anzahl der Features.
- MAX—Das Maximum der Eingabewerte.
- MIN—Das Minimum der Eingabewerte.
- ADD—Die Summe der Werte.
- SUBTRACT—Die Differenz der Werte. Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.
Die operator-Optionen für die Filterfunktionsbarrieren sind folgende: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Weitere Informationen zu Bitwise-Operatoren Die Use Local Values-Optionen für die Filterfunktionsbarrieren sind folgende: - TRUE—Lokale Werte werden verwendet.
- FALSE—Globale Werte werden verwendet. Dies ist die Standardeinstellung.
| 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. - BOTH_JUNCTIONS_AND_EDGES—Der Filter wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
- JUNCTIONS_ONLY—Der Filter wird nur auf Knoten angewendet.
- EDGES_ONLY—Der Filter wird nur auf Kanten angewendet.
| 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. - FILTER_BY_NEAREST—Der Algorithmus "Nächster Nachbar (K)" wird verwendet, um eine Reihe von Features zurückzugeben, wie im Parameter nearest_count, nearest_cost_network_attribute, nearest_categories oder nearest_assets angegeben.
- DO_NOT_FILTER—Der Algorithmus "Nächster Nachbar (K)" wird nicht verwendet, um Ergebnisse zu filtern. Dies ist die Standardeinstellung.
| 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) | Die Berechnungsfunktionen, die auf die Verfolgungsergebnisse angewendet werden.
Folgende Funktionskomponenten stehen zur Verfügung: - Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
- Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Filter Name: Die Funktionsergebnisse nach Attributname filtern.
- Filter Operator: Hier können Sie unter mehreren Operatoren wählen.
- Filter Type: Hier können Sie unter mehreren Filtertypen wählen.
- Filter Value: Geben Sie einen Wert für das Eingabefilterattribut an.
Die Function-Wertoptionen für die Funktionen lauten wie folgt: - AVERAGE—Der Durchschnitt der Eingabewerte.
- COUNT—Die Anzahl der Features.
- MAX—Das Maximum der Eingabewerte.
- MIN—Das Minimum der Eingabewerte.
- ADD—Die Summe der Werte.
- SUBTRACT—Die Differenz der Werte.Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.
Ein Startpunkt-Feature weist beispielsweise den Wert 20 auf. Das nächste Feature hat den Wert 30. Bei Verwendung der Funktion MINIMUM ist das Ergebnis 20, bei MAXIMUM 30, bei ADD 50, bei AVERAGE 25, bei COUNT 2 und bei SUBTRACT -10. Die Filter Operator-Wertoptionen lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Weitere Informationen zu Bitwise-Operatoren Die Filter Type-Wertoptionen für die Funktionen lauten wie folgt: - SPECIFIC_VALUE—Nach einem bestimmten Wert filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
| 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 Verteilungsmodulen zur Verfügung: - Attribute: Hier können Sie wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu filtern.
- Substitution Attribute: Verwendet einen Ersatzwert anstelle von Bitset-Netzwerkattributwerten. Ersetzungen werden basierend auf der Anzahl der Bits im weitergegebenen Netzwerkattribut codiert. Eine Ersetzung ist die Zuordnung der Bits in einer Phase zu jeweils einem anderen Bit. Bei Phase AC kann im Rahmen einer Ersetzung z. B. Bit A zu B und Bit C zu NULL zugeordnet werden. In diesem Beispiel lautet die Ersetzung für 1010 (Phase AC) 0000-0010-0000-0000 (512). In der Ersetzung ist die Zuordnung ersichtlich, damit Sie wissen, dass Phase A zu B zugeordnet und Phase C zu NULL zugeordnet wurde und nicht andersherum (d. h. Phase A wurde nicht zu NULL zugeordnet und Phase C nicht zu B).
- Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
Die function-Wertoptionen für die Verteilungsmodule lauten wie folgt: - PROPAGATED_BITWISE_AND—Die Werte aus einem Feature mit dem nächsten vergleichen.
- PROPAGATED_MIN—Den Minimalwert abrufen.
- PROPAGATED_MAX—Den Maximalwert abrufen.
Die operator-Wertoptionen für die Verteilungsmodule lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Weitere Informationen zu Bitwise-Operatoren Dieser Parameter ist nur für 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) | Die Typen der Features, 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: - Name: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Type: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der im Parameter name angegeben ist, wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
- Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden.
Die operator-Optionen für die Ausgabebedingungen lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Ausgabebedingungen lauten wie folgt: - SPECIFIC_VALUE—Nach einem bestimmten Wert filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
Die Combine Using-Optionen für die Ausgabebedingungen lauten wie folgt: - AND—Kombiniert die Bedingungen.
- OR—Wird verwendet, wenn eine der Bedingungen erfüllt ist.
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. - INCLUDE_ISOLATED_FEATURES—Isolierte Features werden in die Verfolgungsergebnisse einbezogen.
- EXCLUDE_ISOLATED_FEATURES—Isolierte Features werden in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.
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. - IGNORE_BARRIERS_AT_STARTING_POINTS—Barrieren bei Startpunkten werden in der Verfolgung ignoriert.
- DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—Barrieren bei Startpunkten werden in der Verfolgung nicht ignoriert. Dies ist die Standardeinstellung.
| Boolean |
include_up_to_first_spatial_container (optional) | Gibt an, ob die zurückgegebenen Container begrenzt werden, 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 aktiviert ist. - INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER—Es werden nur Container bis einschließlich des ersten räumlichen Containers in die Ergebnisse einbezogen, wenn entlang des Verfolgungspfades geschachtelte Containment-Zuordnungen erkannt werden. Sind keine räumlichen Container vorhanden, werden alle nichträumlichen Container in die Ergebnisse für ein bestimmtes Netzwerkelement einbezogen.
- DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER—Alle Container werden in den Ergebnissen zurückgegeben. Dies ist die Standardeinstellung.
| Boolean |
result_types [result_types,...] (optional) | Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden. - SELECTION—Die Verfolgungsergebnisse werden als Auswahlsatz der entsprechenden Netzwerk-Features zurückgegeben. Dies ist die Standardeinstellung.
- AGGREGATED_GEOMETRY—Die Verfolgungsergebnisse werden nach Geometrietyp aggregiert und in Multipart-Feature-Classes gespeichert, die in den Layern auf der aktiven Karte angezeigt werden.
- CONNECTIVITY—Die Verfolgungsergebnisse werden als Konnektivitätsdiagramm in einer angegebenen .json-Datei zurückgegeben. Mit dieser Option wird der Parameter out_json_file aktiviert.
- ELEMENTS—Die Verfolgungsergebnisse werden als Feature-Elemente in der angegebenen .json-Ausgabedatei zurückgegeben. Mit dieser Option wird der Parameter out_json_file aktiviert.
| String |
selection_type | Gibt an, wie die Auswahl angewendet wird, und welche Aktion ausgeführt wird, wenn eine aktuelle Auswahl vorhanden ist. - NEW_SELECTION—Die getätigte Auswahl ersetzt die aktuelle Auswahl. Dies ist die Standardeinstellung.
- ADD_TO_SELECTION—Die getätigte Auswahl wird der aktuellen Auswahl hinzugefügt (wenn eine vorhanden ist). Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option "Neue Auswahl".
- REMOVE_FROM_SELECTION—Die getätigte Auswahl wird aus der aktuellen Auswahl entfernt. Wenn keine Auswahl vorhanden ist, ist diese Option irrelevant.
- SUBSET_SELECTION—Die getätigte Auswahl wird mit der aktuellen Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, werden ausgewählt.
- SWITCH_SELECTION—Die getätigte Auswahl wird umgekehrt. Bisher ausgewählte Ergebnisse werden aus der aktuellen Auswahl entfernt und bisher nicht ausgewählte Ergebnisse werden der aktuellen Auswahl hinzugefügt. Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option "Neue Auswahl".
| String |
clear_all_previous_trace_results (optional) | Gibt an, ob Inhalte aus den Feature-Classes, die zum Speichern der aggregierten Geometrie ausgewählt wurden, gekürzt oder an diese angehängt werden. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie". - CLEAR_ALL_PREVIOUS_TRACE_RESULTS—Die Feature-Classes, in denen die aggregierte Verfolgungsgeometrie gespeichert wird, werden gekürzt. Nur die Ausgabegeometrie der aktuellen Verfolgungsoperation wird eingefügt. Dies ist die Standardeinstellung.
- DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTS—Die Ausgabegeometrie der aktuellen Verfolgungsoperation wird an die Feature-Classes angefügt, in denen die aggregierte Geometrie gespeichert wird.
| Boolean |
trace_name (optional) | Der Name der Verfolgungsoperation. Dieser Wert wird im Feld TRACENAME der Ausgabe-Feature-Class gespeichert, um die Identifizierung der Verfolgungsergebnisse zu unterstützen. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie". | String |
aggregated_points (optional) | Eine Ausgabe-Multipoint-Feature-Class, die die aggregierte Ergebnisgeometrie enthält. Standardmäßig wird der Parameter von einer vom System generierten Feature-Class namens "Trace_Results_Aggregated_Points" gefüllt, die in der Standard-Geodatabase des Projekts gespeichert wird.
Diese Feature-Class wird automatisch erstellt, wenn sie nicht vorhanden ist. Eine vorhandene Feature-Class kann auch zum Speichern der aggregierten Geometrie verwendet werden. Wenn nicht die Standard-Feature-Class verwendet wird, muss es eine Multipoint-Feature-Class sein, die ein Zeichenfolgenfeld namens TRACENAME enthält. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".
| Feature Class |
aggregated_lines (optional) | Eine Ausgabe-Polyline-Feature-Class, die die aggregierte Ergebnisgeometrie enthält. Standardmäßig wird der Parameter von einer vom System generierten Feature-Class namens "Trace_Results_Aggregated_Lines" gefüllt, die in der Standard-Geodatabase des Projekts gespeichert wird.
Diese Feature-Class wird automatisch erstellt, wenn sie nicht vorhanden ist. Eine vorhandene Feature-Class kann auch zum Speichern der aggregierten Geometrie verwendet werden. Wenn nicht die Standard-Feature-Class verwendet wird, muss es eine Polyline-Feature-Class sein, die ein Zeichenfolgenfeld namens TRACENAME enthält. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".
| Feature Class |
aggregated_polygons (optional) | Eine Ausgabe-Polygon-Feature-Class, die die aggregierte Ergebnisgeometrie enthält. Standardmäßig wird der Parameter von einer vom System generierten Feature-Class namens "Trace_Results_Aggregated_Polygons" gefüllt, die in der Standard-Geodatabase des Projekts gespeichert wird.
Diese Feature-Class wird automatisch erstellt, wenn sie nicht vorhanden ist. Eine vorhandene Feature-Class kann auch zum Speichern der aggregierten Geometrie verwendet werden. Wenn nicht die Standard-Feature-Class verwendet wird, muss es eine Polygon-Feature-Class sein, die ein Zeichenfolgenfeld namens TRACENAME enthält. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".
| Feature Class |
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. - TRACE_INDETERMINATE_FLOW—Features mit einer unbestimmbaren Fließrichtung werden verfolgt. Dies ist die Standardeinstellung.
- IGNORE_INDETERMINATE_FLOW—Bei Features mit einer unbestimmbaren Fließrichtung wird die Durchlassfähigkeit beendet, und die Features werden nicht verfolgt.
| Boolean |
validate_locatability (optional) | Gibt an, ob während der Verfolgung ein Fehler zurückgegeben wird, wenn nichträumliche Knoten- oder Kantenobjekte ohne die erforderliche Containment-, Anbau- oder Konnektivitätszuordnung in der Zuordnungshierarchie der durchquerten Objekte gefunden werden. Dieser Parameter stellt sicher, dass nichträumliche Objekte, die von der Verfolgung oder dem Vorgang "Teilnetz aktualisieren" zurückgegeben werden, durch die Zuordnung mit Features oder anderen verortbaren Objekten verortet werden können. - VALIDATE_LOCATABILITY—Die Verfolgung gibt einen Fehler zurück, wenn nichträumliche Knoten- oder Kantenobjekte ohne die erforderliche Containment-, Anbau- oder Konnektivitätszuordnung in der Zuordnungshierarchie der durchquerten Objekte gefunden werden.
- DO_NOT_VALIDATE_LOCATABILITY—Die Verfolgung führt keine Prüfung auf nicht verortbare Objekte durch und gibt Ergebnisse unabhängig davon zurück, ob nicht verortbare Objekte in der Zuordnungshierarchie der durchquerten Objekte vorhanden sind. Dies ist die Standardeinstellung.
| Boolean |
use_trace_config (optional) | Gibt an, ob zum Füllen der Parameter des Werkzeugs Verfolgen eine vorhandene Verfolgungskonfiguration verwendet wird. - USE_TRACE_CONFIGURATION—Eine vorhandene benannte Verfolgungskonfiguration wird zum Definieren der Verfolgungseigenschaften verwendet. Mit Ausnahme von trace_config_name, starting_points und barriers werden alle Parameter ignoriert.
- DO_NOT_USE_TRACE_CONFIGURATION—Es wird keine vorhandene benannte Verfolgungskonfiguration zum Definieren der Verfolgungseigenschaften verwendet. Dies ist die Standardeinstellung.
| Boolean |
trace_config_name (optional) | Gibt den Namen der Verfolgungskonfiguration an, die zum Definieren der Verfolgungseigenschaften verwendet wird. Dieser Parameter wird nur aktiviert, wenn der Parameter use_trace_config auf USE_TRACE_CONFIGURATION festgelegt ist. | String |
out_json_file (optional) | Der Name und Speicherort der .json-Datei, die generiert wird, wenn Verfolgungsergebnisse als Konnektivitätsdiagramm oder Feature-basierte Informationen zurückgegeben werden. | File |
run_async (optional) | Gibt an, ob Verfolgungen asynchron verarbeitet werden, wenn mit einem Versorgungsnetz in einer Enterprise-Geodatabase gearbeitet wird. - RUN_ASYNCHRONOUSLY—Verfolgungen werden asynchron verarbeitet.
- RUN_SYNCHRONOUSLY—Verfolgungen werden synchron verarbeitet. Dies ist die Standardeinstellung.
Für diesen Parameter ist ArcGIS Enterprise 10.9.1 oder höher erforderlich. | Boolean |