Zusammenfassung
Fügt einem Versorgungsnetz ein Netzwerkattribut hinzu.
Ein Netzwerkattribut ist ein Wert, der von Attributen zugehöriger Features im Netzwerk abgeleitet und in der Netzwerk-Topologie gespeichert wird. Netzwerkattribute werden von Verfolgungsanalysen verwendet, um zu steuern, wie das Netzwerk durchlaufen werden kann. Ein Netzwerkattribut kann nur einem Attribut in einer Feature-Class zugeordnet werden, jedoch kann ein einzelnes Versorgungsnetz über eine unbegrenzte Anzahl von Netzwerkattributen verfügen. Netzwerkattribute können als Gewichtungen verwendet werden, um die Durchlassfähigkeit zu steuern und die Kosten für Pfade im Netzwerk zu modellieren.
Verwendung
Ein Netzwerkattribut kann nur mit einem Attribut einer Feature-Class, aber mit mehreren Feature-Classes verknüpft werden.
Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss das verbundene ArcGIS Enterprise-Portal-Konto der Besitzer des Portal-Versorgungsnetzes sein.
Die Netzwerk-Topologie muss deaktiviert sein.
Bei Verwendung einer Enterprise-Geodatabase muss dieses Werkzeug beim Ausführen mit der Default-Version verbunden sein.
Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss das Eingabe-Versorgungsnetz aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes eingerichtet wurde.
Dieses Werkzeug kann zusammen mit dem Werkzeug Netzwerkattribut festlegen verwendet werden, das zum Zuweisen des Netzwerkattributs zu einem Feature-Class-Feld im Versorgungsnetz verwendet wird.
In der folgenden Tabelle werden die Netzwerkattributarten und die entsprechenden Parameter aufgeführt:
Attributtyp Inline Aufteilbar NULL-Werte zulassen Ersetzung Short
Long
(Nur out-of-line)
Double
Date
Syntax
arcpy.un.AddNetworkAttribute(in_utility_network, attribute_name, attribute_type, {is_inline}, {is_apportionable}, {domain}, {is_overridable}, {is_nullable}, {is_substitution}, {network_attribute_to_substitute})| Parameter | Erklärung | Datentyp |
in_utility_network | Das Eingabe-Versorgungsnetz, dem das Netzwerkattribut hinzugefügt wird. | Utility Network; Utility Network Layer |
attribute_name | Der Name des Netzwerkattributs, das dem Versorgungsnetz hinzugefügt werden soll. | String |
attribute_type | Gibt den Datentyp des Netzwerkattributs an.
| String |
is_inline (optional) | Gibt an, ob das Netzwerkattribut als Inline-Attribut gespeichert werden soll. Inline-Netzwerkattribute sind etwas effizienter, aber die Anzahl der Bits für Inline-Attribute ist auf 28 pro Versorgungsnetz beschränkt. Die am häufigsten verwendeten Netzwerkattribute (z. B. "Phase" bei Stromnetzen, "Druck" bei Gas- und Wassernetzen) sollten als Inline-Attribute gespeichert werden, sofern möglich. Die Größe der Bits wird durch den Domänenparameter bestimmt. Inline-Attribute werden nur für Netzwerkattribute vom Typ "Ganzzahl" unterstützt.
| Boolean |
is_apportionable (optional) | Gibt an, ob das Netzwerkattribut über mehrere Kanten verteilt wird, die zu demselben Feature gehören. Wenn beispielsweise ein Linien-Feature mit dem Netzwerkattribut shape_length aus fünf Kantenelementen besteht und die Gesamtlänge dieses Linien-Features 100 Meter beträgt, wird dieses Attribut auf alle Kanten aufgeteilt, sodass sich für jede Kante je 20 Meter ergeben. Die Verteilung des Wertes hängt vom Prozentsatz entlang der einzelnen Kantenelemente in Bezug auf den Von-Punkt des ursprünglichen Features ab.
| Boolean |
domain (optional) | Die Domäne, mit der das Netzwerkattribut verknüpft wird. Dieser Parameter ist erforderlich, wenn is_inline auf True gesetzt ist. Diese Domäne wird verwendet, um festzulegen, wie viele Bits für das Inline-Attribut zugewiesen werden müssen. Hierbei muss es sich um einen codierten Wert handeln. Für die Domäne LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) sind beispielsweise vier Einträge vorhanden. Das bedeutet, dass zum Speichern des Inline-Attributs 2 Bit benötigt werden. Die Domäne mit codierten Werten muss sequenzielle Codes aufweisen, die bei 0 beginnen. | String |
is_overridable (optional) | Hinweis:Dieser Parameter wird nicht verwendet. Eingegebene Werte werden in der aktuellen Version ignoriert. Die Funktionalität dieses Parameter befindet sich derzeit in Entwicklung und ist in einer zukünftigen Version verfügbar.
| Boolean |
is_nullable (optional) | Gibt an, ob dieses Netzwerkattribut NULL-Werte unterstützt.
| Boolean |
is_substitution (optional) | Gibt an, ob dieses Netzwerkattribut als Ersetzung verwendet wird. Ersetzungsnetzwerkattribute ermöglichen in einer Verfolgung die Verwendung eines Ersatzwertes anstelle eines Bitset-Netzwerkattributwertes während der Weitergabe.
| Boolean |
network_attribute_to_substitute (optional) | Das zur Ersetzung verwendete Netzwerkattribut. Ersetzungen werden basierend auf der Anzahl der Bits im weitergegebenen Netzwerkattribut codiert. Dabei muss es sich um ein Inline-Netzwerkattribut vom Typ eines ganzzahligen Feldes mit bis zu 8 Bit handeln. | String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_utility_network | Das aktualisierte Versorgungsnetz. | Utility Network |
Codebeispiel
Fügt ein Netzwerkattribut mit dem Namen "Bauteilstatus" von der Attributart "Short" hinzu.
import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", "Device Status", "SHORT",
"INLINE", "NOT_APPORTIONABLE", "",
"ElectricDistributionDeviceStatus",
"NOT_OVERRIDABLE")Fügt ein zur Ersetzung zu verwendendes Netzwerkattribut hinzu.
import arcpy
arcpy.AddNetworkAttribute_un("Utility Network",
"Phases", "LONG", "NOT_INLINE",
"NOT_APPORTIONABLE",
"ElectricDistributionDeviceStatus", "",
"NOT_NULLABLE", "SUBSTITUTION",
"Phases current")Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja