JViz - A Multivariate Data Vizualization Tool written in Java

This archive contains the class files as well as the source code for JViz.  It
also includes some sample data files and UNIX and Windows scripts to run JViz.

SYSTEM REQUIREMENTS:
	Java 1.1.2 or higher required.  Java 1.1.5 or higher recommended
	Java Foundation Classes (aka Swing) version 1.0 or higher
		This is a package from Sun Microsystems and can be downloaded
		from their web site at: http://www.javasoft.com/jfc


INSTALLATION:
	Once the JViz files are unarchived, the included scripts require two
	environment varibles be set.
		JAVA_HOME - This environment variable should point to the top
			    directory of the installed JDK or JRE.

		SWING_HOME - This environment variable should point to the top
			     directory of the Swing package installation


EXAMPLES:
	Windows: Using the JRE installed in C:\jre1.1.3 and Swing installed in
		 C:\swing-1.0.1, set the following:

		 set JAVA_HOME=C:\jre1.1.3
		 set SWING_HOME=C:\swing-1.0.1

	UNIX: Using JDK installed in /usr/local/jdk1.1.5 and Swing installed
	      in /usr/local/swing-1.0, set the following:

	      setenv JAVA_HOME /usr/local/jdk1.1.5
	      setenv SWING_HOME /usr/local/swing-1.0


RUNNING JViz:
	Once setting the environment variables correctly, users should be able
	to simply execute the command:
		JViz

	In windows, this will execute a batch file which will invoke the java
	interpreter with the correct CLASSPATH.  In UNIX, this will execute a
	shell script with the correct ClASSPATH.


TROUBLESHOOTING:
	Be sure to verify the correct version of the Java Runtime Environment
	and Swing package.

	Verify the paths assigned to JAVA_HOME and SWING_HOME.

	Be aware the the batch files and script files must be in the same
	directory as the JViz.jar and Acme.jar files.  These files contain the
	class files and image files required for execution.

	If you continue to have problems please contact:
		Prof. Matthew O. Ward
		matt@wpi.edu


COMPILING:
	This distribution comes with the complete source code for JViz as well
	as compiled versions packaged into a Java Archive (.jar file).  We have
	chosen to use a package name conforming to Sun's suggestion.  It is
	edu.wpi.mqp.graphics.jviz so the source files must be located in the
	corresponding directory structure.  JViz also uses functionality from
	another package for Image to Gif conversion.  These classes are located
	in Acme.jar.  The entire package can be found at: http://www.acme.com
	
	When compiling the following must be somewhere in the CLASSPATH:
		classes.zip file from the Java Development Kit
		All the .jar files associated with the Swing package
		Acme.jar that is bundled with this distribution.