Teilnetz aktualisieren (Utility Network)

Zusammenfassung

Aktualisiert Teilnetz-Informationen in der Tabelle der Teilnetze, der SubnetLine-Feature-Class und den Teilnetz-Systemschemas der angegebenen Teilnetze.

In der Tabelle der Teilnetze legt dieses Werkzeug den Status der zugeordneten Teilnetz-Controller auf "Validiert" fest (das Attribut Is dirty wird auf "False" festgelegt). Wenn bei der Ausführung des Werkzeugs Fehler bei "Konsistenz überprüfen" oder Teilnetzfehler festgestellt werden, wird der Status der zugeordneten Teilnetz-Controller als ungültig markiert (das Attribut Is dirty wird auf "Ungültig" festgelegt). In der SubnetLine-Feature-Class wird ein Datensatz für neue Teilnetze erstellt. Außerdem werden die Datensätze für alle gelöschten Teilnetze entfernt und die Form und die Informationen für alle geänderten Teilnetze aktualisiert. Es werden auch bestimmte Attribute für Teilnetz-Features erstellt oder aktualisiert.

Weitere Informationen zum Aktualisieren von Teilnetzen

Verwendung

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

    • Das Versorgungsnetz muss als nach Verzweigung versioniert registriert sein.
    • Das Eingabe-Versorgungsnetz muss aus einem Utility Network-Service stammen.
    • Wenn dieses Werkzeug in der Default-Version ausgeführt wird und die Richtlinie zum Aktualisieren von Teilnetzen für die Ebene so konfiguriert ist, dass das Is dirty-Attribut nicht verwaltet wird, kann der Vorgang "Teilnetz aktualisieren" verwendet werden, um Zeilen in der Tabelle der Teilnetze zu löschen, in der das Attribut Is deleted auf "True" festgelegt ist.
    • Wenn dieses Werkzeug in der Default-Version ausgeführt wird, werden die Geometrie, das Attribut des Teilnetznamens und weitergegebene Felder der SubnetLine-Feature-Class lokal aktualisiert. Wird dieses Werkzeug für eine benannte Version ausgeführt, werden Aktualisierungen durch das Standardverhalten (ohne Ereignisse) auf die in der Version bearbeiteten Features und Objekte beschränkt. Der Bearbeitungsmodus kann so geändert werden, dass Ereignisse (mit Ereignissen) verwendet werden. Mit dieser Option, die in der Teilnetzdefinition sowohl für die Default-Version als auch für die benannte Version festgelegt werden kann, werden Verhaltensweisen von Geodatabases ausgeführt.

      Weitere Informationen zum verwendeten Bearbeitungsmodus des Werkzeugs Teilnetz aktualisieren

  • Mit diesem Werkzeug werden Netzwerkschemas für die aktualisierten Teilnetze erstellt oder aktualisiert, wenn eine Schemavorlage beim Einstellen der Teilnetzdefinition angegeben wurde.

  • Vor dem Ausführen dieses Werkzeugs müssen alle Änderungen gespeichert werden.

  • Die Netzwerk-Topologie muss aktiviert sein.

  • Es gibt keine Dirty Areas, die Teilnetz-Features schneiden.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Versorgungsnetz, in dem das Teilnetz enthalten ist.

Utility Network; Utility Network Layer
Netzart

Die Netzart, in der das Teilnetz enthalten ist.

String
Ebene

Die Ebene, in der das Teilnetz enthalten ist.

String
Alle Teilnetze in Ebene
(optional)

Gibt an, ob alle Teilnetze in der Ebene aktualisiert werden sollen. Um eine Teilmenge der Teilnetze in der Ebene zu aktualisieren, verwenden Sie den Parameter Teilnetzname.

  • Aktiviert: Alle Teilnetze in der Ebene werden aktualisiert. Für diese Option wird eine asynchrone Verarbeitung genutzt, um das Teilnetz mit dem Geoverarbeitungsservice "UtilityNetworkTools" des Systems zu aktualisieren. Der Service ist Geoverarbeitungs-Tasks für Versorgungsnetze vorbehalten und verfügt über eine längere Standard-Timeout-Einstellung. Dies ist die Standardeinstellung.
  • Deaktiviert: Nur die im Parameter Teilnetzname angegebenen Teilnetze werden aktualisiert.

Boolean
Teilnetzname
(optional)

Der Name des Teilnetzes, das aus der Ebene aktualisiert werden soll. Wenn alle Teilnetze über den Parameter Alle Teilnetze in Ebene aktualisiert werden, wird dieser Parameter ignoriert. 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
Bei Fehler fortfahren
(optional)

Gibt an, ob der Aktualisierungsprozess gestoppt werden soll, wenn die Aktualisierung eines Teilnetzes beim Aktualisieren mehrerer Teilnetze fehlschlägt.

  • Aktiviert: Wenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess nicht gestoppt, sondern fortgesetzt.
  • Deaktiviert: Wenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess gestoppt. Dies ist die Standardeinstellung.

Boolean
Bedingungsbarrieren
(optional)
Hinweis:

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

Value Table
Funktionsbarrieren
(optional)
Hinweis:

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

Value Table
Barrieren-Features einbeziehen
(optional)
Hinweis:

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

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 DEVICESTATUS gleich Open ist und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, würde die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da DEVICESTATUS 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.
Hinweis:

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

String
Weitergabemodule
(optional)
Hinweis:

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

Value Table

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Versorgungsnetz

Das aktualisierte Versorgungsnetz.

Utility Network

arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, {all_subnetworks_in_tier}, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})
NameErläuterungDatentyp
in_utility_network

Das Versorgungsnetz, in dem das Teilnetz enthalten ist.

Utility Network; Utility Network Layer
domain_network

Die Netzart, in der das Teilnetz enthalten ist.

String
tier

Die Ebene, in der das Teilnetz enthalten ist.

String
all_subnetworks_in_tier
(optional)

Gibt an, ob alle Teilnetze in der Ebene aktualisiert werden sollen. Verwenden Sie den Parameter subnetwork_name, um eine Teilmenge der Teilnetze in der Ebene zu aktualisieren.

  • ALL_SUBNETWORKS_IN_TIERAlle Teilnetze in der Ebene werden aktualisiert. Für diese Option wird eine asynchrone Verarbeitung genutzt, um das Teilnetz mit dem Geoverarbeitungsservice "UtilityNetworkTools" des Systems zu aktualisieren. Der Service ist Geoverarbeitungs-Tasks für Versorgungsnetze vorbehalten und verfügt über eine längere Standard-Timeout-Einstellung. Dies ist die Standardeinstellung.
  • SPECIFIC_SUBNETWORKNur die im Parameter subnetwork_name angegebenen Teilnetze werden aktualisiert.
Boolean
subnetwork_name
(optional)

Der Name des Teilnetzes, das aus der Ebene aktualisiert werden soll. Wenn alle Teilnetze über den Parameter all_subnetworks_in_tier aktualisiert werden, wird dieser Parameter ignoriert.

String
continue_on_failure
(optional)

Gibt an, ob der Aktualisierungsprozess gestoppt werden soll, wenn die Aktualisierung eines Teilnetzes beim Aktualisieren mehrerer Teilnetze fehlschlägt.

  • CONTINUE_ON_FAILUREWenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess nicht gestoppt, sondern fortgesetzt.
  • STOP_ON_FAILUREWenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess gestoppt. Dies ist die Standardeinstellung.
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 festlegen, der in Abhängigkeit vom 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 Bedingungsbarriere lauten wie folgt:

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

Die type-Optionen für die Bedingungsbarriere lauten wie folgt:

  • 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: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp festlegen, der zur Beendigung führt, wenn er ermittelt wird.
  • Use Local Values: Hier können Sie Werte in jeder Richtung berechnen, im Gegensatz zu einem globalen Gesamtwert. Für eine Funktionsbarriere würde das beispielsweise bedeuten, dass 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 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.

  • TRUELokale Werte werden verwendet.
  • FALSEGlobale Werte werden verwendet. Dies ist die Standardeinstellung.

Mögliche Werte der function-Optionen für die Funktionsbarriere:

  • AVERAGEDer Durchschnitt der Eingabewerte.
  • COUNTDie Anzahl der Features.
  • MAXDas Maximum der Eingabewerte.
  • MINDas Minimum der Eingabewerte.
  • ADDDie Werte addieren.
  • SUBTRACTDie Werte subtrahieren. 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:

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

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 DEVICESTATUS gleich Open ist und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, würde die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da DEVICESTATUS 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],...]
(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_ANDDie Werte aus einem Feature mit dem nächsten vergleichen.
  • 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", bei der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES_NOT_INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", bei der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", bei der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYEine Operation mit "Bitwise AND", bei der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Value Table

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Utility Network

Codebeispiel

UpdateSubnetwork: Beispiel 1 (Python-Fenster)

Mit diesem Beispielskript wird ein bestimmtes Teilnetz mit der Bezeichnung "RMT004" aktualisiert.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004", 
                          "CONTINUE_ON_FAILURE")
UpdateSubnetwork: Beispiel 2 (Python-Fenster)

Mit diesem Beispielskript werden alle Teilnetze in der Ebene "Mittelspannung" aktualisiert.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "ALL")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen