Regel für Verfolgung hinzufügen (Network Diagram)

Zusammenfassung

Fügt eine Schemaregel für die automatische Verfolgung in einem Versorgungs- oder Verfolgungsnetz beim Erstellen von Schemas basierend auf einer vorhandenen Vorlage hinzu. Mit den bei der Verfolgung berücksichtigten Netzwerk-Features und Netzwerkobjekten wird der Schemainhalt erstellt.

Weitere Informationen zur Verwendung der Verfolgungsregel zum Erstellen von Schemas

Vorsicht:

Dieses Werkzeug ist ein Konfigurations- und Verwaltungswerkzeug.

Hinweis:

Dieses Werkzeug hat Auswirkungen auf die Konsistenz aller vorhandenen Schemas, die auf der Eingabeschemavorlage basieren. Alle vorhandenen Schemas werden inkonsistent und werden beim Öffnen mit dem Konsistenzwarnsymbol Möglicherweise inkonsistent angezeigt, bis sie aktualisiert werden.

Verwendung

  • Bei Verwendung eines Utility Network-Service wird dieses Werkzeug nicht unterstützt. Sie müssen entweder ein Versorgungs- oder Verfolgungsnetz in einer File-Geodatabase oder eine Datenbankverbindung zu einem Versorgungsnetz in einer Enterprise-Geodatabase verwenden. Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss die Verbindung über den Besitzer des Datenbank-Versorgungsnetzes hergestellt werden.

  • Wenn Sie diese Operation in einem Versorgungsnetz in einer Enterprise-Geodatabase durchführen, muss das verbundene ArcGIS Enterprise-Portal-Konto der Besitzer des Portal-Versorgungsnetzes sein.

  • Das Netzwerkdaten-Element, das im Parameter "Eingabe-Netzwerk" angegeben wurde, muss aus einem Versorgungs- oder Verfolgungsnetz in einer File-Geodatabase oder einer Datenbankverbindung zu einem Versorgungsnetz in einer Enterprise-Geodatabase stammen.

  • Die Verfolgungsregel dient zur Ausführung einer Verfolgung in Versorgungs- und Verfolgungsnetzelementen, die aktuell in einem Schema dargestellt werden.

    Je nach angegebenem Verfolgungstyp muss das Schema Startpunkte aufweisen, damit die Verfolgungsregel ausgeführt werden kann:

    • Für die Verfolgungstypen "Verbunden", "Teilnetz", "Flussaufwärts" und "Flussabwärts" werden alle Versorgungsnetz- oder Verfolgungsnetz-Elemente, die zum Zeitpunkt des Starts der Verfolgungsregel im Schema dargestellt werden, als Startpunkte für die Verfolgung betrachtet, es sei denn, es wird eine Regel zum Festlegen von Startpunkten für die Schemavorlage konfiguriert, um bestimmte Startpunkte vorab eindeutig zu identifizieren.
    • Für den Verfolgungstyp "Kürzeste Verbindung" müssen Regeln zum Festlegen von Startpunkten für die Schemavorlage konfiguriert werden, um für die kürzeste Route die beiden Startpunkte unter allen derzeit im Schema dargestellten Verfolgungsnetz-Elementen zu ermitteln.

  • Wenn Sie eine Vorlage basierend auf der Verfolgungsregel konfigurieren, wird die Verfolgung bei jeder Aktualisierung des Schemas im Versorgungs- oder Verfolgungsnetz systematisch erneut ausgeführt. Dies bedeutet, dass jedes auf dieser Vorlage basierende Schema nach einer Aktualisierung stets das aktuelle Netzverfolgungsergebnis widerspiegelt.

Syntax

AddTraceRule(in_utility_network, template_name, is_active, trace_type, {domain_network}, {tier}, {target_tier}, {include_structures}, {include_barriers}, {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}, {propagators}, {description}, {allow_indeterminate_flow}, {path_direction}, {path_network_weight_name})
ParameterErklärungDatentyp
in_utility_network

Das Versorgungs- oder Verfolgungsnetz, das die zu ändernden Schemavorlagendefinitionen referenziert.

Utility Network; Trace Network
template_name

Der Name der zu ändernden Schemavorlage.

String
is_active

Gibt an, ob die Regel aktiviert ist, wenn Schemas basierend auf der angegebenen Vorlage erstellt und aktualisiert werden.

  • ACTIVEDie hinzugefügte Regel wird bei der Erstellung und Aktualisierung beliebiger Schemas basierend auf der Eingabevorlage aktiviert. Dies ist die Standardeinstellung.
  • INACTIVEDie hinzugefügte Regel wird bei der Erstellung oder Aktualisierung beliebiger Schemas basierend auf der Eingabevorlage nicht aktiviert.
Boolean
trace_type

Gibt den Verfolgungstyp an, den die Regel zum Erstellen des Schemainhalts durchführt.

  • CONNECTED Eine Verbindungsverfolgung wird über die derzeit im Schema dargestellten Versorgungs- oder Verfolgungsnetz-Elemente ausgeführt, wenn die Regel gestartet wird, und erstreckt sich entlang der verbundenen Elemente nach außen. Dies ist die Standardeinstellung.
  • SUBNETWORK Eine Teilnetz-Verfolgung wird über die derzeit im Schema dargestellten Versorgungsnetz-Elemente ausgeführt, wenn die Regel gestartet wird, und erstreckt sich entlang der verbundenen Elemente nach außen, um Quellen oder Senken zu finden, von denen sie sich entlang des zugehörigen Teilnetzes nach außen erstreckt.
  • UPSTREAMEine Verfolgung flussaufwärts wird über die derzeit im Schema dargestellten Versorgungsnetz- oder Verfolgungsnetz-Elemente ausgeführt, wenn die Regel gestartet wird, um Elemente flussaufwärts zu ermitteln.
  • DOWNSTREAMEine Verfolgung flussabwärts wird über die derzeit im Schema dargestellten Versorgungsnetz- oder Verfolgungsnetz-Elemente ausgeführt, wenn die Regel gestartet wird, um Elemente flussabwärts zu ermitteln.
  • SHORTEST_PATH Eine Verfolgung vom Typ "Kürzeste Verbindung" wird über die derzeit im Schema angegebenen Verfolgungsnetz-Features ausgeführt, wenn die Regel gestartet wird, um Features entlang der kürzesten Verbindung zwischen diesen Startpunkten zu ermitteln. Die Kosten, die beim Passieren des Pfades entstehen, werden anhand des Netzwerkattributs ermittelt, die unabhängig von der Fließrichtung für den Parameter shortest_path_network_attribute_name angegeben wurde.
String
domain_network
(optional)

Der Name der Netzart, in der die Verfolgung eines Versorgungsnetzes ausgeführt wird. Dieser Parameter ist erforderlich, wenn die Verfolgungstypen für Teilnetze, flussaufwärts und flussabwärts ausgeführt werden.

String
tier
(optional)

Der Name der Ebene, auf der die Verfolgung eines Versorgungsnetzes gestartet wird. Dieser Parameter ist beim Ausführen der Verbindungsverfolgung optional; er ist erforderlich, wenn die Verfolgungstypen für Teilnetze, flussaufwärts und flussabwärts ausgeführt werden.

String
target_tier
(optional)

Der Name der Zielebene, in deren Richtung die Eingabeebene eines Versorgungsnetzes 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
include_structures
(optional)

Gibt an, ob Struktur-Features und Objekte in die Verfolgungsergebnisse einbezogen werden.

  • INCLUDE_STRUCTURESStruktur-Features und Objekte werden in die Verfolgungsergebnisse einbezogen.
  • EXCLUDE_STRUCTURESStruktur-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_BARRIERSBarrieren-Features für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.
  • EXCLUDE_BARRIERSBarrieren-Features für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.
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 wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu 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üssen. Sie können sie mit einer And- oder einer Or-Bedingung verbinden.

Die operator-Optionen für die Bedingungsbarrieren sind folgende:

  • IS_EQUAL_TODas Attribut ist gleich dem Wert.
  • DOES_NOT_EQUALDas Attribut ist nicht gleich dem Wert.
  • IS_GREATER_THANDas Attribut ist größer als der Wert.
  • IS_GREATER_THAN_OR_EQUAL_TODas Attribut ist größer als oder gleich dem Wert.
  • IS_LESS_THANDas Attribut ist kleiner als der Wert.
  • IS_LESS_THAN_OR_EQUAL_TODas Attribut ist kleiner als oder gleich dem Wert.
  • INCLUDES_THE_VALUESEine Operation mit "Bitwise AND", bei der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", bei der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", bei der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine Operation mit "Bitwise AND", bei 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_VALUENach einem bestimmten Wert filtern.
  • NETWORK_ATTRIBUTENach einem Netzwerkattribut filtern.

Die Combine Using-Optionen für die Bedingungsbarrieren sind folgende:

  • ANDDie Bedingungsbarrieren kombinieren.
  • ORVerwenden, wenn eine der Bedingungsbarrieren erfüllt ist.
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 wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu 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:

  • AVERAGEDer Durchschnitt der Eingabewerte.
  • COUNTDie Anzahl der Features.
  • MAXDas Maximum der Eingabewerte.
  • MINDas Minimum der Eingabewerte.
  • ADDDie Summe der Werte.
  • SUBTRACTDie 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_TODas Attribut ist gleich dem Wert.
  • DOES_NOT_EQUALDas Attribut ist nicht gleich dem Wert.
  • IS_GREATER_THANDas Attribut ist größer als der Wert.
  • IS_GREATER_THAN_OR_EQUAL_TODas Attribut ist größer als oder gleich dem Wert.
  • IS_LESS_THANDas Attribut ist kleiner als der Wert.
  • IS_LESS_THAN_OR_EQUAL_TODas Attribut ist kleiner als oder gleich dem Wert.
  • INCLUDES_THE_VALUESEine Operation mit "Bitwise AND", bei der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", bei der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", bei der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine Operation mit "Bitwise AND", bei 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:

  • TRUELokale Werte verwenden.
  • FALSEGlobale Werte verwenden. Dies ist die Standardeinstellung.
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 anzuhalten, aber der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht angehalten, wenn ein offenes Bauteil vorhanden ist, da "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_EDGESDurchlassfähigkeit auf Knoten und Kanten anwenden. Dies ist die Standardeinstellung.
  • JUNCTIONS_ONLYDurchlassfähigkeit nur auf Knoten anwenden.
  • EDGES_ONLYDurchlassfähigkeit nur auf Kanten anwenden.
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:

  • 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üssen. Sie können festlegen, dass sie mit einer And- oder einer Or-Bedingung verbunden werden.

Die operator-Optionen für die Filterbarrieren sind folgende:

  • IS_EQUAL_TODas Attribut ist gleich dem Wert.
  • DOES_NOT_EQUALDas Attribut ist nicht gleich dem Wert.
  • IS_GREATER_THANDas Attribut ist größer als der Wert.
  • IS_GREATER_THAN_OR_EQUAL_TODas Attribut ist größer als oder gleich dem Wert.
  • IS_LESS_THANDas Attribut ist kleiner als der Wert.
  • IS_LESS_THAN_OR_EQUAL_TODas Attribut ist kleiner als oder gleich dem Wert.
  • INCLUDES_THE_VALUESEine Operation mit "Bitwise AND", bei der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES NOT INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", bei der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", bei der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INLCUDE_ANYEine Operation mit "Bitwise AND", bei 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_VALUENach einem bestimmten Wert filtern.
  • NETWORK_ATTRIBUTENach einem Netzwerkattribut filtern.

Die Combine Using-Optionen für die Filterbarrieren sind folgende:

  • ANDDie Bedingungsbarrieren kombinieren.
  • ORVerwenden, wenn eine der Bedingungsbarrieren erfüllt ist.
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 wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu 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: Berechnet Werte in jeder Richtung 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:

  • AVERAGEDer Durchschnitt der Eingabewerte.
  • COUNTDie Anzahl der Features.
  • MAXDas Maximum der Eingabewerte.
  • MINDas Minimum der Eingabewerte.
  • ADDDie Summe der Werte.
  • SUBTRACTDie 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_TODas Attribut ist gleich dem Wert.
  • DOES_NOT_EQUALDas Attribut ist nicht gleich dem Wert.
  • IS_GREATER_THANDas Attribut ist größer als der Wert.
  • IS_GREATER_THAN_OR_EQUAL_TODas Attribut ist größer als oder gleich dem Wert.
  • IS_LESS_THANDas Attribut ist kleiner als der Wert.
  • IS_LESS_THAN_OR_EQUAL_TODas Attribut ist kleiner als oder gleich dem Wert.
  • INCLUDES_THE_VALUESEine Operation mit "Bitwise AND", bei der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", bei der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", bei der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine Operation mit "Bitwise AND", bei 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:

  • TRUELokale Werte verwenden.
  • FALSEGlobale Werte verwenden. 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 anzuhalten, aber der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, würde die Verfolgung auch dann nicht angehalten, wenn ein offenes Bauteil vorhanden ist, da "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_EDGESDer Filter wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
  • JUNCTIONS_ONLYDer Filter wird nur auf Knoten angewendet.
  • EDGES_ONLYDer 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_NEARESTDer 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_FILTERDer 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 True 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 True hat, zum Beispiel Shape-Länge.

String
nearest_categories
[nearest_categories,...]
(optional)

Die Kategorien, die zurückgegeben werden sollen, wenn filter_nearest den Wert True 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 True hat, zum Beispiel ElectricDistributionDevice/Transformer/Step Down.

String
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 werden soll. 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:

  • 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-Optionen für die Verteilungsmodule lauten wie folgt:

  • PROPAGATED_BITWISE_ANDDie Werte aus einem Feature mit dem nächsten vergleichen.
  • PROPAGATED_MINDen Minimalwert abrufen.
  • PROPAGATED_MAXDen Maximalwert abrufen.

Die operator-Optionen für die Verteilungsmodule lauten wie folgt:

  • IS_EQUAL_TODas Attribut ist gleich dem Wert.
  • DOES_NOT_EQUALDas Attribut ist nicht gleich dem Wert.
  • IS_GREATER_THANDas Attribut ist größer als der Wert.
  • IS_GREATER_THAN_OR_EQUAL_TODas Attribut ist größer als oder gleich dem Wert.
  • IS_LESS_THANDas Attribut ist kleiner als der Wert.
  • IS_LESS_THAN_OR_EQUAL_TODas Attribut ist kleiner als oder gleich dem Wert.
  • INCLUDES_THE_VALUESEine Operation mit "Bitwise AND", bei der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", bei der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", bei der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine Operation mit "Bitwise AND", bei der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Weitere Informationen zu Bitwise-Operatoren

Hinweis:

Dieser Parameter ist nur über Python verfügbar.

Value Table
description
(optional)

Die Beschreibung der Regel.

String
allow_indeterminate_flow
(optional)

Gibt an, ob Verfolgungsnetz-Features mit einer unbestimmbaren oder nicht initialisierten Fließrichtung verfolgt werden. Dieser Parameter wird nur bei der Ausführung einer Verfolgung flussaufwärts oder flussabwärts berücksichtigt.

  • TRACE_INDETERMINATE_FLOWVerfolgungsnetz-Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen einbeziehen.
  • IGNORE_INDETERMINATE_FLOWVerfolgungsnetz-Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen nicht einbeziehen. Dies ist die Standardeinstellung.
Boolean
path_direction
(optional)

Gibt die Richtung eines Verfolgungsnetzes an. Die Kosten, die beim Passieren des Pfades entstehen, werden anhand des Wertes path_network_attribute_name ermittelt. Dieser Parameter wird nur bei der Ausführung einer Verfolgung vom Typ PATH berücksichtigt.

  • NO_DIRECTIONFindet den Pfad zwischen zwei Startpunkten unabhängig von der Fließrichtung. Dies ist die Standardeinstellung.
  • PATH_UPSTREAMFindet den Pfad flussabwärts zwischen zwei Startpunkten.
  • PATH_DOWNSTREAMFindet den Pfad flussaufwärts zwischen zwei Startpunkten.
String
path_network_weight_name
(optional)

Das Netzwerkattribut, das zum Berechnen des Pfades eines Verfolgungsnetzes 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

Abgeleitete Ausgabe

NameErklärungDatentyp
out_utility_network

Das aktualisierte Versorgungs- oder Verfolgungsnetz.

Versorgungsnetz, Verfolgungsnetz
out_template_name

Der Name der Schemavorlage

Zeichenfolge

Codebeispiel

AddTraceRule – Beispiel (Python-Fenster)

Mit diesem Beispielskript wird der für ein angegebenes Netzwerk bestehenden Vorlage "MyTemplate1" eine Verfolgungsregel hinzugefügt, um in der Domäne "ElectricDistribution" Schemas aus einer Verfolgung in Teilnetzen innerhalb der Ebene "Mittlere Spannung" zu erstellen.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddTraceRule_nd(input_Network, input_DiagramTemplate, "ACTIVE", 
                      "SUBNETWORK", "ElectricDistribution", "Medium Voltage", 
                      "Low Voltage Mesh")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen