Layout für Baumstruktur entlang Hauptleitung hinzufügen (Network Diagram)

Zusammenfassung

Fügt den Algorithmus "Layout für Baumstruktur entlang Hauptleitung" 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 Baumstruktur entlang Hauptleitung" ein.

Dieser Layout-Algorithmus ordnet die Knoten und Kanten im Eingabe-Netzwerkschema hierarchisch entlang einer Hauptleitung an und platziert seine zugehörigen Verzweigungen auf der linken Seite, auf der rechten Seite oder auf beiden Seiten der Hauptleitung.

Weitere Informationen zum Algorithmus "Layout für Baumstruktur entlang Hauptleitung"

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 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:

  • Der Parameterwert Eingabe-Netzwerk muss aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes oder als Besitzers des Datenbank-Verfolgungsnetzes hergestellt wurde.
  • Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes oder den Besitzer des Portal-Verfolgungsnetzes handeln.
  • Dieses Werkzeug muss mit der Default-Version verbunden sein, von der vorausgesetzt wird, dass sie öffentlich und nicht geschützt ist.

• 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

arcpy.nd.AddMainlineTreeLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {tree_direction}, {branches_placement}, {is_unit_absolute}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {are_edges_orthogonal}, {breakpoint_position}, {edge_display_type}, {offset_absolute}, {offset_proportional})

Parameter	Erklärung	Datentyp
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. ACTIVE —Der 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. INACTIVE —Alle 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
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_CONTAINERS —Der 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 Hauptleitung an. FROM_LEFT_TO_RIGHT —Die Hauptleitung wird als horizontale Linie dargestellt, die links beginnt und rechts endet. Dies ist die Standardeinstellung. FROM_RIGHT_TO_LEFT —Die Hauptleitung wird als horizontale Linie dargestellt, die rechts beginnt und links endet. FROM_BOTTOM_TO_TOP —Die Hauptleitung wird als vertikale Linie dargestellt, die unten beginnt und oben endet. FROM_TOP_TO_BOTTOM —Die Hauptleitung wird als vertikale Linie dargestellt, die oben beginnt und unten endet.	String
branches_placement (optional)	Gibt an, wie Verzweigungen von der Hauptleitung relativ zu ihrer Richtung platziert werden. BOTH_SIDES —Verzweigungen werden auf beiden Seiten der Hauptleitung platziert. Dies ist die Standardeinstellung. LEFT_SIDE —Verzweigungen werden nur auf der linken Seite der Hauptleitung platziert. RIGHT_SIDE —Verzweigungen werden nur auf der rechten Seite der Hauptleitung platziert.	String
is_unit_absolute (optional)	Gibt an, wie Parameter, die Abstände darstellen, interpretiert werden. ABSOLUTE_UNIT —Der Layout-Algorithmus interpretiert alle Entfernungswerte als lineare Einheiten. PROPORTIONAL_UNIT —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
perpendicular_absolute (optional)	Der Abstand zwischen Schemaknoten, die entlang der Achse rechtwinklig zur Hauptleitung angezeigt werden. Der Standardwert beträgt 2 im Koordinatensystem des Schemas. Dieser Parameter kann nur mit absoluten Einheiten verwendet werden.	Linear Unit
perpendicular_proportional (optional)	Der Abstand zwischen Schemaknoten, die entlang der Achse rechtwinklig zur Hauptleitung angezeigt werden. Die Standardeinstellung ist 2. Dieser Parameter kann nur mit proportionalen Einheiten verwendet werden.	Double
along_absolute (optional)	Der Abstand zwischen Schemaknoten, die entlang der Hauptleitung angezeigt werden, und der Abstand zwischen Schemaknoten, die entlang der Achse parallel zur Hauptleitung angezeigt werden. Dieser Parameter kann nur mit absoluten Einheiten verwendet werden. Der Standardwert beträgt 2 Einheiten im Koordinatensystem des Schemas.	Linear Unit
along_proportional (optional)	Der Abstand zwischen Schemaknoten, die entlang der Hauptleitung angezeigt werden, und der Abstand zwischen Schemaknoten, die entlang der Achse parallel zur Hauptleitung angezeigt werden. Dieser Parameter wird mit proportionalen Einheiten verwendet. Die Standardeinstellung ist 2.	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.7 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_EDGES —Alle Schemakanten in Beziehung mit den Ästen der Baumstruktur werden mit rechten Winkeln angezeigt. SLANTED_EDGES —Alle 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_EDGES —Alle Schemakanten in Beziehung mit den Ästen der Baumstruktur werden nicht mit rechten Winkeln angezeigt. Dies ist die Standardeinstellung. ORTHOGONAL_EDGES —Alle Schemakanten in Beziehung mit den Ästen der Baumstruktur werden mit rechten Winkeln angezeigt. CURVED_EDGES —Alle Schemakanten, die in Beziehung mit den Ästen der Baumstruktur stehen, sind geschwungen.	String
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

Name	Erklärung	Datentyp
out_utility_network	Das aktualisierte Versorgungsnetz oder Verfolgungsnetz.	Versorgungsnetz, Verfolgungsnetz
out_template_name	Der Name der Schemavorlage	Zeichenfolge

Codebeispiel

AddMainLineTreeLayout – Beispiel (Python-Fenster)

Mit diesem Beispielskript wird der für ein angegebenes Netzwerk bestehenden Vorlage "MyTemplate1" der Algorithmus "Layout für Baumstruktur entlang Hauptleitung" als automatisches Layout hinzugefügt.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddMainlineTreeLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "PRESERVE_CONTAINERS", 
                               "FROM_LEFT_TO_RIGHT", "BOTH_SIDES", 
                               "ABSOLUTE_UNIT", "100 Feet", "", "100 Feet", "", 
                               "200 Feet", "", "", 30, "ORTHOGONAL_EDGES", 
                               "10 Feet")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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