Graph topic panel

Graph topic panel is one of the several available topic panels in Wandora. The graph topic panel views topics as graph nodes and associations as edges between the topic nodes. A node is a colored rectangle with topic's name. The color represents a class of the topic. The edge is a colored line between nodes. The color of the line represents association's type. Association type and roles are viewed when user takes the mouse pointer over line. If association connects more than two topics i.e. it is a hyper-edge, the line branches to each topic node. Next image views an example of graph topic panel.

The Graph topic panel is not a default visualization in Wandora and the user has add the Graph topic panel into the Wandora. A Graph topic panel is added to the Wandora by selecting a menu option View > Add topic panel > Graph topic panel. The user may add several independent graph topic panels into the Wandora. Fresh graph topic panel views current topic with it's immediate topic neighbours in the panel.

When user selects to view a topic in Graph topic panel, the topic and it's neighbors are shown. Th user may expand the initial graph by clicking the nodes or selecting the menu option Expand node in context of the node. Opening a topic with the topic tree also expands the graph with the opened topic. A node is closed by selecting the menu option Close nodes in context of the node. The user can also filter nodes. The Wandora keeps filtered nodes hidden even if the user explicitly tries to open a hidden node. Closed nodes can be opened again.

The graph topic panel doesn't allow the user to edit topic's internals. To edit topic's internal structures you need to change topic panel to Traditional or Tabbed topic panel. However, the graph topic panel allows the user to apply topic editing options to a set of node selection. These topic editing options locate in the context menu, below menu option Topics. For example, context menu option Topics > Base names > Modify base names with a regex applies given regular expression into the topic in selection and possibly alters base names.

The user can zoom in and out the graph. To zoom the graph, user should use the mouse wheel or the magnifier button widget in the buttonbar to the left of the graph.

The graph topic panel views the graph in a hyperbolic perpective. Hyperbolic perspective views nodes in the center bigger. The user can change the strength of the hyperbolic perpective. The strength, or curvature, is changed by rolling the mouse wheel while the SHILF key is pressed down. If the hyperbolic strength, curvature, is large enough, Wandora views a graph horizon, a gray circle around the graph. No node and no edge can ever cross the graph horizon. Also, the curve widget button can be used to change the hyperbolic strength.

To center the graph, the user can select context menu option Center graph or click Center current topic node button. If you have closed or filtered the current topic node, centering doesn't work.

To stop the graph animation, the user can right click the topic panel and choose context menu option Toggle animation. Coosing the menu option while the animation is stopped, starts the animation.

Usually the graph becomes very dense if the user open hundreds of nodes. The user can filter out undesired edges with edge context menu option Filter associations > Filter edges of type X where X is the association type of the current edge. Selecting context menu option Clear association filters clears all edge filters. However, Wandora doesn't view previously filtered edges automatically but user must expand nodes again to make edges visible.

Mouse modes

On the left side of the graph panel locates mouse mode buttons. A mouse mode defines how the graph topic panel interprets mouse clicks, mouse movements, and mouse drags. Available mouse modes are:

• Move mode
• Select mode
• Association mode

Move mode

While the move mode is active, the mouse moves the graph and the graph nodes.

To drag the graph, press left mouse button on the panel background, keep the mouse button down and move the mouse.

To rotate the graph, keep SHIFT key pressed while dragging the mouse over the panel background. The graph is rotated around the current node.

To move a single topic node, press left mouse button over a node, keep the mouse button down and move the mouse. Notice, the node may change it's position after you have eleased the mouse button as the graph has it's own dynamics.

To lock a position of a node on graph, select context menu option Pin nodes > Set selection pinned over the node. To release a pinned node, select context menu option Pin nodes > Set selection unpinned. Pinning and unpinning nodes works in all mouse modes.

Select mode

The select mouse mode enables the user to draw closed paths on the graph panel. The graph panel selects nodes within the closed curve. Selected nodes are colored gray-blue.

To select single node the user can also click on the node. Previous selection is cleared unless the user holds the SHIFT key pressed while clicking on the node.

To select nodes of certain type or with certain property, the user can use selection tools found in the Select menu. Available selection tools allow the user to select topics without classes or instances, for example. The select menu is available in all mouse modes.

Association mode

While the association mouse mode is active, the mouse behavior resembles move mouse mode except that clicking left mouse button over a node activates Draw association. To draw an association the user should press left mouse button over a topic node and drag the mouse over another topic node. A line is drawn from the source node to the mouse pointer during drag. When the user releases the mouse button over a node, an association editor is viewed. By default the association editor views addressed topics as association players. To create a valid association the user should choose association type and roles, and confirm association creation.

See also

• Traditional topic panel
• Tabbed topic panel
• Custom topic panel
• Treemap topic panel
• R topic panel
• Processing topic panel
• Sketch grid