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- oder Trace 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 Versorgungs- oder Verfolgungsnetz in einer Enterprise-Geodatabase verwenden. Für die Verwendung einer Enterprise-Geodatabase gelten folgende Voraussetzungen:

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Netzwerk

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

Utility Network; Trace Network
Eingabe-Schemavorlage

Der Name der zu ändernden Schemavorlage.

String
Aktiv

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

  • Aktiviert: Der hinzugefügte Layout-Algorithmus wird automatisch während der Erstellung beliebiger Schemas ausgeführt, die auf dem Parameter Eingabe-Schemavorlage basieren. 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.

  • Deaktiviert: Alle derzeit für den hinzugefügten Layout-Algorithmus angegebenen Parameterwerte werden standardmäßig geladen, wenn der Algorithmus für beliebige Schemas basierend auf der Eingabevorlage ausgeführt wird.

Boolean
Knotenplatzierung
(optional)

Gibt an, wie die Knoten verschoben werden.

  • Gleiche EntfernungAlle 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.
  • Benutzerdefinierte EntfernungAlle Knoten mit zwei verbundenen Kanten werden so verschoben, dass sich ein Mindestabstand (Parameterwert für Minimale Verschiebung) zwischen ihnen und dem anderen Ende der mit ihnen verbundenen Kanten ergibt. Diese Verschiebung wird am Ende der Layout-Ausführung durchgeführt.
  • Iterative EntfernungAlle Knoten mit zwei verbundenen Kanten werden geringfügig entsprechend den Parameterwerten Anzahl der Iterationen und Maximale Verschiebung verschoben.
String
Abstandswerte, die als absolute Einheiten im Koordinatensystem des Schemas interpretiert werden
(optional)

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

  • Aktiviert: Der Layout-Algorithmus interpretiert alle Entfernungswerte als lineare Einheiten.
  • Deaktiviert: Der 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
Maximale Verschiebung
(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 Entfernung und absolute Einheiten verwenden.

Linear Unit
Maximale Verschiebung
(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 Entfernung und proportionale Einheiten verwenden.

Double
Minimale Verschiebung
(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 Benutzerdefinierte Entfernung und absolute Einheiten verwenden.

Linear Unit
Minimale Verschiebung
(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 Benutzerdefinierte Entfernung und proportionale Einheiten verwenden.

Double
Anzahl der Iterationen
(optional)

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

Long
Pfad beibehalten
(optional)

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

  • Aktiviert: Alle 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.
  • Deaktiviert: Die Stützpunkte entlang der Kanten werden nicht beibehalten.

Boolean
Blätter verschieben
(optional)

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

  • Aktiviert: Blattknoten werden verschoben.
  • Deaktiviert: Blattknoten 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
Blätter erweitern
(optional)

Gibt an, ob Blattknoten erweitert werden.

  • Aktiviert: Blattknoten werden erweitert. Der Parameterwert Verschiebung bei maximaler Erweiterunggibt die maximale Entfernung an, um die die Blattknoten von den Knoten erweitert werden können, mit denen sie verbunden sind.
  • Deaktiviert: Blattknoten 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
Verschiebung bei maximaler Erweiterung
(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
Verschiebung bei maximaler Erweiterung
(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

BeschriftungErläuterungDatentyp
Ausgabe-Netzwerk

Das aktualisierte Versorgungsnetz oder Verfolgungsnetz.

Versorgungsnetz, Verfolgungsnetz
Ausgabe-Schemavorlage

Der Name der Schemavorlage

Zeichenfolge

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

NameErläuterungDatentyp
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