subtest
Experiments Surveys & forms
subtest is a pure metadata column. No display, response, randomization or logic behavior reads it. Use it to tag rows with a sub task or block label that you want copied into each saved results row for analysis.
Syntax
Section titled “Syntax”Type any label you like in the cell, for example encoding or block2. The value is never parsed, split or compared; it is copied into the results as-is.
Options
Section titled “Options”| Value | Effect |
|---|---|
| any string | Stored per trial and echoed into the results row of every saved trial. |
| empty | Nothing. |
There are no reserved values.
Defaults & missing values
Section titled “Defaults & missing values”When the column is present but a cell is left blank, that trial’s results row simply has no subtest value. When the column is absent from the uploaded trial file, it does not appear in the results output at all.
Works with
Section titled “Works with”- Saved together with all other columns when a
type=testtrial completes, when a CFPT trial completes, and when form rows are saved. Practice and learn trials do not write result rows, so theirsubtestvalues never appear in the output. - No interaction with
test,typeor any other column.
Examples
Section titled “Examples”| test | subtest | type | trialNo | stimFormat | stim1 | key |
|---|---|---|---|---|---|---|
| memory | encoding | test | 1 | word | apple | 1 |
| memory | retrieval | test | 2 | word | apple;pear | 1 |
test,subtest,type,trialNo,stimFormat,stim1,key memory,encoding,test,1,word,apple,1 memory,retrieval,test,2,word,apple;pear,1
subtest distinguishes the two phases in the results file; both rows behave identically.
Tips & gotchas
Section titled “Tips & gotchas”- Older documentation describes
subtestas a “secondary experiment identifier” that “subdivides trials within a test”. No such subdivision happens; blocks are derived from consecutivetypevalues, never fromsubtest.