___________________________________________________________________________________________________________________ Adams Task ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 09-16-2022 last updated: 03-28-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 03-28-2023 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 FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored 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 solutionTime_inms: 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 propCorrect_practice: proportion correct practice performance (based on values.ACC) countTestTrials: number of test trials run propCorrect_test: proportion correct test performance (based on values.ACC) /////////// TEST Note: the number refers to ORDER in which the test problem was run /////////// test1_image: the image used for the first test problem run Example: 'testA' test1_ACC: 1 = the final matrix for the first TEST problem is symmetric AND the fewest number of clicks were made to achieve symmetry 0 = otherwise test1_solutionTime: time (in ms) until participant clicked 'next' button for the first TEST problem test1_Symmetry: 1 = the final test grid for the first test problem was symmetric; 0 = otherwise test1_minClicks: stores the minimum number of clicks to achieve symmetry for the first test matrix test1_AddClickCounter: stores the number of Addition - Clicks made on the first test grid test1_SubtractClickCounter: 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: