Layout 'Entlang der Hauptleitung' anwenden (Network Diagram)

Zusammenfassung

Ordnet die Netzwerkschema-Features im aktiven Schema entlang paralleler gerader Linien an.

Weitere Informationen zum Algorithmus "Layout 'Entlang der Hauptleitung'"

Vorsicht:

Wenn Sie eine Editiersitzung geöffnet haben, müssen Sie die Bearbeitungen speichern, bevor Sie dieses Werkzeug ausführen. Dadurch wird sichergestellt, dass im Schema die letzten Änderungen an der Netzwerk-Topologie in der Datenbank widergespiegelt werden. Wenn Sie die Änderungen nicht speichern, werden die Bearbeitungen nicht im Schema widergespiegelt.

Hinweis:

Jeder Layout-Algorithmus enthält standardmäßige Parameterwerte. Die standardmäßigen Parameterwerte werden verwendet, sofern nichts anderes angegeben ist. Wenn das Eingabe-Netzwerkschema auf einer Vorlage basiert, für die dieses Layout mit einem anderen Parameterwert konfiguriert wurde, wird stattdessen dieser Wert verwendet.

Verwendung

  • Dieses Werkzeug wird nicht unterstützt, wenn Sie mit einer Datenbankverbindung zu einem Versorgungs- oder Verfolgungsnetz in einer Enterprise-Geodatabase arbeiten. Sie müssen entweder den zugehörigen veröffentlichten Utility Network- oder Trace Network-Service oder ein Versorgungs- oder Verfolgungsnetz in einer File-Geodatabase verwenden.

  • Der Eingabe-Netzwerkschema-Layer muss aus einem Versorgungs- oder Verfolgungsnetz in einer File-Geodatabase oder einem Netzwerkschema-Service stammen.

  • Dieses Layout ordnet die Netzwerkschema-Features im aktiven Schema entlang von parallelen, geraden Linien an. Dabei weisen alle verbundenen Kanten denselben Attributwert auf. Die Verzweigungen dieser Linien werden so platziert, dass die Richtungen in Bezug auf die geraden Linien beibehalten werden. Die Entfernungen bleiben dabei proportional zur ursprünglichen Entfernung und relativ zueinander.

  • Dieser Algorithmus erfordert Netzwerkattribute mit bestimmten Werte in den Netzwerk-Linienklassen, um die Kanten zu identifizieren, aus denen alle geraden Linien bestehen, und um jede Kante zu klassifizieren, damit sie während des Prozesses priorisiert oder ausgeschlossen wird.

  • Dieses Layout kann auf alle Daten angewendet werden, die parallele Linien referenzieren, auch wenn es nicht für Bahngleise vorgesehen war.

  • Stamm-Flags können festgelegt werden, um die Punkte der Knoten anzugeben, bei denen die geraden Linien beginnen. Wenn kein Stamm festgelegt ist, sucht der Algorithmus zunächst nach Knoten, die mit einer einzelnen Kante verbunden sind und als Startpunkt für eine gerade Linie betrachtet werden können. Unter diesen infrage kommenden Knoten ist der Stammknoten derjenige, bei dem die längste gerade Linie beginnt.

  • Bei der Arbeit in sehr großen Schemas empfiehlt es sich, das Layout im asynchronen Modus auf dem Server anzuwenden.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Netzwerkschema-Layer

Das Netzwerkschema, auf das das Layout angewendet wird.

Diagram Layer
Linienattribut

Der Name des Netzwerkattributs, das zum Identifizieren der Linien verwendet wird, aus denen die geraden Linien zusammengesetzt sind. Dieses Netzwerkattribut muss in den Netzwerk-Linienklassen vorhanden sein. Die jeweiligen Werte müssen für alle Kanten, aus denen eine gerade Linie besteht, gleich sein, z. B. Linie 1, Linie 2 usw.

String
Richtung
(optional)

Gibt die Richtung der Hauptleitung an.

  • Von links nach rechtsDie Hauptleitung wird als horizontale Linie dargestellt, die links beginnt und rechts endet. Dies ist die Standardeinstellung.
  • Von oben nach untenDie Hauptleitung wird als vertikale Linie dargestellt, die oben beginnt und unten endet.
String
Versatz zwischen Verzweigungen
(optional)

Der Abstand zwischen zwei benachbarten Verzweigungen entlang der Achse rechtwinklig zur Richtung der Linien.

Linear Unit
Teilungspunktwinkel (in Grad)
(optional)

Der Winkel, der verwendet wird, um den Teilungspunkt auf den Verzweigungen zu positionieren. Hierbei handelt es sich um einen Wert zwischen 30 und 90 Grad, der zur Berechnung dieser Position mit dem Parameterwert Versatz zwischen Verzweigungen kombiniert wird. Wenn der Wert für den Teilungspunktwinkel 90 Grad beträgt, werden die einzelnen Verzweigungen orthogonal angezeigt.

Double
Typattribut
(optional)

Der Name des Netzwerkattributs, das zum Qualifizieren der Linien verwendet wird. Dieses Netzwerkattribut kann in den Netzwerk-Linienklassen vorhanden sein.

Hinweis:

Die Parameterwerte Typattribut und Linienattribut können identisch sein.

String
Hauptleitungswerte
(optional)

Die Werte des Typattributs, die die Hauptleitungen kennzeichnen. Wenn Werte dieser Art vorhanden sind, müssen sie für alle Kanten, aus denen die Hauptleitungen bestehen, identisch sein. Dabei spielt es keine Rolle, welchen Network-Feature-Linien-Classes oder Kanten-Objekttabellen sie angehören.

Value Table
Verzweigungswerte
(optional)

Die Werte des Typattributs, die die Verzweigungen kennzeichnen.

Value Table
Ausgeschlossene Werte
(optional)

Die Typattribut-Werte, die die Kanten kennzeichnen, die aus den geraden Linien ausgeschlossen werden (Übergänge oder Gitterlinien).

Value Table
Komprimierung entlang der Richtung
(optional)

Gibt an, ob das Diagramm komprimiert wird.

  • Aktiviert: Es erfolgt eine Komprimierung. Am Ende des Vorgangs wird ein zusätzlicher Schritt ausgeführt, um die Abstände zwischen benachbarten Gruppen von Nachbarknoten entlang der Richtung zu reduzieren, während gleichzeitig die relative Position zwischen diesen Gruppen beibehalten wird. Nachbarknoten sind Knoten, die geografisch nah beieinander liegen, ohne direkt verbunden zu sein.
  • Deaktiviert: Es wird keine Komprimierung verwendet. Dies ist die Standardeinstellung.

Boolean
Verhältnis (%)
(optional)

Ein Wert zwischen 0 und 100, der nach dem Subtrahieren des Mindestabstands der Länge einer Kante auf die Länge der Kante angewendet wird. Wenn der Wert für Verhältnis (%) 100 beträgt, entspricht der Abstand zwischen den einzelnen erkannten Knotengruppen dem Mindestabstand.

Double
Mindestabstand
(optional)

Der Mindestabstand zwischen zwei benachbarten Gruppen von Nachbarknoten. Dieser Mindestabstand wird auch verwendet, um Nachbarknoten in Bezug auf ihre Projektion entlang der Richtungsachse zu gruppieren. Zwei an dieser Achse projizierte Knoten gehören derselben Gruppe an, wenn der Abstand zwischen den beiden projizierten Punkten kleiner als dieser Abstand ist.

Linear Unit
Ausrichtungsattribut
(optional)

Der Name des Netzwerkattributs, das zum Ausrichten von geteilten Linien verwendet wird. Der Algorithmus richtet Linien mit demselben Attributwert aus.

String
Initiale Abstände
(optional)

Gibt an, wie die Länge der Schemakanten bewertet wird. Diese Länge bestimmt die Positionen der Knoten entlang der Richtung. Die Abstände zwischen den verbundenen Knoten entlang der Richtung sind nicht äquidistant. Vielmehr sind sie relativ zueinander und hängen von der aktuellen Kantenlänge und der Länge der kürzesten Kante ab.

  • Über aktuelle Kantengeometrie Diese Abstände werden über die aktuelle Kantengeometrie berechnet. Dies ist die Standardeinstellung.
  • Über AttributkanteDie Abstände werden über ein gegebenes Attribut berechnet, das auf einer Kante vorhanden ist.
String
Längenattribut
(optional)

Das Netzwerkattribut, über das die Abstände berechnet werden, wenn der Wert für Initiale Abstände dem Wert für Über Attributkante entspricht.

String
In asynchronem Modus auf dem Server ausführen
(optional)

Gibt an, ob der Layout-Algorithmus asynchron oder synchron auf dem Server ausgeführt wird.

  • Aktiviert: Der Layout-Algorithmus wird asynchron auf dem Server ausgeführt. Diese Option weist Serverressourcen an, den Layout-Algorithmus mit einem längeren Timeout auszuführen. Die asynchrone Ausführung ist empfehlenswert, wenn zeitintensive Layouts (z. B. teilweise überlappende Kanten) ausgeführt werden, die ansonsten das Serverzeitlimit überschreiten würden und auf große Schemas (mehr als 25.000 Features) angewendet werden.
  • Deaktiviert: Der Layout-Algorithmus wird synchron auf dem Server ausgeführt. Er kann vor dem Abschluss des Vorgangs fehlschlagen, wenn für die Ausführung das Service-Timeout (standardmäßig 600 Sekunden) überschritten wird. Dies ist die Standardeinstellung.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Netzwerkschema

Das aktualisierte Netzwerkschema.

Schema-Layer

arcpy.nd.ApplyRelativeMainlineLayout(in_network_diagram_layer, line_attribute, {mainline_direction}, {offset_between_branches}, {breakpoint_angle}, {type_attribute}, {mainline_values}, {branch_values}, {excluded_values}, {is_compressing}, {compression_ratio}, {minimal_distance}, {alignment_attribute}, {initial_distances}, {length_attribute}, {run_async})
NameErläuterungDatentyp
in_network_diagram_layer

Das Netzwerkschema, auf das das Layout angewendet wird.

Diagram Layer
line_attribute

Der Name des Netzwerkattributs, das zum Identifizieren der Linien verwendet wird, aus denen die geraden Linien zusammengesetzt sind. Dieses Netzwerkattribut muss in den Netzwerk-Linienklassen vorhanden sein. Die jeweiligen Werte müssen für alle Kanten, aus denen eine gerade Linie besteht, gleich sein, z. B. Linie 1, Linie 2 usw.

String
mainline_direction
(optional)

Gibt die Richtung der Hauptleitung an.

  • FROM_LEFT_TO_RIGHTDie Hauptleitung wird als horizontale Linie dargestellt, die links beginnt und rechts endet. Dies ist die Standardeinstellung.
  • FROM_TOP_TO_BOTTOMDie Hauptleitung wird als vertikale Linie dargestellt, die oben beginnt und unten endet.
String
offset_between_branches
(optional)

Der Abstand zwischen zwei benachbarten Verzweigungen entlang der Achse rechtwinklig zur Richtung der Linien.

Linear Unit
breakpoint_angle
(optional)

Der Winkel, der verwendet wird, um den Teilungspunkt auf den Verzweigungen zu positionieren. Hierbei handelt es sich um einen Wert zwischen 30 und 90 Grad, der zur Berechnung dieser Position mit dem Parameterwert offset_between_branches kombiniert wird. Wenn der Wert für den Teilungspunktwinkel 90 Grad beträgt, werden die einzelnen Verzweigungen orthogonal angezeigt.

Double
type_attribute
(optional)

Der Name des Netzwerkattributs, das zum Qualifizieren der Linien verwendet wird. Dieses Netzwerkattribut kann in den Netzwerk-Linienklassen vorhanden sein.

Hinweis:

Die Parameterwerte type_attribute und line_attribute können gleich sein.

String
mainline_values
[mainline_values,...]
(optional)

Die Werte des type_attributes, die die Hauptleitungen kennzeichnen. Wenn Werte dieser Art vorhanden sind, müssen sie für alle Kanten, aus denen die Hauptleitungen bestehen, identisch sein. Dabei spielt es keine Rolle, welchen Network-Feature-Linien-Classes oder Kanten-Objekttabellen sie angehören.

Value Table
branch_values
[branch_values,...]
(optional)

Die Werte des type_attributes, die die Verzweigungen kennzeichnen.

Value Table
excluded_values
[excluded_values,...]
(optional)

Die type_attribute-Werte, die die Kanten kennzeichnen, die aus den geraden Linien ausgeschlossen werden (Übergänge oder Gitterlinien).

Value Table
is_compressing
(optional)

Gibt an, ob das Diagramm komprimiert wird.

  • USE_COMPRESSIONEs erfolgt eine Komprimierung. Am Ende des Vorgangs wird ein zusätzlicher Schritt ausgeführt, um die Abstände zwischen benachbarten Gruppen von Nachbarknoten entlang der Richtung zu reduzieren, während gleichzeitig die relative Position zwischen diesen Gruppen beibehalten wird. Nachbarknoten sind Knoten, die geografisch nah beieinander liegen, ohne direkt verbunden zu sein.
  • DO_NOT_USE_COMPRESSIONEs wird keine Komprimierung verwendet. Dies ist die Standardeinstellung.
Boolean
compression_ratio
(optional)

Ein Wert zwischen 0 und 100, der nach dem Subtrahieren des Mindestabstands der Länge einer Kante auf die Länge der Kante angewendet wird. Wenn der Wert für compression_ratio 100 beträgt, entspricht der Abstand zwischen den einzelnen erkannten Knotengruppen dem Mindestabstand.

Double
minimal_distance
(optional)

Der Mindestabstand zwischen zwei benachbarten Gruppen von Nachbarknoten. Dieser Mindestabstand wird auch verwendet, um Nachbarknoten in Bezug auf ihre Projektion entlang der Richtungsachse zu gruppieren. Zwei an dieser Achse projizierte Knoten gehören derselben Gruppe an, wenn der Abstand zwischen den beiden projizierten Punkten kleiner als dieser Abstand ist.

Linear Unit
alignment_attribute
(optional)

Der Name des Netzwerkattributs, das zum Ausrichten von geteilten Linien verwendet wird. Der Algorithmus richtet Linien mit demselben Attributwert aus.

String
initial_distances
(optional)

Gibt an, wie die Länge der Schemakanten bewertet wird. Diese Länge bestimmt die Positionen der Knoten entlang der Richtung. Die Abstände zwischen den verbundenen Knoten entlang der Richtung sind nicht äquidistant. Vielmehr sind sie relativ zueinander und hängen von der aktuellen Kantenlänge und der Länge der kürzesten Kante ab.

  • FROM_CURRENT_EDGE_GEOMETRY Diese Abstände werden über die aktuelle Kantengeometrie berechnet. Dies ist die Standardeinstellung.
  • FROM_ATTRIBUTE_EDGEDie Abstände werden über ein gegebenes Attribut berechnet, das auf einer Kante vorhanden ist.
String
length_attribute
(optional)

Das Netzwerkattribut, über das die Abstände berechnet werden, wenn der Wert für initial_distances dem Wert für FROM_ATTRIBUTE_EDGE entspricht.

String
run_async
(optional)

Gibt an, ob der Layout-Algorithmus asynchron oder synchron auf dem Server ausgeführt wird.

  • RUN_ASYNCHRONOUSLYDer Layout-Algorithmus wird asynchron auf dem Server ausgeführt. Diese Option weist Serverressourcen an, den Layout-Algorithmus mit einem längeren Timeout auszuführen. Die asynchrone Ausführung ist empfehlenswert, wenn zeitintensive Layouts (z. B. teilweise überlappende Kanten) ausgeführt werden, die ansonsten das Serverzeitlimit überschreiten würden und auf große Schemas (mehr als 25.000 Features) angewendet werden.
  • RUN_SYNCHRONOUSLYDer Layout-Algorithmus wird synchron auf dem Server ausgeführt. Er kann vor dem Abschluss des Vorgangs fehlschlagen, wenn für die Ausführung das Service-Timeout (standardmäßig 600 Sekunden) überschritten wird. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_network_diagram_layer

Das aktualisierte Netzwerkschema.

Schema-Layer

Codebeispiel

ApplyRelativeMainlineLayout – Beispiel (Python-Fenster)

Mit diesem Beispielskript wird der Algorithmus "Layout 'Entlang der Hauptleitung'" auf das Schema "Temporary Diagram" angewendet.

import arcpy
arcpy.ApplyRelativeMainlineLayout_nd("Temporary Diagram", "LineTrack", 
                                  "FROM_LEFT_RIGHT", 2, 45, "RUN_SYNCHRONOUSLY")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen