MeasTex Binaries and Scripts

The MeasTex framework is modular and simple to use. To improve the effectiveness and maintain consistency, a number of programs have been supplied. These programs (binaries and scripts) provide useful utilities and control.

Scripts

cleanalg algorithm
"clean-up" algs/algorithm.alg directory, removing .out and .score* files. This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set.

collateResults algorithm [options]
collate the .score or .score_wta files for algorithm, generating a .res or .res_wta file, respectively (depending on the wta option) for each test suite. This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set. Valid options are
See also runscore.

genAlgHTML algorithm
generate HTML file summarising results for algorithm. This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set. This script requires that collateResults has been run with argument algorithm first. See also genResHTML.

genResHTML
generate HTML file in the root/algs directory with links to all individual algorithm result HTML files (creating them if necessary by calling genAlgHTML). This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set.

processAllScores [options]
calls processScores for all valid algorithms in algs directory. This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set. Valid options are
Using the wta option with the nn option will give percentage correct results.

WARNING:
Separate result files are not generated for different normalization options.
Be Careful.

processScores algorithm [options]
calls runscore then collateResults with algorithm as argument. This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set. Valid options are
Using the wta option with the nn option will give percentage correct results.

WARNING:
Separate result files are not generated for different normalization options.
Be Careful.

runalg algorithm [command]
calls runtype for each test suite in the imgs directory. If command is not given, the command is assumed to be algorithm. This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set. The directory algs/algorithm.alg is created if it does not already exist.

runtest algorithm suite test [command]
runs command passing the test file as an argument and storing the results in the file algs/algorithm.alg/suite.ts/test.out. This script must be invoked by runtype unless the MEASTEX_ROOT environment variable has been set.

runtype algorithm suite [command]
calls runtest for each test in the imgs/suite.ts directory. This script must be invoked by runalg unless the MEASTEX_ROOT environment variable has been set.

runscore algorithm [options]
scores all .out files for algorithm, generating a .score or .score_wta file (depending on wta option) for the individual tests in each test suite by calling scoretest with the appropriate arguments. This script must be invoked in the root directory of the distribution unless the MEASTEX_ROOT environment variable has been set. Valid options are
Using the wta option with the nn option will give percentage correct results.
WARNING:
Separate result files are not generated for different normalization options.
Be Careful.
See also collateResults.


Utilities

makeBrick [options]
generate artificial brick texture files. Valid options are


makeTestFile [options] class1_ListFile class2_ListFile [ class3_ListFile ... ]
generate .Test and .Valid files for a test by selecting component images from each of the classes. The list files are usually generated by pgmshatter. Valid options (can occur anywhere in argument list) are


pgmshatter [options] origImage
"shatter" an image into smaller images. A .list file is written containing the filenames of the resulting images. Valid options are


scoretest [options] outFile validFile
scores an output (.out) file using the corresponding validation (.Valid) file. The scores are printed to standard out. Valid options are
Using the -wta option with the -nn option will give percentage correct results.

WARNING:
Separate result files are not generated for different normalization options.
Be Careful.
See also runscore.


Algorithms

NOTE: When using the multivariate Gaussian classifier in these algorithms, ensure that the total number of features is less than the number of example images for each class.
gaborClass [options] testFile
Apply Gabor convolution-based classifier to test testFile. Classification results are written to standard output. Valid options are


glcmClass [options] testFile
Apply GLCM-based classifier to test testFile. Classification results are written to standard output. Valid options are

NOTE: The glcmClass program in the beta version of the MeasTex framework (released October 1996) contained a bug in the code for creating a symmetric GLCM. This bug is fixed in the v1.0 release but results obtained with the beta version of glcmClass are invalid.

markovClass testFile
Apply Gaussian Markov Random Fields-based classifier to test testFile. Classification results are written to standard output. Valid options are


fractalClass testFile
Apply Fractal Dimension-based classifier to test testFile. Classification results are written to standard output. Valid options are



Return to MeasTex Homepage
Return to TextureSynthesis Homepage


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

Last Modified: Tue May 27 17:34:21 EST 1997