task-gen.1

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
.Dd $Mdocdate: October 5, 2024 $
.Dt task-gen 1
.Os
.Sh NAME
.Nm task-gen
.Nd Generate task scenarios for attention tasks
.Sh SYNOPSIS
.Nm
.Op Fl n , -num-tasks Ns = Ns Ar NUM_TASKS
.Op Fl -stimulus-congruent Ns = Ns Ar X
.Op Fl -response-congruent Ns = Ns Ar Y
.Sh DESCRIPTION
The
.Nm
program generates a set
.Ar NUM_TASKS
Stroop Squared tasks for use with the
.Xr stroop-squared 1 ,
.Xr flanker-squared 1 ,
or
.Xr simon-squared 1
testers.
.Bl -tag -width Ds
.It Fl n , -num-tasks Ns = Ns Ar NUM_TASKS
Specify how many tasks should be generated.
.It Fl -stimulus-congruent Ns = Ns Ar X
Specify the ratio of stimulus tasks that will be congruent. Decimal between 0.0
and 1.0
.It Fl -response-congruent Ns = Ns Ar Y
Specify the ratio of responses that will be congruent. Decimal between 0.0 and
1.0
.El
.Sh EXIT STATUS
.Nm
will exit with a non-zero value in the event of an error.
.Sh FILE FORMAT
The emitted file format contains header rows marked off with the '#' followed
by one row per task. Each task row specifies the stimulus and response
configuration. The stimulus specification first indicates if the stimulus
color should be red, "1", or blue, "2", followed by "SI" for stimulus
incongruent or "SC" for stimulus congruent. For instance, the string "1SC"
would indicate the stimulus is a red colored word red. The response
specification starts with a "1" if the red option should be on the left or
a "2" if it should be on the right. Next, "RI" for response incongruent or
"RC" for response congruent. For instance, "2RI" would indicate the word
"blue" appears on the left in the color red and the word "red" appears in
the color blue on the right.
.Sh HISTORY
The
.Nm
program was first created in October of 2024. The Stroop Squared Task is from a
paper titled, "Nature and measurement of attention control" by Burgoyne et al.,
published in the Journal of Experimental Psychology: General in 2023. The DOI
for this paper is 10.1037/xge0001408
.Sh AUTHORS
.An Ron Dahlgren
.Mt ron@sw.gy