User Manual: Inquisit Glocal Local Task with Mouse Input (Children)


___________________________________________________________________________________________________________________	

										Global Local Task for Children
										(mouse/touchscreen version)
___________________________________________________________________________________________________________________

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 05-17-2017
last updated:  02-23-2022 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 02-23-2022 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements a child friendly Global-Local-Task; a test of perceptual processing of global
and local features of stimuli.

The implemented procedure is based on:

Sjöwall, D., Roth, L., Lindqvist, S., & Thorell, L. B. (2013). Multiple deficits in ADHD: 
executive dysfunction, delay aversion, reaction time variability and emotional deficits. 
Journal of Child Psychology and Psychiatry, 54, 619–627.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants see Navon figures made up of an overall shape (circle vs. square) and detail shapes (circle vs. square).
They work through 3 different rounds: (a) pay attention to global shape; (b) pay attention to local shape
(c) a mixed design (measures shifting).

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 7 minutes to complete

___________________________________________________________________________________________________________________	
DATA FILE INFORMATION 
___________________________________________________________________________________________________________________
The default data stored in the data files are:

(1) Raw data file: 'globallocaltask_children_mi_raw*.iqdat' (a separate file for each participant)*

build:								The specific Inquisit version used (the 'build') that was run
computer.platform:					the platform the script was run on (win/mac/ios/android)
date, time: 						date and time script was run 
subject, group: 					with the current subject/groupnumber
session:							with the current session id

blockcode, blocknum:				the name and number of the current block (built-in Inquisit variable)
trialcode, trialnum: 				the name and number of the currently recorded trial (built-in Inquisit variable)
										Note: trialnum is a built-in Inquisit variable; it counts all trials run; even those
										that do not store data to the data file. 
										
countTrials:						counts overall test trials (starttrial excluded from count)								
task:								stores the task from the current task: "global" vs. "local"									
prevtask:							stores the task from the previous task: "global" vs. "local"
globalForm:							the global form of the current stim: "square" vs. "circle"									
localForm:							the local form of the current stim: "square" vs. "circle"										
selectedStim:						the itemnumber of the currently selected stimulus
stimulusitem:						the selected image
response:							the participant's response
responseCategory:					"circle" vs. "square" (selected shape)
correct Response:					the correct response for the current task: "square" vs. "circle"
correct:							accuracy of response: 1 = correct response; 0 = otherwise
latency: 							the response latency (in ms); measured from: onset of stim


(2) Summary data file: 'globallocaltask_children_mi_summary*.iqdat' (a separate file for each participant)*

inquisit.version: 					Inquisit version run
computer.platform:					the platform the script was run on (win/mac/ios/android)
startDate:							date script was run
startTime:							time script was started
subjectid:							assigned subject id number
groupid:							assigned group id number
sessionid:							assigned session id number
elapsedTime:						time it took to run script (in ms); measured from onset to offset of script
completed:							0 = script was not completed (prematurely aborted); 
									1 = script was completed (all conditions run)

ACC_global:						proportion correct across all global test trials (block.global only)
meanRT_global:					mean correct latency (in ms) of all global test trials (block.global only)
ACC_local:						proportion correct across all local test trials (block.local only)
meanRT_local:					mean correct latency (in ms) of all local test trials (block.local only)
ACC_shift:						proportion correct of all mixed, shift trials (block.mixed only)
meanRT_shift:					mean correct latency (in ms) of all mixed, shift trials (block.mixed only)
ACC_nonshift:					proportion correct of all mixed, nonshift trials (block.mixed only)
meanRT_nonshift:				mean correct latency (in ms) of all mixed, nonshift trials (block.mixed only)
shiftCost:						estimates the shift cost by subtracting the mean correct latency on shift trials from those of nonshift trials	
	
* separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section
"DATA" and follow further instructions


___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________

1. Block*: global task
- 10 practice trials (don't count toward summary statistics)
- 20 test trials (test trials are indistinguishable from practice trials)
- smiley feedback provided
- each of the two test stimuli is selected equally often during the test trials (order is randomized)

2. Block*: local task
- 10 practice trials (don't count toward summary statistics)
- 20 test trials (test trials are indistinguishable from practice trials)
- smiley feedback provided
- each of the two test stimuli is selected equally often during the test trials  (order is randomized)

Note: order of global/local tasks is randomized.

3. Block: mixed (assesses shifting costs)
- 11 practice trials (1 starttrial + 10 shift/nonshift trials) - don't count toward summary statistics
	- the starttrial selects the first task randomly
- 40 test trials: 20 shift + 20 nonshift trials (order is randomized)
- smiley feedback provided
- each of the two test stimuli is selected equally often during the test trials  (order is randomized)
- the starttrials 

Trial Sequence:
stimulus -> until response -> Feedback (500ms) -> ITI (500ms)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software:
Sizing can be controlled via an editable parameter

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - can be edited under section Editable Instructions
The instructions are presented in slide format. Slides can easily be customized in PowerPoint.

___________________________________________________________________________________________________________________	
EDITABLE CODE 
___________________________________________________________________________________________________________________	
check below for (relatively) easily editable parameters, stimuli, instructions etc. 
Keep in mind that you can use this script as a template and therefore always "mess" with the entire code 
to further customize your experiment.

The parameters you can change are:

/taskReminderDuration:			duration of the reminder that reminds participants what to pay attention to for the global/local block (default: 2000ms)
/feedbackDuration:				duration (in ms) of feedback smiley (default: 500ms)
/ITI:								intertrial interval (in ms) (default: 500ms)
/readyDuration:					duration (in ms) of the 'get ready' trial (default: 5000ms)

/stimSize:						sizing of the stims proportional to the canvas height (default: 50%)