Teilnetzdefinition festlegen (Utility Network)

Zusammenfassung

Legt die Eigenschaften der Netzartebene für ein Teilnetz in einem Versorgungsnetz fest.

Die Feature-Typen, die an einer Ebene beteiligt sind, können durch die Definition gültiger Asset-Typen aus den Bauteil-, Linien-, Knoten-, Kantenobjekt- und Knotenobjekt-Klassen eingeschränkt werden. Die Definition gültiger Asset-Typen unterstützt die Erzwingung korrekter Daten, indem die Feature-Typen eingeschränkt werden, die sich an einem Teilnetz für eine bestimmte Ebene beteiligen können.

Konfigurationsparameter werden verwendet, um Eigenschaften für den Fall festzulegen, dass eine Verfolgung im Teilnetz ausgeführt wird.

Weitere Informationen zum Festlegen einer Teilnetzdefinition

Weitere Informationen zur Verwaltung von Teilnetzen

Weitere Informationen zum Verfolgen von Versorgungsnetzen

Verwendung

  • Mit diesem Werkzeug können Sie auch die Teilnetzdefinition der Ebene festlegen und ändern. Um die Werte der Teilnetzdefinition der Ebene zu ändern, ändern Sie die Parameterwerte, und führen Sie das Werkzeug erneut aus.

  • Die Netzwerk-Topologie muss deaktiviert sein.

  • Die folgenden Anforderungen müssen erfüllt werden, wenn mit einer Enterprise-Geodatabase gearbeitet wird:

    • Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes handeln.
    • Der Parameterwert Eingabe-Versorgungsnetz muss aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes hergestellt wurde.
    • Dieses Werkzeug muss zur Ausführung mit der Default-Version verbunden sein.
      • Alle anderen Sitzungen, die mit der Default-Version verbunden sind, können während der Aktivierung keine Validierung oder Aktivierung durchführen.
  • Wenn im Rahmen der Teilnetz-Verfolgungskonfiguration Zusammenfassungen definiert werden, filtern die angegebenen Parameterwerte Funktion und Attribut die Liste der verfügbaren Felder für das Zusammenfassungsattribut. Die folgende Matrix gültiger Feldtypen kann verwendet werden, um das Feld Zusammenfassungsattribut basierend auf der angegebenen Funktion und dem Feldtyp Netzwerkattribut zu definieren. Wenn Sie beispielsweise eine Zusammenfassung für den Durchschnitt aus einem Netzwerkattribut vom Typ "Long" erstellen möchten, können Sie für die SubnetLine-Feature-Class ein Feld vom Typ "Double" erstellen und dieses als Feld für Zusammenfassungsattribut angeben.

    Matrix der Netzwerkattributtypen
    Dies ist eine Matrix der gültigen Feldtypen für das Zusammenfassungsattributfeld basierend auf der angegebenen Funktion.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Eingabe-Versorgungsnetz, in dem das Teilnetz der Ebene enthalten ist.

Utility Network; Utility Network Layer
Netzart

Die Netzart, in der die Ebene enthalten ist.

String
Name der Ebene

Der Name der Ebene, in der das Teilnetz enthalten ist.

String
Getrenntes Teilnetz unterstützen

Gibt an, ob die Eingabeebene getrennte Teilnetze unterstützt. Getrennte Teilnetze sind zwei oder mehr Teilnetze, die zur gleichen Ebene gehören und den gleichen Teilnetznamen aufweisen, jedoch nicht durchlässig sind. Dieser Parameter ist nur für Ebenen in Netzarten mit partitionierter Ebenendefinition verfügbar. Dieser Parameter ist für Ebenen in einer Netzart mit hierarchischer Ebenendefinition standardmäßig aktiviert, damit getrennte Teilnetze unterstützt werden.

  • Aktiviert: Die Eingabeebene unterstützt getrennte Teilnetze.
  • Deaktiviert: Die Eingabeebene unterstützt keine getrennten Teilnetze. Dies ist die Standardeinstellung, wenn nichts anderes angegeben ist.

Boolean
Gültige Bauteile
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Bauteile für das Teilnetz angegeben wurden.

String
Teilnetz-Controller für gültige Bauteile
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als Teilnetz-Controller für gültige Bauteile im Teilnetz angegeben wurden.

String
Gültige Linien
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Linien für das Teilnetz angegeben wurden.

String
Aggregierte Linien für SubnetLine-Feature-Class
(optional)

Die gültigen Linien mit Geometrie, die aggregiert wird, um SubnetLine-Features zu erstellen. Diese Liste ist eine Teilmenge der im Parameter Gültige Linien angegebenen Werte.

String
Schemavorlagen für Teilnetze
(optional)

Die Vorlagen, die zum Erstellen von Teilnetzsystemschemas für jedes Teilnetz verwendet werden.

String
Zusammenfassungen
(optional)

Legt für das Feld für Zusammenfassungsattribut fest, dass Funktionsergebnisse gespeichert werden, wenn SubnetLine-Features eingefügt oder aktualisiert werden. Die Zusammenfassungen können zu allen Features in dem Teilnetz berechnet werden. Berechnungen lassen sich so filtern, dass sie nur auf Netzwerk-Features mit einem bestimmten Attributwert oder einer bestimmten Kategorie angewendet werden.

Matrix der Netzwerkattributtypen
Dies ist eine Matrix der gültigen Feldtypen für das Zusammenfassungsattributfeld basierend auf der angegebenen Funktion.

Folgende Komponenten von Zusammenfassungen 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 dem Namen des Netzwerkattributs 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.
  • Zusammenfassungsattribut: Das Feld in der Feature-Class "SubnetLine", in dem das Funktionsergebnis dauerhaft gespeichert wird. Abhängig von der angegebenen Funktion und dem angegebenen Netzwerkattributtyp gelten für diesen Parameter nur die anwendbaren Typen von Teilnetzattributen, die von Benutzern hinzugefügt wurden. Wenn in der SubnetLine-Feature-Class kein Feld zum Speichern des Zusammenfassungsergebnisses vorhanden ist, kann mit dem Werkzeug Feld hinzufügen eines hinzugefügt werden. Pro Feld wird nur das Ergebnis jeweils einer Zusammenfassung unterstützt. Jede Zusammenfassung erfordert ihr eigenes Feld in der SubnetLine-Feature-Class. Im Abschnitt Verwendung finden Sie eine Matrix der gültigen Feldtypen für das Zusammenfassungsattributfeld basierend auf der angegebenen Funktion.

Die Wertoptionen der Feldstatistikfunktion 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 folgenden Werte für die Zusammenfassungsoptionen des Filter-Operators sind verfügbar:

  • 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 Zusammenfassungsoptionen für Filtertyp-Werte 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 Eingabewerte wird berechnet.
  • SubtrahierenDie Differenz der Eingabewerte wird berechnet. Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.
  • 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).
  • Bestimmter WertNach einem bestimmten Wert filtern.
  • NetzwerkattributNach einem Netzwerkattribut filtern.
Value Table
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.

  • 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).
  • Bestimmter WertNach einem bestimmten Wert filtern.
  • NetzwerkattributNach einem Netzwerkattribut filtern.
  • UndDie Bedingungsbarrieren kombinieren.
  • OderVerwenden, wenn eine der Bedingungsbarrieren erfüllt ist.
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).

  • 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 Eingabewerte wird berechnet.
  • SubtrahierenDie Differenz der Eingabewerte wird berechnet.Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.
  • 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).
Value Table
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
Durchlassfähigkeit anwenden auf
(optional)

Gibt den Typ der Durchlassfähigkeit an, der erzwungen wird. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit an Knoten, an Kanten oder an Knoten und an Kanten umgesetzt wird. Beispiel: Wenn eine Bedingungsbarriere definiert wurde, um die Verfolgung zu stoppen, wenn der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da der Bauteilstatus nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.

  • Knoten und Kanten: Die Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet.
  • Nur Knoten: Die Durchlassfähigkeit wird nur auf Knoten angewendet.
  • Nur Kanten: Die Durchlassfähigkeit wird nur auf Kanten angewendet.

  • 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
Weitergabemodule
(optional)
  • Weitergabe von BITWISE_ANDDer Wert eines Features wird mit dem nächsten verglichen.
  • Weitergabe von MINDen Minimalwert abrufen.
  • Weitergabe von MAXDen Maximalwert abrufen.
  • 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).
Value Table
Strukturnetzwerk-Container aktualisieren
(optional)

Gibt an, ob beim Aktualisieren des Teilnetzes das Attribut "Unterstützter Teilnetzname" für Strukturnetzwerk-Container aktualisiert wird.

  • Aktiviert: Die Strukturnetzwerk-Container werden aktualisiert. Dies ist die Standardeinstellung.
  • Deaktiviert: Die Strukturnetzwerk-Container werden nicht aktualisiert.

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

Boolean
Netzart-Container aktualisieren
(optional)

Gibt an, ob beim Aktualisieren des Teilnetzes der unterstützte Teilnetzname für Netzart-Container aktualisiert wird.

  • Aktiviert: Die Netzart-Container werden aktualisiert. Dies ist die Standardeinstellung.
  • Deaktiviert: Die Netzart-Container werden nicht aktualisiert.

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

Boolean
Bearbeitungsmodus für Standardversion
(optional)

Gibt den Bearbeitungsmodus für Teilnetzaktualisierungen in der Standardversion und in File- und Mobile-Geodatabases an.

  • Ohne EreignisseFür Teilnetzaktualisierungen in der Standardversion in einer File- oder mobilen Geodatabase werden keine Ereignisse verwendet. In diesem Bearbeitungsmodus werden der Teilnetzname und die weitergegebenen Werte aktualisiert. Dies ist die Standardeinstellung.
  • Mit EreignissenFür Teilnetzaktualisierungen in der Standardversion und in einer File- oder Mobile-Geodatabase werden Ereignisse verwendet. In diesem Bearbeitungsmodus werden Verhaltensweisen von Geodatabases (z. B. Attributregeln, Editor-Tracking usw.) angewendet, wenn das Teilnetz aktualisiert wird, und es werden der Teilnetzname und die weitergegebenen Werte aller jeweiligen Objekte und Features aktualisiert.
Hinweis:

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

String
Bearbeitungsmodus für benannte Version
(optional)

Gibt den Bearbeitungsmodus für Teilnetzaktualisierungen in einer benannten Version an.

  • Ohne EreignisseEreignisse werden für Teilnetzaktualisierungen in benannten Versionen nicht verwendet. In diesem Bearbeitungsmodus werden der Teilnetzname und die weitergegebenen Werte aktualisiert, die für in der Version bearbeitete Features und Objekte vorhanden sind. Dies ist die Standardeinstellung.
  • Mit EreignissenEreignisse werden für Teilnetzaktualisierungen in benannten Versionen verwendet. In diesem Bearbeitungsmodus werden Verhaltensweisen von Geodatabases (z. B. Attributregeln, Editor-Tracking usw.) angewendet, wenn das Teilnetz aktualisiert wird, und es werden der Teilnetzname und die weitergegebenen Werte aller jeweiligen Objekte und Features aktualisiert.
Hinweis:

Für diesen Parameter ist mindestens Utility Network-Version 4 erforderlich, und er ist nur auf Enterprise-Geodatabases anwendbar.

String
Gültige Knoten
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Knoten für das Teilnetz angegeben wurden.

Hinweis:

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

String
Gültige Knotenobjekte
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Knotenobjekte für das Teilnetz angegeben wurden.

Hinweis:

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

String
Teilnetz-Controller für gültige Knotenobjekte
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als Teilnetz-Controller für gültige Knotenobjekte im Teilnetz angegeben wurden.

Hinweis:

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

String
Gültige Kantenobjekte
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Kantenobjekte für das Teilnetz angegeben wurden.

Hinweis:

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

String
"IsDirty" verwalten
(optional)

Gibt an, ob das Attribut Is dirty in der Tabelle der Teilnetze durch den Vorgang "Teilnetz aktualisieren" verwaltet wird.

  • Aktiviert: Das Attribut Is dirty wird durch den Vorgang "Teilnetz aktualisieren" verwaltet. Dies ist die Standardeinstellung.
  • Deaktiviert: Das Attribut Is dirty wird nicht durch den Vorgang "Teilnetz aktualisieren" verwaltet.

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

Boolean
Container einbeziehen
(optional)

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

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

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

Boolean
Inhalt einbeziehen
(optional)

Gibt an, ob bei der Verfolgung in den Ergebnissen Inhalte von Containern einbezogen werden.

  • Aktiviert: Inhalte von Container-Features und -objekten werden in die Verfolgungsergebnisse einbezogen.
  • Nicht aktiviert: Inhalte von Container-Features und -objekten werden nicht in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.

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

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.

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 oder dem Vorgang "Teilnetz aktualisieren" 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: Wenn nichträumliche Knoten- oder Kantenobjekte ohne die erforderliche Containment-, Anbau- oder Konnektivitätszuordnung in der Zuordnungshierarchie der durchquerten Objekte gefunden werden, wird ein Fehler zurückgegeben.
  • 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 5 oder höher benötigt.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Versorgungsnetz

Das aktualisierte Eingabe-Versorgungsnetz.

Utility Network

arcpy.un.SetSubnetworkDefinition(in_utility_network, domain_network, tier_name, support_disjoint_subnetwork, {valid_devices}, {valid_subnetwork_controller}, {valid_lines}, {aggregated_line}, {diagram_template}, {summaries}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {update_structure_features}, {update_container_features}, {edit_mode_for_default_version}, {edit_mode_for_named_version}, {valid_junctions}, {valid_junction_objects}, {valid_junction_object_subnetwork_controller}, {valid_edge_objects}, {manage_subnetwork_isdirty}, {include_containers}, {include_content}, {include_structures}, {validate_locatability})
NameErläuterungDatentyp
in_utility_network

Das Eingabe-Versorgungsnetz, in dem das Teilnetz der Ebene enthalten ist.

Utility Network; Utility Network Layer
domain_network

Die Netzart, in der die Ebene enthalten ist.

String
tier_name

Der Name der Ebene, in der das Teilnetz enthalten ist.

String
support_disjoint_subnetwork

Gibt an, ob die Eingabeebene getrennte Teilnetze unterstützt. Getrennte Teilnetze sind zwei oder mehr Teilnetze, die zur gleichen Ebene gehören und den gleichen Teilnetznamen aufweisen, jedoch nicht durchlässig sind. Dieser Parameter ist nur für Ebenen in Netzarten mit partitionierter Ebenendefinition verfügbar. Dieser Parameter ist für Ebenen in einer Netzart mit hierarchischer Ebenendefinition standardmäßig auf SUPPORT_DISJOINT festgelegt, damit getrennte Teilnetze unterstützt werden.

  • SUPPORT_DISJOINTDie Eingabeebene unterstützt getrennte Teilnetze.
  • NO_DISJOINTDie Eingabeebene unterstützt keine getrennten Teilnetze. Dies ist die Standardeinstellung, wenn nichts anderes angegeben ist.
Boolean
valid_devices
[valid_devices,...]
(optional)

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Bauteile für das Teilnetz angegeben wurden.

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

Die Paare aus Asset-Gruppe/Asset-Typ, die als Teilnetz-Controller für gültige Bauteile im Teilnetz angegeben wurden.

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

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Linien für das Teilnetz angegeben wurden.

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

Die gültigen Linien mit Geometrie, die aggregiert wird, um SubnetLine-Features zu erstellen. Diese Liste ist eine Teilmenge der im Parameter valid_lines angegebenen Werte.

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

Die Vorlagen, die zum Erstellen von Teilnetzsystemschemas für jedes Teilnetz verwendet werden.

String
summaries
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Summary Attribute],...]
(optional)

Legt das Summary Attribute-Feld so fest, dass Funktionsergebnisse gespeichert werden, wenn SubnetLine-Features eingefügt oder aktualisiert werden. Die Zusammenfassungen können zu allen Features in dem Teilnetz berechnet werden. Berechnungen lassen sich so filtern, dass sie nur auf Netzwerk-Features mit einem bestimmten Attributwert oder einer bestimmten Kategorie angewendet werden.

Matrix der Netzwerkattributtypen
Dies ist eine Matrix der gültigen Feldtypen für das Zusammenfassungsattributfeld basierend auf der angegebenen Funktion.

Folgende Komponenten von Zusammenfassungen 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.
  • Summary Attribute: Das Feld in der Feature-Class "SubnetLine", in dem das Funktionsergebnis dauerhaft gespeichert wird. Abhängig von der angegebenen Funktion und dem angegebenen Netzwerkattributtyp gelten für diesen Parameter nur die anwendbaren Typen von Teilnetzattributen, die von Benutzern hinzugefügt wurden. Wenn in der SubnetLine-Feature-Class kein Feld zum Speichern des Zusammenfassungsergebnisses vorhanden ist, kann mit dem Werkzeug Feld hinzufügen eines hinzugefügt werden. Pro Feld wird nur das Ergebnis jeweils einer Zusammenfassung unterstützt. Jede Zusammenfassung erfordert ihr eigenes Feld in der SubnetLine-Feature-Class. Im Abschnitt Verwendung finden Sie eine Matrix der gültigen Feldtypen für das Zusammenfassungsattributfeld basierend auf der angegebenen Funktion.

Die Zusammenfassungsoptionen für Function-Werte 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 Eingabewerte wird berechnet.
  • SUBTRACTDie Differenz der Eingabewerte wird berechnet. Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.

Die Zusammenfassungsoptionen für Filter Operator-Werte 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).

Die Zusammenfassungsoptionen für Filter Type-Werte lauten wie folgt:

  • SPECIFIC_VALUENach einem bestimmten Wert filtern.
  • NETWORK_ATTRIBUTENach einem Netzwerkattribut filtern.

Weitere Informationen zu Bitwise-Operatoren

Value Table
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 die Filterung nach im System definierten Netzwerkattributen oder Netzwerkkategorien festlegen.
  • 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-Werte für die Bedingungsbarrieren 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 Bedingungsbarrieren sind folgende:

  • SPECIFIC_VALUENach einem bestimmten Wert filtern.
  • NETWORK_ATTRIBUTENach einem Netzwerkattribut filtern.

Die Combine Using-Werte lauten wie folgt:

  • 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: Bietet einen bestimmten Wert für den Eingabeattributtyp, der zur Beendigung führt, wenn er ermittelt wird.
  • Use Local Values: Berechnet Werte in jeder Richtung im Gegensatz zu einem globalen Gesamtwert. Beispiel sei eine Funktionsbarriere, die die Summe einer Shape-Länge berechnet, wobei die Verfolgung beendet wird, wenn der Wert größer als oder gleich 4 ist. Wenn Sie im globalen Fall zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da Sie bereits die Shape-Länge 4 erreicht haben. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern.

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

  • AVERAGEDer Durchschnitt der Eingabewerte wird berechnet.
  • COUNTDie Anzahl der Features wird ermittelt.
  • MAXDas Maximum der Eingabewerte wird ermittelt.
  • MINDas Minimum der Eingabewerte wird ermittelt.
  • ADDDie Summe der Eingabewerte wird berechnet.
  • SUBTRACTDie Differenz der Eingabewerte 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 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 Funktionsbarrierenoptionen für Use Local Values-Werte lauten wie folgt:

  • TRUELokale Werte verwenden.
  • FALSEGlobale Werte verwenden. Dies ist die Standardeinstellung.
Value Table
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.

  • INCLUDE_BARRIERSBarrieren für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.
  • EXCLUDE_BARRIERSBarrieren für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.
Boolean
traversability_scope
(optional)

Der Typ der Durchlassfähigkeit, der angewendet wird. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit an Knoten, an Kanten oder an Knoten und an 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
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...]
(optional)

Legt fest, welche Netzwerkattribute weitergegeben werden sollen und wie diese Weitergabe während einer Verfolgung durchgeführt wird. Weitergegebene Klassenattribute geben die Schlüsselwerte für Teilnetz-Controller an, die auf die restlichen Features im Teilnetz verteilt werden. In einem Stromversorgungsmodell können Sie beispielsweise die Phasenwerte weitergeben.

Folgende Komponenten stehen bei den Verteilungsmodulen zur Verfügung:

  • Attribute: Hier können Sie 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 umgekehrt (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.
  • Propagated Attribute: Der Name des Feldes in der Netzwerkklasse, in dem die berechneten weitergegebenen Werte gespeichert werden. Der Feldtyp sollte dem Feldtyp des Netzwerkattributs entsprechen, der für den Wert Attribute angegeben wurde.

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

  • PROPAGATED_BITWISE_ANDDer Wert eines Features wird mit dem nächsten verglichen.
  • PROPAGATED_MINDen Minimalwert abrufen.
  • PROPAGATED_MAXDen Maximalwert abrufen.

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 in Python verfügbar.

Value Table
update_structure_features
(optional)

Gibt an, ob beim Aktualisieren des Teilnetzes das Attribut Unterstützter Teilnetzname für Strukturnetzwerk-Container aktualisiert wird.

  • UPDATEDie Strukturnetzwerk-Container werden aktualisiert. Dies ist die Standardeinstellung.
  • NOT_UPDATEDie Strukturnetzwerk-Container werden nicht aktualisiert.
Hinweis:

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

Boolean
update_container_features
(optional)

Gibt an, ob beim Aktualisieren des Teilnetzes der unterstützte Teilnetzname für Netzart-Container aktualisiert wird.

  • UPDATEDie Netzart-Container werden aktualisiert. Dies ist die Standardeinstellung.
  • NOT_UPDATEDie Netzart-Container werden nicht aktualisiert.
Hinweis:

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

Boolean
edit_mode_for_default_version
(optional)

Gibt den Bearbeitungsmodus für Teilnetzaktualisierungen in der Standardversion und in File- und Mobile-Geodatabases an.

  • WITHOUT_EVENTINGFür Teilnetzaktualisierungen in der Standardversion in einer File- oder mobilen Geodatabase werden keine Ereignisse verwendet. In diesem Bearbeitungsmodus werden der Teilnetzname und die weitergegebenen Werte aktualisiert. Dies ist die Standardeinstellung.
  • WITH_EVENTINGFür Teilnetzaktualisierungen in der Standardversion und in einer File- oder Mobile-Geodatabase werden Ereignisse verwendet. In diesem Bearbeitungsmodus werden Verhaltensweisen von Geodatabases (z. B. Attributregeln, Editor-Tracking usw.) angewendet, wenn das Teilnetz aktualisiert wird, und es werden der Teilnetzname und die weitergegebenen Werte aller jeweiligen Objekte und Features aktualisiert.
Hinweis:

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

String
edit_mode_for_named_version
(optional)

Gibt den Bearbeitungsmodus für Teilnetzaktualisierungen in einer benannten Version an.

  • WITHOUT_EVENTINGEreignisse werden für Teilnetzaktualisierungen in benannten Versionen nicht verwendet. In diesem Bearbeitungsmodus werden der Teilnetzname und die weitergegebenen Werte aktualisiert, die für in der Version bearbeitete Features und Objekte vorhanden sind. Dies ist die Standardeinstellung.
  • WITH_EVENTINGEreignisse werden für Teilnetzaktualisierungen in benannten Versionen verwendet. In diesem Bearbeitungsmodus werden Verhaltensweisen von Geodatabases (z. B. Attributregeln, Editor-Tracking usw.) angewendet, wenn das Teilnetz aktualisiert wird, und es werden der Teilnetzname und die weitergegebenen Werte aller jeweiligen Objekte und Features aktualisiert.
Hinweis:

Für diesen Parameter ist mindestens Utility Network-Version 4 erforderlich, und er ist nur auf Enterprise-Geodatabases anwendbar.

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

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Knoten für das Teilnetz angegeben wurden.

Hinweis:

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

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

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Knotenobjekte für das Teilnetz angegeben wurden.

Hinweis:

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

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

Die Paare aus Asset-Gruppe/Asset-Typ, die als Teilnetz-Controller für gültige Knotenobjekte im Teilnetz angegeben wurden.

Hinweis:

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

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

Die Paare aus Asset-Gruppe/Asset-Typ, die als gültige Kantenobjekte für das Teilnetz angegeben wurden.

Hinweis:

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

String
manage_subnetwork_isdirty
(optional)

Gibt an, ob das Attribut Is dirty in der Tabelle der Teilnetze durch den Vorgang "Teilnetz aktualisieren" verwaltet wird. Wenn für eine Ebene keine Teilnetz-Controller definiert wurden, wird standardmäßig die Option NOT_MANAGE verwendet.

  • MANAGEDas Attribut Is dirty wird durch den Vorgang "Teilnetz aktualisieren" verwaltet. Dies ist die Standardeinstellung, wenn nichts anderes angegeben ist.
  • NOT_MANAGEDas Attribut Is dirty wird nicht durch den Vorgang "Teilnetz aktualisieren" verwaltet.
Hinweis:

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

Boolean
include_containers
(optional)

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

  • INCLUDE_CONTAINERSContainer-Features und -objekte werden in die Verfolgungsergebnisse einbezogen.
  • EXCLUDE_CONTAINERSContainer-Features und -objekte werden nicht in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.

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

Boolean
include_content
(optional)

Gibt an, ob bei der Verfolgung in den Ergebnissen Inhalte von Containern einbezogen werden.

  • INCLUDE_CONTENTInhalte von Container-Features und Objekten werden in die Verfolgungsergebnisse einbezogen.
  • EXCLUDE_CONTENTInhalte von Container-Features und -objekten werden nicht in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.

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

Boolean
include_structures
(optional)

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

  • INCLUDE_STRUCTURESInhalte von Container-Features und -objekten werden in die Verfolgungsergebnisse einbezogen.
  • EXCLUDE_STRUCTURESInhalte von Container-Features und -objekten werden nicht in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.

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 oder dem Vorgang "Teilnetz aktualisieren" 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. Diese Option 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_LOCATABILITYWenn nichträumliche Knoten- oder Kantenobjekte ohne die erforderliche Containment-, Anbau- oder Konnektivitätszuordnung in der Zuordnungshierarchie der durchquerten Objekte gefunden werden, wird ein Fehler zurückgegeben.
  • 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 5 oder höher benötigt.

Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Eingabe-Versorgungsnetz.

Utility Network

Codebeispiel

SetSubnetworkDefinition: Beispiel (eigenständiges Skript)

In diesem Beispiel wird die Definition des Teilnetzes in einer Netzart mit der Bezeichnung "ElectricDistribution" festgelegt.

'''****************************************************************************
Name:        SetSubnetworkDefinition.py
Description: This script sets the subnetwork definition for a tier in a Utility Network
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "ElectricDistribution"
domain_network = "ElecDist"
tier_name = "Medium Voltage"
support_disjoint_subnetwork = "SUPPORT_DISJOINT"
valid_devices = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered';'NetworkProtector/Unknown';'NetworkProtector/NetworkProtector';'Transformer/Unknown';'Transformer/Buck boost';'Transformer/Single-phase overhead';'Transformer/Single-phase padmounted';'Transformer/Three-phase padmounted';'Transformer/Power';'Transformer/Step';'Transformer/Vault'"
valid_subnetwork_controller = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered'"
valid_lines = "'Busbar/Unknown';'Busbar/Busbar';'Connector/Unknown';'Connector/Connector';'LowVoltage/Unknown';'LowVoltage/Overhead';'LowVoltage/Underground';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground';'IsolatedNeutral/Unknown';'IsolatedNeutral/Concentric neutral';'IsolatedNeutral/Neutral';'SubTransmission/Unknown';'SubTransmission/Overhead';'SubTransmission/Underground'"
aggregated_line = "'Busbar/Unknown';'Busbar/Busbar';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground'"
diagram_template = "Basic"
summaries = ""
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 'Opened' #"
function_barriers = ""
include_barriers = "INCLUDE_BARRIERS"
traversability_scope = "BOTH_JUNCTIONS_AND_EDGES"
propagators = ""

# Run the SetSubnetworkDefinition tool
arcpy.un.SetSubnetworkDefinition(in_utility_network, 
                                 domain_network, 
                                 tier_name, 
                                 support_disjoint_subnetwork, 
                                 valid_devices, 
                                 valid_subnetwork_controller, 
                                 valid_lines, 
                                 aggregated_line, 
                                 diagram_template, 
                                 summaries, 
                                 condition_barriers, 
                                 function_barriers, 
                                 include_barriers, 
                                 traversability_scope, 
                                 propagators)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen