Ebene hinzufügen (Utility Network)

Zusammenfassung

Erstellt eine neue Ebene für eine Netzart in einem Versorgungsnetz.

Ebenen sind Sammlungen von Teilnetzen, bei denen Ebene, Namenseinschränkungen und Topologietyp identisch sind. Ebenen sind für die Verwaltung von Teilnetzen erforderlich.

Verwendung

  • Bei Netzarten mit einer partitionierten Ebenendefinition für die erste der Netzart hinzugefügten Ebene wird ein Feld für den Teilnetznamen hinzugefügt. Bei Netzarten mit einer hierarchischen Ebenendefinition wird mithilfe des Parameterwertes Teilnetz-Feldname ein Teilnetz-Feldname erstellt. Weitere Informationen finden Sie unter Teilnetzname.

  • Bei Netzarten mit einer hierarchischen Ebenendefinition ist der Ebenengruppenname ein erforderlicher Parameter. Mithilfe des Werkzeugs Ebenengruppe hinzufügen können Ebenengruppen für Netzarten mit einer hierarchischen Ebenendefinition erstellt werden.

  • Ebenen sollten vor dem Anhängen von Daten in den Utility-Network-Feature-Classes hinzugefügt werden. Wenn Daten vor dem Hinzufügen einer neuen Ebene angehängt werden, tritt ein Fehler auf.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Versorgungsnetz, das die Netzart enthält, der die Ebene hinzugefügt wird.

Utility Network; Utility Network Layer
Netzart

Die Netzart, in der die Ebene erstellt wird.

String
Name

Der Name der neuen Ebene. Dieser Name muss im gesamten Versorgungsnetz eindeutig sein.

String
Rangstufe

Die Rangstufe der Ebene, die hinzugefügt wird. Die höchste Rangstufe ist die Nummer 1.

Long
Topologietyp
(optional)

Gibt den Topologietyp für die neue Ebene an. Teilnetze der Topologietypen "Sternförmig" und "Vermascht" unterstützen einen oder mehrere Teilnetz-Controller. Dieser Parameter wird im Werkzeugdialogfeld deaktiviert, wenn die Eingabe-Netzart mit einer hierarchischen Ebenendefinition erstellt wurde und der Standard-Topologietyp "Vermascht" verwendet wird. Wenn die Netzart mit einer partitionierten Ebenendefinition erstellt wurde, sind für diesen Parameter alle Topologietypen in der Dropdown-Liste verfügbar.

Für die Verfolgung oder die Teilnetzverwaltung weist der Parameter derzeit kein unterschiedliches Verhalten auf. Die Funktionalität dieses Parameter befindet sich derzeit in Entwicklung und ist in einer zukünftigen Version verfügbar.

  • SternförmigDie Teilnetze weisen den Topologietyp "Sternförmig" auf.
  • VermaschtDie Teilnetze weisen den Topologietyp "Vermascht" auf. Dies ist der Standard-Topologietyp für eine Ebene, die mit einer hierarchischen Ebenendefinition erstellt wurde.
String
Ebenengruppenname
(optional)

Die vorhandene Ebenengruppe, der die neue Ebene hinzugefügt wird. Dieser Parameter ist für Netzarten mit einer hierarchischen Ebenendefinition erforderlich.

String
Teilnetz-Feldname
(optional)

Der Name des Feldes, in dem die Teilnetznamen für diese Ebene gespeichert werden. Dies ist ein vom System verwaltetes Feld, das erstellt wird, wenn eine Ebene zum ersten Mal einer Ebenengruppe hinzugefügt wird. Danach wird es für weitere Ebenen wiederverwendet. Beispielsweise haben Sie zwei Ebenengruppen: Verteilung und Übertragung. Wenn Sie der Gruppe "Verteilung" eine Ebene namens "system" hinzufügen und als Teilnetzwerk-Feldname systemsubnet festlegen, wird das Feld erstellt. Dann fügen Sie der Gruppe "Übertragung" eine zweite Ebene namens "system" hinzu. Dieser Parameter erkennt, dass das Feld systemsubnet als Teilnetzwerk-Feldname verwendet werden soll. Dieser Parameter ist für hierarchische Ebenentypen erforderlich.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Versorgungsnetz

Das aktualisierte Versorgungsnetz.

Versorgungsnetz

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})
NameErläuterungDatentyp
in_utility_network

Das Versorgungsnetz, das die Netzart enthält, der die Ebene hinzugefügt wird.

Utility Network; Utility Network Layer
domain_network

Die Netzart, in der die Ebene erstellt wird.

String
name

Der Name der neuen Ebene. Dieser Name muss im gesamten Versorgungsnetz eindeutig sein.

String
rank

Die Rangstufe der Ebene, die hinzugefügt wird. Die höchste Rangstufe ist die Nummer 1.

Long
topology_type
(optional)

Gibt den Topologietyp für die neue Ebene an. Teilnetze der Topologietypen "Sternförmig" und "Vermascht" unterstützen einen oder mehrere Teilnetz-Controller. Dieser Parameter wird im Werkzeugdialogfeld deaktiviert, wenn die Eingabe-Netzart mit einer hierarchischen Ebenendefinition erstellt wurde und der Standard-Topologietyp "Vermascht" verwendet wird. Wenn die Eingabe-Netzart mit einer hierarchischen Ebenendefinition erstellt wurde, wird der Standard-Topologietyp MESH verwendet. Wenn die Eingabe-Netzart mit einer partitionierten Ebenendefinition erstellt wurde, ist der Topologietyp als Parameter erforderlich.

Hinweis:

Für die Verfolgung oder die Teilnetzverwaltung weist der Parameter derzeit kein unterschiedliches Verhalten auf. Die Funktionalität dieses Parameter befindet sich derzeit in Entwicklung und ist in einer zukünftigen Version verfügbar.

  • RADIALDie Teilnetze weisen den Topologietyp "Sternförmig" auf.
  • MESHDie Teilnetze weisen den Topologietyp "Vermascht" auf. Dies ist der Standard-Topologietyp für eine Ebene, die mit einer hierarchischen Ebenendefinition erstellt wurde.
String
tier_group_name
(optional)

Die vorhandene Ebenengruppe, der die neue Ebene hinzugefügt wird. Dieser Parameter ist für Netzarten mit einer hierarchischen Ebenendefinition erforderlich.

String
subnetwork_field_name
(optional)

Der Name des Feldes, in dem die Teilnetznamen für diese Ebene gespeichert werden. Dies ist ein vom System verwaltetes Feld, das erstellt wird, wenn eine Ebene zum ersten Mal einer Ebenengruppe hinzugefügt wird. Danach wird es für weitere Ebenen wiederverwendet. Beispielsweise haben Sie zwei Ebenengruppen: Verteilung und Übertragung. Wenn Sie der Gruppe "Verteilung" eine Ebene namens "system" hinzufügen und als Teilnetzwerk-Feldname systemsubnet festlegen, wird das Feld erstellt. Dann fügen Sie der Gruppe "Übertragung" eine zweite Ebene namens "system" hinzu. Dieser Parameter erkennt, dass das Feld systemsubnet als Teilnetzwerk-Feldname verwendet werden soll. Dieser Parameter ist für hierarchische Ebenentypen erforderlich.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Versorgungsnetz

Codebeispiel

AddTier – Beispiel 1 (Python-Fenster)

Es wird eine Ebene im hierarchischen Netzwerk "DistributionSystem" mit dem Topologietyp MESH erstellt.

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")
AddTier – Beispiel 2 (Python-Fenster)

Es wird eine Ebene im partitionierten Netzwerk "MediumVoltage" mit dem Topologietyp RADIAL erstellt.

import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen