Go to Google Home
A data-code-compute resource for research and education in information visualization
InfoVis Home Learning Modules Software Databases Compute Resources References

How to Install, Compile, and Run the XML Repository

How to Install | How to Compile | Run | Acknowledgments

How to Install

If you are taking the InfoVis course at IU then check out the repository source code by logging into 'iuni.slis.indiana.edu' and typing 'cvs -d /u4/L579 co IVR'.
Read more about Version Management with CVS if you plan to contribute new code. Currently, the command line above is all you need to get access to the most recent code.

You now have an /IVR directory in your current directory that has the following subdirectories:

/bin (contains all binary files)
/build (contains all compiled classes)
/classes (checkout the code with 'cvs -D -d /u4/L579 co IVR' and you won't get empty directories)
/docs (contains automatically generated javadoc)
/edu/iu/iv/persistence (needed by jaxb)
/lib (libraries used by the repository)
/src (source code)
/test (will contain code of unit testing)
/data (sample data sets)

Most interesting might be that the /IVR/src directory that is further divided into:

/src/com/bashpole/bUtil/ (utility code contributed by Ben Ashpole)
/src/edu/iu/iv/analysis/ (analysis algorithms such as burst, clustering, lsa, mds, topics)
/src/edu/iu/iv/layout/ (layout algorithms such as fisheye, gridl, hypertree, radialtree, simvis, som, spring, treemap)
/src/edu/iu/iv/persistence/(persistence to read and write data out - includes jaxb)
/src/edu/iu/iv/toolkit/ (the main program)
/src/edu/iu/iv/util/ (more utility programs inclusing converters that aere used to generate ListModel, MatrixModel, TreeModels, etc.)
/src/edu/umd/cs/ (diverse code from the University of Maryland such as gridl, piccolo, piccolox, temporalquery)

Please follow the links from http://iv.slis.indiana.edu/sw/ for a detailed explanation of all these analysis and layout algorithms.

The next time you check out code use 'cvs update'. With 'cvs commit' you can check the changes you made into the central IVR repository. Add and delete files with 'cvs add your.file' and 'cvs remove your.file'. All commands need to be issues from within your IVR directory structure.

How to Compile

You will need ant to compile and run the repository code. Ant is installed on ella, iuni, and on the machines in the IE Lab, Woodburn Hall 220. You can type 'ant' at the command line to see if it is installed at other machines. The code you just checked out contains a properly set up 'build.xml' and 'build.properties' file for ant in the main /IVR directory.
You can download ant at http://ant.apache.org. but you will most likely need to edit the 'build.properties' file to use your working directory and change the run target of 'build.xml'.

Make sure your java installation on linux is properly configured, i.e., it knows about classpath and where JAVA_HOME is.

To compile the IVR toolkit, you must be in the main '/IVR' directory. Then you can issue the following commands from the command line:

ant run (runs the IVToolkit)
ant compile (compiles the codebase)
ant clean (deletes all the compiled class files)
ant help (shows a list of commands you can use)

How to Run

If you are working on a Unix machine then go to the main '/IVR' directory and type 'ant run'.

If you are working on a dos machine and you are remotely loged into a unix machine, then 'ant run' won't be able to open a window. You will have to use 'run.bat' in the '/IVR/bin' directory to run the toolkit.

In both cases, the main Information Visualization Toolkit window (see below) will open. Use it to open a data set and to select algorithms for data analysis and visualization. Please follow the links from http://iv.slis.indiana.edu/sw/ for detailed explanations of the algorithms.


You may now like to load a tree data set and see different layout of it.


This documentation was compiled by Katy Börner and Bruce William Herr.

Information Visualization Cyberinfrastructure @ SLIS, Indiana University
Last Modified February 10, 2004