Skip To Content

Teilnetzdefinition festlegen

Zusammenfassung

Legt die Eigenschaften 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 Device- und Line-Feature-Classes 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 können verwendet werden, um Eigenschaften für den Fall festzulegen, dass eine Verfolgung im Teilnetz ausgeführt wird.

Weitere Informationen zum Festlegen einer Definition des Teilnetzes

Weitere Informationen zur Verwaltung von Teilnetzen

Weitere Informationen zum Verfolgen von Versorgungsnetzen

Verwendung

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

  • Die Netzwerk-Topologie muss deaktiviert sein.

  • Bei dem verbundenen ArcGIS Enterprise-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes handeln.

  • Dieses Werkzeug sollte bei bestehender Verbindung zur Standardversion ausgeführt werden.

  • Das Eingabe-Versorgungsnetz muss aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes hergestellt wurde.

Syntax

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})
ParameterErklärungDatentyp
in_utility_network

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

Utility Network; Utility Network Layer
domain_network

Die Netzart, in der das Teilnetz enthalten ist.

String
tier_name

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

String
support_disjoint_subnetwork

Gibt an, ob die Ebene getrennte Teilnetze unterstützt. Getrennte Teilnetze sind zwei oder mehr Teilnetze, die zur gleichen Ebene gehören und den gleichen Teilnetznamen aufweisen, jedoch nicht passierbar sind. Diese Option ist nur für Ebenen in Netzarten mit partitionierter Ebenendefinition verfügbar. Für Ebenen in einer Netzart mit einer hierarchischen Ebenendefinition ist für diese Ebeneneigenschaft immer "true" festgelegt, um getrennte Teilnetze zu unterstützen.

  • SUPPORT_DISJOINT Die Eingabeebene unterstützt getrennte Teilnetze.
  • NO_DISJOINTDie Eingabeebene unterstützt keine getrennten Teilnetze. Dies ist die Standardeinstellung.
Boolean
valid_devices
[valid_devices,...]

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

String
valid_subnetwork_controller
[valid_subnetwork_controller,...]

Die Liste der Paare aus Asset-Gruppe/Asset-Typ, die Teilnetz-Controller im Teilnetz werden können.

String
valid_lines
[valid_lines,...]

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

String
aggregated_line
[aggregated_line,...]

Die gültigen Linien, deren Geometrie 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 Zusammenfassungsfeld so fest, dass Funktionsergebnisse gespeichert werden, wenn SubnetLine-Features eingefügt oder aktualisiert werden.

Folgende Komponenten von Zusammenfassungen stehen zur Verfügung:

  • Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
  • Attribute: Hier können Sie wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu filtern.
  • Filter Name: Wählen Sie die Option aus, um die Funktionsergebnisse nach Attributname zu filtern.
  • Filter Operator: Hier können Sie unter mehreren Operatoren wählen.
  • Filter Type: Wählen Sie aus verschiedenen Filtertypen.
  • Filter Value: Legen Sie einen bestimmten Wert für das Eingabefilterattribut fest.
  • Summary Attribute: Das Feld in der Feature-Class SubnetLine, in dem das Funktionsergebnis dauerhaft gespeichert wird. Abhängig von der ausgewählten Funktion und dem ausgewählten 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 erstellt werden. Pro Feld wird nur das Ergebnis jeweils einer Zusammenfassung unterstützt. Daher erfordert jede Zusammenfassung ihr eigenes Feld in der SubnetLine-Feature-Class. In der folgenden Matrix finden Sie die gültigen Feldtypen für die verschiedenen Funktionen: Matrix gültiger Feldtypen für das Feld mit Zusammenfassungsattributen, basierend auf der ausgewählten Funktion

Mögliche Werte für die Function-Zusammenfassungsoptionen:

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

Mögliche Werte für die Filter Type-Zusammenfassungsoptionen:

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

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", 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
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(optional)

Legt für Features eine Bedingungsbarriere für Durchlässigkeit basierend auf einem Vergleich mit einem Netzwerkattribut fest, oder führt eine Überprüfung der Kategoriezeichenfolge durch. Eine Bedingungsbarriere verwendet ein Netzwerkattribut, einen Operator und einen Typ sowie einen Attributwert. Halten Sie eine Verfolgung beispielsweise an, wenn das Attribut Device Status dem spezifischen Wert Open entspricht. Wenn ein Feature diese Bedingung erfüllt, wird die Verfolgung angehalten. Bei Verwendung mehrerer Attribute können Sie mit dem Parameter Kombination verwenden eine And- oder eine Or-Bedingung definieren.

Die Komponenten der Bedingungsbarrieren sind folgende:

  • Name: Hier können Sie wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu filtern.
  • Operator: Hier können Sie unter mehreren Operatoren wählen.
  • Type: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der im Parameter name angegeben ist, wählen.
  • Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp 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üssen. 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", bei der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
  • DOES NOT INCLUDE_THE_VALUESEine Operation mit "Bitwise AND", bei der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
  • INCLUDES_ANYEine Operation mit "Bitwise AND", bei der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
  • DOES_NOT_INLCUDE_ANYEine Operation mit "Bitwise AND", bei der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).

Mögliche Werte für die Type-Optionen:

  • 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.
Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(optional)

Legt für Features eine Durchlässigkeitsbarriere basierend auf einer Funktion fest. Funktionsbarrieren können beispielsweise verwendet werden, um die Entfernung der Verfolgung vom Startpunkt einzuschränken oder einen Maximalwert zum Anhalten einer Verfolgung festzulegen. Die Länge der jeweils zurückgelegten Linie wird beispielsweise der bisher zurückgelegten Gesamtentfernung hinzugefügt. Wenn die zurückgelegte Gesamtlänge den angegebenen Wert erreicht hat, wird die Verfolgung angehalten.

Die Komponenten der Funktionsbarrieren sind folgende:

  • Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
  • Attribute: Hier können Sie wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu filtern.
  • Operator: Hier können Sie unter mehreren Operatoren wählen.
  • Value: Hier können Sie einen bestimmten Wert des Eingabeattributtyps 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.

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.

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).

Die Use Local Values-Optionen für die Funktionsbarriere lauten wie folgt:

  • TRUELokale Werte verwenden.
  • FALSEGlobale Werte verwenden. Dies ist die Standardeinstellung.
Value Table
include_barriers
(optional)

Definiert, 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 umgesetzt werden soll. Der Umfang der Durchlassfähigkeit regelt, ob die Durchlassfähigkeit an Knoten, an Kanten oder an Knoten und an Kanten umgesetzt wird. Beispiel: Wenn eine Bedingungsbarriere definiert wurde, um die Verfolgung zu stoppen, wenn Device Status dem Wert Open entspricht 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 Device Status nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.

  • BOTH_JUNCTIONS_AND_EDGESDurchlassfähigkeit auf Knoten und Kanten anwenden. Dies ist die Standardeinstellung.
  • JUNCTIONS_ONLYDurchlassfähigkeit nur auf Knoten anwenden.
  • EDGES_ONLYDurchlassfähigkeit nur auf Kanten anwenden.
String
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 werden soll. Weitergegebene Klassenattribute geben die Schlüsselwerte für Teilnetz-Controller an, die auf die restlichen Features im Teilnetz verteilt werden. In einem Stromversorgungsmodell können Sie beispielsweise die Phasenwerte weitergeben.

Folgende Komponenten stehen bei den Weitergabemodulen zur Verfügung:

  • Attribute: Hier können Sie wählen, um nach einem beliebigen Netzwerkattribut, das im System definiert ist, zu filtern.
  • Substitution Attribute: Verwendet einen Ersatzwert anstelle von Bitset-Netzwerkattributwerten. Ersetzungen werden basierend auf der Anzahl der Bits im weitergegebenen Netzwerkattribut codiert. Eine Ersetzung ist die Zuordnung der Bits in einer Phase zu jeweils einem anderen Bit. Bei Phase AC kann im Rahmen einer Ersetzung z. B. Bit A zu B und Bit C zu Null zugeordnet werden. In diesem Beispiel lautet die Ersetzung für 1010 (Phase AC) 0000-0010-0000-0000 (512). In der Ersetzung ist die Zuordnung ersichtlich, damit Sie wissen, dass Phase A zu B zugeordnet und Phase C zu NULL zugeordnet wurde und nicht andersherum (d. h. Phase A wurde nicht zu NULL zugeordnet und Phase C nicht zu B).
  • Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
  • Operator: Hier können Sie unter mehreren Operatoren wählen.
  • Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
  • Propagated Attribute: Der Name des Feldes in Ihrer Netzwerkklasse, in dem die berechneten verteilten Werte gespeichert werden. Der Feldtyp sollte dem Feldtyp des Netzwerkattributs entsprechen, der für den Wert Attribute festgelegt wurde.

Mögliche Werte von function für die Weitergabemodule:

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

Die operator-Werte für das Weitergabemodul 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).
Hinweis:

Dieser Parameter ist nur über Python verfügbar.

Value Table

Abgeleitete Ausgabe

NameErklärungDatentyp
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.SetSubnetworkDefinition_un(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