Regel hinzufügen (Utility Network)—ArcGIS Pro

Zusammenfassung

Fügt einem Versorgungsnetz eine Regel hinzu.

Alle in einem Versorgungsnetz erstellten Regeln basieren auf Netzwerkklassen auf der Ebene der Asset-Gruppen und Asset-Typen und können zum Steuern einiger Verhaltensweisen im Versorgungsnetz verwendet werden.

Verwendung

Die Netzwerk-Topologie muss deaktiviert sein.
Die folgenden Anforderungen müssen erfüllt werden, wenn mit einer Enterprise-Geodatabase gearbeitet wird:
- Der Parameterwert Eingabe-Versorgungsnetz muss aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes hergestellt wurde.
- Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes handeln.

Syntax

arcpy.un.AddRule(in_utility_network, rule_type, from_class, from_assetgroup, from_assettype, to_class, to_assetgroup, to_assettype, {from_terminal}, {to_terminal}, {via_class}, {via_assetgroup}, {via_assettype}, {via_terminal})

Parameter	Erklärung	Datentyp
in_utility_network	Das Versorgungsnetz, für das die Regel hinzugefügt wird.	Utility Network; Utility Network Layer
rule_type	Der Typ der Regel, die erstellt werden soll. JUNCTION_JUNCTION_CONNECTIVITY —Erstellt eine Knoten-Knoten-Konnektivitätsregel, mit der zwei Punkt-Features über eine Konnektivitätszuordnung verbunden werden können (Features sind geometrisch versetzt). CONTAINMENT —Erstellt eine Containment-Regel, wobei die "Von"-Parameter die Container darstellen und die "Zu"-Parameter die Inhalte in einer Containment-Zuordnung. STRUCTURAL_ATTACHMENT —Erstellt eine Regel für strukturelle Anbauten, wobei die "Von"-Parameter die Struktur-Features darstellen und die "Zu"-Parameter die Anbau-Features in einer strukturellen Anbau-Zuordnung sind. JUNCTION_EDGE_CONNECTIVITY —Erstellt eine Kanten-Knoten-Konnektivitätsregel, mit der Kanten- und Knoten-Features über geometrische Übereinstimmung verbunden werden können (Features befinden sich an derselben XYZ-Position). EDGE_JUNCTION_EDGE_CONNECTIVITY —Erstellt eine Kanten-Knoten-Kanten-Konnektivitätsregel, mit der eine Kante mit beiden Seiten eines Knoten-Features verbunden werden kann.	String
from_class	Die "Von"-Utility-Network-Feature-Class oder -Tabelle, die in die Regel einbezogen werden soll. Bei Regeln für die strukturelle Anbau-Zuordnung und die Containment-Zuordnung muss das Container- oder Struktur-Feature in diesem Parameter enthalten sein. Sortieren ist bei Knoten-Knoten-, Knoten-Kanten- und Kanten-Knoten-Kanten-Konnektivitätsregeln nicht erforderlich.	String
from_assetgroup	Eine Asset-Gruppe für die from_class, für die die Regel gilt.	String
from_assettype	Ein Asset-Typ für die from_class, für die die Regel gilt.	String
to_class	Die "Zu"-Utility-Network-Feature-Class oder -Tabelle, die in die Regel einbezogen werden soll. Bei Regeln für die strukturelle Anbau-Zuordnung und die Containment-Zuordnung muss das Inhalts- oder Anbau-Feature in diesem Parameter enthalten sein. Sortieren ist bei Knoten-Knoten-, Knoten-Kanten- und Kanten-Knoten-Kanten-Konnektivitätsregeln nicht erforderlich.	String
to_assetgroup	Eine Asset-Gruppe für die to_class, für die die Regel gilt.	String
to_assettype	Gibt einen Asset-Typ für die to_class an, für die die Regel gilt.	String
from_terminal (optional)	Der "Von"-Anschlusspunkt, für den die Regel gilt. Hierbei handelt es sich um einen Anschlusspunkt in der from_class. Beim Erstellen einer Konnektivitätsregel für ein Feature mit Anschlusspunkten zum Verbinden mit einem anderen Feature muss die Anschlusspunktseite angegeben werden, die verbunden werden soll, z. B. die Oberspannungsseite eines Transformators. Dieser Parameter ist erforderlich, wenn der Asset-Typ Anschlusspunkte aufweist. Er wird bei den Regeltypen für die strukturelle Anbau-Zuordnung und die Containment-Zuordnung ignoriert.	String
to_terminal (optional)	Der "Zu"-Anschlusspunkt, für den die Regel gilt. Hierbei handelt es sich um einen Anschlusspunkt in der to_class. Beim Erstellen einer Konnektivitätsregel für ein Feature zum Verbinden mit einen anderen Feature mit Anschlusspunkten muss die Anschlusspunktseite angegeben werden, die verbunden werden soll, wie z. B. die Niedrigspannungsseite eines Transformators. Dieser Parameter ist erforderlich, wenn der Asset-Typ Anschlusspunkte aufweist. Er wird bei den Regeltypen für die strukturelle Anbau-Zuordnung und die Containment-Zuordnung ignoriert.	String
via_class (optional)	Die Junction-Utility-Network-Feature-Class oder -Tabelle, für die die Regel gilt. Dieser Parameter kann nur für EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type angegeben werden, da für die Beteiligung an einer Kanten-Knoten-Kanten-Konnektivität drei Feature-Classes oder Tabellen erforderlich sind.	String
via_assetgroup (optional)	Eine Asset-Gruppe der via_class, für die die Regel gilt. Dieser Parameter kann nur für den Parameterwert EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type angegeben werden.	String
via_assettype (optional)	Ein Asset-Typ der via_class, für die die Regel gilt. Dieser Parameter kann nur für den Parameterwert EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type angegeben werden.	String
via_terminal (optional)	Der Anschlusspunkt aus der via_class, für den die Regel gilt. Dieser Parameter kann nur für den Parameterwert EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type angegeben werden.	String

Abgeleitete Ausgabe

Name	Erklärung	Datentyp
out_utility_network	Das aktualisierte Versorgungsnetz.	Versorgungsnetz

Codebeispiel

AddRule – Beispiel 1 (Python-Fenster)

Mit diesem Beispielskript wird eine Regel für die Knoten-Knoten-Konnektivitätszuordnung erstellt, mit der die Lastseite von Leistungsschaltern mit der Oberspannungsseite von Transformatoren in einem Stromverteilungsnetz verbunden werden kann.

import arcpy
arcpy.AddRule_un("Distribution Network", "JUNCTION_JUNCTION_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Transformer", "High")

AddRule – Beispiel 2 (Python-Fenster)

Mit diesem Beispielskript wird eine Knoten-Kanten-Konnektivitätsregel erstellt, mit der in einem Stromverteilungsnetz die Lastseite von Schutzschaltern mit Mittelspannungsleitungen verbunden werden kann.

import arcpy
arcpy.AddRule_un("Utility Network", "JUNCTION_EDGE_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Medium Voltage", 
                 "Single Phase Overhead")

AddRule – Beispiel 3 (Python-Fenster)

Mit diesem Beispielskript wird eine Containment-Zuordnungsregel erstellt, damit ein Schaltkasten einen Winkel enthalten kann.

import arcpy
arcpy.AddRule_un("Electric Network", "CONTAINMENT", "StructureJunction", 
                 "JunctionBox", "Junction Box", "ElectricDistributionDevice", 
                 "Fuse", "Underground Single Phase Load Break Elbow")

AddRule – Beispiel 4 (Python-Fenster)

Mit diesem Beispielskript wird eine Regel für die strukturelle Anbau-Zuordnung erstellt, mit der ein Schalter an einen Leitungsmast angebaut werden kann.

import arcpy
arcpy.AddRule_un("Electric Network", "STRUCTURAL_ATTACHMENT", 
                 "StructureJunction", "Pole", "Wood", 
                 "ElectricDistributionDevice", "Switch", 
                 "Overhead Low Voltage Single Phase Disconnect")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

Basic: Nein
Standard: Ja
Advanced: Ja