MultiTaskBattery 1.3.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. MultiTaskBattery/__init__.py +4 -0
  2. MultiTaskBattery/battery.py +223 -0
  3. MultiTaskBattery/experiment_block.py +340 -0
  4. MultiTaskBattery/fetch.py +77 -0
  5. MultiTaskBattery/screen.py +152 -0
  6. MultiTaskBattery/task_blocks.py +1703 -0
  7. MultiTaskBattery/task_details.json +1047 -0
  8. MultiTaskBattery/task_file.py +1833 -0
  9. MultiTaskBattery/task_table.tsv +23 -0
  10. MultiTaskBattery/ttl_clock.py +73 -0
  11. MultiTaskBattery/utils.py +201 -0
  12. multitaskbattery-1.3.0.dist-info/METADATA +92 -0
  13. multitaskbattery-1.3.0.dist-info/RECORD +17 -0
  14. multitaskbattery-1.3.0.dist-info/WHEEL +5 -0
  15. multitaskbattery-1.3.0.dist-info/entry_points.txt +2 -0
  16. multitaskbattery-1.3.0.dist-info/licenses/LICENSE +21 -0
  17. multitaskbattery-1.3.0.dist-info/top_level.txt +1 -0
MultiTaskBattery/task_details.json ADDED
@@ -0,0 +1,1047 @@
1
+ {
2
+ "movie": {
3
+ "short_description": "Participants passively watch a 30-second movie clip (nature, animated romance, or landscape scenery) without audio or subtitles.",
4
+ "detailed_description": "Participants passively watch a single 30-second video clip per block, presented without audio or subtitles, and are instructed to keep their head still and attend to the screen; no response is required. Three clip conditions are available: 'nature' — a nature documentary clip (kickboxing kangaroos, from 'Planet Earth II: Islands'); 'romance' — an emotional love story between two characters from the Pixar movie 'Up'; and 'landscape' — an aesthetically-pleasing clip depicting diverse scenery (sourced from Vimeo). The clips of a given condition are presented in order across runs so they unfold as a continuous sequence over the session. Movie watching is a naturalistic-viewing task that engages visual and dynamic-scene processing, with the romance condition additionally recruiting social and emotional processing.",
5
+ "reference": [
6
+ "Nguyen, V. T., Sonkusare, S., Stadler, J., Hu, X., Breakspear, M., & Guo, C. C. (2017). Distinct cerebellar contributions to cognitive-perceptual dynamics during natural viewing. Cerebral Cortex, 27(12), 5652-5662.",
7
+ "King, M., Hernandez-Castillo, C. R., Poldrack, R. A., Ivry, R. B., & Diedrichsen, J. (2019). Functional boundaries in the human cerebellum revealed by a multi-domain task battery. Nature neuroscience, 22(8), 1371-1378."
8
+ ],
9
+ "task_file_columns": {
10
+ "trial_num": {
11
+ "type": "int",
12
+ "description": "Trial number (0-indexed)."
13
+ },
14
+ "trial_dur": {
15
+ "type": "float",
16
+ "description": "Duration of the trial (in seconds)."
17
+ },
18
+ "iti_dur": {
19
+ "type": "float",
20
+ "description": "Inter-trial interval after the trial (in seconds)."
21
+ },
22
+ "stim": {
23
+ "type": "str",
24
+ "description": "Movie clip filename played this trial."
25
+ },
26
+ "condition": {
27
+ "type": "str",
28
+ "description": "Clip category: 'romance', 'nature', or 'landscape'."
29
+ },
30
+ "stim_width": {
31
+ "type": "float",
32
+ "description": "Width of the pictures / clips (degrees of visual angle); height keeps the aspect ratio."
33
+ },
34
+ "start_time": {
35
+ "type": "float",
36
+ "description": "Trial start, relative to the block start (in seconds)."
37
+ },
38
+ "end_time": {
39
+ "type": "float",
40
+ "description": "Trial end, relative to the block start (in seconds)."
41
+ }
42
+ },
43
+ "conditions": "romance,nature,landscape",
44
+ "recorded_metrics": "None"
45
+ },
46
+ "oddball": {
47
+ "short_description": "Participants see a black or red 'K' or 'O' on screen and press a button only when a red 'K' appears.",
48
+ "recorded_metrics": "Accuracy + RT",
49
+ "detailed_description": "Participants see a single letter ('K' or 'O') briefly shown in either black or red on each trial. They press a button when they see a red 'K' (the infrequent target) and withhold responses to all other stimuli. The red 'K' appears on 10% of the trials, with the remaining trials split between black 'K' (40%), black 'O' (40%), and red 'O' (10%) non-targets. This task explores detection of transient responses to salient, visual oddball targets that are uncommon relative to irrelevant nontargets and distracting nontargets. The goal of the task is to activate the SAL/PMN and CG-OP networks.",
50
+ "task_file_columns": {
51
+ "key_one": {
52
+ "type": "int",
53
+ "description": "Response key to press when a red 'K' target appears."
54
+ },
55
+ "trial_num": {
56
+ "type": "int",
57
+ "description": "Trial number (0-indexed)."
58
+ },
59
+ "hand": {
60
+ "type": "str",
61
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
62
+ },
63
+ "trial_dur": {
64
+ "type": "float",
65
+ "description": "Duration of the trial (in seconds)."
66
+ },
67
+ "iti_dur": {
68
+ "type": "float",
69
+ "description": "Inter-trial interval after the trial (in seconds)."
70
+ },
71
+ "trial_type": {
72
+ "type": "int",
73
+ "description": "Whether this is the target: 1 = red 'K' (target), 0 = non-target."
74
+ },
75
+ "stim": {
76
+ "type": "str",
77
+ "description": "Stimulus shown: 'black_K', 'black_O', 'red_O', or 'red_K'."
78
+ },
79
+ "text_height": {
80
+ "type": "float",
81
+ "description": "Height of the task text (degrees of visual angle)."
82
+ },
83
+ "start_time": {
84
+ "type": "float",
85
+ "description": "Trial start, relative to the block start (in seconds)."
86
+ },
87
+ "end_time": {
88
+ "type": "float",
89
+ "description": "Trial end, relative to the block start (in seconds)."
90
+ }
91
+ },
92
+ "reference": "Du, J., DiNicola, L. M., Angeli, P. A., Saadon-Grosman, N., Sun, W., Kaiser, S., ... & Buckner, R. L. (2024). Organization of the human cerebral cortex estimated within individuals: networks, global topography, and function. Journal of neurophysiology, 131(6), 1014-1082."
93
+ },
94
+ "demand_grid": {
95
+ "short_description": "Participants see a sequence of steps that each light up boxes in a grid, mentally combine them into a single pattern, then choose which of two grids matches the full sequence.",
96
+ "detailed_description": "A spatial working memory task. A grid is presented (typically 3x4) and at each step (typically 3) a number of boxes (typically 2) light up for 1.3 s. Participants need to mentally integrate the steps to build the overall pattern. After the sequence, two grids appear side by side, one showing the correct pattern and the other with one of the steps modified. Participants need to make a button press (within 3s) to choose the correct options. Grid size, number of steps, and boxes lit per step are adjustable to vary working memory load. Contrasting harder against easier trials localizes the domain-general Multiple Demand (MD) network in frontal and parietal cortex. The easier>harder or easier>fixation contrasts can be used to localize the Default Mode Network (DMN). After each response, the participant receives trial-specific feedback: a green check mark for a correct answer and a red cross for an incorrect one (set display_feedback=False in make_task_file to show a white fixation cross instead).",
97
+ "reference": "Fedorenko, E., Duncan, J., & Kanwisher, N. (2013). Broad domain generality in focal regions of frontal and parietal cortex. Proceedings of the National Academy of Sciences of the United States of America, 110(41), 16616-16621.",
98
+ "recorded_metrics": "Accuracy + RT",
99
+ "task_file_columns": {
100
+ "key_left": {
101
+ "type": "int",
102
+ "description": "Response key for choosing the left grid."
103
+ },
104
+ "key_right": {
105
+ "type": "int",
106
+ "description": "Response key for choosing the right grid."
107
+ },
108
+ "correct_side": {
109
+ "type": "str",
110
+ "description": "Which side shows the correct grid ('left' or 'right')."
111
+ },
112
+ "trial_type": {
113
+ "type": "int",
114
+ "description": "Numeric code for the correct side (0 = left, 1 = right)."
115
+ },
116
+ "trial_num": {
117
+ "type": "int",
118
+ "description": "Trial number (0-indexed)."
119
+ },
120
+ "hand": {
121
+ "type": "str",
122
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
123
+ },
124
+ "grid_size": {
125
+ "type": "tuple",
126
+ "description": "Grid dimensions as (rows, cols)."
127
+ },
128
+ "square_size": {
129
+ "type": "float",
130
+ "description": "Side of one grid square (degrees of visual angle)."
131
+ },
132
+ "answer_offset": {
133
+ "type": "float",
134
+ "description": "Horizontal distance of each answer grid's centre from the screen centre (degrees of visual angle)."
135
+ },
136
+ "num_steps": {
137
+ "type": "int",
138
+ "description": "Number of steps in the sequence."
139
+ },
140
+ "original_sequence": {
141
+ "type": "list",
142
+ "description": "Flattened list of all lit cells across the sequence (the correct pattern)."
143
+ },
144
+ "modified_sequence": {
145
+ "type": "list",
146
+ "description": "Flattened list of lit cells for the incorrect (modified) grid."
147
+ },
148
+ "original_step_1": {
149
+ "type": "list",
150
+ "description": "Cells lit during step 1."
151
+ },
152
+ "original_step_2": {
153
+ "type": "list",
154
+ "description": "Cells lit during step 2."
155
+ },
156
+ "original_step_3": {
157
+ "type": "list",
158
+ "description": "Cells lit during step 3."
159
+ },
160
+ "display_trial_feedback": {
161
+ "type": "bool",
162
+ "description": "Whether to show green/red feedback after the trial."
163
+ },
164
+ "trial_dur": {
165
+ "type": "float",
166
+ "description": "Duration of the trial (in seconds)."
167
+ },
168
+ "sequence_dur": {
169
+ "type": "float",
170
+ "description": "Duration of the sequence-presentation phase (in seconds)."
171
+ },
172
+ "question_dur": {
173
+ "type": "float",
174
+ "description": "Duration of the two-grid choice phase (in seconds)."
175
+ },
176
+ "iti_dur": {
177
+ "type": "float",
178
+ "description": "Inter-trial interval after the trial (in seconds)."
179
+ },
180
+ "start_time": {
181
+ "type": "float",
182
+ "description": "Trial start, relative to the block start (in seconds)."
183
+ },
184
+ "end_time": {
185
+ "type": "float",
186
+ "description": "Trial end, relative to the block start (in seconds)."
187
+ }
188
+ },
189
+ "conditions": "Configurable (not predefined): vary the working-memory load through several parameters — grid size (grid_size) / number of steps (num_steps) / boxes lit per step (num_boxes_lit)."
190
+ },
191
+ "action_observation": {
192
+ "short_description": "Participants watch a video of a knot being tied, followed by a rotating 360 view of the knot. A made-up name of the knot is displayed.",
193
+ "detailed_description": "Participants watch videos of a knot being tied then immediately a 360-degree view of the completed knot. Each video/trial is 14s long. The first trial in a block shows the knot-tying action, and subsequent trial shows the static knot view. No motor response during scanning is required, but participants are instructed to learn the knot so they could reproduce it after the scan. The task is designed to engage action observation.",
194
+ "reference": "Cross, E. S., Cohen, N. R., Hamilton, A. F. de C., Ramsey, R., Wolford, G., & Grafton, S. T. (2012). Physical experience leads to enhanced object perception in parietal cortex: Insights from knot tying. Neuropsychologia, 50(14), 3207-3217.",
195
+ "task_file_columns": {
196
+ "trial_num": {
197
+ "type": "int",
198
+ "description": "Trial number (0-indexed)."
199
+ },
200
+ "trial_dur": {
201
+ "type": "float",
202
+ "description": "Duration of the trial (in seconds)."
203
+ },
204
+ "iti_dur": {
205
+ "type": "float",
206
+ "description": "Inter-trial interval after the trial (in seconds)."
207
+ },
208
+ "condition": {
209
+ "type": "str",
210
+ "description": "'action' (watching the knot being tied) or 'control' (a rotating 360-degree view of the completed knot)."
211
+ },
212
+ "stim": {
213
+ "type": "str",
214
+ "description": "Knot video filename — 'knotAction<Name>.mov' on the first trial (tying), 'knotControl<Name>.mov' afterwards (360 deg view)."
215
+ },
216
+ "stim_width": {
217
+ "type": "float",
218
+ "description": "Width of the pictures / clips (degrees of visual angle); height keeps the aspect ratio."
219
+ },
220
+ "start_time": {
221
+ "type": "float",
222
+ "description": "Trial start, relative to the block start (in seconds)."
223
+ },
224
+ "end_time": {
225
+ "type": "float",
226
+ "description": "Trial end, relative to the block start (in seconds)."
227
+ }
228
+ },
229
+ "conditions": "action, control",
230
+ "recorded_metrics": "None"
231
+ },
232
+ "visual_search": {
233
+ "short_description": "A set of letter Ls with different orientations are presented each trial, participants must identify if 'L' is present or not.",
234
+ "reference": "Duncan, J., & Humphreys, G. W. (1989). Visual search and stimulus similarity. Psychological review, 96(3), 433.",
235
+ "detailed_description": "Participants view a display of geometric shapes at different rotations (90, 180, 270, 360 degrees) and must determine whether a L is present in the canonical orientation. The number of shapes is flexible, on easy trials 4 shapes are shown, on hard trials 8 shapes are shown. Participants press one button if the target is present and another if it is absent. The task requires a serial search of the display as indicated by RTs increasing linearly in the array size. The task requires shifts of visual attention and elicits eye-movement related activity.",
236
+ "task_file_columns": {
237
+ "key_true": {
238
+ "type": "int",
239
+ "description": "Response key for 'target present'."
240
+ },
241
+ "key_false": {
242
+ "type": "int",
243
+ "description": "Response key for 'target absent'."
244
+ },
245
+ "trial_num": {
246
+ "type": "int",
247
+ "description": "Trial number (0-indexed)."
248
+ },
249
+ "hand": {
250
+ "type": "str",
251
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
252
+ },
253
+ "trial_dur": {
254
+ "type": "float",
255
+ "description": "Duration of the trial (in seconds)."
256
+ },
257
+ "iti_dur": {
258
+ "type": "float",
259
+ "description": "Inter-trial interval after the trial (in seconds)."
260
+ },
261
+ "display_trial_feedback": {
262
+ "type": "bool",
263
+ "description": "Whether to show green/red feedback after the trial."
264
+ },
265
+ "trial_type": {
266
+ "type": "int",
267
+ "description": "Whether the target 'L' is present (1) or absent (0)."
268
+ },
269
+ "condition": {
270
+ "type": "str",
271
+ "description": "Difficulty as the number of search items / set size, e.g. '4-items' (easy) or '8-items' (hard)."
272
+ },
273
+ "start_time": {
274
+ "type": "float",
275
+ "description": "Trial start, relative to the block start (in seconds)."
276
+ },
277
+ "end_time": {
278
+ "type": "float",
279
+ "description": "Trial end, relative to the block start (in seconds)."
280
+ }
281
+ },
282
+ "conditions": "Configurable difficulty via set size (e.g. 4-items / 8-items).",
283
+ "recorded_metrics": "Accuracy + RT"
284
+ },
285
+ "serial_reaction_time": {
286
+ "short_description": "Participants need to make one of 4 button presses at time, cued by a spatial location of a box",
287
+ "detailed_description": "Four boxes are displayed in a row. On each trial one box lights up green (for 0.5s every 1,5s) and the participant presses the corresponding button as fast as possible. Stimuli are randomized, such that there is no implicit sequence learning. The only constraint is that the same box never lights up on consecutive trials. The task measures basic visuomotor response speed. By default, the 4 buttons are pressed with index and middle finger of the left and right hand.",
288
+ "reference": "Nissen, M. J., & Bullemer, P. (1987). Attentional requirements of learning: Evidence from performance measures. Cognitive psychology, 19(1), 1-32.",
289
+ "task_file_columns": {
290
+ "trial_num": {
291
+ "type": "int",
292
+ "description": "Trial number (0-indexed)."
293
+ },
294
+ "hand": {
295
+ "type": "str",
296
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
297
+ },
298
+ "trial_dur": {
299
+ "type": "float",
300
+ "description": "Duration of the trial (in seconds)."
301
+ },
302
+ "iti_dur": {
303
+ "type": "float",
304
+ "description": "Inter-trial interval after the trial (in seconds)."
305
+ },
306
+ "stim": {
307
+ "type": "int",
308
+ "description": "Which box lights up this trial (1-4)."
309
+ },
310
+ "start_time": {
311
+ "type": "float",
312
+ "description": "Trial start, relative to the block start (in seconds)."
313
+ },
314
+ "end_time": {
315
+ "type": "float",
316
+ "description": "Trial end, relative to the block start (in seconds)."
317
+ }
318
+ },
319
+ "recorded_metrics": "RT"
320
+ },
321
+ "verb_generation": {
322
+ "short_description": "Participants see words one at a time and, either silently read each word (read condition) or covertly generate a verb associated with it (generate condition).",
323
+ "detailed_description": "Participants see words presented one at a time. In the 'read' condition they silently read each word as it appears. In the 'generate' condition they covertly think of a verb associated with each word. A persistent colour-coded label at the top of the screen indicates the current condition ('READ' in red or 'GENERATE' in green) and stays on throughout. No button response is required. The generate>read contrast is designed to engage language and semantic-retrieval processing.",
324
+ "task_file_columns": {
325
+ "trial_num": {
326
+ "type": "int",
327
+ "description": "Trial number (0-indexed)."
328
+ },
329
+ "condition": {
330
+ "type": "str",
331
+ "description": "'read' (silently read each word) or 'generate' (covertly generate a verb)."
332
+ },
333
+ "trial_dur": {
334
+ "type": "float",
335
+ "description": "Duration of the trial (in seconds)."
336
+ },
337
+ "iti_dur": {
338
+ "type": "float",
339
+ "description": "Inter-trial interval after the trial (in seconds)."
340
+ },
341
+ "text_height": {
342
+ "type": "float",
343
+ "description": "Height of the task text (degrees of visual angle)."
344
+ },
345
+ "start_time": {
346
+ "type": "float",
347
+ "description": "Trial start, relative to the block start (in seconds)."
348
+ },
349
+ "end_time": {
350
+ "type": "float",
351
+ "description": "Trial end, relative to the block start (in seconds)."
352
+ },
353
+ "stim": {
354
+ "type": "str",
355
+ "description": "The word shown this trial."
356
+ }
357
+ },
358
+ "conditions": "read, generate",
359
+ "reference": "Adapted by changing into covert rather than overt reading/generation from Raichle, M. E., Fiez, J. A., Videen, T. O., MacLeod, A. M. K., Pardo, J. V., Fox, P. T., & Petersen, S. E. (1994). Practice-related changes in human brain functional anatomy during nonmotor learning. Cerebral cortex, 4(1), 8-26.",
360
+ "recorded_metrics": "None"
361
+ },
362
+ "rest": {
363
+ "short_description": "Participants are instructed to fixate on a central crosshair.",
364
+ "detailed_description": "Participants lie still and fixate on a central crosshair. No stimuli are presented and no response is required. For most fMRI experiments, rest is used as the baseline condition, and it is therefore recommended to include it into every task battery to allow for alignment with other datasets. However, rest does not minimize brain activity. Some region (the default mode network) are quite activated during rest.",
365
+ "reference": "Gusnard, D.A., Raichle, M.E., and Raichle, M.E. (2001). Searching for a baseline: functional imaging and the resting human brain. Nat. Rev. Neurosci. 2, 685-694.",
366
+ "task_file_columns": {
367
+ "trial_num": {
368
+ "type": "int",
369
+ "description": "Trial number (0-indexed)."
370
+ },
371
+ "trial_dur": {
372
+ "type": "float",
373
+ "description": "Duration of the trial (in seconds)."
374
+ },
375
+ "start_time": {
376
+ "type": "float",
377
+ "description": "Trial start, relative to the block start (in seconds)."
378
+ },
379
+ "end_time": {
380
+ "type": "float",
381
+ "description": "Trial end, relative to the block start (in seconds)."
382
+ }
383
+ },
384
+ "recorded_metrics": "None"
385
+ },
386
+ "theory_of_mind": {
387
+ "short_description": "Participants read a short story, followed by a statement they must judge as true or false.",
388
+ "reference": "Dodell-Feder, D., Koster-Hale, J., Bedny, M., & Saxe, R. (2011). fMRI item analysis in a theory of mind task. NeuroImage, 55(2), 705-712. Saxe, R. and Kanwisher, N. (2003) People thinking about thinking people: The role of the temporo-parietal junction in “theory of mind”, NeuroImage, 19(4), pp. 1835-1842.",
389
+ "conditions": "belief, photo",
390
+ "recorded_metrics": "Accuracy + RT",
391
+ "detailed_description": "Participants read short stories. Each story is followed by a statement and a true/false judgment. In the belief condition, stories require inferring what another person believes, even if this belief does not match the state of the world (false belief); in the photo condition, stories require reasoning about outdated content of a physical or external representation such as a photograph, a map or a book, whose information no longer accurate. Both conditions are matched in structure (each involves holding a mental representation that conflicts with the current reality). Only the belief condition involves another person's mind. Participants press a button to indicate whether the statement about the story is true or false. Task is designed to engage mentalizing (theory of mind): reasoning about other people's mental states. After each response, the participant receives trial-specific feedback: a green check mark for a correct answer and a red cross for an incorrect one.",
392
+ "task_file_columns": {
393
+ "key_true": {
394
+ "type": "int",
395
+ "description": "Response key for a 'True' judgment."
396
+ },
397
+ "key_false": {
398
+ "type": "int",
399
+ "description": "Response key for a 'False' judgment."
400
+ },
401
+ "trial_type": {
402
+ "type": "int",
403
+ "description": "Numeric code for the correct answer: 1 = True, 0 = False."
404
+ },
405
+ "trial_num": {
406
+ "type": "int",
407
+ "description": "Trial number (0-indexed)."
408
+ },
409
+ "hand": {
410
+ "type": "str",
411
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
412
+ },
413
+ "trial_dur": {
414
+ "type": "float",
415
+ "description": "Duration of the trial (in seconds)."
416
+ },
417
+ "iti_dur": {
418
+ "type": "float",
419
+ "description": "Inter-trial interval after the trial (in seconds)."
420
+ },
421
+ "story": {
422
+ "type": "str",
423
+ "description": "The short story text shown in the first phase."
424
+ },
425
+ "question": {
426
+ "type": "str",
427
+ "description": "The true/false statement shown after the story."
428
+ },
429
+ "condition": {
430
+ "type": "str",
431
+ "description": "'belief' (infer a false belief) or 'photo' (reason about an outdated representation)."
432
+ },
433
+ "story_dur": {
434
+ "type": "float",
435
+ "description": "How long the story is displayed (in seconds)."
436
+ },
437
+ "question_dur": {
438
+ "type": "float",
439
+ "description": "How long the question is displayed (in seconds)."
440
+ },
441
+ "text_height": {
442
+ "type": "float",
443
+ "description": "Height of the story/question text (degrees of visual angle)."
444
+ },
445
+ "display_trial_feedback": {
446
+ "type": "bool",
447
+ "description": "Whether to show green/red feedback after the trial."
448
+ },
449
+ "start_time": {
450
+ "type": "float",
451
+ "description": "Trial start, relative to the block start (in seconds)."
452
+ },
453
+ "end_time": {
454
+ "type": "float",
455
+ "description": "Trial end, relative to the block start (in seconds)."
456
+ }
457
+ }
458
+ },
459
+ "n_back": {
460
+ "short_description": "Participants see a stream of images one at a time and press a button on each to indicate whether it matches the image shown n items earlier.",
461
+ "recorded_metrics": "Accuracy + RT",
462
+ "reference": [
463
+ "Ragland, J. D., Turetsky, B. I., Gur, R. C., Gunning-Dixon, F., Turner, T., Schroeder, L., ... & Gur, R. E. (2002). Working memory for complex figures: an fMRI comparison of letter and fractal n-back tasks. Neuropsychology, 16(3), 370.",
464
+ "King, M., Hernandez-Castillo, C. R., Poldrack, R. A., Ivry, R. B., & Diedrichsen, J. (2019). Functional boundaries in the human cerebellum revealed by a multi-domain task battery. Nature neuroscience, 22(8), 1371-1378."
465
+ ],
466
+ "detailed_description": "Participants see a continuous stream of images presented one at a time, drawn from a small set of pictures. On every image they make a two-alternative button press indicating whether the current image is the same as the one shown n items earlier or not. The sequence is generated so that about half of the trials are n-back matches. Non-match trials never repeat any of the just presented images, so a match always requires holding the n-back item in mind rather than just detecting a repeat. The memory load is configurable, so the same task can run as a 1-back, 2-back, 3-back, and so on. This continuous n-back paradigm engages working memory and the domain-general multiple-demand / frontoparietal control network. After each response, the participant receives trial-specific feedback: a green check mark for a correct answer and a red cross for an incorrect one.",
467
+ "task_file_columns": {
468
+ "trial_num": {
469
+ "type": "int",
470
+ "description": "Trial number (0-indexed)."
471
+ },
472
+ "hand": {
473
+ "type": "str",
474
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
475
+ },
476
+ "trial_dur": {
477
+ "type": "float",
478
+ "description": "Duration of the trial (in seconds)."
479
+ },
480
+ "iti_dur": {
481
+ "type": "float",
482
+ "description": "Inter-trial interval after the trial (in seconds)."
483
+ },
484
+ "stim_width": {
485
+ "type": "float",
486
+ "description": "Width of the pictures / clips (degrees of visual angle); height keeps the aspect ratio."
487
+ },
488
+ "condition": {
489
+ "type": "str",
490
+ "description": "The n-back level as an 'N-back' label (e.g. '2-back' = a match refers to the item 2 back). This is the modeling-level condition and the only place the n-back level is stored."
491
+ },
492
+ "display_trial_feedback": {
493
+ "type": "bool",
494
+ "description": "Whether to show green/red feedback after the trial."
495
+ },
496
+ "key_match": {
497
+ "type": "int",
498
+ "description": "Response key for a 'match' judgment."
499
+ },
500
+ "key_nomatch": {
501
+ "type": "int",
502
+ "description": "Response key for a 'no-match' judgment."
503
+ },
504
+ "trial_type": {
505
+ "type": "int",
506
+ "description": "Whether the current image matches the one n items back: 1 = match, 0 = no-match."
507
+ },
508
+ "stim": {
509
+ "type": "str",
510
+ "description": "Image filename shown this trial."
511
+ },
512
+ "start_time": {
513
+ "type": "float",
514
+ "description": "Trial start, relative to the block start (in seconds)."
515
+ },
516
+ "end_time": {
517
+ "type": "float",
518
+ "description": "Trial end, relative to the block start (in seconds)."
519
+ }
520
+ },
521
+ "conditions": "Configurable (not predefined): set the memory load via the n-back level (e.g. 1-back / 2-back / 3-back)."
522
+ },
523
+ "tongue_movement": {
524
+ "short_description": "Participants move their tongue right to left against the upper premolar teeth, paced by a flashing circle around a fixation cross.",
525
+ "detailed_description": "Participants move their tongue from right to left, touching their upper premolar teeth on each side. A flashing black circle around a fixation crosshair guides the rhythm at 1-second periods: a black circle cues a movement to the right, no circle cues a movement to the left. The task targets tongue-related somatomotor activation.",
526
+ "reference": "A Third Somatomotor Representation in the Human Cerebellum (Saadon-Grosmanet al., 2022)",
527
+ "recorded_metrics": "None",
528
+ "task_file_columns": {
529
+ "trial_num": {
530
+ "type": "int",
531
+ "description": "Trial number (0-indexed)."
532
+ },
533
+ "trial_dur": {
534
+ "type": "float",
535
+ "description": "Duration of the trial (in seconds)."
536
+ },
537
+ "iti_dur": {
538
+ "type": "float",
539
+ "description": "Inter-trial interval after the trial (in seconds)."
540
+ },
541
+ "trial_type": {
542
+ "type": "str",
543
+ "description": "Cued movement direction: 'right' or 'left'."
544
+ },
545
+ "start_time": {
546
+ "type": "float",
547
+ "description": "Trial start, relative to the block start (in seconds)."
548
+ },
549
+ "end_time": {
550
+ "type": "float",
551
+ "description": "Trial end, relative to the block start (in seconds)."
552
+ }
553
+ }
554
+ },
555
+ "auditory_narrative": {
556
+ "short_description": "Participants listen to 30-second audio snippets from The Moth Radio Hour story 'Where There's Smoke'.",
557
+ "detailed_description": "The audio clips are presented sequentially across runs so the participant follows the narrative. The task is designed to engage auditory cortex, the language network and higher-level narrative comprehension.",
558
+ "reference": "Tang, J., LeBel, A., Jain, S., & Huth, A. G. (2023). Semantic reconstruction of continuous language from non-invasive brain recordings. Nature Neuroscience, 26(5), 858-866.",
559
+ "recorded_metrics": "None",
560
+ "task_file_columns": {
561
+ "trial_num": {
562
+ "type": "int",
563
+ "description": "Trial number (0-indexed)."
564
+ },
565
+ "trial_dur": {
566
+ "type": "float",
567
+ "description": "Duration of the trial (in seconds)."
568
+ },
569
+ "iti_dur": {
570
+ "type": "float",
571
+ "description": "Inter-trial interval after the trial (in seconds)."
572
+ },
573
+ "stim": {
574
+ "type": "str",
575
+ "description": "Audio filename ('narrative_NN.wav') played this trial."
576
+ },
577
+ "start_time": {
578
+ "type": "float",
579
+ "description": "Trial start, relative to the block start (in seconds)."
580
+ },
581
+ "end_time": {
582
+ "type": "float",
583
+ "description": "Trial end, relative to the block start (in seconds)."
584
+ }
585
+ }
586
+ },
587
+ "spatial_navigation": {
588
+ "short_description": "Imagined navigation through a remembered environment.",
589
+ "detailed_description": "Participants are instructed to imagine walking from one room to another room in their childhood home. No visual stimuli are presented beyond the instruction. The task is designed to engage spatial memory and mental navigation.",
590
+ "recorded_metrics": "None",
591
+ "reference": "Boly, M., Coleman, M. R., Davis, M. H., Hampshire, A., Bor, D., Moonen, G., ... & Owen, A. M. (2007). When thoughts become action: an fMRI paradigm to study volitional brain activity in non-communicative brain injured patients. Neuroimage, 36(3), 979-992.",
592
+ "task_file_columns": {
593
+ "trial_num": {
594
+ "type": "int",
595
+ "description": "Trial number (0-indexed)."
596
+ },
597
+ "trial_dur": {
598
+ "type": "float",
599
+ "description": "Duration of the trial (in seconds)."
600
+ },
601
+ "iti_dur": {
602
+ "type": "float",
603
+ "description": "Inter-trial interval after the trial (in seconds)."
604
+ },
605
+ "start_time": {
606
+ "type": "float",
607
+ "description": "Trial start, relative to the block start (in seconds)."
608
+ },
609
+ "end_time": {
610
+ "type": "float",
611
+ "description": "Trial end, relative to the block start (in seconds)."
612
+ },
613
+ "location_1": {
614
+ "type": "str",
615
+ "description": "Start location of the imagined route."
616
+ },
617
+ "location_2": {
618
+ "type": "str",
619
+ "description": "Destination location of the imagined route."
620
+ }
621
+ }
622
+ },
623
+ "passage_listening": {
624
+ "short_description": "Participants listen to intact or acoustically degraded (muffled) speech passages",
625
+ "detailed_description": "Participants listen to excerpts from speeches and talks from several sources (e.g., The moth podcast, Ted talks, celebrity interviews). In the intact condition the audio is intelligible. In the degraded condition the same type of audio is acoustically degraded so it is matched in lower level acoustic properties but the content can no longer be understood. Participants are instructed to only listen attentively; no response is required. The intact>degraded contrast localizes high-level language processing brain regions. ",
626
+ "conditions": "intact, degraded",
627
+ "reference": "Scott, T. L., Gallee, J., & Fedorenko, E. (2017). A new fun and robust version of an fMRI localizer for the frontotemporal language system. Cognitive Neuroscience, 8(3), 167-176.",
628
+ "recorded_metrics": "None",
629
+ "task_file_columns": {
630
+ "trial_num": {
631
+ "type": "int",
632
+ "description": "Trial number (0-indexed)."
633
+ },
634
+ "trial_dur": {
635
+ "type": "float",
636
+ "description": "Duration of the trial (in seconds)."
637
+ },
638
+ "iti_dur": {
639
+ "type": "float",
640
+ "description": "Inter-trial interval after the trial (in seconds)."
641
+ },
642
+ "condition": {
643
+ "type": "str",
644
+ "description": "Speech condition: 'intact' (intelligible) or 'degraded' (acoustically degraded)."
645
+ },
646
+ "stim": {
647
+ "type": "str",
648
+ "description": "Audio filename played this trial."
649
+ },
650
+ "start_time": {
651
+ "type": "float",
652
+ "description": "Trial start, relative to the block start (in seconds)."
653
+ },
654
+ "end_time": {
655
+ "type": "float",
656
+ "description": "Trial end, relative to the block start (in seconds)."
657
+ }
658
+ }
659
+ },
660
+ "reading": {
661
+ "short_description": "Participants read sentences or nonword sequences.",
662
+ "detailed_description": "One word or non-word is shown at a time. Participants are instructed to read silently as they would when reading a book. In the standard version of the task, each sentence has 12 words / nonwords, and each word is presented for 450ms. At the end of each sentence/nonword sequence, participants see a picture of a finger pressing a button; whenever they see that picture they need to make a button press within 400ms (to help them stay alert during throughout the task. The sentences>nonwords contrast can be used to localize high-level language processing brain regions, i.e., regions that support lexico-semantic and combinatorial (syntactic and semantic) processes. ",
663
+ "reference": "Fedorenko, E., Hsieh, P.-J., Nieto-Castanon, A., Whitfield-Gabrieli, S., & Kanwisher, N. (2010). New method for fMRI investigations of language: defining ROIs functionally in individual subjects. Journal of Neurophysiology, 104(2), 1177-1194.",
664
+ "conditions": "sentences, nonwords",
665
+ "recorded_metrics": "RT",
666
+ "task_file_columns": {
667
+ "trial_num": {
668
+ "type": "int",
669
+ "description": "Trial number (0-indexed)."
670
+ },
671
+ "trial_dur": {
672
+ "type": "float",
673
+ "description": "Duration of the trial (in seconds)."
674
+ },
675
+ "iti_dur": {
676
+ "type": "float",
677
+ "description": "Inter-trial interval after the trial (in seconds)."
678
+ },
679
+ "condition": {
680
+ "type": "str",
681
+ "description": "'sentences' or 'nonwords'."
682
+ },
683
+ "stim": {
684
+ "type": "str",
685
+ "description": "The sentence or nonword string shown (presented one word at a time)."
686
+ },
687
+ "text_height": {
688
+ "type": "float",
689
+ "description": "Height of the task text (degrees of visual angle)."
690
+ },
691
+ "stim_width": {
692
+ "type": "float",
693
+ "description": "Width of the pictures / clips (degrees of visual angle); height keeps the aspect ratio."
694
+ },
695
+ "start_time": {
696
+ "type": "float",
697
+ "description": "Trial start, relative to the block start (in seconds)."
698
+ },
699
+ "end_time": {
700
+ "type": "float",
701
+ "description": "Trial end, relative to the block start (in seconds)."
702
+ }
703
+ }
704
+ },
705
+ "finger_sequence": {
706
+ "short_description": "Discrete sequence production task.",
707
+ "detailed_description": "In each trial, a sequence of 6 digits (1-4) is displayed. Participants are instructed to press the corresponding buttons in order as quickly and accurately as possible, starting immediately after presentation. For each correct press, the corresponding digit turns green, for each incorrect press, red. In the standard version, each trial has a length of 3.25s with an ITI of 0.5s. Recorded accuracy is the average press accuracy, and reaction time is the average inter-press-interval. No consecutive repeats appear in the sequence.",
708
+ "recorded_metrics": "Accuracy + RT",
709
+ "reference": "Wiestler, T., & Diedrichsen, J. (2013). Skill learning strengthens cortical representations of motor sequences. eLife.",
710
+ "task_file_columns": {
711
+ "trial_num": {
712
+ "type": "int",
713
+ "description": "Trial number (0-indexed)."
714
+ },
715
+ "hand": {
716
+ "type": "str",
717
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
718
+ },
719
+ "trial_dur": {
720
+ "type": "float",
721
+ "description": "Duration of the trial (in seconds)."
722
+ },
723
+ "iti_dur": {
724
+ "type": "float",
725
+ "description": "Inter-trial interval after the trial (in seconds)."
726
+ },
727
+ "display_trial_feedback": {
728
+ "type": "bool",
729
+ "description": "Whether to show green/red feedback after the trial."
730
+ },
731
+ "stim": {
732
+ "type": "str",
733
+ "description": "The 6-digit sequence to tap, space-separated (e.g. '1 3 2 4 1 3')."
734
+ },
735
+ "text_height": {
736
+ "type": "float",
737
+ "description": "Height of the task text (degrees of visual angle)."
738
+ },
739
+ "start_time": {
740
+ "type": "float",
741
+ "description": "Trial start, relative to the block start (in seconds)."
742
+ },
743
+ "end_time": {
744
+ "type": "float",
745
+ "description": "Trial end, relative to the block start (in seconds)."
746
+ }
747
+ }
748
+ },
749
+ "toe_movement": {
750
+ "short_description": "Toe movements. Alternating periods of flexing/extending toes.",
751
+ "recorded_metrics": "None",
752
+ "detailed_description": "Participants repeatedly flex and extend the toes of both feet, paced by a visual cue at the center of the screen that alternates between the words 'flexion' and 'extension' every couple of seconds. Each cue is shown for a fixed duration and the participant performs the indicated movement for as long as it is displayed; no button response is collected and no feedback is given. The block simply alternates between the two movements for its entire duration. The task is used to drive the foot/toe somatomotor representation and to help map the somatomotor territory of the cerebellum and cortex.",
753
+ "reference": "Saadon-Grosman, N., Angeli, P. A., DiNicola, L. M., & Buckner, R. L. (2022). A third somatomotor representation in the human cerebellum. Journal of Neurophysiology, 128(4), 1051-1073.",
754
+ "task_file_columns": {
755
+ "trial_num": {
756
+ "type": "int",
757
+ "description": "Cue index within the block (0-indexed); one row per cue."
758
+ },
759
+ "stim": {
760
+ "type": "str",
761
+ "description": "The cue shown this row: 'flexion' or 'extension'. Rows alternate between the two across the block."
762
+ },
763
+ "trial_dur": {
764
+ "type": "float",
765
+ "description": "How long this cue is shown, in seconds (e.g. 2)."
766
+ },
767
+ "text_height": {
768
+ "type": "float",
769
+ "description": "Height of the task text (degrees of visual angle)."
770
+ },
771
+ "start_time": {
772
+ "type": "float",
773
+ "description": "Cue onset, relative to the block start (in seconds)."
774
+ },
775
+ "end_time": {
776
+ "type": "float",
777
+ "description": "Cue offset, relative to the block start (in seconds)."
778
+ }
779
+ }
780
+ },
781
+ "semantic_prediction": {
782
+ "short_description": "Participants read a sentence presented one word at a time, then decide whether the final word makes the sentence meaningful or meaningless.",
783
+ "detailed_description": "Participants read a sentence presented one word at a time. Each word is presented for 0.8 seconds. After the sentence, a brief fixation cross is shown and then the final, critical word appears; participants make a two-alternative button press to indicate whether that word makes the sentence meaningful (a sensible completion) or meaningless. About half of the trials end with the sentence's plausible word and half with an implausible word, so participants must use the accumulating sentence context to predict and evaluate the ending. The task engages language comprehension and semantic processing. After each response, the participant receives trial-specific feedback: a green check mark for a correct answer and a red cross for an incorrect one.",
784
+ "recorded_metrics": "Accuracy + RT",
785
+ "reference": "Moberget, T., Gullesen, E. H., Andersson, S., Ivry, R. B., & Endestad, T. (2014). Generalized role for the cerebellum in encoding internal models: Evidence from semantic processing. The Journal of Neuroscience, 34(8), 2871-2878.",
786
+ "task_file_columns": {
787
+ "key_true": {
788
+ "type": "int",
789
+ "description": "Response key for 'meaningful'."
790
+ },
791
+ "key_false": {
792
+ "type": "int",
793
+ "description": "Response key for 'meaningless'."
794
+ },
795
+ "trial_num": {
796
+ "type": "int",
797
+ "description": "Trial number (0-indexed)."
798
+ },
799
+ "hand": {
800
+ "type": "str",
801
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
802
+ },
803
+ "trial_dur": {
804
+ "type": "float",
805
+ "description": "Duration of the trial (in seconds)."
806
+ },
807
+ "sentence_dur": {
808
+ "type": "float",
809
+ "description": "Response window for the final word (in seconds)."
810
+ },
811
+ "sentence": {
812
+ "type": "str",
813
+ "description": "The lead-in sentence (without the final word), with words separated by '|'; the runtime splits on '|' and shows one word at a time (e.g. 'A|Dalmatian|dog|is|recognized|by|its|black|and|white')."
814
+ },
815
+ "trial_type": {
816
+ "type": "int",
817
+ "description": "Whether the final word makes the sentence meaningful (1) or meaningless (0)."
818
+ },
819
+ "last_word": {
820
+ "type": "str",
821
+ "description": "The final (critical) word shown after the sentence."
822
+ },
823
+ "display_trial_feedback": {
824
+ "type": "bool",
825
+ "description": "Whether to show green/red feedback after the trial."
826
+ },
827
+ "text_height": {
828
+ "type": "float",
829
+ "description": "Height of the task text (degrees of visual angle)."
830
+ },
831
+ "start_time": {
832
+ "type": "float",
833
+ "description": "Trial start, relative to the block start (in seconds)."
834
+ },
835
+ "end_time": {
836
+ "type": "float",
837
+ "description": "Trial end, relative to the block start (in seconds)."
838
+ }
839
+ }
840
+ },
841
+ "affective": {
842
+ "short_description": "Participants view a picture (scenes, animals, or foods) and choose whether it is pleasant or unpleasant.",
843
+ "detailed_description": "Participants view pictures drawn from the Open Affective Standardized Image Set (OASIS; 64 pleasant and 64 unpleasant images, listed with their ratings in stimuli/affective/oasis_images.tsv) — depicting scenes, animals, and foods — and indicate via a button press whether each image is pleasant or unpleasant. The task is designed to engage affective/emotional valence processing. After each response, the participant receives trial-specific feedback: a green check mark for a correct answer and a red cross for an incorrect one.",
844
+ "recorded_metrics": "Accuracy + RT",
845
+ "reference": [
846
+ "Kurdi, B., Lozano, S., & Banaji, M. R. (2017). Introducing the Open Affective Standardized Image Set (OASIS). Behavior Research Methods, 49(2), 457-470.",
847
+ "Moulton, E. A., Elman, I., Pendse, G., Schmahmann, J., Becerra, L., & Borsook, D. (2011). Aversion-related circuitry in the cerebellum: responses to noxious heat and unpleasant images. Journal of neuroscience, 31(10), 3795-3804."
848
+ ],
849
+ "task_file_columns": {
850
+ "trial_num": {
851
+ "type": "int",
852
+ "description": "Trial number (0-indexed)."
853
+ },
854
+ "stim": {
855
+ "type": "str",
856
+ "description": "IAPS image filename; valence is encoded in the prefix ('pleasant...' / 'unpleasant...')."
857
+ },
858
+ "trial_type": {
859
+ "type": "int",
860
+ "description": "Image valence: 1 = unpleasant, 2 = pleasant."
861
+ },
862
+ "hand": {
863
+ "type": "str",
864
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
865
+ },
866
+ "trial_dur": {
867
+ "type": "float",
868
+ "description": "Duration of the trial (in seconds)."
869
+ },
870
+ "iti_dur": {
871
+ "type": "float",
872
+ "description": "Inter-trial interval after the trial (in seconds)."
873
+ },
874
+ "key_unpleasant": {
875
+ "type": "int",
876
+ "description": "Response key for an 'unpleasant' judgment."
877
+ },
878
+ "key_pleasant": {
879
+ "type": "int",
880
+ "description": "Response key for a 'pleasant' judgment."
881
+ },
882
+ "display_trial_feedback": {
883
+ "type": "bool",
884
+ "description": "Whether to show green/red feedback after the trial."
885
+ },
886
+ "stim_width": {
887
+ "type": "float",
888
+ "description": "Width of the pictures / clips (degrees of visual angle); height keeps the aspect ratio."
889
+ },
890
+ "start_time": {
891
+ "type": "float",
892
+ "description": "Trial start, relative to the block start (in seconds)."
893
+ },
894
+ "end_time": {
895
+ "type": "float",
896
+ "description": "Trial end, relative to the block start (in seconds)."
897
+ }
898
+ }
899
+ },
900
+ "finger_rhythmic": {
901
+ "short_description": "Rhythmic tapping production task. Participants are instructed to produce a regular series of taps at a prescribed target interval.",
902
+ "reference": "Ivry, R. B., & Keele, S. W. (1989). Timing Functions of the Cerebellum. Journal of Cognitive Neuroscience, 1(2), 136-152.",
903
+ "detailed_description": "A timing production task in which participants listen to a train of auditory tones and tap along at the same pace. The task engages motor timing.",
904
+ "task_file_columns": {
905
+ "key_one": {
906
+ "type": "int",
907
+ "description": "Response key used to tap."
908
+ },
909
+ "trial_num": {
910
+ "type": "int",
911
+ "description": "Trial number (0-indexed)."
912
+ },
913
+ "hand": {
914
+ "type": "str",
915
+ "description": "Which hand responds ('left', 'right', or 'bimanual')."
916
+ },
917
+ "trial_dur": {
918
+ "type": "float",
919
+ "description": "Duration of the trial (in seconds)."
920
+ },
921
+ "iti_dur": {
922
+ "type": "float",
923
+ "description": "Inter-trial interval after the trial (in seconds)."
924
+ },
925
+ "ioi": {
926
+ "type": "float",
927
+ "description": "Inter-onset interval (pace) for this trial, in seconds."
928
+ },
929
+ "stim": {
930
+ "type": "str",
931
+ "description": "Always 'generated' — the tone train is synthesized at runtime."
932
+ },
933
+ "display_trial_feedback": {
934
+ "type": "bool",
935
+ "description": "Whether to show green/red feedback after the trial."
936
+ },
937
+ "start_time": {
938
+ "type": "float",
939
+ "description": "Trial start, relative to the block start (in seconds)."
940
+ },
941
+ "end_time": {
942
+ "type": "float",
943
+ "description": "Trial end, relative to the block start (in seconds)."
944
+ }
945
+ }
946
+ },
947
+ "time_perception": {
948
+ "short_description": "Assess the precision of internal timing mechanisms by measuring participants' perceptual acuity in discriminating short auditory intervals. Participants are presented with sequences of tones and must decide whether a comparison interval is longer or shorter than a standard reference interval.",
949
+ "reference": "Ivry, R. B., & Keele, S. W. (1989). Timing Functions of the Cerebellum. Journal of Cognitive Neuroscience, 1(2), 136-152.",
950
+ "recorded_metrics": "Accuracy + RT",
951
+ "task_file_columns": {
952
+ "trial_num": {
953
+ "type": "int",
954
+ "description": "Trial number (0-indexed)."
955
+ },
956
+ "modality": {
957
+ "type": "str",
958
+ "description": "Which dimension is judged ('time' or 'volume')."
959
+ },
960
+ "side": {
961
+ "type": "str",
962
+ "description": "Correct answer ('shorter'/'longer' for time, 'quieter'/'louder' for volume)."
963
+ },
964
+ "key_one": {
965
+ "type": "int",
966
+ "description": "Response key for the left option."
967
+ },
968
+ "key_two": {
969
+ "type": "int",
970
+ "description": "Response key for the right option."
971
+ },
972
+ "trial_type": {
973
+ "type": "int",
974
+ "description": "Correct-response code: 1 = left option (shorter/quieter), 2 = right option (longer/louder)."
975
+ },
976
+ "question_dur": {
977
+ "type": "float",
978
+ "description": "Response window after the tones (in seconds)."
979
+ },
980
+ "trial_dur": {
981
+ "type": "float",
982
+ "description": "Duration of the trial (in seconds)."
983
+ },
984
+ "iti_dur": {
985
+ "type": "float",
986
+ "description": "Inter-trial interval after the trial (in seconds)."
987
+ },
988
+ "display_trial_feedback": {
989
+ "type": "bool",
990
+ "description": "Whether to show green/red feedback after the trial."
991
+ },
992
+ "comparison_ms": {
993
+ "type": "float",
994
+ "description": "Comparison interval used (filled at runtime; NaN in the generated file)."
995
+ },
996
+ "comparison_dba": {
997
+ "type": "float",
998
+ "description": "Comparison volume used (filled at runtime; NaN in the generated file)."
999
+ },
1000
+ "start_time": {
1001
+ "type": "float",
1002
+ "description": "Trial start, relative to the block start (in seconds)."
1003
+ },
1004
+ "end_time": {
1005
+ "type": "float",
1006
+ "description": "Trial end, relative to the block start (in seconds)."
1007
+ }
1008
+ }
1009
+ },
1010
+ "motor_localizer": {
1011
+ "short_description": "A general somatomotor localizer. Each block cycles through body-part conditions (e.g. hand, foot, tongue) shown as a label above a fixation cross, while a circle around the fixation appears and disappears to pace the movement.",
1012
+ "detailed_description": "A general motor localizer for mapping somatomotor cortex and cerebellum. The block is divided into equal segments, one per condition (e.g. 10 s each for hand, foot and tongue in a 30 s block), presented in a randomized order. The current condition is shown as a label at the top of the screen (in black) above a central fixation cross, telling the participant which body part to move. Around the fixation a black circle appears (trial_type = 1) and disappears (trial_type = 0) to pace the movement. The mapping from condition to movement (e.g. tongue = left-right, foot = flex/extend) and the meaning of the circle appearing versus disappearing are explained to the participant during training and are deliberately NOT encoded in the task file: the code only reads the condition and trial_type and renders them. No response is collected and no feedback is given. Because several body-part conditions are cued within one block, a single localizer block can target multiple somatomotor representations.",
1013
+ "reference": "Saadon-Grosman, N., Angeli, P. A., DiNicola, L. M., & Buckner, R. L. (2022). A third somatomotor representation in the human cerebellum. Journal of Neurophysiology, 128(4), 1051-1073.",
1014
+ "recorded_metrics": "None",
1015
+ "conditions": "Configurable: the body parts to localize (default hand, foot, tongue). Each condition gets an equal, randomly ordered segment of the block.",
1016
+ "task_file_columns": {
1017
+ "trial_num": {
1018
+ "type": "int",
1019
+ "description": "Row index within the block (0-indexed); one row per circle on/off phase."
1020
+ },
1021
+ "condition": {
1022
+ "type": "str",
1023
+ "description": "The body part to move for this segment (e.g. 'hand', 'foot', 'tongue'), shown as a label at the top of the screen. Conditions are cued one equal-length segment each, in a randomized order."
1024
+ },
1025
+ "trial_type": {
1026
+ "type": "int",
1027
+ "description": "Whether the circle is drawn around the fixation this row: 1 = circle present, 0 = circle absent. What present vs absent means (e.g. move vs hold, or move right vs left) is defined in training, not in the code."
1028
+ },
1029
+ "trial_dur": {
1030
+ "type": "float",
1031
+ "description": "How long this row is shown, in seconds (the circle on/off toggle interval within a segment)."
1032
+ },
1033
+ "text_height": {
1034
+ "type": "float",
1035
+ "description": "Height of the task text (degrees of visual angle)."
1036
+ },
1037
+ "start_time": {
1038
+ "type": "float",
1039
+ "description": "Row onset, relative to the block start (in seconds)."
1040
+ },
1041
+ "end_time": {
1042
+ "type": "float",
1043
+ "description": "Row offset, relative to the block start (in seconds)."
1044
+ }
1045
+ }
1046
+ }
1047
+ }