SONIVIS User Manual

From SONIVIS:Wiki

The following page provides an overview of using SONIVIS:Tool. This tool allows users to load, analyze, and visualize virtual information spaces.

Contents 1 Concept 2 General 2.1 How to activate predefined statistics? 2.2 How to open a perspective? 2.3 How to open a view? 3 Network 3.1 How to load a network? 3.2 How to zoom in or out in a network? 3.3 How to (de)select a node? 3.4 How to show node characteristics? 4 Clustering

Concept

SONIVIS:Tool is a Java-based open source software, which is based on [Eclipse Rich Client Platform] (RCP). Eclipse was developed proprietarily by IBM and published under an open source license in 2001. RCP enables the creation of generic applications with a native graphical user interface. It offers a simple dynamic component-based model to develop plug-ins that contains the functionality of the application. The metrics are calculated by [GNU R], an open source software environment for statistical computing and graphics. SONIVIS:Tool essentially follows the model-view-controller (MVC) pattern, that means data, functionality, and user interface are separated.

To enhance the usability of SONIVIS, two different perspectives are offered: the analysis and the manipulation perspective. Each perspective contains different views, which are predefined in their position and size. Following the Eclipse approach, these views can be organized based on the user's needs.

General

How to activate predefined statistics?

Predefined statistics help to identify changes in the investigated domain quickly.

1. Choose "Window" in the main menu.
2. Select "Preferences..."

   The preference pane is organized in two parts. On the left hand side is the topic tree and the right hand side depends on your selection.

3. Click on "Statistics" and set the check mark on "Activate Statistics".

   Each created image will be saved in the folder you enter in the "Select Folder" text field. By default, images are saved in the SONIVIS folder.

How to open a perspective?

There are two perspectives in the open source version and three perspectives in the binary version available. After the first start of SONIVIS, only one perspective - the analysis perspective - is visible. The other views have to be loaded for the first time.

1. Choose "Window" in the main menu.
2. Choose "Open Perspective"
3. Click on the desired perspective.
4. You can rearrange the sequence of all perspectives using drag-and-drop.

It is also possible to define your own perspective based on your requirements. The first step is to organize the different views as you want. Then save this new defined perspective with "Save Perspective As...". This new perspective is still available after a re-start of SONIVIS.

How to open a view?

A view is typically used to show specific information, provide selection boxes, or display properties of another active view. The position of each view is freely definable. There are only few restrictions on changing the layout of a specific view. Therefore, the usage of predefined perspectives is not obligatory. Users can change the layout of the pane depending on their specific requirements.

1. Choose "Window" in the main menu.
2. Choose "Show View"
3. Click on the desired view.
4. After the view has opened you can define its position per drag and drop.

A view can be closed or reduced in size. If you want to do this please use the buttons on the top right of each view.

Network

How to load a network?

Before beginning an analysis, you should activate only the metrics that you need in the Metrics Preferences dialog. Additionally, you should limit your analyses by filtering the network by category or namespace. This can save you a lot of time.

Here is a step-by-step guide how to load a network:

1. Select a network type (mandatory).

   At the moment, there are three network types available: collaboration network, wiki-link network, and dynamic collaboration network.

2. Specify the start and end day of your network visualization (optional).

   If there is no date chosen, the starting day is 01.01.1970 and the ending day is today.

3. Select a namespace (optional).
4. Select a specific category (optional – see note above).
5. Click on the "Load Network" button.

   If a category is selected, the network is loaded by using the return key.

After loading (here you have to setup a connection to the database, see description here) the selected databases, basic domain specific measurements are conducted automatically and visualized in the characteristics view (number 1 in picture). These metrics are categorized in general domain measures and attribute measures. There is already a specification for MediaWiki.

In addition, first statistical measurements and temporal measurements are visualized graphically in the statistics view (number 1 in picture). These diagrams offer a quick overview of the existing developments in the investigated information space.

How to zoom in or out in a network?

Right-click on the network graph and drag the mouse to zoom in or out of the network graph.

How to (de)select a node?

There are two possibilities of select a node. One possibility is as follows:

1. Load a network.
2. Click on the desired node in the network. This node and all adjacent edges are highlighted.

   To unselect a node keep the control (CTRL) key pressed and click on that node again.

   You can select more the one node. During the selection process you have to keep the control (CTRL) key pressed.

You can now use the "Hide node" filter in the Network Filter view to remove the nodes visually from the network.

How to show node characteristics?

1. Choose the specific node in the network.
2. The node characteristics are shown on the right hand side in the node properties view.

   Based on your selection in the preference pages, all calculated metrics are shown.

When the network data are non-anonymous, node names are displayed as the node IDs. Furthermore the weight of the relations between the nodes is shown depending on the selected network. Simultaneously to a visualization of the network, specific metrics on the macroscopic level are measured and represented. The same applies to node metrics that describe the microscopic level. Here the user has the option to visualize the metrics in diagrams as well.

A best-of view calculates a ranking between all network nodes based on specific metrics.

Clustering

1. Load a network.

2. Choose DataMining -> Clustering.

3. Select in the following wizard your options:

Method:

1. partioning

2.hierarchical

Algorithm:

1. partioning has the following algorithms to choose from:

k-means

PAM

1. hierarchical has the following algorithms to choose from:

single linkage

complete linkage

average linkage

WARD

Parameter:

1. select one or more of the listed metrics you wish to cluster

Amount of clusters:

1. select the number of clusters you want to calculate

4. Press Finish to calculate the clusters.

The calculated clusters are shown as colored hulls in the GraphView and you also get a list of all clusters in the CLusterView.