Trial Template Legacy Options¶

For reference only - Do not use in new studies

Legacy trial templates are now deprecated and will be removed in a future version of FindingFive. All functionality offered by these trial templates can be achieved using the basic trial template, which you are encouraged to use instead.

Instruction¶

An instruction trial template is specialized in displaying a single paragraph of text that usually serves as instructions for upcoming trials.

type¶

UsageExample code

Definition: The type of trial template
Possible values: For instruction trial templates, must be specified as instruction.

"T1": {
  "type": "instruction",
  "stimuli": ["s1"]
}

stimuli¶

UsageSimple optionCustom option

Definition: A single item or multiple items specifying which stimulus or stimuli to present on the same trial. This property is similar to the "stimuli"property of the basic trial template, but it will only display stimuli specified to appear on the first trial.
Possible values: There are two ways to specify the stimuli:
a simple option that places stimuli in standard locations
a custom option that allows researchers to manipulate the locations of stimuli

Please see the following tabs for more details on each of these options!

Definition: This option defines which stimulus or stimuli to present in standard locations during instruction trials.
Possible values: A single stimulus name (e.g., ["s1"] or a nested list of stimulus names to present multiple stimuli on an instruction trial (e.g., [["s1", "s2", "s3"]]),
Example code:
```
"T1": {
  "type": "instruction",
  "stimuli": ["instruct1"]
}
```
This trial template will generate a single instruction trial with instruct1 displayed in the center of the trial.
```
"T1": {
  "type": "instruction",
  "stimuli": [["instruct1", "instruct2", "instruct3"]]
}
```
This trial template will generate a single instruction trial displaying all three stimuli (instruct1,instruct2,instruct3) at intuitive default locations chosen by FindingFive.

Definition: A dictionary of a stimulus name or names, paired with their locations in a 3x3 grid. Optionally, one can also specify whether to randomly shuffle the stimuli across the defined locations.
The 3x3 grid is organized as follows:
Possible values: A dictionary specified in the form: {"which": [LIST_OF_STIMULI], "location": [LIST_OF_LOCATIONS], "randomize_location": true or false}. Note that "randomize_location" is optional and its default value is false.
Example code: For example, to place two stimuli on a single trial so that one is at the top left corner and the other at the bottom right corner, one can specify:
```
"T1": {
  "type": "instruction",
  "stimuli": [{"which": ["instruct1", "instruct2"],
               "location": [1, 9],
               "randomize_location": true}]
}
```
Because randomize_location is specified as true, instruct1 and instruct2 will be randomly placed in the top left corner (location 1) and bottom right corner (location 9).

duration¶

UsageExample code

Definition: The amount of time to wait before automatically proceeding to the next trial. This property is recommended for instruction trials, which do not collect repsonses.
Possible values: A number of seconds (fractions are supported)

"T1": {
  "type": "instruction",
  "stimuli": [["instruct1", "instruct2", "instruct3"]],
  "duration": 1.6
}

In the above example, participants will view three stimuli in a single instruction trial for 1600 milliseconds before automatically advancing to the next trial.

AFC¶

An N alternative-forced-choice (AFC) trial template is specialized in handling alternative-forced-choice trials.

All properties are the same as the "basic" trial template. Specifying "AFC" will trigger additional semantic checks for the convenience of the researcher. In particular, an AFC trial template checks for the presence of choice responses and that each choice response has at least two choices defined.