User Manual: Inquisit Optical Illusion


___________________________________________________________________________________________________________________	

								Optical Illusions
								- Main Script- 
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of a computerized Visual Illusion Simulator (VIS)
inspired by Bednarek et al (2024).

The script provides the functionality to run several visual illusion tasks:
- Ebbinghaus Visual Illusion (opticalillusion_ebbinghaus.iqjs)
- Delboeuf Visual Illusion (opticalillusion_delboeuf.iqjs)
- Mueller-Lyer Visual Illusion (opticalillusion_muellerlyer.iqjs)
- Ponzo Visual Illusion (opticalillusion_ponzos.iqjs)
- Poggendorff Visual Illusion (opticalillusion_poggendorff.iqjs)
- T-Illusion (opticalillusion_tillusion.iqjs)
- Horizontal-Vertical Illusion (opticalillusion_horizontalvertical.iqjs)
- Zoellner Visual Illusion (opticalillusion_zoellner.iqjs)
(the individual tasks can be fine-tuned via changes in their respective scripts)

Due to the fact that screens vary wildly in absolute sizes and pixel sizes, this script
provides the functionality to run the illusion tasks with absolute sizing.
The default setup uses proportional sizing.
See section default for more info.

Reference:	

Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
Reduction of the Ponzo effect through working memory training. 
International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226										

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////Ebbinghaus Visual Illusion//////
Participant see a BASELINE setup (one center circle surrounded by 6 satellite circles) on the LEFT side of the screen
and a TARGET setup (one center circle surrounded by 6 satellite circles) on the RIGHT side of the screen.
The task is to match the size of the TARGET (center circle on the right) to the BASELINE (center circle on the left)
via  "right arrow key" (increase in size) and "left arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the ENTER key.

-> code to fine-tune this task can be found here: opticalillusion_ebbinghaus.iqjs

/////Delboeuf Visual Illusion///////
Task:
Participant see a BASELINE setup (one center circle embedded in a bigger circle) on the LEFT side of the screen
and a TARGET setup (one center circle embedded in a bigger circle) on the RIGHT side of the screen.
The task is to match the size of the TARGET (center circle on the right) to the BASELINE (center circle on the left)
via  "RIGHT arrow key" (increase in size) and "Left arrow key" (decrease in size) buttons. Once the sizes are matched, participants are asked
to press the [ENTER] key.

-> code to fine-tune this task can be found here: opticalillusion_delboeuf.iqjs

/////Mueller-Lyer Visual Illusion///////
Task:
Participant see a BASELINE setup ( >----------<) on the top
and a TARGET setup (<---------->) on the bottom.
The task is to match the length of the TARGET line to the BASELINE line
via  "RIGHT arrow key" (increase in size) and "Left arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

-> code to fine-tune this task can be found here: opticalillusion_muellerlyer.iqjs

/////Ponzo Visual Illusion///////
Participant see two non-parallel, vertical track lines in the middle of the screen that seemingly converge at the top.
In between those track lines, participants see two horizontal lines. The line closer to the track convergence point
(= the narrow part of the track) point is the BASELINE (= the Top line). The line on the bottom is the TARGET
(Target is closer to the wider part of the track).
The task is to match the length of the TARGET line to the BASELINE line
via  "RIGHT arrow key" (increase in size) and "Left arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

-> code to fine-tune this task can be found here: opticalillusion_ponzo.iqjs


/////Poggendorff Visual Illusion///////
Task:
Participant see two parallel, vertical track lines in the middle of the screen.
On the left side of the track display a BASELINE line intersects the track display but seems to 'vanish'
behind the tracks. 
On the right side of the track display a TARGET line 'continues' the BASELINE but is not positioned in the 
correct vertical spot on the right track.
The task is to adjust the vertical position of the TARGET line so that it correctly continues the BASELINE line
via  "RIGHT arrow key" (move up) and "Left arrow key" (move down) buttons. 
Once the lines are matched, participants are asked to press the [ENTER] key.

-> code for this task can be found here: opticalillusion_poggendorff.iqjs

/////T-Illusion///////
Task:
Participant see two lines arranged in an inverted T.
The horizontal line is the BASELINE. The vertical line is the TARGET.
The task is to match the length of the vertical TARGET line to the horizontal BASELINE line
via  "RIGHT arrow key" (increase in size) and "Left arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

-> code for this task can be found here: opticalillusion_tillusion.iqjs

/////Horizontal-Vertical-Illusion///////
Task:
Participant see two lines arranged in a mirrored L.
The horizontal line is the BASELINE. The vertical line is the TARGET.
The task is to match the length of the vertical TARGET line to the horizontal BASELINE line
via  "RIGHT arrow key" (increase in size) and "Left arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

-> code for this task can be found here: opticalillusion_horizontalvertical.iqjs

/////Zoellner-Illusion///////
Task:
Participant see 5 lines in the middle of the screen.
The second and fourth line are two parallel horizontal-ish BASELINES that may be slightly tilted. 
Each baseline is crossed with short, repeating lines (these crossing lines are the same for each baseline).

In between and on top and bottom of the two baselines, there are three TARGET lines. 
The Target lines are crossed with short, repeating lines that are orthogonal to the crossing lines of the baselines. 
The target lines are parallel to each other BUT are NOT parallel to the baselines.
The task is to match the rotation of the TARGET lines to the rotation of the BASELINE lines (aka make all lines parallel)
via  "RIGHT arrow key" and "Left arrow key" buttons. 
Once the rotation angles are matched, participants are asked to press the [ENTER] key.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 1 minutes per Visual Illusion task (or less)
(with approx. 15s per adjustment round)
Default script: 8 minutes
___________________________________________________________________________________________________________________	
DATA OUTPUT DICTIONARY
___________________________________________________________________________________________________________________
The fields in the data files are:

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

//built-in Inquisit variables:
								
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. 

response:					the response of participant during current trial
correct:					correctness of response (1 = correct, 0 = error)
latency:					response latency (in ms)

//custom variables:
illusion: 					the name of the current illusion task
stepSizeInPX: 				the step size adjustment in screen pixels
roundCounter: 				tracks the rounds run for the current illusion task


baselineSizeInMM: 			the BASELINE size (radius, length etc) in canvas mm (nature of baseline depends on task run)
baselineSizeInPX: 			the BASELINE size (radius, length etc) in canvas pixels (nature of baseline depends on task run)
								IMPORTANT Note: for Zoellner Illusion: 
								Zoellner "Sizes" are rotation angles of the baselines


targetStartSizeInMM: 		the start TARGET size (radius, length etc) in canvas mm at beginning of round (nature of target depends on task run)
targetStartSizeInPX: 		the start TARGET size (radius, length etc) in canvas pixels at beginning of round (nature of target depends on task run)
targetSizeInPX:				the current TARGET size (radius, length etc) in canvas pixels 
								IMPORTANT Note: for Zoellner Illusion: 
								Zoellner "Sizes" are rotation angles of the target lines

error:						sets the TARGET size (in px) relative to BASELINE size (in px)
							- error Prop < 1 the size was underestimated
							- error Prop > 1 the size overestimated
								IMPORTANT Note: for Zoellner Illusion: 
								error is the simple absolute DIFFERENCE in rotation angles of the Baselines and the Target lines


(2) Summary data file: 'opticalillusion_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)	

//Summary Data for Individual Visual Illusions								
(parameters)runEbbinghausIllusion: 	parameter setting
									true (1) = The script ran the Ebbinghaus Illusion Task
									false (0) = The script skipped the Ebbinghaus Illusion Task

roundCounterEbbinghausIllusion: 	the rounds run for the Ebbinghaus Illusion Task
meanEbbinghausError: 				the mean error across all trials run
stdEbbinghausError:					the standard deviation of the propErrors across all trials run
	

(same for all remaining visual illusion tasks)							
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________	

By default, the script runs the following illusion in random order:
- Ebbinghaus Visual Illusion
- Delboeuf Visual Illusion
- Mueller-Lyer Visual Illusion
- Ponzo Visual Illusion
- Poggendorff Visual Illusion
- T-Illusion
- Horizontal-Vertical Visual Illusion
- Zoellner Visual Illusion
IMPORTANT NOTE: each illusion task can be skipped via Editable Parameters settings.

///////////////General Set-up:
For each illusion participants are asked to adapt a TARGET to a BASELINE via button presses
(a '+' and '-' button as well as an 'submit' button).

● Number of Trials:
The number of trials run is determined by parameters.numberOfRoundsPerIllusion (see below in this script).
By default, each illusion runs 2 rounds.

● TARGET Start Size:
The target start sizes can be fixed or randomly determined by the script. This is controlled by
parameters.runFixedStartSizesOfTargets (see below in this script).
The individual start sizes are set in each of the individual illusion scripts.
Currently all illusion scripts run with fixed start sizes that either increase the goal by 25% or
decrease the goal by 25%.

If parameters.runFixedStartSizesOfTargets = false 
the target start size is randomly determined to be between a min/max percent of the baseline Size
(Script automatically ensures that the selected target size is less than 85% OR greater than 
115% of the baseline size - see individual illusion scripts for specific settings)

● Pixel Units:
All sizes (baseline/target) are calculated/displayed in ROUNDED screen pixels and adjustments are made
by increments/decrements of 1 pixel.
Note: Zoellner Illusion Task operates slightly different as the target unit are rotation angles

___________________________________________________________________________________________________________________	
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:

//color parameter
/ canvasColor = white		//Display color of the actively used portion of the screen (the 'canvas')	
							//Note: if set to a color other than the screencolor, the active canvas
							//appears 'anchored' on the screen regardless of monitor size
								
/ screenColor = white		//Color of the screen not used by the canvas ('inactive screen')
/ defaultTextColor = black		//Default color of text items presented on active canvas

//DESIGN ELEMENTS:
/ itiMS = 500					//the intertrial interval in ms (= duration of blank canvas in between rounds)

/ automaticAdjustmentIntervalMS = 150 //the duration (in ms) of the automatic adjustment interval if a finger does not lift off the arrow keys

/ responseKeyReminderDelayMS = 10000 //the delay which which the responseKeyReminder is provided if no response is detected

/ stepSizeInPX = 1				//sets the adjusting stepsize in pixels
								//Note: all baseline/target sizes and values are calculated in rounded screen pixels 
								
/ runFixedStartSizesOfTargets = true	//true = start sizes of targets will be fixed
										//Note: you have to set the start sizes within the individual illusion scripts
										//false = start sizes are determined randomly using the boundary parameters
										//specified in each illusion script
							
//task design:
/ numberOfRoundsPerIllusion = 2			//number of rounds to run per Illusion task
										//Note: You can set the specific values for each trial in each
										//of the individual illusion scripts

/ runEbbinghausIllusion = true			//true = The script runs the Ebbinghaus Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_ebbinghaus_inc.iqjs"
										//false = The script skips the Ebbinghaus Illusion task
										
/ runDelboeufIllusion = true			//true = The script runs the Delboeuf Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_delboeuf_inc.iqjs"
										//false = The script skips the Delboeuf Illusion task

/ runMuellerlyerIllusion = true			//true = The script runs the Muellerlyer Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_muellerlyer_inc.iqjs"
										//false = The script skips the Muellerlyer Illusion task

/ runPonzoIllusion = true				//true = The script runs the Ponzo Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_ponzo_inc.iqjs"
										//false = The script skips the Ponzo Illusion task	
	
/ runPoggendorffIllusion = true			//true = The script runs the Poggendorff Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_poggendorff_inc.iqjs"
										//false = The script skips the Poggendorff Illusion task
														
/ runTilIllusion = true					//true = The script runs the T-Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_tillusion_inc.iqjs"
										//false = The script skips the T-Illusion task	
					
/ runHorizontalVerticalIllusion = true	//true = The script runs the HorizontalVertical-Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_horizontalvertical_inc.iqjs"
										//false = The script skips the HorizontalVertical-Illusion task	
					
/ runZoellnerIllusion = true			//true = The script runs the Zoellner Illusion task
										//individual settings for this task can be changed in 
										//script file "opticalillusion_zoellner_inc.iqjs"
										//false = The script skips the Zoellner Illusion task											
										
Also check userManuals of Individual Illusion Scripts for editable settings


___________________________________________________________________________________________________________________	

										Optical Illusions: Ebbinghaus Visual Illusion Simulation (Ebb-VIS)
										- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of an Ebbinghaus Visual Illusion Simulation (Ebb-VIS).
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Ponzo effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit Ebbinghaus Visual Illusion Simulation (Ebb-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see a BASELINE setup (one center circle surrounded by 6 satellite circles) on the LEFT side of the screen
and a TARGET setup (one center circle surrounded by 6 satellite circles) on the RIGHT side of the screen.
The task is to match the size of the TARGET (center circle on the right) to the BASELINE (center circle on the left)
via  "RIGHT arrow key" (increase in size) and "LEFT arrow key" (decrease in size) buttons. Once the sizes are matched, participants are asked
to press the [ENTER] key.

Design:
By default, the Inquisit Ebb-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.eiTargetStart below):  by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)
Participants have as much time as needed.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minute to complete
(with approx. 15s per adjustment round)

___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_ebbinghaus_design.iqx'


___________________________________________________________________________________________________________________	

								Optical Illusions: Delboeuf Visual Illusion Simulation (Delb-VIS)
								- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of an Delboeuf  Visual Illusion Simulation (Delb-VIS).
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Ponzo effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit Delboeuf Visual Illusion Simulation (Delb-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see a BASELINE setup (one center circle embedded in a bigger circle) on the LEFT side of the screen
and a TARGET setup (one center circle embedded in a bigger circle) on the RIGHT side of the screen.
The task is to match the size of the TARGET (center circle on the right) to the BASELINE (center circle on the left)
via  "RIGHT arrow key" (increase in size) and "LEFT arrow key" (decrease in size) buttons. Once the sizes are matched, participants are asked
to press the [ENTER] key.

Design:
By default, the Inquisit Delb-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.dbiTargetStart below): by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)
Participants have as much time as needed.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minutes to complete
(with approx. 15s per adjustment round)

___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_delboeuf_design.iqx'


___________________________________________________________________________________________________________________	

										Optical Illusions: Mueller-Lyer Visual Illusion Simulation (Mull-VIS)
										- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of an Mueller-Lyer Visual Illusion Simulation (Mull-VIS).
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Ponzo effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit Mueller-Lyer Visual Illusion Simulation (Mull-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see a BASELINE setup ( >----------<) on the top
and a TARGET setup (<---------->) on the bottom.
The task is to match the length of the TARGET line to the BASELINE line
via  "RIGHT arrow key" (increase in size) and "LEFT arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

Design:
By default, the Inquisit MUL-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.mulTargetStart below): by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)
Participants have as much time as needed.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minute to complete
(with approx. 15s per adjustment round)

___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_muellerlyer_design.iqx'


___________________________________________________________________________________________________________________	

										Optical Illusions: Ponzo Visual Illusion Simulation (Pon-VIS)
										- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of an Ponzo Visual Illusion Simulation (Pon-VIS).
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Ponzo effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit Ponzo Visual Illusion Simulation (Pon-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see two non-parallel, vertical track lines in the middle of the screen that seemingly converge at the top.
In between those track lines, participants see two horizontal lines. The line closer to the track convergence point
(= the narrow part of the track) point is the BASELINE (= the Top line). The line on the bottom is the TARGET
(Target is closer to the wider part of the track).
The task is to match the length of the TARGET line to the BASELINE line
via  "RIGHT arrow key" (increase in size) and "LEFT arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

Design:
By default, the Inquisit Pon-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.ponTargetStart below): by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)
Participants have as much time as needed.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minute to complete
(with approx. 15s per adjustment round)
___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_ponzo_design.iqx'


___________________________________________________________________________________________________________________	

								Optical Illusions: Poggendorff Visual Illusion Simulation (Pog-VIS)
								- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of an Poggendorff Visual Illusion Simulation (Pog-VIS).
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Poggendorff effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit Poggendorff Visual Illusion Simulation (Pog-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see two parallel, vertical track lines in the middle of the screen.
On the left side of the track display a BASELINE line intersects the track display but seems to 'vanish'
behind the tracks. 
On the right side of the track display a TARGET line 'continues' the BASELINE but is not positioned in the 
correct vertical spot on the right track.
The task is to adjust the vertical position of the TARGET line so that it correctly continues the BASELINE line
via  "RIGHT arrow key" (move up) and "LEFT arrow key" (move down) buttons. 
Once the lines are matched, participants are asked to press the [ENTER] key.

Design:
By default, the Inquisit Pog-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.pogTargetStart below): by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)

Participants have as much time as needed.

NOTE: you can visually check the calculations used for the Inquisit Poggendorff Illusion script 
in "opticalillusion_poggendorfcheckcalculations.iqx"
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minute to complete
(with approx. 15s per adjustment round)

___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_poggendorf_design.iqx'


___________________________________________________________________________________________________________________	

										Optical Illusions: T- Visual Illusion Simulation (Til-VIS)
										- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of a T-Illusion Visual Illusion Simulation (Til-VIS).
The T-illusion is part of the horizontal-vertical illusions with the vertical line bisecting the horizontal line.
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Ponzo effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit T- Visual Illusion Simulation (Til-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see two lines arranged in an inverted T.
The horizontal line is the BASELINE. The vertical line is the TARGET.
The task is to match the length of the vertical TARGET line to the horizontal BASELINE line
via  "RIGHT arrow key" (increase in size) and "LEFT arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

Design:
By default, the Inquisit Til-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.tilTargetStart below):  by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)
Participants have as much time as needed.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minute to complete
(with approx. 15s per adjustment round)

___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_tillusion_design.iqx'


___________________________________________________________________________________________________________________	

										Optical Illusions: Horizontal-Vertical- Visual Illusion Simulation (hv-VIS)
										- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of a Horizontal-Vertical-Illusion Visual Illusion Simulation (hv-VIS).
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Ponzo effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit Horizontal-Vertical- Visual Illusion Simulation (hv-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see two lines arranged in a mirrored L.
The horizontal line is the BASELINE. The vertical line is the TARGET.
The task is to match the length of the vertical TARGET line to the horizontal BASELINE line
via  "RIGHT arrow key" (increase in size) and "LEFT arrow key" (decrease in size) buttons. 
Once the sizes are matched, participants are asked to press the [ENTER] key.

Design:
By default, the Inquisit hv-VIS runs 5 trials (see Editable Parameters) and runs - by default-
the same setup for the baseline (top) and target (bottom) stimulus display for each trial.
(however, the displays can be manipulated for each individual trial via Editable Lists).
The starting size of the TARGET line is randomly decided for each trial using sizes that are between half to 1.5 times 
the length of the BASELINE line (check Editable Parameters to change the range) with the constraint
that sizes are either at least 85% or less than the BASELINE OR 115% or greater than the BASELINE.
Participants have as much time as needed to match the lines.

Design:
By default, the Inquisit HV-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.hvTargetStart below):  by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)
Participants have as much time as needed.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minutes to complete
(with approx. 15s per adjustment round)

___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_hvlusion_design.iqx'


___________________________________________________________________________________________________________________	

										Optical Illusions: Zoellner Visual Illusion Simulation (zoll-VIS)
										- Helper script (does not run on its own)
___________________________________________________________________________________________________________________	


Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 02-26-2024
last updated:  01-02-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-02-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________
This script implements Millisecond Software's version of an Zoellner Visual Illusion Simulation (zoll-VIS).
It is run by Inquisit script 'opticalillusion.iqx'.
The setup of the task was inspired by the VIS description provided by Bednarek et al (2024).


Reference:											

 Bednarek, H., Przedniczek, M., Wujcik, R., Olszewska, J. M., & Orzechowski, J. (2024). 
 Cognitive training based on human-computer interaction and susceptibility to visual illusions. 
 Reduction of the Ponzo effect through working memory training. 
 International Journal of Human-Computer Studies, 184, 103226-. https://doi.org/10.1016/j.ijhcs.2024.103226

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________

/////////////////////////////////////////////////////////////////////////////////////////
////////////Inquisit Zoellner Visual Illusion Simulation (zoll-VIS)/////////////
/////////////////////////////////////////////////////////////////////////////////////////
 
Task:
Participant see 5 lines in the middle of the screen.
The second and fourth line are two parallel horizontal BASELINES that may be slightly tilted. 
Each baseline is crossed with short, repeating lines (these crossing lines are the same for each baseline).

In between and on top and bottom of the two baselines, there are three TARGET lines. 
The Target lines are crossed with short, repeating lines that are orthogonal to the crossing lines of the baselines. 
The target lines are parallel to each other BUT are NOT parallel to the baselines.
The task is to match the rotation of the TARGET lines to the rotation of the BASELINE lines (aka make all lines parallel)
via  "RIGHT arrow key" and "LEFT arrow key" buttons. 
Once the rotation angles are matched, participants are asked to press the [ENTER] key.

Design:
By default, the Inquisit Ebb-VIS runs 2 rounds/trials (see parameters.numberOfRoundsPerIllusion in opticalillusion.iqx).
The display sizes are determined by editable lists in this script (see below to make changes).
Depending on 'parameters.runFixedStartSizesOfTargets' (script opticalillusion.iqx) 
The TARGET start sizes are either
1. fixed (see list.zolTargetStart below):  by default they are 25% smaller and 25% larger than goal
2. or randomly determined using the parameters settings of this script (see below under parameter settings)
Participants have as much time as needed.

The starting size of the TARGET rotation angle is randomly decided for each trial using 
parameters.zolTargetMinAngleChange and zolTargetMaxAngleChange. The script ensures that the
resulting start size is always at least 5degrees different to the baseline rotation angle.


___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the task takes appr. 1 minute to complete
(with approx. 15s per adjustment round)
___________________________________________________________________________________________________________________	
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.

IMPORTANT NOTE:
you can try out different editable parameter/list settings using script 'opticalillusion_zoellner_design.iqx'