User Manual: Inquisit Adams Task


___________________________________________________________________________________________________________________	

											Adams Task
											(German Version)											
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 09-16-2022
last updated:  03-29-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 03-29-2023 Millisecond Software

German Translation provided by K. Borchert for Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of the 'Adams Task' - a problem solving
paradigm investigating people's use of additive and subtractive changes to convert asymmetrical images
to symmetrical ones.

Reference:											

Adams, G.S., Converse, B.A., Hales, A.H. et al. People systematically overlook subtractive changes. 
Nature 592, 258–261 (2021). https://doi.org/10.1038/s41586-021-03380-y
___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

Participants are presented 10x10 grids made out of boxes of 2 different colors.
The initial color pattern is asymmetrical and the task is to make the pattern symmetrical 
(left to right, top to bottom) with the fewest clicks possible (when clicked, each box reverses its color).

2 experimental conditions:
1) with practice: participants work through up to 3 practice problems before working on the test problem(s)
2) without practice: participants only work on the test problem(s) (no practice)

Assignment to the two experimental conditions is done via list.practiceProblems settings
(see section Editable Parameters)

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

___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

(1) Raw data file: 'adamstask_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:					with the current subject id
group: 						with the current group id
session:					with the current session id

expCondition:				"practice" vs. "no practice"
							see section Editable Parameters						
							
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. 
								
								
countPracticeTrials: 		counter for the practice trials
countTestTrials: 			counter for the test trials

image: 						"demo", "practice1/2/3", "test1/2/3/4/5"
							Note: the number in the image file does not refer to the order in which it is run

fewestClicks:				the fewest clicks needed to achieve symmetry for the current image

countClicks:				the number of clicks made by participant

addClickCounter:			the number of Addition clicks (Addition click = a click that turns a background color into the target color) 
subtractClickCounter:		the number of Subtraction clicks (Subtraction clicks = a click that turns a target color into a background color)

symmetry:  					1 = the final matrix is symmetric; 0 = otherwise

acc: 						1 = the final matrix is symmetric AND the fewest number of clicks were made to achieve symmetry
							0 = otherwise
							
solutionTimeMS:			the cumulative response times (in ms) until the 'next' button is pressed						
								
//built-in DVs:
response:					the response of participant (box clicked or button pressed)
latency:					response latency (in ms); measured from: onset of trial


(2) Summary data file: 'adamstask_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)
												
expCondition:				"practice" vs. "no practice"
							see section Editable Parameters							

//Summary Data:

countPracticeTrials:		number of practice trials run
propCorrectPractice:		proportion correct practice performance (based on values.acc)

countTestTrials:			number of test trials run
propCorrectTest:			proportion correct test performance (based on values.acc)


///////////
test:

Note: the number refers to ORDER in which the test problem was run
///////////

test1Image:				the image used for the first test problem run 
							Example: 'testA' 

test1Acc: 					1 = the final matrix for the first TEST problem is symmetric AND the fewest number of clicks were made to achieve symmetry
							0 = otherwise
							
test1SolutionTime:			time (in ms) until participant clicked 'next' button for the first TEST problem

test1Symmetry:				1 = the final test grid for the first test problem was symmetric; 0 = otherwise 
test1MinClicks:			stores the minimum number of clicks to achieve symmetry for the first test matrix
test1AddClickCounter:		stores the number of Addition - Clicks made on the first test grid
test1SubtractClickCounter:	stores the number of Subtraction - Clicks made on the first test grid

same for max = 5 test problems
							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

NOTES:
● Script can be run with 0-3 practice problems and 0-5 test problems for each participant
=> See section Editable Parameters for more info (look for list.practiceProblems/list.testProblems)

////Setup/////

(1) Intro with Demo Matrix
Participants get the chance to play with a demo matrix and change colors. Self-paced.

(2) Practice (if practice should be run - see above)
Up to 3 practice matrices presented. Self-paced.
list.practiceProblems (Under Section Editable Parameters) controls
● how many practice problems are run (0-3)
● which practice problems are run
● in what order those practice problems should be run

The default setup runs 3 practice problems in fixed order.

(3) Test (all)
Up to 5 Critical Test Matrices. Self-paced.
list.testProblems (Under Section Editable Parameters) controls
● how many practice problems are run (0-5)
● which practice problems are run
● in what order those practice problems should be run

The default setup runs 1 test problem.

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________

This script uses the matrices used in the original Qualtrics survey. However,
the matrices can be easily adapted under section Editable Stimuli

stimuli: https://osf.io/7v6r2/
(Qualtrics survey)
___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________

This script uses instructions used in the original Qualtrics survey
instructions: https://osf.io/7v6r2/
(Qualtrics survey)
___________________________________________________________________________________________________________________	
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: