Tik-76.115 Individual Project: Guinea Pig
$Id: gpRunTest.html,v 1.1 1996/04/21 17:40:50 hynde Exp $

gpRunTest - program for running the test

The gpRunTest program of the Test Logic module is the program that performs the test for the test subject. Most of the functionality of the test logic is implemented in the gpTestLogic and gpTestItems python modules and the gpRunTest program is just a front end.

Starting the test

First go to the test directory where the configuration files etc. are. Then you can type:
    gpRunTest
assuming that your test configuration file's name is 'test.config'. If it isn't, use the '-f' option to specify the file's name like this:
    gpRunTest -f alt_test.config

Next the program will search for an unused guineapig ID for saving the results. It scans the GuineaPigs directory for directories that have the right kind of name and which don't already contain a 'results.raw' file. The first directory (in alphabetical order) which satisfies the test is selected as the result dir and the directory name is the guineapig ID. If there are no free directories, the program displays an error message and exits.

You can override the automatic search with the '-g' option which specifies which directory to use:

    gpRunTest -g gp023
This would select guineapig ID 'gp023' for testing if a directory with that name exists in the 'GuineaPigs' directory. If there is already a result file for that ID, it will be overwritten.

Next the program will ask the information about the subject. Pressing return for any question selects the default value (shown in paranthesis) and answering 'none' will clear the answer. After answers are given, the program asks for confirmation for the information. Answering 'n' (no) allows you to retype answers.

The test can now begin. The program asks whether you want to proceed with the test. Answering 'y' starts the test, 'n' aborts.

First the subject sets the most comfortable listening level (if enabled in test configuration) and then proceeds to the sequence of test items. (See Testee UI Manuals for information about user interfaces)

After all items are done, the test is over and the raw results file is in the subject's directory. For converting and analysing the result files, see Results processing, filtering and conversion.


· Test Logic index · Document index · Guinea Pig ·