Return to the Self-Paced Reading Task page
						
						  Self-Paced Reading (Moving Window Paradigm)
SCRIPT INFO

Script Author: David Nitz (dave@millisecond.com) for Millisecond Software, LLC
last updated:  12-01-2015 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC

Copyright ©  12-01-2015 Millisecond Software


BACKGROUND INFO

											*Purpose*
This script implements the  Self-Paced Reading procedure described in:

	Just, M. A., Carpenter, P. A., & Woolley, J. D. (1982). Paradigms and processes in reading 
	comprehension. Journal of Experimental Psychology: General, 111(2), 228-238.

	Related resources:

	Just, M. A., & Carpenter, P. A. (1980). A theory of reading: From eye fixations to 
	comprehension. Psychological Review, 87(4), 329-354.

	Thibadeau, R., Just, M. A., & Carpenter, P. A. (1982). A model of the time course and
	content of reading. Cognitive Science, 6, 157-203.

	Mitchell, D. C. (2004). On-line methods in language processing: Introduction and historical 
	review. In M. Carreiras & C.E. Clifton, Eds., The on-line study of sentence comprehension: 
	Eyetracking, ERP and beyond (pp. 15-32). New York, NY: Psychology Press.
	
Note: Currently this program only supports left-to-right (LTR) languages.


											  *Task*
Masked text examples are presented and revealed word by word by Spacebar press.
2 conditions: 
cumulative => words already revealed stay revealed
non-cumulative => words that have been revealed are masked again when the next word is revealed										  


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

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

build:							Inquisit build
computer.platform:				the platform the script was run on
date, time, subject, group:		date and time script was run with the current subject/groupnumber 
blockcode, blocknum:			the name and number of the current block
trialcode, trialnum: 			the name and number of the currently recorded trial
									(Note: not all trials that are run might record data; by default data is collected unless /recorddata = false is set for a particular trial/block) 
response:						the participant's response
correct:						the correctness of the response (1 = correct; 0 = incorrect)
latency: 						the response latency (in ms)

list.mwstims.nextvalue:			current "page" number 
text.mywindow.stimulusonset:	returns the stimulus onset time. The onset time is the point at which the stimulus 
									is presented relative to the start of the trial.			
windowstring					The current window (always unmasked)
wincount						Ordinal number of the currently displayed text segment (window).
inputend						Returns the total number of characters of the current input string
									(paragraph or sentence to be displayed in window segments). Used
									to determine the end of the paragraph and initiate the selection of 
									the next stimulus (sentence or paragraph).
winstart						Start position of current text segment (window).
winend							End position of current text segment (window) 
cumulative						Determines the moving window mode to use. If set to 'true', any 
									previously displayed window segments will remain visible on the 
									screen. If set to 'false' any previously displayed window segments will
									be remasked (noncumulative mode). Default is 'false'.
highlight						Determines whether the current window should be displayed in a 
									different color than the remaining (masked or unmasked) text in 
									order to make it more salient. The highlighting color can be adjusted 
									via the '/ txcolor' attribute of 'text.mywindowhl'. Default is 'true'.

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

script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				subject id number
script.groupid:					group id number
script.elapsedtime:				time it took to run script (in ms)
computer.platform:				the platform the script was run on
/completed:						0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run)


EXPERIMENTAL SET-UP
runs 2 conditions:
Cumulative (revealed words stay revealed) and Non-cumulative (once revealed words get mask again)
	
STIMULI
see section Editable Stimuli

INSTRUCTIONS
see 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:

	windicator					A single character that indicates each display segment (window). 
								Must be set to a character which doesn't occur "naturally" in throughout
								the stimulus material (e.g. '|' or '#'). Each stimulus must start and end 
								with this character. Default is "I".
	cumulative					Determines the moving window mode to use. If set to 'true', any 
								previously displayed window segments will remain visible on the 
								screen. If set to 'false' any previously displayed window segments will
								be remasked (noncumulative mode). Default is 'false'.
	highlight					Determines whether the current window should be displayed in a 
								different color than the remaining (masked or unmasked) text in 
								order to make it more salient. The highlighting color can be adjusted 
								via the '/ txcolor' attribute of 'text.mywindowhl'. Default is 'true'.
	ucmaskchar					Character used to mask uppercase letters and numbers (as defined in 
								'list.uppercase'). Suitable characters include (but are not limited to)
								"-", "—", "_" or "…". The masking character may not be identical to
								the character defined as window indicator (-> 'parameters.windicator')!
								Default is "-".
	lcmaskchar					Character used to mask lowercase letters and interpunctuation 
								characters (as defined in 'list.lowercase'). Suitable characters 
								include (but are not limited to) "-", "—", "_" or "…". The masking 
								character may not be identical to the character defined as window 
								indicator (-> 'parameters.windicator')! Default is "-".

Copyright © Millisecond Software. All rights reserved.
Contact | Terms of Service | Security Statement | Employment