User Manual: Inquisit Random Dot Kinematogram (RDK) Demo


___________________________________________________________________________________________________________________	

									*Random Dot Motion Displays: Demo*
___________________________________________________________________________________________________________________	

Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 04-23-2021
last updated:  01-13-2025 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 01-13-2025 Millisecond Software

Millisecond Software thanks Dr. Aaron Seitz for his generous help with Random Dot Motion Displays!
___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script runs a demonstration of random dot motion displays.
The random dot displays are presented via an animated html-element
that uses the jsPsych framework (Josh de Leeuw, 2008) and the "jspsych-rdk.js" plugin
(Rajananda, 2018). 


///References

Pilly, P.K. & Aaron R. Seitz, A.R (2009)
What a difference a parameter makes: A psychophysical comparison of random dot motion algorithms,
Vision Research, 49, 1599-1612,
https://doi.org/10.1016/j.visres.2009.03.019.

Rajananda, S., Lau, H. & Odegaard, B., (2018). A Random-Dot Kinematogram for Web-Based Vision Research. 
Journal of Open Research Software. 6(1), p.6. DOI: [http://doi.org/10.5334/jors.194]
(Note: Millisecond slightly edited the provided "jspsych-rdk.js" plugin code to allow the cross to be 
moved in the direction of the coherent dots).

__________________________________________________________________________________________________________________	
TASK
___________________________________________________________________________________________________________________	

This script runs as many demo trials as needed.

For each trial:
- choose the RDK type
- aperture type
- relative dot size
- number of dots (up to 300)
- movement coherence (1% to 100%)
- 'speed' of coherent dots
- movement angle (direction of movement)
- duration of rdk movement display

Fixed in this script:
The random dot display will be presented with a border and a cross in the center.
The cross is rotated in such a way that one arm points in the direction of the movement;
the other is orthogonal to it.

___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 1 minutes to complete

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

(1) Raw data file: 'xxxx_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. 

stimulusItem:						the presented stimuli in order of trial presentation
response:							the participant's response
latency: 							the response latency (in ms)


//display:
RDKType:							1: signal dots always stay signal dots & noise dots are randomly positioned in each frame (no trajectories for random dots)
									2: signal signal dots always stay signal dots & noise dots are on random trajectories that change directions randomly in each frame
									3: signal signal dots always stay signal dots & noise dots are placed on random trajectories that do not change directions
									4: signal dots can turn into noise dots & noise dots are randomly positioned in each frame
									5: signal dots can turn into noise dots & noise dots are on random trajectories that change directions randomly in each frame
									6: signal dots can turn into noise dots & noise dots are placed on random trajectories that do not change directions
									
									Note: for 4/5/6 it is randomly decided in each frame which dot is a signal dot and which dot is a noise dot.

apertureType:						1 = circle
									2 = ellipse
									3 = square
									4 = rectangle
									
dotRadiusPct:						the radius of the dots in canvasHeight Pct									
																				
numberOfDots:						the number of dots currently on display 
coherence:							the selected coherence value (percentage of signal dots)

direction:							the selected motion angle (counterclockwise)	
									0: movement from E->W
									90: movement from S->N
									180: movement from W->E
									270: movement from N->S
									
moveDistancePct:					the selected 'speed' of signal dots	

duration:							the display duration in ms															
							
* separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section
"DATA" and follow further instructions



___________________________________________________________________________________________________________________	

								*RANDOM DOT MOTION DISPLAY DEMO- SELECTION SCREEN*
								HELPER SCRIPT
___________________________________________________________________________________________________________________	

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

Script Copyright © 01-10-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the RANDOM DOT MOTION DISPLAY DEMO selection screen



___________________________________________________________________________________________________________________	

								*RANDOM DOT MOTION DISPLAY DEMO- RDK DISPLAY*
								HELPER SCRIPT
___________________________________________________________________________________________________________________	

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

Script Copyright © 01-13-2025 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________	

This script implements the Inquisit trial to run the RDK display via an animated html-element
that uses the jsPsych framework (Josh de Leeuw, 2008) and the "jspsych-rdk.js" plugin
(Rajananda, 2018).

Reference:
Rajananda, S., Lau, H. & Odegaard, B., (2018). A Random-Dot Kinematogram for Web-Based Vision Research. 
Journal of Open Research Software. 6(1), p.6. DOI: [http://doi.org/10.5334/jors.194]
(Note: Millisecond slightly edited the provided "jspsych-rdk.js" plugin code to allow the cross to be 
moved in the direction of the coherent dots).