Graph topic panel

Revision as of 19:56, 26 October 2013

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.

Animation and framerate

The graph is animated by default. To stop the graph animation, the user can right click the topic panel and choose context menu option Toggle animation. Choosing the menu option while the animation is stopped, starts the animation.

Animation framerate is 25 frames per socond by default. Current real framerate is viewed at the bottom right corner of the graph topic panel. User's computer and the graph size sets limits to the real framerate.

Sometimes while viewing a large graph it may be handy to lower the framerate of the graph topic panel. Framerate is changed with the fps button widget on the right side of the panel. Framerate also affects the responsivity of user interactions. Thus, with a small framerate, moving the graph feels like a stop motion animation.

Pinning nodes

The graph is animated by default. Sometimes the user may want to lock the position of some nodes while the rest of the graph is still animated. This position locking is called pinning. To pin a node the user can right mouse click over a node, and choose menu option Pin nodes > Set selection pinned. A pinned node has an emphasized black edge.

To release pinning of a single node the user should select menu option Pin nodes > Set selection unpinned.

To pin all nodes the user should select menu option Pin nodes > Set all pinned. To release all pinned nodes the user should select menu option Pin nodes > Set all unpinned. To reverse the pinning status of all nodes the user can select menu option Pin nodes > Reverse pinning.

Filtering nodes and edges

Usually the graph becomes very dense if the user open hundreds of nodes. The user can filter out unwanted nodes with context menu options below Filter nodes and unwanted edges with context menu options below Filter edges.

To release filtered nodes the user can choose menu option Clear all node filters. Similarly, all edge filters are released by choosing a menu option Clear all edge filters. To release a specific filter, the user should use menu options below Release node filters and Release edge filters.

The user can select to view filter status top right corner of the graph topic panel by choosing a context menu option Options > View filter info. Choosing the menu option again hides filter status text.

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.

Exporting the graph

See also

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