Zusammenfassung
Ordnet Schemaknoten und -kanten entlang einer Hauptleitung hierarchisch an.
Weitere Informationen zum Algorithmus "Layout für Baumstruktur entlang 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.
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.
Stamm- und Endknoten können im Schema angegeben werden, sodass der Algorithmus für das Layout für die Baumstruktur entlang von Hauptleitungen eine Hauptleitung erstellt, die am angegebenen Stammknoten beginnt und am angegebenen Endknoten endet.
- Wenn keine Stamm- und Endknoten angegeben wurden, ermittelt der Algorithmus standardmäßig den Schemaknoten, der mit dem kleinsten Index für Netzwerk-Topologien verknüpft ist. Beginnend bei diesem Knoten, der den Stamm darstellt, sucht der Algorithmus nach einer Leitung mit den meisten Kanten: die Hauptleitung.
- Wenn ein Stammknoten festgelegt wurde, ist die Hauptleitung eine der Verzweigungen mit den meisten Kanten ab diesem Stammknoten.
- Wenn Stamm- und Endknoten angegeben werden und eine Verbindung zwischen beiden besteht, ist die Hauptleitung die Verzweigung mit den meisten Schemakanten beginnend ab dem Stammknoten und endend mit dem Endknoten.
Wenn Ihr Netzwerkschema aus mehreren nicht verbundenen Schemateilen besteht, können Sie mehrere Stamm- und Endknoten festlegen, z. B. einen für jeden Teil des Schemas.
Verschiedene Knoten, die zum selben verbundenen Schemateil gehören, können ebenfalls als Stämme angegeben werden. Sie werden alle entlang der gleichen Achse rechtwinklig zur Richtung der Baumstruktur ausgerichtet und als unterschiedliche Startpunkte für eine Strukturverzweigung des Schemas angezeigt. Obwohl Sie mehrere Enden für dasselbe verbundene Schemateil angeben können, erkennt das System nur eines davon als Endknoten.
Wenn ein Endknoten, aber kein Stammknoten angegeben wird, wird der Endknoten ignoriert.
Bei der Arbeit in sehr großen Schemas empfiehlt es sich, das Layout im asynchronen Modus auf dem Server anzuwenden.
Syntax
arcpy.nd.ApplyMainlineTreeLayout(in_network_diagram_layer, {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}, {run_async}, {offset_absolute}, {offset_proportional})| Parameter | Erklärung | Datentyp |
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:
| Boolean |
tree_direction (optional) | Gibt die Richtung der Hauptleitung an.
| String |
branches_placement (optional) | Gibt an, wie Verzweigungen von der Hauptleitung relativ zu ihrer Richtung platziert werden.
| String |
is_unit_absolute (optional) | Gibt an, wie Parameter, die Abstände darstellen, interpretiert werden.
| 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.
| 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.
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:
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.
| String |
run_async (optional) | Gibt an, ob der Layout-Algorithmus asynchron oder synchron auf dem Server ausgeführt wird.
| 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
| Name | Erklärung | Datentyp |
| out_network_diagram_layer | Der aktualisierte Netzwerkschema-Layer. | Schema-Layer |
Codebeispiel
Mit diesem Beispielskript wird der Algorithmus "Layout für Baumstruktur entlang Hauptleitung" auf das Schema "Temporary Diagram" angewendet.
import arcpy
arcpy.ApplyMainlineTreeLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS",
"FROM_LEFT_TO_RIGHT", "BOTH_SIDES",
"ABSOLUTE_UNIT", "100 Feet", "" , "100 Feet",
"", "200 Feet", "", "", 30, "ORTHOGONAL_EDGES",
"RUN_SYNCHRONOUSLY", "10 Feet", "")Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja