ITLACMDScientific Applications  Visualization Group
Visualization Software
Attractive Image NIST
 
Up Visualization Parallel Computing Data Mining Released Software

DiVisa




DiVisa is an application distributed here as free for download and use. As a courtesy, it is requested that credit be given to the Scientific Applications and Visualization Group at NIST.


In order to gain insight into data collected from networks and network simulations, we have developed an information visualization tool called DiVisa.

DiVisa is a multi-dimensional visualization tool developed for researchers to understand the behavior of their data. From raw data, the user can interact with the visualization in order to obtain different "points of views" and thus to extract more information from the data. Geometrical forms such as squares, ellipses or lines are associated with data and visual attributes such as position, size, shape, color, stroke are used to represent different dimensions. Indeed, the researcher can easily modify the associations between data items and visual attributes, apply mathematical functions on and between items, subset and zoom in on areas, data ranges, or times of interest, superpose curves with transparency to compare them, and animate the visualization to show time series data. Moreover, the program can read any kind of data (simulation, statistics, text or numeric, etc.), and converters have been implemented to read several data formats without need for reformatting.

 Figure 1: One frame from an animated visualization of a simulation of the "Abilene" network. On the left panel, the innermost nodes are the backbone routers, the next ring represents the subnet routers, and the outermost ring shows the leaf routers. On the right panel, the time series curves of the routers (one is currently selected) are displayed. On the right side, different options available: numeric data display (top); superposed time series curves (middle); and diagram view (bottom).
Figure 1: One frame from an animated visualization of a simulation of the "Abilene" network. On the left panel, the innermost nodes are the backbone routers, the next ring represents the subnet routers, and the outermost ring shows the leaf routers. On the right panel, the time series curves of the routers (one is currently selected) are displayed. On the right side, different options available: numeric data display (top); superposed time series curves (middle); and diagram view (bottom).

Click to see the movie: DiVisa_08.10.01.mpeg



DiVisa can read ".csv" (Comma-Separated Values) files, in which the first line contains the names of the variables, and the other lines the values of the variables. For the variables values, lines can be added in any order, and values can be numerical or literal. You can add ".csv" files with the "Database Items" interface.

 Figure 2: Example of a valid ".csv" file for DiVisa.
Figure 2: Example of a valid ".csv" file for DiVisa.


When one or more files are added, some variables (items) have to be selected in order to launch a visualization:

(bullet) Time Item: it is the item chosen to be on the "Time Axis", as the dynamic reference item. Then the visualization could be played along this axis. (It does not have to be a real time variable);
(bullet) Id Item: it is the item chosen as the elements of the visualization. One graphical element (such as an ellipse) will be attributed to each element. In the ".csv" example above, a good Id Item could be "user";
(bullet) Visual attributes items: a visualization can be launched with only both items above, but a complete visualization need other items in order to associate visual attributes to the variables. Such an item can be associated with a visual attribute from the beginning, and then changed during the visualization. There are two types of visual attributes:
(bullet) Regular attribute: directly associated with the elements graphical symbols (position with X and Y axe, size, color, stroke size, stroke color, shape);
(bullet) Link attribute: in case of linked elements (such as nodes in a network), two more visual attributes can be associated with links graphical symbols: size and color.

The properties of the files and the items have to be set correctly in order to launch the visualization, otherwise an error could be returned.

(bullet) For the items (click on the item to see its properties):
(bullet) Name: the name used in the Visualization can be changed by the user;
(bullet) Dynamic: checked if the item depends on the "time item" chosen;
(bullet) Numeric: checked if the item is numeric only, unchecked if the values of the item are text only. In this case, an values-order can be determined by the user;
(bullet) Linked item: checked if the item is associated with a link between elements. In this case, a departure-item and a arrival-item have to be selected. The departure-item gives the starting node for each link, the arrival-item gives the ending node for each link, and the item selected gives the value;
(bullet) For the files (click on the file to see its properties): in case multiple files are selected, some items can be static (ex: position of a node in a network). Thus the dynamic property of the file containing those items has to be unchecked, and a "key item" has to be selected to link this file to the main dynamic file. A "key item" is an item containing the id of the "id item" chosen in the main file.

The visualization tabulation is divided in three parts: the left main view (in the middle), the right time view (on the right), and the menu (on the left).


The Left Main View gives a view along the X and Y axe. It displays all the elements (each represented by a graphical element such as an ellipse) at a given time. Most of the visual attributes are displayed in this view, which is updated while playing.

A Legend panel is displayed on this view in order to give a summary of the associations and to display the information specific to an element while passing the mouse on.


The Right Time View gives a view along the Y and Z (Time) axe. It displays all the elements (each represented by a line) through the time (according to the time item chosen). A blue bar indicates the current time.

A Computed Curves panel is displayed on this view: the user can choose to display some computed curves. For example, the average curve displays for each time the average of the Y item values between all elements.


The associations between the items and the visual attributes are defined in the "Parameter panel" (in the menu on the left). Each visual attribute is represented and the user can select the item he wants to associate with. Stroke is unactivated by default and could be activated by checking the box next to the "Stroke" tabulation. Visual atributes of links are activated only if there is links, ie if a linked items hav been chosen in the "Database items" tabulation.


Options are available for the visual attributes:

(bullet) Displayed range: allows the user to determine a range where elements which have values in will be displayed, and others will be hidden.
(bullet) Unlink panels (for Y Axis): The Y Axis is by default the same on the left panel (X and Y) and on the right one (Y and Z). The user can unlink both those panel and select two different Y Axis for them.
(bullet) Scale (for size): gives the value corresponding to the size of the default square displayed. The scale can be changed by the user.
(bullet) Scale (for color, stroke color and links color): gives the value corresponding to the color. When passing the mouse on the colored scale, the value corresponding to the color, according to the chosen item, is displayed.
(bullet) Shape selection (for shape): two shapes are available: ellipse and square (by default, ellipses are selected). A separating value can be selected in order to give a range for both those shapes.

This panel is used to "play" the visualization. The user can:

(bullet) play the visualization by clicking on the "play" button;
(bullet) change the speed:
(bullet) with the shortcuts button: divide or multiply speed by '2';
(bullet) manually, by entering a number in the speed box (default value is '1');
(bullet) navigate through the time axis using the knob;
(bullet) change the accuracy: the number of timesteps can be very high, and thus the number of points displayed too, especially in the right panel. This notably reduce the capacity of java to display objects in real time, and thus reduces the capacities of the program. The accuracy represents the number of timesteps used and displayed for the visualization. The default number is '50', and the user can change this value to increase/decrease displayed accuracy. Increase accuracy could slow down the program, depending on the number of elements and curves you have.

(bullet) The Navigation Panel: it gives a small view of the entire left view. The user can also use it to navigate through the left view.
(bullet) The Separating Lens: when more than one elements are displayed at the same position in the left view (same X and Y), passing the separating lens on them will separate them.
(bullet) Bar Diagram: to display elements as diagrams (long bars instead of ellipses or squares). More useful after using the "To Diagram" converter.



Version 08.10.30: DiVisa_8.10.30.jar

Additional file: KMills_config_files.zip

Updates since previous version:

(bullet) Some minor bugs fixed.

Version 08.10.01: DiVisa_8.10.01.jar

Updates since previous version:

(bullet) Some minor bugs fixed.

Version 08.09.30: DiVisa_8.9.30.jar

Updates since previous version:

(bullet) Loading time improved;
(bullet) Files selection behavior more user-friendly

Version 08.09.19: DiVisa_8.9.19.jar

Additional file: KMills_config_files.tar.gz

Updates since previous version:

(bullet) Major change: user preferences autosave (and possibility to clear them);
(bullet) The interface have been updated with icons;
(bullet) Interface in "Database items tabulation" changed;
(bullet) Converters: conversion time improved by about 50%;
(bullet) K. Mills converter: XML updated to let the user configure more options (files and nodes);
(bullet) K. Mills converter: selection behavior improved (more natural);
(bullet) K. Mills converter: interface updated;
(bullet) Diagrams converter: interface updated;
(bullet) Error Windows display: portability improved (Linux - Windows - Mac);
(bullet) Preference about font and position of the dashes improved;
(bullet) Some minor bugs fixed.

Updates for future releases:

(bullet) memory usage improvment;
(bullet) computation time improvment;

Version 08.08.29: DiVisa_8.8.29.jar

Updates since previous version:

(bullet) K. Mills converter: memory selection improved;
(bullet) K. Mills converter: bug correction while selecting a directory;
(bullet) Text displayed: portability improved (for Windows and Mac);
(bullet) Options added: possibility to change the font, location and angle of the dashes in the visualization.

Version 08.08.26: DiVisa_8.8.26.jar

Updates since previous version:

(bullet) Bug with the Time double slider (in "Parameters") fixed.
(bullet) Bug with the Accuracy slider initialisation fixed.

Version 08.08.22: DiVisa_8.8.22.jar

Updates since previous version:

(bullet) complete rebuilding of the option "Get All Curves" for an element (accessible with right-click on an element)
(bullet) K. Mills converter: modification of the access for the selected xml file/directory
(bullet) K. Mills converter: memory kept for multiple operations
(bullet) visualizations saving: "CSV saving" bug fixed and progression bar added;
(bullet) Some others minor bugs fixed.

Version 08.08.14: DiVisa_8.8.14.jar

This is the first version available on the Internet.

Updates since previous version:

(bullet) visualizations saving: only one window with all available options instead of multiple windows;
(bullet) visualizations loading: graphical change to add properly the template option selection;
(bullet) K.Mills converter: the way selections are done have been changed to give more flexibility to the user;
(bullet) Accuracy selection: the selection is done throught a spinner to give the user the option to "enter" the number.

Updates for future releases:

(bullet) memory usage improvment;
(bullet) K.Mills converter: add more flexibility to select Algorithms/Simulations/Runs;
(bullet) K.Mills converter: create a template option designed for this converter.

Visualization: Cedric Houard John G. Hagedorn Group Leader: Judith E. Terrill

For information about this application, contact Cedric Houard



Privacy Policy | Disclaimer | FOIA
NIST is an agency of the U.S. Commerce Department.
Date created: 2001-08-14, Last updated: 2011-01-12.
Contact