Chapter 2. Graphic Interface

Table of Contents

1. Main window : Menus
2. Main window : Tools bar
3. Graph Editor
Property
Element
Hierarchy
4. View Editor
5. Standard views
Node Link Diagram view
Table view

1. Main window : Menus

The main window of Tulip software is composed of several subwindows and a menu bar :

  • File: this menu is used for usual file operations :

    • New (Ctrl+N, APPLE+N on Mac),

    • Open (Ctrl+O, APPLE+0 on Mac),

    • Save (Ctrl+S, APPLE+S on Mac),

    • Save As (Ctrl+Shift+S, APPLE+Shift+S on Mac),

    • Print (Ctrl+P, APPLE+P on Mac),

    • Close Tab,

    • Exit(Ctrl+Q, APPLE+Q on Mac).

    Others are added:

    • Import : this submenu is populated by import plugins.

      • File : Plugins allowing importation of graph files in different format such as Adjacent Matrix, gml, dot (graphviz), or tlp (tulip default file format).

      • Graph : Plugins allowing the creation of randomly generated graphs of different types.

      • Misc : Plugins to capture the tree structure of a file system directory, or the graph structure of a web site.

    • Export: this submenu is populated by export plugins allowing to save a tulip graph accordingly to a specified format. By default Tulip is able to export in GML and TLP formats.

  • Edit: this is composed of tools affecting the selected elements:

    • Cut (Ctrl+X, APPLE+X on Mac),

    • Copy (Ctrl+C, APPLE+C on Mac),

    • Paste (Ctrl+V, APPLE+V on Mac),

    • Find (Ctrl+F, APPLE+F on Mac). This tool has 4 options:

      • Replace : Replace the current selection (nodes or edges already selected).

      • Add : Add the nodes (or edges) to be selected to the current selection.

      • Remove : Remove nodes (or edges) from the current selection.

      • Intersect : Select the intersection between the nodes (or edges) TO BE selected, and the ones from the current selection.

    • Select All (Ctrl+A, APPLE+A on Mac),

    • Delete selection (Del),

    • Deselect all (Ctrl+Shift+A, APPLE+Shift+A on Mac),

    • Invert Selection (Ctrl+I, APPLE+I on Mac).

    This menu contains also:

    • Create group (Ctrl+G, APPLE+G on Mac),

    • Create subgraph (Ctrl+Shift+G, APPLE+Shift+G on Mac),

    • Undo (Ctrl+Z, APPLE+Z on Mac),

    • Redo (Ctrl+Y, APPLE+Y on Mac).

  • Algorithm: this one is divided in several parts to make a difference between the kind of algorithms you can apply. These are:

    • Selection: this submenu is populated by 'selection' algorithms. These algorithms allows to select nodes and or edges (assign the 'viewSelection' property see Section 3, “Properties of graph” for more details) satifying some criteria. For example the 'Loop Selection' algorithm detects all edges for which the starting and ending nodes are the same.

    • Color: this submenu is populated by 'color' algorithms. This kind of algorithm computes the color (the 'viewColor' property see Section 3, “Properties of graph” for more details ) of the graph elements. A default one, 'Metric Mapping', is provided; it allows to color all graph elements according to a metric property.

    • Measure: this submenu is populated by 'metric' algorithms. These algorithms allows to compute and assigned a value to the 'viewMetric' property of graph elements see Section 3, “Properties of graph” for more details. For example, when running the 'Degree' algorithm, the degree (the number of its neighbors) is compute and assigned to each graph node 'viewMetric' property.

    • Layout: this submenu is populated by 'layout' algorithms which allow to display graphs using different types of drawings. For example, the 'Circular' algorithm places all nodes of a graph along a circle.

      Before :

      After :

    • Size: this submenu is populated by 'size' algorithms which allow to compute the size (the 'viewSize' property see Section 3, “Properties of graph” for more details) of the graph elements.

    • General: this submenu is populated by more general algorithms for computing properties, subgraphs, quotient graphs, groups... For example the 'Equal Value' algorithm create subgraphs for which the included elements have the same value for a choosed 'metric' property.

    For more information please visit Section 2, “Algorithms”

  • Graph : This menu is composed of 2 sub menus :

    • Tests: This sub menu contains tools able to say if the graph obey some constraints :

      • Simple : Is the Graph Simple ? For more information please visit : Wikipedia: Simple graphs

      • Directed Tree : A directed tree is a directed graph which would be a tree if the directions on the edges were ignored. Some authors restrict the phrase to the case where the edges are all directed towards a particular vertex, or all directed away from a particular vertex.

        For more information please visit : Wikipedia: Directed Tree

      • Free Tree: A tree without any designated root is called a free tree.

        For more information please visit : Wikipedia: Simple graphs

      • Acyclic : A graph is acyclic if it contains no cycle. A cycle is a path that as the same source and target.

        For more information please visit : Wikipedia: Acyclic graphs

      • Connected : A graph is called connected if every pair of vertices in the graph is connected. For more information please visit :

        Wikipedia: Connectivity

      • Bi-connected : A connected graph is biconnected if the removal of any single node and his out edges can not disconnect the graph.

        For more information please visit :Wikipedia: Biconnected Graphs

      • Tri-connected : If it is always possible to establish a path from any node to an other one even after removing any 2 nodes, then the graph is said to be Tri-connected. For more information please visit : Wikipedia: k-connected graphs

      • Planar : A graph is said to be planar if it can be drawn on the (Euclidean) plane without any edges crossing. For more information please visit : Wikipedia : Planar Graphs

      • Outer Planar : A graph is said to be outer planar if it has an embedding in the plane such that its nodes lie on a fixed circle and its edges lie inside the disk without any crossing. For more information please visit : Wikipedia : Outerplanar Graphs

    • Modify : Those operations will modify the entire structure of a graph .

      • Make Simple : This algorithm will change the graph to make it a simple graph. For more information please visit : Wikipedia: Simple graphs

      • Make Acyclic : A graph is acyclic if it contains no cycle. A cycle is a path that as the same source and target. For more information please visit : Wikipedia: Acyclic graphs

      • Make Connected : A graph is said to be connected if every pair of vertices in the graph is connected. For more information please visit : Wikipedia: Connectivity

      • Make Bi-connected : For more information please visit : Wikipedia: Biconnected Graphs

      • Make directed : If the graph is a free tree, make it directed. If only one node is selected, this one will be considered as the root node. If none is selected, Tulip will heuristically choose the center of the graph as the root node. For more information please visit : Wikipedia: Directed Tree

      • Reverse selected edges : Exchange source and target of an edge.

    View: this menu display all available view types. Click on one and a new view on the current graph will be created (Section 5, “Standard views” )

  • Windows: this menu contains two options for the management of the views in the workspace : cascade or tile mode.

  • Options: this menu allows to enable/disable the display options and show Graph/View editor widget:

    • Display options :

      • Force ratio : Tries to keep a good Height/Width ratio for the layout of the graph.

      • Map metric : Applies the Color / Metric Mapping algorithm, whenever, a measure algorithm has been run.

      • Morphing : Enables the Morphing from a layout to an other.

    • Show Graph/View editor : if you close Graph/View editor tab on left dock widget, you can show it by this menu

  • Help: in this menu, you can find informations about the software and the way to make your first steps.