MEASTEX INSTALLATION

Distribution Files:

The MeasTex distribution contains the following files.


    meastex_base.tar.gz - framework utility and control programs, some 
                                 sample algorithms - REQUIRED
    meastex_artbrick.tar.gz - artificial brick texture images - OPTIONAL
    meastex_artbrickL.tar.gz - artificial brick texture images (overlayed 
                                 mortar) - OPTIONAL
    meastex_vistex.tar.gz - test suite based on the VisTex Database - OPTIONAL 
    meastex_newtex.tar.gz - test suite based on the newTex Database 
    meastex_newtexRaw[A-D].tar.gz - newTex Database created by the 
                                 authors - OPTIONAL 
    meastex_brodatz.tar.gz - information about texture images from Brodatz 
                                 album - OPTIONAL 
    meastex_algs.tar.gz - our results for the sample algorithms supplied in
                                 meastex_base.tar.gz - OPTIONAL  

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:

1. 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 -

2. 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

3. Update your path environment.
    Add the MEASTEX_ROOT/bin directory to your path.

4. Install the optional packages.
    Optional packages should be installed from the MEASTEX_ROOT directory
    using the same commands as Step 1 above.

	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.

5. Installation is now complete.  


Checking the installation:

A simple test suite (imgs/demo.ts) and sample results
(algs/example/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/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.