User Manual: Inquisit Dimensional Change Card Sort (DCCS) - Advanced Version


___________________________________________________________________________________________________________________	

								*Dimensional Change Card Sort (DCCS)*
					(Advanced/Mixed Version - formerly the 'Border' Version)
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 11-04-2021
last updated:  10-09-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 10-09-2024 Millisecond Software

Millisecond Software thanks Samantha Gualtieri for her help with this script!

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a computer implementation of the Advanced/Mixed Version (formerly: Border Version) 
Dimensional Change Card Sort (DCCS) task  as described by Zelazo (2006). The DCCS is a widely used test of 
executive functioning in children as young as 3 years olds. It is originally played with real cards.
This computer implementation attempts to stay close to the original procedure. This script, however,
replaces the 'border' (or picture frames) cues by verbal cues before each trial.  It is best played
on touchscreens where children can simply touch the relevant categories. Nevertheless, it can also be
played with the mouse on regular desktops. 

Reference
Zelazo, P.D. (2006). The Dimensional Change Card Sort (DCCS): a method of assessing executive function in children.
Nature Protocols, 1, pp. 297+. 

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

--------------------------------------------------------------------------
Standard Version (Inquisit script dccs_standard.iqjs): Blocked Conditions
--------------------------------------------------------------------------
Participants see two categories up top: a blue shape1 with a sorting basket and a red shape2 with a sorting basket.
The game is played in two phases:
1. Pre Phase: participants either start with the COLOR game or the SHAPE game.

In the COLOR game, participants are asked to sort cards of red bunnies and blue boats in the respective
baskets. Red bunnies should be sorted in the basket of the red boats whereas blue boats should be sorted in
the basket of the blue bunny.

In the SHAPE game, participants are asked to sort cards of red bunnies and blue boats in the respective
baskets. Red bunnies should be sorted in the basket of the blue bunny whereas blue boats should be sorted in
the basket of the red boat

Participants are assigned to either the COLOR or SHAPE game by groupnumber and work on 6 trials (editable parameter)
(no feedback is provided). By default, participants are NOT reminded of the COLOR (or SHAPE) rule
before each trial (as is done in Zelazo, 2006). However, if needed, that feature can be turned on under
section 'Editable Parameters'

Addition: this script runs 2 practice trials for the pre-sorting game. 
Participants have to get both trials correct before moving on to the pre-test and they
have 3 attempts (editable parameter) to pass this practice. If they don't pass the pre-practice,
the script is prematurely aborted.

2. Post Phase: after 6 trials (editable parameter) the game changes from the COLOR game to the SHAPE game 
(or from the SHAPE game to the COLOR game). 

Participants again work on 6 trials. By default, participants are reminded of the COLOR (or SHAPE) rule
before each trial.

A participant is said to 'pass' the standard version if they get
80% (editable parameter) Post Trials correct.

--------------------------------------------------------------------------
Advanced Version (formerly: Border Version): Mixed Conditions
--------------------------------------------------------------------------
If participants pass the Standard Version, they can immediately be tested with the Advanced Version.
The Advanced Version runs color and shape trials in a mixed block. A verbal cue is presented
upfront to let participants know which task should be performed:
- Color Game OR
- Shape Game
After a short introduction of the Advanced Version, participants play 12 trials (editable parameters). ule.

A participant is said to 'pass' the Advanced version if they get at least 75% trials correct.

Notes: 
* this script uses audio stimuli - please make sure to have audio on
* the 'Advanced' game was originally called the 'Border Game' by Zelazo (2006) as it used non-verbal borders 
around the cards as cues to signal the color condition (no border meant that the shape game should be played).
The Inquisit version uses verbal cues instead.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
Standard Version (separate color and shape sorting blocks): takes appr. 5 minutes to complete
Advanced Version (mixed color and shape sorting blocks): takes appr. 5 minutes to complete
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________		
The fields in the data files are:

(1) Raw data file: 'dccs_advanced_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. 
								
dccsStandardPreCategory:	the game category (color vs. shape) that the participants started the DCCS standard version with (if applicable)
																		
phase:						"advanced"
trialCount:					trialcounter per phase

trialType:					1 = red (color)
							2 = blue (color)
							3 = bunny (shape)
							4 = boat (shape)
							
cue:						C(olor) vs. S(hape)							
									
stim:						the currently presented image (filename of image)

correctResponse:			the correct response for the current trial

response:					the participant's response (selected basket)
correct:					accuracy of response: 1 = correct response; 0 = otherwise
latency: 					the response latency (in ms); measured from: onset of card 


(2) Summary data file: 'dccs_advanced_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)
									
dccsStandardPreCategory:	the game category (color vs. shape) that the participants started the DCCS standard version with (if applicable)
dccsStandard:				"pass" vs. "fail"									

trialCountAdvanced:			total number of Advanced trials run									
countCorrectAdvanced:		number correctly sorted items in the Advanced Game
propCorrectAdvanced:		proportion correct in the Advanced Game
meanCorrAdvancedRT:			mean correct response time (in ms) in the Advanced Game

trialCountAdvancedColor:	total number of Advanced Color trials run
propCorrectAdvancedColor:	proportion correct color trials in the Advanced Game
meanCorrRTAdvancedColor:	mean correct response time (in ms) on color trials in the Advanced Game

trialCountAdvancedShape:	total number of Advanced Shape trials run
propCorrectAdvancedShape:	proportion correct shape trials in the Advanced Game
meanCorrRTAdvancedShape:	mean correct response time (in ms) on shape trials in the Advanced Game

//categorical summary data:
dccsAdvanced:				"pass" (75% correct or higher)
							"fail" otherwise	

dccsAdvancedScore:			if pass => 1; if fail => 0

dccsScore:					only applicable if run in conjunction with Standard version:
							0 = participant failed 'Pre' block (Standard)
							1 = participant passed 'Pre' block but failed 'Post' block (Standard)
							2 = participant passed 'Pre' and 'Post' block (Standard) but failed Advanced version	
							3 = participant passed Advanced version
							
							
* 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 
___________________________________________________________________________________________________________________	

Participants are given a short introduction to the Advanced Game
with one practice trial each

1. Test 12 trials
- 3 color trials with a red bunny
- 3 color trials with a blue boat
- 3 shape trials with a red bunny
- 3 shape trials with a blue boat
- trials are randomly selected with the constraint that the same trialtype cannot run
consecutively

Participants 'pass' the advanced DCCS if they respond correctly to at least 75% of the test trials.

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli
- stimuli downloaded under the Creative Commons License.

The stimuli can easily be exchanged for others. Go to section Editable Stimuli.
If the categories are changed from Bunnies and Boats, the instructions have to be updated accordingly.

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
inspired by instructions suggested by Zelazo (2006)
___________________________________________________________________________________________________________________	
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:

/ showQuitButton = true 			//true = the script presents a convenient 'quit' button in the form of a gray X
									//at the top of the screen. Once pressed, the script terminates.
									//false = no quit button is presented
									
									
/ ruleReminderAdvanced = false		//true = participants get reminded of the rules before each trial
									//false = no rule reminders are given before each trial
									
									
									
/ numberOfTestTrials = 12			//the number of trials to run during the advanced test
									//Note: number needs to be divisible by 4

/ dccsStandardPass = 0.75			//participant needs to get 75% of the test trials correct to pass the advanced version 	

//duration parameter
/ cardDelay = 500					//duration (in ms) between offset of cue sound file and onset of card
/ iti = 500							//the intertrial interval (in ms) btw. test trials