Verfolgen (Utility Network)

Zusammenfassung

Gibt ausgewählte Netzwerk-Features in einem Versorgungsnetz basierend auf Konnektivität oder Durchlassfähigkeit aus den angegebenen Startpunkten zurück.

Mithilfe von Versorgungsnetz-Verfolgungsfunktionen können Sie die Pfade in einem Netzwerk analysieren. Durchlassfähigkeit bezieht sich auf Pfade, die durch verbundene oder verknüpfte Features entstehen, die bestimmte Konfigurationsanforderungen erfüllen.

Standardmäßig werden Verfolgungsergebnisse als Auswahl zurückgegeben und enthalten das vollständige Linien-Feature. Um teilweise Feature-Ergebnisse unter Berücksichtigung der Position von Startpunkten und Barrieren entlang einer Kante zurückzugeben, legen Sie den Parameter Ergebnistypen auf Aggregierte Geometrie fest. Mittig entlang eines Kantenobjekts platzierte Verfolgungspositionen können mit dem Parameter Geometrien darstellen zum Zurückgeben partieller Geometrien verwendet werden, wenn Kantenobjekte Inhalt eines Linien-Features sind.

Mit der Option Aggregierte Geometrie geben die an einer Kante platzierten Startpunkte das Kantenelement aus dem vorherigen Knoten mit mittiger Verbindung bzw. dem Endpunkt zurück. Wenn eine Barriere an einer Kante platziert wird, während der Parameter Barrieren-Features einbeziehen aktiviert ist, endet die Verfolgung am nächsten Knoten mit mittiger Konnektivität oder am Linienende. Ist der Parameter Barrieren-Features einbeziehen nicht aktiviert, endet die Verfolgung am vorherigen Knoten mit mittiger Konnektivität oder am vorherigen Linienende.

Anschließend können Sie den aus einer Verfolgung resultierenden Auswahlsatz oder die durch die Verfolgung generierte Feature-Class an eine andere Karte oder an eine Schemaansicht weitergeben oder sie als Eingabe für ein anderes Werkzeug bzw. eine andere Verfolgung verwenden.

Weitere Informationen zum Verfolgen von Versorgungsnetzen

Verwendung

  • Die Netzwerk-Topologie muss aktiviert sein. Da das Werkzeug Verfolgen auf der Netzwerk-Topologie basiert, sind die Ergebnisse einer Verfolgung möglicherweise nicht genau, wenn Dirty Areas verfolgt werden. Die Netzwerk-Topologie für die zu verfolgende Fläche muss validiert werden, damit die aktuellen Änderungen oder Aktualisierungen am Netzwerk darstellt werden.

  • Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss das Eingabe-Versorgungsnetz aus einem Versorgungsnetz-Service stammen.

  • Wird eine teilnetzbasierte Verfolgung mit dem Werkzeug Verfolgen über Python ausgeführt, wird die Teilnetz-Verfolgungskonfiguration der Eingabeebene nicht automatisch angewendet und muss manuell angegeben werden.

  • Wenn Sie mit Netzwerkattributen arbeiten, die einem Datumsfeld zum Filtern von Barrieren, Funktionsbarrieren, Funktionen und Ausgabebedingungen zugewiesen sind, muss der Datumswert das Format yyyy-mm-dd hh:mm:ss aufweisen, z. B. 2020-10-12 18:45:31.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

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
Verfolgungstyp

Gibt den zu verwendenden Netzverfolgungstyp an.

  • VerbundenEine Verbindungsverfolgung, die an mindestens einem Startpunkt beginnt und sich entlang der verbundenen Features nach außen erstreckt, wird verwendet. Dies ist die Standardeinstellung.
  • TeilnetzEine Teilnetz-Verfolgung, die an mindestens einem Startpunkt beginnt und sich nach außen erstreckt, um die Ausdehnung des Teilnetzes zu umschließen, wird verwendet.
  • Teilnetz-ControllerEine Verfolgung von Teilnetz-Controllern, die Quellen und Senken in Teilnetz-Controllern verortet, die mit einem Teilnetz verknüpft sind.
  • FlussaufwärtsEine Verfolgung flussaufwärts, bei der Features ermittelt werden, die sich flussaufwärts von einer Position im Netzwerk befinden, wird verwendet.
  • FlussabwärtsEine Verfolgung flussabwärts, bei der Features ermittelt werden, die sich flussabwärts von einer Position im Netzwerk befinden, wird verwendet.
  • SchleifenEine Schleifenverfolgung, die sich basierend auf der Konnektivität vom Startpunkt aus nach außen erstreckt. Schleifen sind Bereiche des Netzwerks, in denen die Fließrichtung unklar ist.
  • Kürzeste VerbindungEine Verfolgung des kürzesten Pfads, die den kürzesten Pfad zwischen zwei Startpunkten ermittelt.
  • IsolationEine Isolationsverfolgung, die Features ermittelt, die die Fläche eines Netzwerks isolieren.
String
Startpunkte
(optional)

Ein Feature-Layer, der mithilfe des Werkzeugs Startpunkte im Bereich Verfolgungspositionen erstellt wurde, oder 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. Die Feature-Class "UN_Temp_Starting_Points" in der Standard-Geodatabase des Projekts wird standardmäßig verwendet.

Feature Layer; Table View
Barrieren
(optional)

Ein Feature-Layer, der mithilfe des Werkzeugs Barrieren im Bereich Verfolgungspositionen erstellt wird, oder eine Tabelle oder Feature-Class mit mindestens einem Datensatz, der die Barrieren darstellt, 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. Die Feature-Class "UN_Temp_Barriers" in der Standard-Geodatabase des Projekts wird standardmäßig verwendet.

Feature Layer; Table View
Netzart
(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
Ebene
(optional)

Der Name der Ebene, auf der die Verfolgung gestartet wird. Dieser Parameter ist erforderlich, wenn die Verfolgungen vom Typ "Teilnetz", "Teilnetz-Controller", "Flussaufwärts" und "Flussabwärts" ausgeführt werden.

String
Zielebene
(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
Teilnetzname
(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 Startpunkte nicht erforderlich. Wenn die Teilnetztabelle 10.000 oder mehr Datensätze für eine Ebene enthält, ist die Auswahlliste des Parameters nicht gefüllt, und für den Teilnetznamen wird ein leeres Feld angezeigt.

String
Name des Netzwerkattributs für "Kürzester Pfad"
(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
Container einbeziehen
(optional)

Gibt an, ob die Container-Features in die Verfolgungsergebnisse einbezogen werden.

  • Aktiviert: Container-Features werden in die Verfolgungsergebnisse einbezogen. Dadurch wird der Parameter Bis ersten räumlichen Container einbeziehen aktiviert.
  • Nicht aktiviert: Container-Features werden in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.

Boolean
Inhalt einbeziehen
(optional)

Gibt an, ob die Verfolgung in den Ergebnissen den Inhalt von Container-Features zurückgibt.

  • Aktiviert: Inhalt in Container-Features wird in die Verfolgungsergebnisse einbezogen.
  • Nicht aktiviert: Inhalt in Container-Features wird in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.

Boolean
Strukturen einbeziehen
(optional)

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

  • Aktiviert: Struktur-Features und Objekte werden in die Verfolgungsergebnisse einbezogen.
  • Nicht aktiviert: Struktur-Features und Objekte werden nicht in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.

Boolean
Barrieren-Features einbeziehen
(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.

  • Aktiviert: Barrieren-Features für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.
  • Deaktiviert: Barrieren-Features für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.

Boolean
Konsistenz überprüfen
(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, validieren Sie die Netzwerk-Topologie.

  • Aktiviert: Bei der Verfolgung wird ein Fehler ausgegeben, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die Standardeinstellung.
  • Deaktiviert: Die Verfolgungsergebnisse werden ausgegeben, auch wenn in den durchlaufenen Features Dirty Areas gefunden werden.

Boolean
Bedingungsbarrieren
(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: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut oder einer Netzwerkkategorie fest.
  • Operator: Treffen Sie eine Auswahl aus verschiedenen Operatoren.
  • Typ: Wählen Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der im Parameter Name angegeben ist, aus.
  • Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
  • Kombination verwenden: 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-Wertoptionen für die Bedingungsbarrieren lauten wie folgt:

  • Ist gleich: Das Attribut ist gleich dem Wert.
  • Ist ungleich: Das Attribut ist nicht gleich dem Wert.
  • Ist größer als: Das Attribut ist größer als der Wert.
  • Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert.
  • Ist kleiner als: Das Attribut ist kleiner als der Wert.
  • Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert.
  • Enthält die Werte: Eine Operation mit "Bitwise And", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • Enthält die Werte nicht: Eine Operation mit "Bitwise And", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • Enthält mindestens einen der Werte: Eine Operation mit "Bitwise And", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • Kein Einbeziehen von: Eine Operation mit "Bitwise And", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Die Typ-Optionen für die Bedingungsbarrieren lauten wie folgt:

  • Bestimmter Wert: Nach einem bestimmten Wert filtern.
  • Netzwerkattribut: Nach einem Netzwerkattribut filtern.

Value Table
Funktionsbarrieren
(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:

  • Funktion: Wählen Sie aus verschiedenen Berechnungsfunktionen aus.
  • Attribut: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest.
  • Operator: Treffen Sie eine Auswahl aus verschiedenen Operatoren.
  • Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der zur Beendigung führt, wenn er ermittelt wird.
  • Lokale Werte verwenden: Hier können Sie Werte in jeder Richtung berechnen, im Gegensatz zu einem globalen Gesamtwert. Beispiel sei eine Funktionsbarriere, bei der die Summe von Shape length berechnet wird, 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 für Shape length bereits eine Summe von 4 erreicht wurde. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern.
    • Aktiviert: Lokale Werte werden verwendet.
    • Deaktiviert: Globale Werte werden verwendet. Dies ist die Standardeinstellung.

Die Wertoptionen für die Komponente Funktion der Funktionsbarriere lauten wie folgt:

  • Minimum: Das Minimum der Eingabewerte.
  • Maximum: Das Maximum der Eingabewerte.
  • Addieren: Die Summe der Eingabewerte.
  • Mittelwert: Der Durchschnitt der Eingabewerte.
  • Anzahl: Die Anzahl der Features
  • Subtrahieren: Die Differenz zwischen den Eingabewerten.

    Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.

Das Startpunkt-Feature weist beispielsweise den Wert 20 auf. Das nächste Feature hat den Wert 30. Mit der Funktion "Minimum" ist das Ergebnis 20, mit "Maximum" ist es 30, mit "Addieren" ist es 50, mit "Mittelwert" ist es 25, mit "Anzahl" ist es 2, und mit "Subtrahieren" ist es -10.

Die Operator-Wertoptionen für die Funktionsbarriere lauten wie folgt:

  • Ist gleich: Das Attribut ist gleich dem Wert.
  • Ist ungleich: Das Attribut ist nicht gleich dem Wert.
  • Ist größer als: Das Attribut ist größer als der Wert.
  • Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert.
  • Ist kleiner als: Das Attribut ist kleiner als der Wert.
  • Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert.
  • Enthält die Werte: Eine Operation mit "Bitwise And", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • Enthält die Werte nicht: Eine Operation mit "Bitwise And", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • Enthält mindestens einen der Werte: Eine Operation mit "Bitwise And", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • Kein Einbeziehen von: Eine Operation mit "Bitwise And", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Value Table
Durchlassfähigkeit anwenden auf
(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.

  • Knoten und KantenDie Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
  • Nur KnotenDie Durchlassfähigkeit wird nur auf Knoten angewendet.
  • Nur KantenDie Durchlassfähigkeit wird nur auf Kanten angewendet.
String
Filterbarrieren
(optional)

Legt fest, wann die 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 Kombination verwenden 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: Treffen Sie eine Auswahl aus verschiedenen Operatoren.
  • Typ: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der im Parameter Name angegeben ist, auswählen.
  • Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
  • Kombination verwenden: 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 lauten wie folgt:

  • Ist gleich: Das Attribut ist gleich dem Wert.
  • Ist ungleich: Das Attribut ist nicht gleich dem Wert.
  • Ist größer als: Das Attribut ist größer als der Wert.
  • Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert.
  • Ist kleiner als: Das Attribut ist kleiner als der Wert.
  • Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert.
  • Enthält die Werte: Eine Operation mit "Bitwise And", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • Enthält die Werte nicht: Eine Operation mit "Bitwise And", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • Enthält mindestens einen der Werte: Eine Operation mit "Bitwise And", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • Kein Einbeziehen von: Eine Operation mit "Bitwise And", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Die Typ-Optionen für die Filterbarrieren lauten wie folgt:

  • Bestimmter Wert: Nach einem bestimmten Wert filtern.
  • Netzwerkattribut: Nach einem Netzwerkattribut filtern.

Value Table
Filterfunktionsbarrieren
(optional)

Diese filtern die Ergebnisse der Verfolgung entsprechend einer bestimmten Kategorie.

Die Komponenten der Filterfunktionsbarrieren sind folgende:

  • Funktion: Wählen Sie aus verschiedenen Berechnungsfunktionen aus.
  • Attribut: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest.
  • Operator: Treffen Sie eine Auswahl aus verschiedenen Operatoren.
  • Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der zur Beendigung führt, wenn er ermittelt wird.
  • Lokale Werte verwenden: Berechnet Werte in jeder Richtung im Gegensatz zu einem globalen Gesamtwert. 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.
    • Aktiviert: Lokale Werte werden verwendet. Dies ist die Standardeinstellung.
    • Deaktiviert: Globale Werte werden verwendet.

Die Funktion-Optionen für die Filterfunktionsbarrieren lauten wie folgt:

  • Minimum: Das Minimum der Eingabewerte wird ermittelt.
  • Maximum: Das Maximum der Eingabewerte wird ermittelt.
  • Addieren: Die Summe der Werte wird berechnet.
  • Durchschnitt: Der Durchschnitt der Eingabewerte wird berechnet.
  • Anzahl: Die Anzahl der Features wird ermittelt.
  • Subtrahieren: Die Differenz zwischen den Werten wird berechnet. 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. Wenn Sie die Funktion Minimum verwenden, ist das Ergebnis 20. Maximum ist 30, Addieren ist 50, Mittelwert ist 25, Anzahl ist 2 und Subtrahieren ist -10.

Die Operator-Optionen für die Filterfunktionsbarrieren lauten wie folgt:

  • Ist gleich: Das Attribut ist gleich dem Wert.
  • Ist ungleich: Das Attribut ist nicht gleich dem Wert.
  • Ist größer als: Das Attribut ist größer als der Wert.
  • Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert.
  • Ist kleiner als: Das Attribut ist kleiner als der Wert.
  • Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert.
  • Enthält die Werte: Eine Operation mit "Bitwise And", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • Enthält die Werte nicht: Eine Operation mit "Bitwise And", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • Enthält mindestens einen der Werte: Eine Operation mit "Bitwise And", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • Kein Einbeziehen von: Eine Operation mit "Bitwise And", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Value Table
Filter anwenden auf
(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.

  • Knoten und Kanten: Der Filter wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
  • Nur Knoten: Der Filter wird nur auf Knoten angewendet.
  • Nur Kanten: Der Filter wird nur auf Kanten angewendet.

  • Knoten und KantenDer Filter wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
  • Nur KnotenDer Filter wird nur auf Knoten angewendet.
  • Nur KantenDer Filter wird nur auf Kanten angewendet.
String
Filtern nach Bitset-Netzwerkattribut
(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
Filtern nach nächstgelegenen
(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. Sie können Anzahl und Kosten sowie eine Sammlung von Kategorien und/oder einen Asset-Typ angeben.

  • Aktiviert: Der Algorithmus "Nächster Nachbar (K)" wird verwendet, um eine Reihe von Features zurückzugeben, wie in den Parametern Anzahl, Kosten-Netzwerkattribut, Nächstgelegene Kategorien oder Nächstgelegene Asset-Gruppen/-Typen angegeben.
  • Deaktiviert: Der Algorithmus "Nächster Nachbar (K)" wird nicht verwendet, um Ergebnisse zu filtern. Dies ist die Standardeinstellung.

Boolean
Anzahl
(optional)

Die Anzahl der zurückzugebenden Features, wenn Filtern nach nächstgelegenen aktiviert ist.

Long
Kosten-Netzwerkattribut
(optional)

Das numerische Netzwerkattribut, das zum Berechnen von Nähe, Kosten oder Entfernung verwendet werden soll, wenn Filtern nach nächstgelegenen aktiviert ist, zum Beispiel Shape-Länge.

String
Nächstgelegene Kategorien
(optional)

Die Kategorien, die zurückgegeben werden sollen, wenn Filtern nach nächstgelegenen aktiviert ist, zum Beispiel Schutz.

String
Nächstgelegene Asset-Gruppen/-Typen
(optional)

Die Asset-Gruppen und Asset-Typen, die zurückgegeben werden sollen, wenn Filtern nach nächstgelegenen aktiviert ist, zum Beispiel ElectricDistributionDevice/Transformer/Step Down.

String
Funktionen
(optional)

Die Berechnungsfunktionen, die auf die Verfolgungsergebnisse angewendet werden.

Folgende Funktionskomponenten stehen zur Verfügung:

  • Funktion: Wählen Sie aus verschiedenen Berechnungsfunktionen aus.
  • Attribut: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest.
  • Name: Legen Sie die Filterung der Funktionsergebnisse nach Attributname fest.
  • Operator: Wählen Sie aus verschiedenen Operatoren aus.
  • Typ: Wählen Sie aus verschiedenen Filtertypen aus.
  • Filterwert: Geben Sie einen Wert für das Eingabefilterattribut an.

Die Funktion-Optionen für die Funktionen lauten wie folgt:

  • Durchschnitt: Der Durchschnitt der Eingabewerte wird berechnet.
  • Anzahl: Die Anzahl der Features wird ermittelt.
  • Maximum: Das Maximum der Eingabewerte wird ermittelt.
  • Minimum: Das Minimum der Eingabewerte wird ermittelt.
  • Addieren: Die Summe der Eingabewerte wird berechnet.
  • Subtrahieren: Die Differenz zwischen den Eingabewerten wird berechnet.

    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. Wenn Sie die Funktion Minimum verwenden, ist das Ergebnis 20. Maximum ist 30, Addieren ist 50, Mittelwert ist 25, Anzahl ist 2 und Subtrahieren ist -10.

Die Filteroperator-Optionen für die Funktionen lauten wie folgt:

  • Ist gleich: Das Attribut ist gleich dem Wert.
  • Ist ungleich: Das Attribut ist nicht gleich dem Wert.
  • Ist größer als: Das Attribut ist größer als der Wert.
  • Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert.
  • Ist kleiner als: Das Attribut ist kleiner als der Wert.
  • Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert.
  • Enthält die Werte: Eine Operation mit "Bitwise And", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • Enthält die Werte nicht: Eine Operation mit "Bitwise And", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • Enthält mindestens einen der Werte: Eine Operation mit "Bitwise And", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • Kein Einbeziehen von: Eine Operation mit "Bitwise And", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Die Filtertyp-Optionen für die Funktionen lauten wie folgt:

  • Bestimmter Wert: Nach einem bestimmten Wert filtern.
  • Netzwerkattribut: Nach einem Netzwerkattribut filtern.

  • DurchschnittDer Durchschnitt der Eingabewerte wird berechnet.
  • AnzahlDie Anzahl der Features wird ermittelt.
  • MaximumDas Maximum der Eingabewerte wird ermittelt.
  • MinimumDas Minimum der Eingabewerte wird ermittelt.
  • AddierenDie Summe der Werte wird berechnet.
  • SubtrahierenDie Differenz zwischen den Werten wird berechnet.Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.
Value Table
Weitergabemodule
(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:

  • Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, 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:

Die Operator-Wertoptionen für die Verteilungsmodule lauten wie folgt:

Weitere Informationen zu Bitwise-Operatoren

  • Ist gleichDas Attribut ist gleich dem Wert.
  • Ist ungleichDas Attribut ist nicht gleich dem Wert.
  • Ist größer alsDas Attribut ist größer als der Wert.
  • Ist größer als oder gleichDas Attribut ist größer als oder gleich dem Wert.
  • Ist kleiner alsDas Attribut ist kleiner als der Wert.
  • Ist kleiner als oder gleichDas Attribut ist kleiner als oder gleich dem Wert.
  • Enthält die Werte (Bitwise AND entspricht dem Wert)Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • Enthält die Werte nicht (Bitwise AND entspricht dem Wert nicht)Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • Enthält mindestens einen der Werte (Bitwise AND ist "True")Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • Kein Einbeziehen von (Bitwise AND ist "False")Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Hinweis:

Dieser Parameter ist nur für Python verfügbar.

Value Table
Ausgabe-Asset-Typen
(optional)

Filtert die Ausgabe-Asset-Typen, die in die Ergebnisse einbezogen werden sollen, z. B. nur Freileitungstransformatoren.

String
Ausgabebedingungen
(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.

Die Komponenten der Ausgabebedingungen sind folgende:

  • Name: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest.
  • Operator: Treffen Sie eine Auswahl aus verschiedenen Operatoren.
  • Typ: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der im Parameter Name angegeben ist, auswählen.
  • Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
  • Kombination verwenden: 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-Wertoptionen für die Ausgabebedingungen lauten wie folgt:

  • Ist gleich: Das Attribut ist gleich dem Wert.
  • Ist ungleich: Das Attribut ist nicht gleich dem Wert.
  • Ist größer als: Das Attribut ist größer als der Wert.
  • Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert.
  • Ist kleiner als: Das Attribut ist kleiner als der Wert.
  • Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert.
  • Enthält die Werte: Eine Operation mit "Bitwise And", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • Enthält die Werte nicht: Eine Operation mit "Bitwise And", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • Enthält mindestens einen der Werte: Eine Operation mit "Bitwise And", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • Kein Einbeziehen von: Eine Operation mit "Bitwise And", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Die Typ-Optionen für die Ausgabebedingungen lauten wie folgt:

  • Bestimmter Wert: Nach einem bestimmten Wert filtern.
  • Netzwerkattribut: Nach einem Netzwerkattribut filtern.

Value Table
Isolierte Features einbeziehen
(optional)

Gibt an, ob die isolierten Features in die Verfolgungsergebnisse einbezogen werden. Dieser Parameter wird zum Ausführen einer Isolationsverfolgung verwendet.

  • Aktiviert: Isolierte Features für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen.
  • Nicht aktiviert: Isolierte Features werden in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.

Boolean
Barrieren bei Startpunkten ignorieren
(optional)

Gibt an, ob dynamische Barrieren in der Verfolgungskonfiguration für Startpunkte ignoriert werden. 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.

  • Aktiviert: Barrieren bei Startpunkten werden in der Verfolgung ignoriert.
  • Deaktiviert: Barrieren bei Startpunkten werden in der Verfolgung nicht ignoriert. Dies ist die Standardeinstellung.

Boolean
Bis ersten räumlichen Container einbeziehen
(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 ist nur verfügbar, wenn Container einbeziehen aktiviert ist.

  • Aktiviert: Es werden nur Container bis einschließlich des ersten räumlichen Containers in den Ergebnissen zurückgegeben, 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.
  • Nicht aktiviert: Alle Container werden in den Ergebnissen zurückgegeben. Dies ist die Standardeinstellung.
Boolean
Ergebnistypen
(optional)

Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden.

  • AuswahlDie Verfolgungsergebnisse werden als Auswahlsatz der entsprechenden Netzwerk-Features zurückgegeben. Dies ist die Standardeinstellung.
  • Aggregierte GeometrieDie Verfolgungsergebnisse werden nach Geometrietyp aggregiert und in Multipart-Feature-Classes gespeichert, die in den Layern auf der aktiven Karte angezeigt werden.
  • KonnektivitätDie Verfolgungsergebnisse werden als Konnektivitätsdiagramm in der angegebenen .json-Ausgabedatei für die durchlaufenen Netzwerk-Features zurückgegeben. Mit dieser Option wird der Parameter Ausgabe-JSON aktiviert.
  • ElementeDie Verfolgungsergebnisse werden als Feature-basierte Informationen in der angegebenen .json-Ausgabedatei für die durchlaufenen Netzwerk-Features zurückgegeben. Mit dieser Option wird der Parameter Ausgabe-JSON aktiviert.
  • FeaturesDie Verfolgungsergebnisse werden als Feature-basierte Informationen in der angegebenen .json-Ausgabedatei für die durchlaufenen Netzwerk-Features zurückgegeben. Mit dieser Option werden die Parameter Geometrie einbeziehen, Domänenbeschreibungen einbeziehen, Ergebnis-Netzwerkattribute, Ergebnisfelder und Ausgabe-JSON aktiviert.
  • Containment-Zuordnungen und Zuordnungen struktureller AnbautenDie Verfolgungsergebnisse werden als Zuordnungsinformationen für durchlaufene Netzwerk-Features, die durch Containment und strukturelle Anbau-Zuordnungen zugeordnet sind, in der angegebenen .json-Ausgabedatei zurückgegeben. Mit dieser Option werden die Parameter Domänenbeschreibungen einbeziehen und Ausgabe-JSON aktiviert.
String
Auswahltyp

Gibt an, wie die Auswahl angewendet wird, und welche Aktion ausgeführt wird, wenn eine aktuelle Auswahl vorhanden ist.

  • Neue AuswahlDie getätigte Auswahl ersetzt die aktuelle Auswahl. Dies ist die Standardeinstellung.
  • Zur aktuellen Auswahl hinzufügenDie 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".
  • Aus aktueller Auswahl entfernenDie getätigte Auswahl wird aus der aktuellen Auswahl entfernt. Wenn keine Auswahl vorhanden ist, ist diese Option irrelevant.
  • Teilmenge aus der aktuellen Auswahl auswählenDie getätigte Auswahl wird mit der aktuellen Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, werden ausgewählt.
  • Aktuelle Auswahl umkehrenDie 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
Alle vorherigen Verfolgungsergebnisse löschen
(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".

  • Aktiviert: 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.
  • Deaktiviert: Die Ausgabegeometrie der aktuellen Verfolgungsoperation wird an die Feature-Classes angefügt, in denen die aggregierte Geometrie gespeichert wird.
Boolean
Name der Verfolgung
(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
Aggregierte Punkte
(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
Aggregierte Linien
(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
Aggregierte Polygone
(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
Unbestimmbare Fließrichtung zulassen
(optional)

Gibt an, ob Features mit einer unbestimmbaren Fließrichtung verfolgt werden. Dieser Parameter ist nur bei der Ausführung einer Verfolgung flussaufwärts, einer Verfolgung flussabwärts oder einer Isolationsverfolgung anwendbar.

  • Aktiviert: Features mit einer unbestimmbaren Fließrichtung werden verfolgt. Dies ist die Standardeinstellung.
  • Nicht aktiviert: Bei Features mit einer unbestimmbaren Fließrichtung wird die Durchlassfähigkeit beendet, und die Features werden nicht verfolgt.

Hinweis:

Für diesen Parameter wird eine Utility Network-Version mit dem Wert 5 oder höher benötigt.

Boolean
Verortbarkeit überprüfen
(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.

  • Aktiviert: 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.
  • Deaktiviert: 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.

Hinweis:

Für diesen Parameter wird eine Utility Network-Version mit dem Wert 4 oder höher benötigt.

Boolean
Verfolgungskonfiguration verwenden
(optional)

Gibt an, ob zum Füllen der Parameter des Werkzeugs eine vorhandene benannte Verfolgungskonfiguration verwendet wird.

  • Aktiviert: Eine vorhandene benannte Verfolgungskonfiguration wird zum Definieren der Verfolgungseigenschaften verwendet. Mit Ausnahme von Name der Verfolgungskonfiguration, Startpunkte und Barrieren werden alle Parameter ignoriert.
  • Deaktiviert: Es wird keine vorhandene benannte Verfolgungskonfiguration zum Definieren der Verfolgungseigenschaften verwendet. Dies ist die Standardeinstellung.

Hinweis:

Für diesen Parameter wird eine Utility Network-Version mit dem Wert 5 oder höher benötigt.

Boolean
Name der Verfolgungskonfiguration
(optional)

Der Name der vorhandenen benannten Verfolgungskonfiguration, die zum Definieren der Verfolgungseigenschaften verwendet wird. Dieser Parameter ist nur aktiv, wenn der Parameter Verfolgungskonfiguration verwenden aktiviert wurde.

Hinweis:

Für diesen Parameter wird eine Utility Network-Version mit dem Wert 5 oder höher benötigt.

String
Ausgabe-JSON
(optional)

Der Name und Speicherort der .json-Datei, die generiert wird, wenn Verfolgungsergebnisse mithilfe der Ergebnistypen "Konnektivität", "Elemente", "Features" oder "Containment" und "Anbau" zurückgegeben werden.

File
In asynchronem Modus auf dem Server ausführen
(optional)

Gibt an, ob Verfolgungen asynchron verarbeitet werden, wenn mit einem Versorgungsnetz in einer Enterprise-Geodatabase gearbeitet wird.

  • Aktiviert: Verfolgungen werden asynchron verarbeitet.
  • Deaktiviert: Verfolgungen werden synchron verarbeitet. Dies ist die Standardeinstellung.

Hinweis:

Für diesen Parameter ist ArcGIS Enterprise 10.9.1 oder höher erforderlich.

Boolean
Geometrie einbeziehen
(optional)

Gibt an, ob Geometrie in die Ergebnisse einbezogen wird.

  • Aktiviert: Geometrie wird in die Ergebnisse einbezogen.
  • Deaktiviert: Geometrie wird nicht in die Ergebnisse einbezogen. Dies ist die Standardeinstellung.

Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

Boolean
Domänenbeschreibungen einschließen
(optional)

Gibt an, ob in die .json-Ausgabedatei Domänenbeschreibungen aufgenommen werden, um Domänenzuordnungen für controller, featureElements, connectivity und associations weiterzugeben.

  • Aktiviert: Domänenbeschreibungen werden in die Ergebnisse aufgenommen.
  • Deaktiviert: Domänenbeschreibungen werden nicht in die Ergebnisse aufgenommen. Dies ist die Standardeinstellung.

Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

Boolean
Ergebnis-Netzwerkattribute
(optional)

Die Netzwerkattribute, die in die Ergebnisse aufgenommen werden.

Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

String
Ergebnisfelder
(optional)

Felder aus einer Feature-Class, die als Ergebnisse zurückgegeben werden sollen. Die Werte der Felder werden in den Ergebnissen für die Features in der Netzverfolgung zurückgegeben.

Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

Value Table
Digitalisierrichtung verwenden
(optional)

Gibt an, ob die Fließrichtung bei Verfolgungen flussaufwärts oder flussabwärts mithilfe der Digitalisierrichtung der Linie, der Von- und Bis-Global-ID des Kantenobjekts in der Zuordnung sowie des Attributs Flow direction bestimmt wird. Dieser Parameter ist nur für Utility Network-Version 7 und höher verfügbar und aktiv, wenn für den Parameter Verfolgungstyp die Option Flussaufwärts oder Flussabwärts festgelegt wurde.

  • Aktiviert: Bei Verfolgungen wird die Fließrichtung mithilfe der Digitalisierrichtung der Linie, der Von- und Bis-Global-ID des Kantenobjekts in der Zuordnung sowie des Fließrichtungsattributs bestimmt. Wenn dieser Parameter aktiviert ist, werden die Parameter Netzart, Ebene und Zielebene ausgeblendet und ignoriert.
  • Deaktiviert: Die Fließrichtung von Verfolgungen wird abhängig von der Position der Teilnetz-Controller bestimmt. Dies ist die Standardeinstellung.

Hinweis:

Bei Verwendung einer Geodatabase ist für diesen Parameter ArcGIS Enterprise 11.3 oder höher erforderlich.

Boolean
Geometrien darstellen
(optional)

Gibt an, ob Geometrien für Zuordnungen und Kantenobjekte, die bei einer Verfolgung durchquert werden, abgeleitet und erstellt (dargestellt) werden. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".

  • Aktiviert: Es werden Geometrien für die durchquerten Zuordnungen und Kantenobjekte in der Ausgabe-Feature-Class "Trace_results_Aggregated_Lines" abgeleitet und erstellt.
  • Deaktiviert: Es werden keine Geometrien für die durchquerten Zuordnungen und Kantenobjekte dargestellt. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Versorgungsnetz

Das aktualisierte Versorgungsnetz.

Utility Network

arcpy.un.Trace(in_utility_network, trace_type, {starting_points}, {barriers}, {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}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {aggregated_polygons}, {allow_indeterminate_flow}, {validate_locatability}, {use_trace_config}, {trace_config_name}, {out_json_file}, {run_async}, {include_geometry}, {include_domain_descriptions}, {result_network_attributes}, {result_fields}, {use_digitized_direction}, {synthesize_geometries})
NameErläuterungDatentyp
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 zu verwendenden Netzverfolgungstyp an.

  • CONNECTEDEine Verbindungsverfolgung, die an mindestens einem Startpunkt beginnt und sich entlang der verbundenen Features nach außen erstreckt, wird verwendet. Dies ist die Standardeinstellung.
  • SUBNETWORKEine 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_CONTROLLERSEine Verfolgung von Teilnetz-Controllern, die Quellen und Senken in Teilnetz-Controllern verortet, die mit einem Teilnetz verknüpft sind.
  • UPSTREAMEine Verfolgung flussaufwärts, bei der Features ermittelt werden, die sich flussaufwärts von einer Position im Netzwerk befinden, wird verwendet.
  • DOWNSTREAMEine Verfolgung flussabwärts, bei der Features ermittelt werden, die sich flussabwärts von einer Position im Netzwerk befinden, wird verwendet.
  • LOOPSEine Schleifenverfolgung, die sich basierend auf der Konnektivität vom Startpunkt aus nach außen erstreckt. Schleifen sind Bereiche des Netzwerks, in denen die Fließrichtung unklar ist.
  • SHORTEST_PATHEine Verfolgung des kürzesten Pfads, die den kürzesten Pfad zwischen zwei Startpunkten ermittelt.
  • ISOLATIONEine 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 der 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 der 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, auf der die Verfolgung gestartet wird. 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 ist, ist der Parameter starting_points 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_CONTAINERSContainer-Features werden in die Verfolgungsergebnisse einbezogen.
  • EXCLUDE_CONTAINERSContainer-Features werden in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.
Boolean
include_content
(optional)

Gibt an, ob die Verfolgung in den Ergebnissen den Inhalt von Container-Features zurückgibt.

  • INCLUDE_CONTENTInhalt in Container-Features wird in die Verfolgungsergebnisse einbezogen.
  • EXCLUDE_CONTENTInhalt 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_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
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, validieren Sie die Netzwerk-Topologie.

  • VALIDATE_CONSISTENCYBei der Verfolgung wird ein Fehler ausgegeben, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die Standardeinstellung.
  • DO_NOT_VALIDATE_CONSISTENCYDie 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_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", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine 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_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.

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 globalen Gesamtwert. Es kann beispielsweise eine Funktionsbarriere konfiguriert werden, durch die die Verfolgung beendet wird, sobald die Summe von Shape length größer oder gleich 4 ist. Wenn Sie mit dem globalen Wert zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da die Shape length-Summe 4 erreicht ist. Wenn lokale Werte verwendet werden und beim Durchlaufen eine Gabelung gefunden wird, werden die berechneten Werte für jeden Pfad entlang der Verzweigung getrennt beibehalten. Wenn in diesem Fall der Startpunkt an der Gabelung platziert wird, werden die lokalen Werte entlang der einzelnen Pfade getrennt berechnet, und die Verfolgung wird fortgesetzt, bis entlang jedes Pfades die Summe 4 erreicht ist.

Die Function-Wertoptionen für die Funktionsbarriere lauten wie folgt:

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

  • TRUELokale Werte werden verwendet. Dies ist die Standardeinstellung.
  • FALSEGlobale Werte werden verwendet.
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_EDGESDie Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
  • JUNCTIONS_ONLYDie Durchlassfähigkeit wird nur auf Knoten angewendet.
  • EDGES_ONLYDie 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_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", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INLCUDE_ANYEine 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_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.

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:

  • AVERAGEDer Durchschnitt der Eingabewerte wird berechnet.
  • COUNTDie Anzahl der Features wird ermittelt.
  • MAXDas Maximum der Eingabewerte wird ermittelt.
  • MINDas Minimum der Eingabewerte wird ermittelt.
  • ADDDie Summe der Werte wird berechnet.
  • SUBTRACTDie Differenz zwischen den Werten wird berechnet. 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", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine 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:

  • TRUELokale Werte werden verwendet. Dies ist die Standardeinstellung.
  • FALSEGlobale Werte werden verwendet.
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_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. Sie können Anzahl und Kosten sowie eine Sammlung von Kategorien und/oder einen Asset-Typ angeben.

  • 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 auf FILTER_BY_NEAREST festgelegt ist.

Long
nearest_cost_network_attribute
(optional)

Das numerische Netzwerkattribut, das zum Berechnen von Nähe, Kosten oder Entfernung verwendet werden soll, wenn filter_nearest auf FILTER_BY_NEAREST festgelegt ist, zum Beispiel Shape-Länge.

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

Die Kategorien, die zurückgegeben werden sollen, wenn filter_nearest auf FILTER_BY_NEAREST festgelegt ist, zum Beispiel Schutz.

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

Die Asset-Gruppen und Asset-Typen, die zurückgegeben werden sollen, wenn filter_nearest auf FILTER_BY_NEAREST festgelegt ist, 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:

  • AVERAGEDer Durchschnitt der Eingabewerte wird berechnet.
  • COUNTDie Anzahl der Features wird ermittelt.
  • MAXDas Maximum der Eingabewerte wird ermittelt.
  • MINDas Minimum der Eingabewerte wird ermittelt.
  • ADDDie Summe der Werte wird berechnet.
  • SUBTRACTDie Differenz zwischen den Werten wird berechnet.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_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", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine 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_VALUENach einem bestimmten Wert filtern.
  • NETWORK_ATTRIBUTENach 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 Weitergabemodulen zur Verfügung:

  • Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, 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_ANDDer Wert aus einem Feature wird mit dem nächsten verglichen.
  • PROPAGATED_MINDer Minimalwert wird identifiziert.
  • PROPAGATED_MAXDer Maximalwert wird identifiziert.

Die Operator-Wertoptionen 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", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Weitere Informationen zu Bitwise-Operatoren

Hinweis:

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_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", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine 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_VALUENach einem bestimmten Wert filtern.
  • NETWORK_ATTRIBUTENach einem Netzwerkattribut filtern.

Die Combine Using-Optionen für die Ausgabebedingungen lauten wie folgt:

  • ANDKombiniert die Bedingungen.
  • ORWird 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_FEATURESIsolierte Features werden in die Verfolgungsergebnisse einbezogen.
  • EXCLUDE_ISOLATED_FEATURESIsolierte Features werden in die Verfolgungsergebnisse nicht einbezogen. Dies ist die Standardeinstellung.
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. 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_POINTSBarrieren bei Startpunkten werden in der Verfolgung ignoriert.
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTSBarrieren 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 findet nur Anwendung, wenn include_containers auf INCLUDE_CONTAINERS festgelegt ist.

  • INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINEREs 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_CONTAINERAlle 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.

  • SELECTIONDie Verfolgungsergebnisse werden als Auswahlsatz der entsprechenden Netzwerk-Features zurückgegeben. Dies ist die Standardeinstellung.
  • AGGREGATED_GEOMETRYDie Verfolgungsergebnisse werden nach Geometrietyp aggregiert und in Multipart-Feature-Classes gespeichert, die in den Layern auf der aktiven Karte angezeigt werden.
  • CONNECTIVITYDie Verfolgungsergebnisse werden als Konnektivitätsdiagramm in der angegebenen .json-Ausgabedatei für die durchlaufenen Netzwerk-Features zurückgegeben. Mit dieser Option wird der Parameter out_json_file aktiviert.
  • ELEMENTSDie Verfolgungsergebnisse werden als Feature-basierte Informationen in der angegebenen .json-Ausgabedatei für die durchlaufenen Netzwerk-Features zurückgegeben. Mit dieser Option wird der Parameter out_json_file aktiviert.
  • FEATURESDie Verfolgungsergebnisse werden als Feature-basierte Informationen in der angegebenen .json-Ausgabedatei für die durchlaufenen Netzwerk-Features zurückgegeben. Mit dieser Option werden die Parameter include_geometry, include_domain_description, result_network_attributes, result_fields und out_json_file aktiviert.
  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONSDie Verfolgungsergebnisse werden als Zuordnungsinformationen für die durchlaufenen Netzwerk-Features, die durch Containment und strukturelle Anbau-Zuordnungen zugeordnet sind, in der angegebenen .json-Ausgabedatei zurückgegeben. Mit dieser Option werden die Parameter include_domain_description und 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_SELECTIONDie getätigte Auswahl ersetzt die aktuelle Auswahl. Dies ist die Standardeinstellung.
  • ADD_TO_SELECTIONDie 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_SELECTIONDie getätigte Auswahl wird aus der aktuellen Auswahl entfernt. Wenn keine Auswahl vorhanden ist, ist diese Option irrelevant.
  • SUBSET_SELECTIONDie getätigte Auswahl wird mit der aktuellen Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, werden ausgewählt.
  • SWITCH_SELECTIONDie 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_RESULTSDie 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_RESULTSDie 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 ist nur bei der Ausführung einer Verfolgung flussaufwärts, einer Verfolgung flussabwärts oder einer Isolationsverfolgung anwendbar.

  • TRACE_INDETERMINATE_FLOWFeatures mit einer unbestimmbaren Fließrichtung werden verfolgt. Dies ist die Standardeinstellung.
  • IGNORE_INDETERMINATE_FLOWBei Features mit einer unbestimmbaren Fließrichtung wird die Durchlassfähigkeit beendet, und die Features werden nicht verfolgt.
Hinweis:

Für diesen Parameter wird eine Utility Network-Version mit dem Wert 5 oder höher benötigt.

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_LOCATABILITYDie 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_LOCATABILITYDie 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.
Hinweis:

Für diesen Parameter wird eine Utility Network-Version mit dem Wert 4 oder höher benötigt.

Boolean
use_trace_config
(optional)

Gibt an, ob zum Füllen der Parameter des Werkzeugs eine vorhandene benannte Verfolgungskonfiguration verwendet wird.

  • USE_TRACE_CONFIGURATIONEine 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_CONFIGURATIONEs wird keine vorhandene benannte Verfolgungskonfiguration zum Definieren der Verfolgungseigenschaften verwendet. Dies ist die Standardeinstellung.
Hinweis:

Für diesen Parameter wird eine Utility Network-Version mit dem Wert 5 oder höher benötigt.

Boolean
trace_config_name
(optional)

Der Name der vorhandenen benannten Verfolgungskonfiguration, 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 mithilfe der Ergebnistypen "Konnektivität", "Elemente", "Features" oder "Containment" und "Anbau" 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_ASYNCHRONOUSLYVerfolgungen werden asynchron verarbeitet.
  • RUN_SYNCHRONOUSLYVerfolgungen werden synchron verarbeitet. Dies ist die Standardeinstellung.
Hinweis:
Für diesen Parameter ist ArcGIS Enterprise 10.9.1 oder höher erforderlich.
Boolean
include_geometry
(optional)

Gibt an, ob Geometrie in die Ergebnisse einbezogen wird.

  • INCLUDE_GEOMETRYGeometrie wird in die Ergebnisse einbezogen.
  • EXCLUDE_GEOMETRYGeometrie wird nicht in die Ergebnisse einbezogen. Dies ist die Standardeinstellung.
Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

Boolean
include_domain_descriptions
(optional)

Gibt an, ob in die .json-Ausgabedatei Domänenbeschreibungen aufgenommen werden, um Domänenzuordnungen für controller, featureElements, connectivity und associations weiterzugeben.

  • INCLUDE_DOMAIN_DESCRIPTIONSDomänenbeschreibungen werden in die Ergebnisse aufgenommen.
  • EXCLUDE_DOMAIN_DESCRIPTIONSDomänenbeschreibungen werden nicht in die Ergebnisse aufgenommen. Dies ist die Standardeinstellung.
Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

Boolean
result_network_attributes
[result_network_attributes,...]
(optional)

Die Netzwerkattribute, die in die Ergebnisse aufgenommen werden.

Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

String
result_fields
[[Feature Class, Field Name],...]
(optional)

Felder aus einer Feature-Class, die als Ergebnisse zurückgegeben werden sollen. Die Werte der Felder werden in den Ergebnissen für die Features in der Netzverfolgung zurückgegeben.

Hinweis:

Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.1 oder höher.

Value Table
use_digitized_direction
(optional)

Gibt an, ob die Fließrichtung bei Verfolgungen flussaufwärts oder flussabwärts mithilfe der Digitalisierrichtung der Linie, der Von- und Bis-Global-ID des Kantenobjekts in der Zuordnung sowie des Attributs Flow direction bestimmt wird. Dieser Parameter ist nur für Utility Network-Version 7 und höher verfügbar und aktiv, wenn für den Parameter trace_type die Option UPSTREAM oder DOWNSTREAM festgelegt wurde.

  • USE_DIGITIZED_DIRECTIONBei Verfolgungen wird die Fließrichtung mithilfe der Digitalisierrichtung der Linie, der Von- und Bis-Global-ID des Kantenobjekts in der Zuordnung sowie des Fließrichtungsattributs bestimmt. Bei dieser Option werden die Parameter domain_network, tier und target_tier ignoriert.
  • IGNORE_DIGITIZED_DIRECTIONDie Fließrichtung von Verfolgungen wird abhängig von der Position der Teilnetz-Controller bestimmt. Dies ist die Standardeinstellung.
Hinweis:
Bei Verwendung einer Geodatabase ist für diesen Parameter ArcGIS Enterprise 11.3 oder höher erforderlich.
Boolean
synthesize_geometries
(optional)

Gibt an, ob Geometrien für Zuordnungen und Kantenobjekte, die bei einer Verfolgung durchquert werden, abgeleitet und erstellt (dargestellt) werden. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".

  • DO_NOT_SYNTHESIZE_GEOMETRIESEs werden keine Geometrien für die durchquerten Zuordnungen und Kantenobjekte dargestellt. Dies ist die Standardeinstellung.
  • SYNTHESIZE_GEOMETRIESEs werden Geometrien für die durchquerten Zuordnungen und Kantenobjekte in der Ausgabe-Feature-Class "Trace_results_Aggregated_Lines" abgeleitet und erstellt.

Hinweis:
Bei Verwendung einer Geodatabase ist für diesen Parameter ArcGIS Enterprise 11.3 oder höher erforderlich.

Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Utility Network

Codebeispiel

Trace: Beispiel (eigenständiges Skript)

Mit diesem Beispielskript wird eine Verfolgung vom Typ "Flussabwärts" für ein Stromversorgungsnetz auf der Ebene "Mittlere Spannung" ausgeführt, wobei die Transformatorlasten in den Phasen A, B und C addiert werden.

'''****************************************************************************
Name:        DownstreamTrace.py
Description: This script executes a downstream trace on the Medium Voltage tier 
             that adds up the transformer load on phases A, B, and C.
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "NapervilleElectric Utility Network"
trace_type = "DOWNSTREAM"
starting_points = "C:\\MyProject\\Bissell.gdb\UN_Temp_Starting_Points"
barriers = "C:\\MyProject\\Bissell.gdb\UN_Temp_Barriers"
domain_network = "ElectricDistribution"
tier = "Medium Voltage Radial"
include_containers = "INCLUDE_CONTAINERS"
include_content ="INCLUDE_CONTENT"
include_structures = "INCLUDE_STRUCTURES"
include_barriers ="INCLUDE_BARRIERS"
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 1 #"
propagators = "'Phases Current' phasessub PROPAGATED_BITWISE_AND INCLUDES_ANY 15"
functions = "ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 4;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 2;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 1"
synthesize_geometries = "SYNTHESIZE_GEOMETRIES"

# Run Trace with specified parameters and leave the rest default
arcpy.un.Trace(in_utility_network, 
               trace_type, 
               starting_points, 
               barriers, 
               domain_network, 
               tier,
               include_containers=include_containers,
               include_content=include_content,
               include_structures=include_structures,
               condition_barriers=condition_barriers,
               propagators=propagators,
               functions=functions,
               synthesize_geometries=synthesize_geometries)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen