Layout für intelligente Baumstruktur anwenden (Network Diagram)

Zusammenfassung

Ordnet die Schema-Features hierarchisch an und platziert sie in einer intelligenten Baumstruktur.

Weitere Informationen zum Algorithmus "Layout für intelligente Baumstruktur"

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

  • Diese Werkzeug wird nicht unterstützt, wenn Sie mit einer Datenbankverbindung zu einem Versorgungsnetz in einer Enterprise-Geodatabase arbeiten. Sie müssen entweder den zugehörigen veröffentlichten Utility 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.

  • Dieser Layout-Algorithmus ordnet die Schema-Features hierarchisch an und platziert sie entsprechend der festgelegten Richtung und den Abständen in einer intelligenten Baumstruktur.

  • Wenn ein Stammknoten im Schema angegeben ist, erstellt der Algorithmus für dieses Layout eine intelligente Baumstruktur, die an diesem Knoten beginnt.

    Wenn im Schema verschiedene Stammknoten angegeben sind, werden diese Stammknoten entlang der gleichen Achse rechtwinklig zur Richtung der Baumstruktur ausgerichtet und als unterschiedliche Startpunkte für eine Strukturverzweigung des Schemas angezeigt.

    Wenn kein Stammknoten angegeben ist, ermittelt der Algorithmus den Schemaknoten, der mit dem kleinsten Index für Netzwerk-Topologien verknüpft ist, und verwendet diesen Knoten als Stammknoten.

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

Syntax

ApplySmartTreeLayout(in_network_diagram_layer, {are_containers_preserved}, {tree_direction}, {is_unit_absolute}, {subtree_absolute}, {subtree_proportional}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {are_edges_orthogonal}, {breakpoint_position}, {edge_display_type}, {run_async}, {offset_absolute}, {offset_proportional})
ParameterErklärungDatentyp
in_network_diagram_layer

Das Netzwerkschema, auf das das Layout angewendet wird.

Diagram Layer
are_containers_preserved
(optional)

Legt fest, wie der Algorithmus Container verarbeitet:

  • PRESERVE_CONTAINERS Der Layout-Algorithmus wird für den oberen Graphen des Schemas ausgeführt, sodass die Container beibehalten werden.
  • IGNORE_CONTAINERSDer Layout-Algorithmus wird für Features mit und ohne Inhalt im Schema ausgeführt. Dies ist die Standardeinstellung.
Boolean
tree_direction
(optional)

Gibt die Richtung der Baumstruktur an.

  • FROM_LEFT_TO_RIGHTDie Baumstruktur wird von links nach rechts gezeichnet. Dies ist die Standardeinstellung.
  • FROM_RIGHT_TO_LEFTDie Baumstruktur wird von rechts nach links gezeichnet.
  • FROM_BOTTOM_TO_TOPDie Baumstruktur wird von unten nach oben gezeichnet.
  • FROM_TOP_TO_BOTTOMDie Baumstruktur wird von oben nach unten gezeichnet.
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
subtree_absolute
(optional)

Der Abstand zwischen zwei benachbarten Teilstrukturen, d. h. der Abstand zwischen Schemaknoten, die rechtwinklig zur Richtung der intelligenten Baumstruktur angezeigt werden und zu einer anderen Teilstruktur gehören. Der Standardwert wird in den Einheiten des Koordinatensystems des Schemas angegeben. Dieser Parameter kann nur mit absoluten Einheiten verwendet werden.

Linear Unit
subtree_proportional
(optional)

Der Abstand zwischen zwei benachbarten Teilstrukturen, d. h. der Abstand zwischen Schemaknoten, die rechtwinklig zur Richtung der intelligenten Baumstruktur angezeigt werden und zu einer anderen Teilstruktur gehören. Die Standardeinstellung ist 2. Dieser Parameter kann nur mit proportionalen Einheiten verwendet werden.

Double
perpendicular_absolute
(optional)

Der Abstand zwischen Schemaknoten, die rechtwinklig zur Richtung der intelligenten Baumstruktur angezeigt werden und zur gleichen Teilstrukturebene gehören. Der Standardwert beträgt 2 Einheiten im Koordinatensystem des Schemas. Dieser Parameter kann nur mit absoluten Einheiten verwendet werden.

Linear Unit
perpendicular_proportional
(optional)

Der Abstand zwischen Schemaknoten, die rechtwinklig zur Richtung der intelligenten Baumstruktur angezeigt werden und zur gleichen Teilstrukturebene gehören. Die Standardeinstellung ist 2. Dieser Parameter kann nur mit proportionalen Einheiten verwendet werden.

Double
along_absolute
(optional)

Der Abstand zwischen Schemaknoten, die entlang der Richtung der intelligenten Baumstruktur angezeigt werden. Der Standardwert beträgt 2 Einheiten im Koordinatensystem des Schemas. Dieser Parameter kann nur mit absoluten Einheiten verwendet werden.

Linear Unit
along_proportional
(optional)

Der Abstand zwischen Schemaknoten, die entlang der Richtung der intelligenten Baumstruktur angezeigt werden. Die Standardeinstellung ist 2. Dieser Parameter kann nur mit proportionalen Einheiten verwendet werden.

Double
disjoined_graph_absolute
(optional)

Der Mindestabstand, der Features trennt, die zu getrennten Graphen gehören, wenn das Schema solche Graphen enthält. Dieser Parameter wird mit absoluten Einheiten verwendet. Der Standardwert beträgt 4 Einheiten im Koordinatensystem des Schemas.

Linear Unit
disjoined_graph_proportional
(optional)

Der Mindestabstand, der Features trennt, die zu getrennten Graphen gehören, wenn das Schema solche Graphen enthält. Dieser Parameter wird mit proportionalen Einheiten verwendet. Die Standardeinstellung ist 4.

Double
are_edges_orthogonal
(optional)

Gibt an, wie Schemakanten, die in Beziehung zu den Ästen der Baumstruktur stehen, angezeigt werden.

Ältere Versionen:

Dieser Parameter ist seit ArcGIS Pro 2.6 veraltet. Er wird unabhängig von seinem Wert systematisch ignoriert, wenn der Parameter edge_display_type festgelegt ist. Um die Kompatibilität mit ArcGIS Pro 2.1 zu wahren, bleibt er jedoch aktiviert, wenn der Parameter edge_display_type nicht angegeben ist.

  • ORTHOGONAL_EDGESAlle Schemakanten in Beziehung mit den Ästen der Baumstruktur werden mit rechten Winkeln angezeigt.
  • SLANTED_EDGESAlle Schemakanten in Beziehung mit den Ästen der Baumstruktur werden nicht mit rechten Winkeln angezeigt. Dies ist die Standardeinstellung.
Boolean
breakpoint_position
(optional)

Die relative Position des Teilungspunktes, der entlang der Schemakanten eingefügt wird, wenn für Kantenanzeigetyp die Option Regelmäßige Kanten (edge_display_type = "REGULAR_EDGES" in Python) oder Orthogonale Kanten (edge_display_type = "ORTHOGONAL_EDGES" in Python) festgelegt wurde. Dabei handelt es sich um einen Prozentsatz zwischen 0 und 100.

  • Bei einem Wert von 0 für "Relative Teilungspunktposition (%)" wird der Teilungspunkt auf der X-Koordinate des von der Kante ausgehenden Knotens und auf der Y-Koordinate des Zielknotens der Kante positioniert, wenn es sich um eine horizontale Baumstruktur handelt. Bei einer vertikalen Baumstruktur wird er auf der Y-Koordinate des von der Kante ausgehenden Knotens und auf der X-Koordinate des Zielknotens der Kante positioniert.
  • Bei einem Wert von 100 für "Relative Teilungspunktposition (%)" wird kein Teilungspunkt an den Schemakanten eingefügt. Jede Schemakante verbindet direkt die ausgehenden Knoten mit den Zielknoten.
  • Bei einem Wert N für "Relative Teilungspunktposition (%)" zwischen 0 und 100 wird der Teilungspunkt bei N % der Länge des Segments [XY] positioniert. Dabei entspricht X der X-Koordinate des von der Kante ausgehenden Knotens und Y der Y-Koordinate des Zielknotens der Kante, wenn es sich um eine horizontale Baumstruktur handelt. Er wird bei N % der Länge des Segments [YX] positioniert. Dabei entspricht Y der Y-Koordinate des von der Kante ausgehenden Knotens und X der X-Koordinate des Zielknotens der Kante, wenn es sich um eine vertikale Baumstruktur handelt.

Die relative Position der beiden Wendepunkte, die entlang der Schemakanten eingefügt werden, um die Geometrie von geschwungenen Kanten zu berechnen, wenn für Kantenanzeigetyp die Option Geschwungene Kanten (edge_display_type = "CURVED_EDGES" in Python) festgelegt wurde. Dabei handelt es sich um einen Prozentsatz zwischen 15 und 40. Bei einem Wert N für "Relative Teilungspunktposition (%)" zwischen 15 und 40:

  • Mit X als der X-Koordinate der vom Knoten ausgehenden Kante und Y als der Y-Koordinate der vom Knoten ausgehenden Kante für eine horizontale Baumstruktur:
    • Der erste Wendepunkt wird bei N % der Länge des [XY]-Segments positioniert.
    • Der zweite Wendepunkt wird bei (100-N) % der Länge des [XY]-Segments positioniert.
  • Mit Y als der Y-Koordinate der vom Knoten ausgehenden Kante und X als der X-Koordinate der vom Knoten ausgehenden Kante für eine vertikale Baumstruktur:
    • Der erste Wendepunkt wird bei N % der Länge des [YX]-Segments positioniert.
    • Der zweite Wendepunkt wird bei (100-N) % der Länge des [XY]-Segments positioniert.

Hinweis:

Das oben beschriebene Konzept der ausgehenden Knoten und Zielknoten ist relativ zur Richtung der Baumstruktur. Die reale Topologie des Kanten-Features oder Kantenobjekts im Netzwerk spielt dabei keine Rolle.

Double
edge_display_type
(optional)

Gibt den Anzeigetyp für die Schemakanten an, die mit den Ästen der Baumstruktur in Beziehung stehen.

  • REGULAR_EDGESAlle Schemakanten in Beziehung mit den Ästen der Baumstruktur werden nicht mit rechten Winkeln angezeigt. Dies ist die Standardeinstellung.
  • ORTHOGONAL_EDGESAlle Schemakanten in Beziehung mit den Ästen der Baumstruktur werden mit rechten Winkeln angezeigt.
  • CURVED_EDGESAlle Schemakanten, die in Beziehung mit den Ästen der Baumstruktur stehen, sind geschwungen.
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
offset_absolute
(optional)

Der zum Trennen überlappender Segmente verwendete Versatz, wenn is_unit_absolute = "ABSOLUTE_UNIT" und edge_display_type = "ORTHOGONAL_EDGES". Dieser Wert darf nicht größer als 10 Prozent des kleinsten für die anderen Abstandsparameter angegebenen Wertes sein. Die Standardeinstellung ist 0.

Linear Unit
offset_proportional
(optional)

Der zum Trennen überlappender Segmente verwendete Versatz, wenn is_unit_absolute = "PROPORTIONAL_UNIT" und edge_display_type = "ORTHOGONAL_EDGES". Dies ist ein Double-Wert, der nicht größer als 10 Prozent des kleinsten für die anderen Abstandsparameter angegebenen Wertes sein darf. Die Standardeinstellung ist 0.

Double

Abgeleitete Ausgabe

NameErklärungDatentyp
out_network_diagram_layer

Der aktualisierte Netzwerkschema-Layer.

Schema-Layer

Codebeispiel

ApplySmartTreeLayout – Beispiel (Python-Fenster)

Mit diesem Beispielskript wird der Algorithmus "Layout für intelligente Baumstruktur" auf das Schema "Temporary Diagram" angewendet.

import arcpy
arcpy.ApplySmartTreeLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS", 
                              "FROM_LEFT_TO_RIGHT", "PROPORTIONAL_UNIT", 
                              "", 8, "", 5, "", 5, "", 15, "", 70, 
                              "REGULAR_EDGES", "RUN_SYNCHRONOUSLY")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen