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
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 bei der Ausführung mit der Default-Version verbunden sein.
Syntax
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})
Parameter | Erklärung | Datentyp |
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. 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 SUPPORT_DISJOINT festgelegt, um getrennte Teilnetze zu unterstützen.
| 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 Zusammenfassungsfeld so fest, dass Funktionsergebnisse gespeichert werden, wenn SubnetLine-Features eingefügt oder aktualisiert werden. Folgende Komponenten von Zusammenfassungen stehen zur Verfügung:
Die Zusammenfassungsoptionen für Function-Werte lauten wie folgt:
Die Zusammenfassungsoptionen für Filter Operator-Werte lauten wie folgt:
Die Zusammenfassungsoptionen für Filter Type-Werte lauten wie folgt:
| 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:
Die operator-Werte für die Bedingungsbarrieren lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Bedingungsbarrieren sind folgende:
Die Combine Using-Werte lauten wie folgt:
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:
Die function-Wertoptionen für die Funktionsbarriere lauten wie folgt:
Die operator-Wertoptionen für die Funktionsbarriere lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Die Funktionsbarrierenoptionen für Use Local Values-Werte lauten wie folgt:
| 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.
| 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 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.
| 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 Weitergabemodulen zur Verfügung:
Die function-Optionen für die Weitergabemodule lauten wie folgt:
Die operator-Optionen für die Weitergabemodule lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Hinweis:Dieser Parameter ist nur über 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.
Hinweis:Für diesen Parameter wird Utility Network-Version 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.
Hinweis:Für diesen Parameter wird Utility Network-Version 4 oder höher benötigt. | Boolean |
edit_mode_for_default_version (optional) | Gibt den Bearbeitungsmodus für Teilnetzaktualisierungen in der Standardversion und in einer File-Geodatabases an.
Hinweis:Für diesen Parameter wird Utility Network-Version 4 oder höher benötigt. | String |
edit_mode_for_named_version (optional) | Gibt den Bearbeitungsmodus für Teilnetzaktualisierungen in einer benannten Version an.
Hinweis:Für diesen Parameter ist die Utility Network-Version 4 oder höher 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 Utility Network-Version 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 Utility Network-Version 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 Utility Network-Version 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 Utility Network-Version 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, verwendet dieser Parameter die Standardoption NOT_MANAGE.
Hinweis:Für diesen Parameter wird Utility Network-Version 5 oder höher benötigt. | Boolean |
include_containers (optional) | Gibt an, ob Container-Features und -objekte in die Verfolgungsergebnisse einbezogen werden.
Für diesen Parameter wird Utility Network-Version 5 oder höher benötigt. | Boolean |
include_content (optional) | Gibt an, ob bei der Verfolgung in den Ergebnissen Inhalte von Containern zurückgegeben werden.
Für diesen Parameter wird Utility Network-Version 5 oder höher benötigt. | Boolean |
include_structures (optional) | Gibt an, ob Struktur-Features und Objekte in die Verfolgungsergebnisse einbezogen werden.
Für diesen Parameter wird Utility Network-Version 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.
Hinweis:Für diesen Parameter wird Utility Network-Version 5 oder höher benötigt. | Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_utility_network | Das aktualisierte Eingabe-Versorgungsnetz. | Versorgungsnetz |
Codebeispiel
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
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja