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 in 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 der Parameterwert für Eingabe-Versorgungsnetz aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes hergestellt wurde.

  • Lizenz:
    Dem aktiven Portal-Konto muss eine Lizenz mit der Benutzertyp-Erweiterung ArcGIS Advanced Editing zugewiesen sein, um dieses Werkzeug in einer Enterprise-Bereitstellung verwenden zu können.
  • Dieses Werkzeug kann zusammen mit dem Werkzeug Netzwerkattribut festlegen verwendet werden, mit dem das Netzwerkattribut zu einem Feature-Class-Feld im Versorgungsnetz zugewiesen 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

    Datum

    Häkchen

    Big Integer

    Hinweis:
    Netzwerkattribute vom Typ "Big Integer" werden ab Utility Network Version 7 unterstützt.
    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 wird.

String
Attributtyp

Gibt den Datentyp des Netzwerkattributs an.

  • Short (16-Bit-Integer)Der Feldtyp ist "Short".
  • Long (32-Bit-Integer)Der Feldtyp ist "Long".
  • Double (64-Bit-Gleitkomma)Der Feldtyp ist "Double".
  • DatumDer Feldtyp ist "Datum".
  • Big Integer (64-Bit-Integer)Der Feldtyp ist "Big Integer".
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 benutzerdefinierte Inline-Netzwerkattribute ist auf 25 pro Versorgungsnetz beschränkt. Speichern Sie die am häufigsten verwendeten Netzwerkattribute (z. B. "Phase" bei Stromnetzen, "Druck" bei Gas- und Wassernetzen) als Inline-Attribute, sofern möglich. Die Größe der Bits wird durch den Domänenparameter bestimmt. Inline-Attribute werden nur für Netzwerkattribute vom Typ "Integer" ("Short" oder "Long") 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.

Das Verhalten "Aufteilbar" wird nur für Netzwerkattribute Typ "Double" unterstützt. 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 shape_length-Netzattribut und ein Linien-Feature aus fünf Kantenelementen von je 20 Metern besteht und die Gesamtlänge dieses Linien-Features 100 Meter beträgt, wird das Attribut auf alle Kanten aufgeteilt. Wenn zum Beispiel eine Funktion innerhalb einer verbundenen Verfolgung zum Zählen des Attributs shape length für diese Linie verwendet wird, wird die Anzahl 5 zurückgegeben, da die einzelnen Kanten-Features berücksichtigt werden, nicht die gesamte Linie. 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. Mit dieser Domäne wird die Anzahl an Bits festgelegt, die 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.

Weitere Informationen zum Berechnen der Bitgröße für Inline-Netzwerkattribute

String
Ist überschreibbar
(optional)
Hinweis:

Dieser Parameter wird in der aktuellen Version nicht verwendet. Eingegebene Werte werden ignoriert. Die Funktionalität dieses Parameter befindet sich derzeit in Entwicklung und ist in einer zukünftigen Version verfügbar.

Gibt an, ob der aktuell in der Topologie gespeicherte Wert anhand einer externen Überschreibungstabelle überschrieben wird. Dieser Parameter kann beispielsweise verwendet werden, um Live-Daten aus externen Systemen einzugeben, wie etwa die aktuelle Position bei einem Stromnetz oder der Druckwert bei einem Gasnetz. 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. Dies ist die Standardeinstellung.
  • Nicht aktiviert: Das Netzwerkattribut unterstützt keine NULL-Werte.

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. "Ersetzung" wird nur für Netzwerkattribute vom Typ "Long Integer" unterstützt.

  • 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 Netzwerkattribut, das zur Ersetzung verwendet wird. 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 wird.

String
attribute_type

Gibt den Datentyp des Netzwerkattributs an.

  • SHORTDer Feldtyp ist "Short".
  • LONGDer Feldtyp ist "Long".
  • DOUBLEDer Feldtyp ist "Double".
  • DATEDer Feldtyp ist "Datum".
  • BIGINTEGERDer Feldtyp ist "Big Integer".
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 benutzerdefinierte Inline-Netzwerkattribute ist auf 25 pro Versorgungsnetz beschränkt. Speichern Sie die am häufigsten verwendeten Netzwerkattribute (z. B. "Phase" bei Stromnetzen, "Druck" bei Gas- und Wassernetzen) als Inline-Attribute, sofern möglich. Die Größe der Bits wird durch den Domänenparameter bestimmt. Inline-Attribute werden nur für Netzwerkattribute vom Typ "Integer" ("Short" oder "Long") 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.

Das Verhalten "Aufteilbar" wird nur für Netzwerkattribute Typ "Double" unterstützt. 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 shape_length-Netzattribut und ein Linien-Feature aus fünf Kantenelementen von je 20 Metern besteht und die Gesamtlänge dieses Linien-Features 100 Meter beträgt, wird das Attribut auf alle Kanten aufgeteilt. Wenn zum Beispiel eine Funktion innerhalb einer verbundenen Verfolgung zum Zählen des Attributs shape_length für diese Linie verwendet wird, wird die Anzahl 5 zurückgegeben, da die einzelnen Kanten-Features berücksichtigt werden, nicht die gesamte Linie. 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 bei is_inline = "INLINE" erforderlich. Mit dieser Domäne wird die Anzahl an Bits festgelegt, die 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 in der aktuellen Version nicht verwendet. Eingegebene Werte werden ignoriert. Die Funktionalität dieses Parameter befindet sich derzeit in Entwicklung und ist in einer zukünftigen Version verfügbar.

Gibt an, ob der aktuell in der Topologie gespeicherte Wert anhand einer externen Überschreibungstabelle überschrieben wird. Dieser Parameter kann beispielsweise verwendet werden, um Live-Daten aus externen Systemen einzugeben, wie etwa die aktuelle Position bei einem Stromnetz oder der Druckwert bei einem Gasnetz. 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. Dies ist die Standardeinstellung.
  • NOT_NULLABLEDas Netzwerkattribut unterstützt keine NULL-Werte.
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. "Ersetzung" wird nur für Netzwerkattribute vom Typ "Long Integer" unterstützt.

  • 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 Netzwerkattribut, das zur Ersetzung verwendet wird. 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.un.AddNetworkAttribute("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.un.AddNetworkAttribute("Utility Network", 
                             "Phases", "LONG", "NOT_INLINE", 
                             "NOT_APPORTIONABLE", 
                             "ElectricDistributionDeviceStatus", "", 
                             "NOT_NULLABLE", "SUBSTITUTION", 
                             "Phases current")

Lizenzinformationen

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

Verwandte Themen