8.1 LM:Subject Loop

The LM:Subject Loop module is a specialized STD:For Loop which is used to generate a set of Cogsys testlists. All modules which help generate the contents of a particular testlist (as opposed to modules which need only be executed once, like reading materials from files) are added as children of the subject loop.

Note that there is no limit on the number of LM:Subject Loop modules that can appear in a Bunao script (but they can not be nested).

Enter the name of a file containing a list of filenames to generate in the the List File field. The LM:Subject Loop iterates over the list of filenames (skipping blank lines), resetting the current output file at the top of reach loop.

The current subject number is available as the predeclared Bunao variable `SUBJNUM'. The total number of subjects is available in `TOTALSUBJS'. The variable SUBJFILELIST contains the list of output files for this subject (not the full contents of the list.

In some cases, each subject will need more than one physical file generated from a single run through the loop. Use the Files per subject entry box to specify this value, filespersubj. LM:Subject Loop will then use the first filespersubj entries at the first subject's files, the second filespersubj entries at the second subject's, and so on.

The subject loop is still iterated only as many times as there are subjects. At the top of each run, the first file for the current subject is selected. The LM:Switch Output module (see section LM:Switch Output) can be used to move between the different output files for a subject within the loop.

LM:Subject Loop user interface:

LM:Subject Loop attribute list:

Attribute	Type	Default	Description
src	filename	(blank)	name of file containing the output list
filespersubj	integer	`1'	number of files per subject