Tik-76.115 Individual Project: Guinea Pig
$Id: index.html,v 1.11 1996/04/21 18:03:59 kepa Exp $

Directory structure and files

Each test set has it's own directory where the information about the test is stored. This information contains the parameters of the test, playlists, the samples, the results and directories for individual subjects' results, playlists and personal information. The structure of the test directory is shown below.

[ Picture of directory structure ]
Figure 1. The structure of a test directory

1 · Test configuration

The file test.config contains the information needed to perform the test. It tells the type of the test, samples used, number of testees and so on. This file can be created with Test creation module.

More detailed information: Format of the test.config file

2 · Test items

Test items file contains information on how samples are used together in a test. In it the tester can generate pairs or triples of samples that form the test items. The test.items file can be generated by the Playlist creator.The test subject will give one answer for each test item during a test.

More detailed information: Format of the test.items file

3 · Playlist

The playlist is closely related with the test configuration file. It tells the order the individual test items are presented to the testee. A single test item can be, for example, a certain sample pair in the case of the AB-test. As the result of performing one test item an entry is generated in the results file. The playlist can be generated by the Playlist creator.

More detailed information: Format of the playlist
See also: Personal playlist

4 · Samples-directory

The samples directory contains the sound samples used in this test. This is only a suggested location as the file names are specified in the test configuration file and can be anywhere. The sound sample format is specified in the Sound Player documentation.

The name of the directory can be specified with the SamplesDir keyword in the test.config file.

5 · Guineapigs-directory

The guineapigs directory contains the information about the individual test subjects and their results. Each testee has a directory of its own where the data is stored. The directories are named 'gp001', 'gp002' and so on. Information stored in these directories include personal information, results and possibly a personal playlist.

The name of the directory can be specified with the GuineaPigDir keyword in the test.config file.

5.1 · Personal information

Some information about the test subject is recorded, including age, sex and name. Also comments can be included.

More detailed information: Format of the info file

5.2 · Personal playlist

The optional personal playlist specifies the presentation order of the test items for this particular subject. It has the same format at the general playlist which is also used if no personal playlist is present.

More detailed information: Format of the playlist

5.3 · Results

In the beginning (the header) the time and date and the test subject's ID are recorded.

For each test item at least the following information is recorded: the test item's number, the start time of this item and the answer time (when answer was given) and the subject's answer.

Finally a trailer may be recorded. Currently nothing is saved in the trailer.

More detailed information: Format of the results


· Document index · Guinea Pig ·