Netzwerkattribut hinzufügen (Utility Network)

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:

    AttributtypInlineAufteilbarNULL-Werte zulassenErsetzung

    Short

    HäkchenHäkchen

    Long

    HäkchenHäkchenHäkchen

    (Nur out-of-line)

    Double

    HäkchenHäkchen

    Date

    Häkchen

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Eingabe-Versorgungsnetz, dem das Netzwerkattribut hinzugefügt wird.

Utility Network; Utility Network Layer
Attributname

Der Name des Netzwerkattributs, das dem Versorgungsnetz hinzugefügt werden soll.

String
Attributtyp

Gibt den Datentyp des Netzwerkattributs an.

  • Short (small integer)Kleine Ganzzahl
  • Long (large integer)Große Ganzzahl
  • Double (double precision)Doppelte Genauigkeit
  • DateDatentyp
String
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.

  • Aktiviert: Das Attribut wird intern der Topologie hinzugefügt, sodass ein effizienteres Abrufen ermöglicht wird.
  • Nicht aktiviert: Das Attribut wird in einer externen Tabelle gespeichert. Beim Abrufen muss eine externe Gewichtungstabelle aufgerufen werden. Dies ist die Standardeinstellung.
Boolean
Aufteilbar
(optional)

Gibt an, ob das Netzwerkattribut über mehrere Kanten verteilt wird, die zu demselben Feature gehören.

Netzwerkattribute mit der Eigenschaft "Aufteilbar" können Feldern in Line- oder Junction-Feature-Classes zugewiesen werden. Das mit der Eigenschaft "Aufteilbar" definierte Verhalten haben aber nur Linien-Features.

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.

  • Aktiviert: Das Netzwerkattribut wird aufgeteilt.
  • Deaktiviert: Das Netzwerkattribut wird nicht aufgeteilt. Dies ist die Standardeinstellung.
Boolean
Domänenname
(optional)

Die Domäne, mit der das Netzwerkattribut verknüpft wird. Dieser Parameter ist erforderlich, wenn Inline aktiviert 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
Ist überschreibbar
(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.

Gibt an, ob ein Netzwerkattribut eine externe Überschreibungstabelle aufweist, die von der Netzwerk-Topologie gelesen wird und deren aktuell in der Topologie gespeicherter Wert überschrieben wird. Sie kann verwendet werden, um Live-Daten aus externen Systemen einzugeben, wie etwa die aktuelle Position bei einem elektrischen Wert oder einem Druckwert bei Gas. Ein Beispiel ist ein SCADA-System, das die aktualisierten Schaltpositionen von Bauteil A an die Überschreibungstabelle des Netzwerkattributs "DeviceStatus" übermittelt, die dann von der Topologie-Engine verwendet werden, um den aktuellen Wert des Bauteilstatus für Bauteil A mit dem Überschreibwert zu überschreiben.

  • Aktiviert: Der in der Topologie gespeicherte aktuelle Wert wird überschrieben.
  • Deaktiviert: Der in der Topologie gespeicherte aktuelle Wert wird nicht überschrieben. Dies ist die Standardeinstellung.
Boolean
NULL-Werte zulassen
(optional)

Gibt an, ob dieses Netzwerkattribut NULL-Werte unterstützt.

  • Aktiviert: Das Netzwerkattribut unterstützt NULL-Werte.
  • Nicht aktiviert: Das Netzwerkattribut unterstützt keine NULL-Werte. Dies ist die Standardeinstellung.

Boolean
Ersetzung
(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.

  • Aktiviert: Das Netzwerkattribut wird als Ersetzung verwendet.
  • Deaktiviert: Das Netzwerkattribut wird nicht als Ersetzung verwendet. Dies ist die Standardeinstellung.

Boolean
Zu ersetzendes Netzwerkattribut
(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

BeschriftungErläuterungDatentyp
Aktualisiertes Versorgungsnetz

Das aktualisierte Versorgungsnetz.

Utility Network

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})
NameErläuterungDatentyp
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.

  • SHORTKleine Ganzzahl
  • LONGGroße Ganzzahl
  • DOUBLEDoppelte Genauigkeit
  • DATEDatentyp
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.

  • INLINEDas Attribut wird intern der Topologie hinzugefügt, sodass ein effizienteres Abrufen ermöglicht wird.
  • NOT_INLINEDas Attribut wird in einer externen Tabelle gespeichert. Beim Abrufen muss eine externe Gewichtungstabelle aufgerufen werden. Dies ist die Standardeinstellung.
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.

  • APPORTIONABLEDas Netzwerkattribut wird aufgeteilt.
  • NOT_APPORTIONABLEDas Netzwerkattribut wird nicht aufgeteilt. Dies ist die Standardeinstellung.
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.

Gibt an, ob ein Netzwerkattribut eine externe Überschreibungstabelle aufweist, die von der Netzwerk-Topologie gelesen wird und deren aktuell in der Topologie gespeicherter Wert überschrieben wird. Sie kann verwendet werden, um Live-Daten aus externen Systemen einzugeben, wie etwa die aktuelle Position bei einem elektrischen Wert oder einem Druckwert bei Gas. Ein Beispiel ist ein SCADA-System, das die aktualisierten Schaltpositionen von Bauteil A an die Überschreibungstabelle des Netzwerkattributs "DeviceStatus" übermittelt, die dann von der Topologie-Engine verwendet werden, um den aktuellen Wert des Bauteilstatus für Bauteil A mit dem Überschreibwert zu überschreiben.

  • OVERRIDEDer in der Topologie gespeicherte aktuelle Wert wird überschrieben.
  • NOT_OVERRIDABLEDer in der Topologie gespeicherte aktuelle Wert wird nicht überschrieben. Dies ist die Standardeinstellung.
Boolean
is_nullable
(optional)

Gibt an, ob dieses Netzwerkattribut NULL-Werte unterstützt.

  • NULLABLEDas Netzwerkattribut unterstützt NULL-Werte.
  • NOT_NULLABLEDas Netzwerkattribut unterstützt keine NULL-Werte. Dies ist die Standardeinstellung.
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.

  • SUBSTITUTIONDas Netzwerkattribut wird als Ersetzung verwendet.
  • NOT_SUBSTITUTIONDas Netzwerkattribut wird nicht als Ersetzung verwendet. Dies ist die Standardeinstellung.
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

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Utility Network

Codebeispiel

AddNetworkAttribute – Beispiel 1 (Python-Fenster)

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")
AddNetworkAttribute – Beispiel 2 (Python-Fenster)

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

Sonderfälle

Lizenzinformationen

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

Verwandte Themen