Tree Layout

Tree layout requires a tree or a collection of trees as its input. A tree is a graph that contains no undirected cyclic edge path.

General Tab

Layout Style

The layout style determines the overall style of the resulting tree layout. The remaining option tabs allow for the configuration of the chosen layout style in more detail.

Directed
The tree will be laid out hierarchically with the root node at the top. This is a good choice for directed trees with a unique root node and a moderate number of nodes on a single hierarchy level. This layout style uses the input graph as a sketch to determine the order of siblings at a common node. This means that the order of x-coordinates of the nodes in the input graph determines the order of siblings in the resulting layout.
Horizontal-Vertical
The children of a node will be either arranged on a horizontal or on a vertical line. The edges will be routed orthogonally in a bus-like fashion. This layout can be very compact if the user has chosen the right alignment type for the children of a node. Subgraphs rooted at selected nodes will be laid out vertically. Subgraphs rooted at unselected nodes will be laid out horizontally.
Compact
Generates compact orthogonal tree drawings. As a layout constraint a preferred aspect ratio (relation of width to height) can be given. This is especially useful when the graph should fit perfectly on a page of given size.

Allow General Graphs

Whether non-tree graphs should be processed, too. (Normally, only proper tree-structured graphs are processed.)

Routing Style for Non-Tree Edges

Determines the routing style for all non-tree edges.
(Note: Tree and non-tree edges are determined automatically.)

Organic
Organic routing.
Orthogonal
Orthogonal routing.
Straight-Line
Straight-line routing.

Act on Selection Only

Whether or not to act on selected nodes and edges that are connected to selected nodes only.

Directed Tab

These options configure the layout style Directed in more detail.

Minimal Node Distance

Determines the minimal distance between the siblings of a node.

Minimal Layer Distance

Determines the minimal distance between parent and child nodes.

Orientation

Determines the main layout orientation. The layouter tries to arrange nodes in such a way that all edges point in the main layout direction.

Top to Bottom
The main layout orientation will be from top to bottom. Note that the documentation for the other layout options assumes that this default layout orientation is being used.
Bottom to Top
The main layout orientation will be from bottom to top.
Left to Right
The main layout orientation will be from left to right.
Right to Left
The main layout orientation will be from right to left.

Port Style

Determines the port assignment policy to be used.

Node Centered
Ports will be placed in the center of the corresponding nodes.
Border Centered
Ports will be placed in the center of the border of the corresponding nodes.
Border Distributed
Ports will be distributed along the border of the corresponding nodes.

Consider Node Labels

Whether or not node labels should be considered during layout calculation.

Consider Edge Labels

Whether or not edge labels should be considered during layout calculation.

Orthogonal Edge Routing

If set, all edges will be routed orthogonally in a bus-like fashion. If not set, the edges will be routed as straight-line segments.

Edge Bus Alignment

Determines the relative placement of the bus-like routing of edges that connect to child nodes.

Child Alignment

Determines the placement of same-level child nodes relative to each other. 0.0 means alignment at the top side of the nodes, 1.0 at the bottom side.

Leaf Layout Policy

This option determines the placement of leaf nodes. Leaf nodes are nodes, that have no child nodes. Depending on the selected leaf layout policy, an optimal area utilization can be achieved.

Siblings in Same Layer
This setting configures the algorithm to place siblings (leaf nodes with the same parent node) in the same layer. This means that all sibling nodes are aligned on the same horizontal line. This option is useful in order to make a graph vertically more compact.
Stacked (left)
This setting configures the algorithm for a stacked style of leaf nodes. This allows to make a graph horizontally more compact. "Left" means, that all leaf nodes are placed left of the corresponding bus axis.
Stacked (right)
This setting configures the algorithm for a stacked style of leaf nodes. This allows to make a graph horizontally more compact. "Right" means, that all leaf nodes are placed right of the corresponding bus axis.
Stacked (left and right)
This setting configures the algorithm for a stacked style of leaf nodes. This allows to make a graph horizontally more compact. "Left and right" means, that the leaf nodes are placed both left and right of the corresponding bus axis.
Stacked (auto)
This setting configures the algorithm for a stacked style of leaf nodes. This allows to make a graph horizontally more compact. The second advantage of the setting is, that it tries to balance all bus heights. For each subtree that consists of leaf nodes only, the algorithm decides about the style. Depending on the number of leaf nodes, "Stacked (right)" or "Stacked (left and right)" will be used.
All in Same Layer
This results in a Dendrogram-like style and places all leaf nodes of the tree in the same layer (one horizontal line for all leaf nodes of the tree). A Dendrogram layout is often applied in computational biology in order to show clustering of genes.

Enforce Global Layering

If set, the algorithm ensures that all nodes of same depth are placed in the same layer. This means, that all nodes which have the same distance to the root node (distance = number of edges on the shortest path connecting two nodes), are placed on the same horizontal line.
This setting is useful, if the hierarchical structure of the tree should be more distinguished.

Horizontal-Vertical Tab

These options configure the layout style Horizontal-Vertical in more detail. Subgraphs rooted at selected nodes will be laid out vertically. Subgraphs rooted at unselected nodes will be laid out horizontally.

Horizontal Spacing

The minimal horizontal distance between adjacent nodes.

Vertical Spacing

The minimal vertical distance between adjacent nodes.

Compact Tab

These options configure the layout style Compact in more detail. Children rooted at selected nodes will be laid out in vertical columns. Children rooted at unselected nodes will be laid out in horizontal rows.

Horizontal Spacing

The minimal horizontal distance between adjacent nodes.

Vertical Spacing

The minimal vertical distance between adjacent nodes.

Bend Distance

Determines the preferred minimal distance between two consecutive bends, between source port and first bend, and between target port and last bend. In other words, this settings determines the preferred minimal length for the line segments of an edge path.

Use Aspect Ratio of View

The current aspect ratio of the view will be used to determine the preferred aspect ratio of the calculated drawing.

Preferred Aspect Ratio

Determines the preferred aspect ratio (width by height) of the resulting layout. This option allows for creating layouts which for example fit perfectly onto the page of a book.

This option will only be respected if the Use Aspect Ratio of View option is disabled.