Quick Links
Tools
Instructions:
Please download the tool and the data for the programs that you would like to visualize. The Tool is a JAR file and to run the tool on the command line use the following:
java -jar Viz.jar
Once the tool starts click on file chooser to browse through the directories to get to the direcotry holding the source data for the program your are interested in visualizing. Select the file named "updated_max-cluster-size-of-loc.txt". The tool will take a couple of mintues to build the cluster data and the graph information. Following which it will start the visualization by displaying control panel. The control panel is used to Control the visualization:
- Heat Map View Button is used to display the HeatMap (Colour Code)
- Project View Button open up a global view of the entire project
- Sliders lower bound and upper bound are used to set a bound on which to concentrate. This allows the user to highlight one or multiple clusters.
- Button B-SCG display the B-SCG window for the Program
- Button F-SCG display the F-SCG window for the Program
- Turning on the first check box will hide all the clusters that fall outside the range specified using the sliders.
- Turning on the second check box will hide all the lines of code which are never executed.
- Clicking on a file in the Project View opens up two more views one showing the Source Code and the other showing a Line Represtnation of the file.
- Clicking on a line in the Line View will scroll the code view to that particular source code line.
- The number below each file in the project view indicates the clusters that are present in the file. Note: numbers for only the largest 5 clusters are displayed as they are of most interest. 1 being the largest cluster and 5 the 5th largest.
Please report any problems and extensions that you feel would help to the following email address : syed.s.islam@kcl.ac.uk
Downloads:
Cluster Visualization Tool :
Source Data Download:
acct
barcode
bc
byacc
compress
ctags
diffutils-2.8.1
diffutils-2.8
ed-1.2
findutils-4.2.25
findutils-4.4.1
indent-2.2.6
time-1.7
userv-1.0.1
userv-1.0.3
wdiff
which
Scheme Script:
Scheme Script to produce the data dump from CodeSurfer-2.1 for use with CViz
To run the script after loading it call the function "(test-run)"