User Manual: Inquisit Anagrams Test


___________________________________________________________________________________________________________________	

													*Anagram Task*
___________________________________________________________________________________________________________________	

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

Script Copyright © 03-29-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements a simple Anagram Test procedure

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	

Participants are asked to solve 5 easy and 5 difficult anagrams (order of easy and difficult anagrams is 
fixed). They have 2 minutes per anagram and can enter as many solutions as they want during that time frame.
A correct solution will terminate the current anagram and automatically present the next one.
If participants run out of time, the next anagram is presented automatically.
Participants can skip any anagram at any point, by entering 'SKIP' into the textbox.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes approx. 7 minutes.

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

(1) Raw data file: 'anagramtask_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. 
										
***built-in Inquisit variables: 
Note that in this script, only the trial.easyAnagramData/trial.difficultAnagramData store
data to the data files. These trials do not collect responses.
All other trials are set to /recorddata = false.

response:					the participant's response (scancode of response buttons)
correct:					accuracy of response: 1 = correct response; 0 = otherwise
latency: 					the response latency (in ms); measured from: 

***custom variables
anagramCondition:			'easy' vs. 'difficult 
anagramIndex:				the itemnumber of the current anagram 
anagram:					the presented anagram  
suggestedSolutions:			collects all suggested solutions for an anagram 

lastSuggestedSolution:		the last suggested solution 
							Note: if a participant enteres 'SKIP', the last suggested solution will be empty by default
							(however suggestedSolutions will contain all suggested solutions collected up to this point)

correctSolution:			the correct solution for each anagram
anagramAcc:					1 = final suggested solution is correct; 2 = final suggested solution is incorrect 
anagramRT:					the cumulative time (in ms) that participants spent on solving each anagram  

skip:						1 = participant entered 'SKIP' into the textbox; 0 = participant did not enter 'SKIP' 
									
countAttempts:				the number of suggested solutions per anagram


(2) Summary data file: 'anagramtask_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)
									
									
countSkipsEasy:		counts the number of times participant entered 'SKIP' for an easy anagram
meanAttemptsEasy:		mean number of solutions provided for easy anagrams (includes anagrams that were 'skipped' at some point)
propCorrectEasy:		proportion correctly solved easy anagrams 
meanRTEasy:			mean time (ms) participant spent on easy anagrams
meanCorrRTEasy:		mean time (ms) participant spent on easy anagrams that were solved correctly
(same for difficult anagrams)							
							
* 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 
___________________________________________________________________________________________________________________	

Anagram 1, 2, 5, 8, 10 randomly sample without replacement from the 5 easy anagrams.
Anagram 3, 4, 6, 7, 9 randomly sample without replacement from the 5 difficult anagrams.

Eachh anagram has 2 minutes.
=> if participant enters an incorrect solution: feedback is given, the last suggested solution is cleared out
and participant can make another attempt
=> if participant enters the correct solution: feedback is given and the next anagram is presented automatically
=> if participant runs out of time: the next anagram is automatically provided with the note 'ok - let's try this one instead'
=> if participant enters 'skip' at any point: no feedback is provided and the next anagram is presented immediately
___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________
provided by Millisecond Software - can be edited under section Editable Stimuli

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
provided by Millisecond Software - can be edited under section Editable Instructions
___________________________________________________________________________________________________________________	
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: