MeasTex Installation

First obtain the relevant components of the MeasTex distribution. Installation of Meastex is quite simple. For a working framework, you require only meastex_base.tar.gz and any of the texture image packages.

Installation Instructions:

Unpack the base distribution file.

    e.g.
      > gunzip meastex_base.tar.gz
      > tar xvf meastex_base.tar

    OR

      > gunzip -c meastex_base.tar.gz | tar xvf -

Build the binaries.
Change to the src directory.
```
         > cd src
```
Edit the file makedefs and change for your situation. In particular, set MEASTEX_ROOT and check CC, OPT, INSTALL. Issue the make command,
```
         > make
```
If make completed successfully and MEASTEX_ROOT is set correctly, install the binaries.
```
         > make install
```
Update your path environment.
Add the MEASTEX_ROOT/bin directory to your path.
Install any required test suites e.g. meastex_newtex.tar.gz
Test suites should be installed from the MEASTEX_ROOT directory using the same commands as Step 1 above.
```
    e.g.
      > gunzip meastex_newtex.tar.gz
      > tar xvf meastex_newtex.tar

    OR

      > gunzip -c meastex_newtex.tar.gz | tar xvf -
```
If you wish to retain existing Beta version test suites and/or algorithm results, you need only rename the directories to conform to the new directory naming conventions. The script updateFromBeta is provided to assist you. This script checks your existing directories and creates a command file with "mv" statements for each directory which may need renaming. Before running this command file you must check that every move operation is appropriate.

NOTE: The newTex and visTex distributions require further installation to build the suites. Check the files imgs/_newTex/00README and imgs/visTex/00README for instructions.
Installation is now complete.

Checking the installation

A simple test suite (imgs/demo.ts) and sample results (algs/example.alg/demo.ts) have been included in the base distribution. These indicate what files are to be expected when running an algorithm. The results in (algs/example.alg/demo.ts) were obtained by using the markovClass program with the default options. That is (in the $MEASTEX_ROOT directory),

      > runalg example markovClass
      > processScores example

You may check the installation by repeating this test with a different algorithm name and comparing the results. That is,

      > runalg my_results markovClass
      > processScores my_results

You can now run the framework with existing sample algorithms and test suites or add your own algorithm.

Ian Burns burns@cs.uq.edu.au
Guy Smith guy@cs.uq.edu.au

Last Modified: Thu Sep 19 15:09:20 EST 1996