Advanced Installation

If you already have a copy of the Matrix framework that is suitable for this version of MatrixPro, you can download this type of release. If you have the matrix.jar file in the same directory as matrixpro.jar, you can start it by typing:

java -jar matrixpro.jar

In general, you can start it by typing:

java -classpath <path-of-matrix.jar>:matrixpro.jar
matrixpro.ui.MainFrame <configuration-file>

Substitute the path of the matrix.jar file for <path-of-matrix.jar> and the path and filename of the configuration file for <configuration-file>. You can get the configuration file from the download page.

The source release does not contain the Matrix framework. To be able to compile the system, you should download an appropriate version of Matrix. By default, the MatrixPro lib directory is expected to contain matrix.jar. The source release of MatrixPro is available as a gzipped TAR or as a ZIP file. To build MatrixPro you should have Apache Ant installed. The build file (build.xml) contains the following targets:

clean

Removes the compiled class files.

compile

Compiles all source code.

javadoc

Generates the Java API documentation for the system.

run

Compiles and runs the application.

manual

Compiles PDF, PS and HTML versions of the manual from L^ATEX source (L^ATEX, dvips, ps2pdf and latex2html must be in the path).

The important directories are:

build/classes

This directory contains the compiled classes, and is created only if you use the Ant build file provided with the source.

docs/javadoc

Contains the Java API documentation of the system.

docs/manual

Contains the user's manual.

lib

Empty. This directory is where the ant build file searches for the matrix.jar file.

src

Contains the source code of MatrixPro.

If you don't want to copy the matrix.jar file into the lib directory (or create a symbolic link if your file system supports them), you can modify the build.xml file. Change the value of the property named matrix.jar:

<property name="matrix.jar" value="\${lib.dir}/matrix.jar"/>

If you don't have Ant and you don't want to install it, you can try the following in the MatrixPro root directory (in Unix):

javac -classpath src:lib/matrix.jar src/*/*/*.java src/*/*/*/*.java
java -classpath src:lib/matrix.jar matrixpro.ui.MainFrame

Windows users should change the colons in the above commands to semicolons and the slashes to backslashes.