Layout für lineare Verteilung hinzufügen (Network Diagram)

Zusammenfassung

Fügt den Algorithmus "Layout für lineare Verteilung" zur Liste der Layouts hinzu, die automatisch am Ende der Generierung von Schemas basierend auf einer bestimmten Vorlage angehängt werden sollen. Dieses Werkzeug stellt auch entsprechend dieser Vorlage die Parameter des Algorithmus "Layout für lineare Verteilung" ein.

Mit diesem Layout-Algorithmus wird der Abstand zwischen Schemaknoten erhöht, die visuell zu nahe beieinander liegen, sich überlappen oder lagegleich sind. Er verschiebt Knoten entlang ihrer verbundenen Kanten. Die Verschiebung entlang der Kanten hängt von der aktuellen und relativen Position von Knoten und von den Layout-Parametern ab.

Weitere Informationen zum Algorithmus "Layout für lineare Verteilung"

Vorsicht:

Dieses Werkzeug ist ein Konfigurations- und Verwaltungswerkzeug.

Hinweis:

Dieses Werkzeug hat Auswirkungen auf die Konsistenz aller vorhandenen Schemas, die auf der Eingabeschemavorlage basieren. Alle vorhandenen Schemas werden inkonsistent und werden beim Öffnen mit dem Konsistenzwarnsymbol Möglicherweise inkonsistent angezeigt, bis sie aktualisiert werden.

Verwendung

  • Bei Verwendung eines Utility Network-Service wird dieses Werkzeug nicht unterstützt. Sie müssen entweder ein Versorgungs- oder Verfolgungsnetz in einer File-Geodatabase oder eine Datenbankverbindung zu einem Versorgungsnetz in einer Enterprise-Geodatabase verwenden. Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss die Verbindung über den Besitzer des Datenbank-Versorgungsnetzes hergestellt werden.

  • Wenn Sie diese Operation in einem Versorgungsnetz in einer Enterprise-Geodatabase durchführen, muss das verbundene ArcGIS Enterprise-Portal-Konto der Besitzer des Portal-Versorgungsnetzes sein.

  • Das Netzwerkdaten-Element, das im Parameter "Eingabe-Netzwerk" angegeben wurde, muss aus einem Versorgungs- oder Verfolgungsnetz in einer File-Geodatabase oder einer Datenbankverbindung zu einem Versorgungsnetz in einer Enterprise-Geodatabase stammen.

  • Um die Parameter für den Layout-Algorithmus eines beliebigen Schemas basierend auf der Schemavorlage voreinzustellen, deaktivieren Sie den Parameter Aktiv (is_active = "INACTIVE" in Python).

  • Führen Sie das Werkzeug mit aktivierter Option Aktiv (Standardeinstellung) (is_active = "ACTIVE" in Python) aus, wenn Sie möchten, dass der Layout-Algorithmus der Liste der Layouts hinzugefügt wird, die automatisch am Ende der Schemaerstellung basierend auf der Eingabe-Schemavorlage verkettet werden.

Syntax

AddLinearDispatchLayout(in_utility_network, template_name, is_active, {junction_placement_type}, {is_unit_absolute}, {maximum_shift_absolute}, {maximum_shift_proportional}, {minimum_shift_absolute}, {minimum_shift_proportional}, {iterations_number}, {is_path_preserved}, {are_leaves_moved}, {are_leaves_expanded}, {expand_shift_absolute}, {expand_shift_proportional})
ParameterErklärungDatentyp
in_utility_network

Das Versorgungs- oder Verfolgungsnetz, das die zu ändernden Schemavorlagendefinitionen referenziert.

Utility Network; Trace Network
template_name

Der Name der zu ändernden Schemavorlage.

String
is_active

Gibt an, ob der Layout-Algorithmus automatisch ausgeführt wird, wenn Schemas basierend auf einer angegebenen Vorlage erstellt werden.

  • ACTIVEDer hinzugefügte Layout-Algorithmus wird automatisch während der Erstellung eines beliebigen Schemas ausgeführt, das auf dem Parameter template_name basiert. Dies ist die Standardeinstellung.Die für den Layout-Algorithmus angegebenen Parameterwerte entsprechen den Werten, die zum Ausführen des Layouts während der Schemaerstellung verwendet werden. Sie werden darüber hinaus standardmäßig geladen, wenn der Algorithmus für ein beliebiges Schema basierend auf der Eingabevorlage ausgeführt wird.
  • INACTIVEAlle derzeit für den hinzugefügten Layout-Algorithmus angegebenen Parameterwerte entsprechen den Werten, die standardmäßig geladen werden, wenn der Algorithmus für beliebige Schemas basierend auf der Eingabevorlage ausgeführt wird.
Boolean
junction_placement_type
(optional)

Gibt an, wie die Knoten verschoben werden.

  • EQUAL_DISTANCEAlle Knoten mit zwei verbundenen Kanten werden so verschoben, dass die Abstände zwischen ihnen und ihren zwei verbundenen Knoten gleich sind. Dies ist die Standardeinstellung.
  • USER_DEFINE_DISTANCEAlle Knoten mit zwei verbundenen Kanten werden so verschoben, dass sich ein Mindestabstand (Parameterwert für minimum_shift_) zwischen ihnen und dem anderen Ende der mit ihnen verbundenen Kanten ergibt. Diese Verschiebung wird am Ende der Layout-Ausführung durchgeführt.
  • ITERATIVE_DISTANCEAlle Knoten mit zwei verbundenen Kanten werden geringfügig entsprechend den Parameterwerten iterations_number und maximum_shift_ verschoben.
String
is_unit_absolute
(optional)

Gibt an, wie Parameter, die Abstände darstellen, interpretiert werden.

  • ABSOLUTE_UNITDer Layout-Algorithmus interpretiert alle Entfernungswerte als lineare Einheiten.
  • PROPORTIONAL_UNITDer Layout-Algorithmus interpretiert alle Entfernungswerte als relative Einheiten für eine Abschätzung des Durchschnitts für die Knotengrößen in der aktuellen Schemaausdehnung. Dies ist die Standardeinstellung.
Boolean
maximum_shift_absolute
(optional)

Die maximale Entfernung, mit der die Knoten mit zwei Verbindungen von den Knoten aus verschoben werden, mit denen sie verbunden sind. Der Standardwert beträgt 2 Einheiten im Koordinatensystem des Schemas. Sobald diese Entfernung erreicht ist, werden die Knoten bei folgenden Iterationen nicht mehr verschoben. Dieser Parameter kann nur verwendet werden, wenn Sie den Knotenplatzierungstyp ITERATIVE_DISTANCE und absolute Einheiten verwenden.

Linear Unit
maximum_shift_proportional
(optional)

Die maximale Entfernung, mit der die Knoten mit zwei Verbindungen von den Knoten aus verschoben werden, mit denen sie verbunden sind. Die Standardeinstellung ist 2. Sobald diese Entfernung erreicht ist, werden die Knoten bei folgenden Iterationen nicht mehr verschoben. Dieser Parameter kann nur verwendet werden, wenn Sie den Knotenplatzierungstyp ITERATIVE_DISTANCE und proportionale Einheiten verwenden.

Double
minimum_shift_absolute
(optional)

Die minimale Entfernung, die jeden Knoten mit zwei verbundenen Kanten nach der Layout-Ausführung von den zugehörigen Kantenenden trennt. Der Standardwert beträgt 2 Einheiten im Koordinatensystem des Schemas. Wenn dieser Parameterwert zu groß ist, werden die Knoten mit zwei Verbindungen so verschoben, dass die Entfernungen zwischen jedem verschobenen Knoten und den zugehörigen Kantenenden entlang dem durch die zwei verbundenen Kanten definierten Pfad gleich sind. Dieser Parameter kann nur verwendet werden, wenn Sie den Knotenplatzierungstyp USER_DEFINE_DISTANCE und absolute Einheiten verwenden.

Linear Unit
minimum_shift_proportional
(optional)

Die minimale Entfernung, die jeden Knoten mit zwei verbundenen Kanten nach der Layout-Ausführung von den zugehörigen Kantenenden trennt. Die Standardeinstellung ist 2. Wenn dieser Parameterwert zu groß ist, werden die Knoten mit zwei Verbindungen so verschoben, dass die Entfernungen zwischen jedem verschobenen Knoten und den zugehörigen Kantenenden entlang dem durch die zwei verbundenen Kanten definierten Pfad gleich sind. Dieser Parameter wird verwendet, wenn Sie den Knotenplatzierungstyp USER_DEFINE_DISTANCE und proportionale Einheiten verwenden.

Double
iterations_number
(optional)

Die Anzahl der zu verarbeitenden Iterationen. Die Standardeinstellung ist 5. Dieser Parameter kann nur verwendet werden, wenn Sie den Knotenplatzierungstyp ITERATIVE_DISTANCE verwenden.

Long
is_path_preserved
(optional)

Gibt an, wie die Stützpunkte entlang der Kanten verarbeitet werden.

  • PRESERVE_PATHAlle Stützpunkte entlang der verbundenen Kanten werden beibehalten, neue Stützpunkte werden an den ursprünglichen Positionen der verschobenen Knoten hinzugefügt. Dies ist die Standardeinstellung.
  • IGNORE_PATHDie Stützpunkte entlang der Kanten werden nicht beibehalten.
Boolean
are_leaves_moved
(optional)

Gibt an, ob Blattknoten – Knoten mit einer Verbindung – während der Ausführung des Algorithmus verschoben werden:

  • MOVE_LEAVESBlattknoten werden verschoben.
  • DO_NOT_MOVE_LEAVESBlattknoten werden nicht verschoben. Dies ist die Standardeinstellung, es sei denn, das angegebene Eingabe-Netzwerkschema basiert auf einer Vorlage, für die der Algorithmus "Layout für lineare Verteilung" mit einem anderen Parameterwert konfiguriert wurde.
Boolean
are_leaves_expanded
(optional)

Gibt an, ob Blattknoten erweitert werden:

  • EXPAND_LEAVESBlattknoten werden erweitert. Der Parameterwert expand_shift_absolute gibt die maximale Entfernung an, um die diese Blattknoten von den Knoten aus erweitert werden können, mit denen sie verbunden sind.
  • DO_NOT_EXPAND_LEAVESBlattknoten werden nicht erweitert. Dies ist die Standardeinstellung, es sei denn, das angegebene Eingabe-Netzwerkschema basiert auf einer Vorlage, für die der Algorithmus "Layout für lineare Verteilung" mit einem anderen Parameterwert konfiguriert wurde.
Boolean
expand_shift_absolute
(optional)

Die maximale Entfernung, um die Blattknoten von den Knoten aus erweitert werden, mit denen sie verbunden sind. Der Standardwert beträgt 2 Einheiten des Koordinatensystems des Schemas, es sei denn, das angegebene Eingabe-Netzwerkschema basiert auf einer Vorlage, für die der Algorithmus "Layout für lineare Verteilung" mit einem anderen Parameterwert konfiguriert wurde. Sobald diese Entfernung erreicht ist, werden die Blattknoten bei folgenden Iterationen nicht mehr verschoben. Dieser Parameter kann nur verwendet werden, wenn Sie den Knotenplatzierungstyp Blätter erweitern und absolute Einheiten verwenden.

Linear Unit
expand_shift_proportional
(optional)

Die maximale Entfernung, um die Blattknoten von den Knoten aus erweitert werden, mit denen sie verbunden sind. Der Standardwert beträgt 2, es sei denn, das angegebene Eingabe-Netzwerkschema basiert auf einer Vorlage, für die der Algorithmus "Layout für lineare Verteilung" mit einem anderen Parameterwert konfiguriert wurde. Sobald diese Entfernung erreicht ist, werden die Blattknoten bei folgenden Iterationen nicht mehr verschoben. Dieser Parameter kann nur verwendet werden, wenn Sie den Knotenplatzierungstyp Blätter erweitern und proportionale Einheiten verwenden.

Double

Abgeleitete Ausgabe

NameErklärungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz oder Verfolgungsnetz.

Versorgungsnetz, Verfolgungsnetz
out_template_name

Der Name der Schemavorlage

Zeichenfolge

Codebeispiel

AddLinearDispatchLayout – Beispiel (Python-Fenster)

Mit diesem Beispielskript wird der für ein Eingabe-Netzwerk bestehenden Vorlage "MyTemplate1" der Algorithmus "Layout für lineare Verteilung" als automatisches Layout hinzugefügt.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddLinearDispatchLayout_nd(input_Network, input_DiagramTemplate, 
                                 "ACTIVE", "ITERATIVE_DISTANCE", "ABSOLUTE_UNIT", 
                                 "15 Feet", "", "2 Feet", "", 10, "PRESERVE_PATH", 
                                 "DO_NOT_MOVE_LEAVES", "DO_NOT_EXPAND_LEAVES", 
                                 "2 Feet", 2)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen