User Manual: Inquisit Judgment of Line and Position Task


___________________________________________________________________________________________________________________	

						JUDGMENT OF LINE ANGLE AND POSITION TASK (JLAP) - 15
___________________________________________________________________________________________________________________

Script Author: Sean Draine, Ph.D. (seandr@millisecond.com) for Millisecond Software LLC
last updated:  07-26-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 07-26-2023 Millisecond Software
___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________

This script implements a computerized Judgment of Line Angle and Position (JLAP-15) task;
a measure of visuospatial ability known to reveal sex differences.

The implemented procedure is based on:

Collaer, M., Reimers, L., & Manning, S. (2007). Visuospatial Performance on an Internet 
Line Judgment Task and Potential Hormonal Markers: Sex, Sexual Orientation, and 2D:4D. 
Archives of Sexual Behavior, 36(2), 177-192.

___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________	
Participants are given 20 lines (one at a time), presented at a specific angle, and have to select 
their equals out of 15 line options within 10s per line. 
											
___________________________________________________________________________________________________________________	
DURATION 
___________________________________________________________________________________________________________________	
the default set-up of the script takes appr. 3 minutes to complete

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

(1) Raw data file: 'jlap15_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 such as feedback trials
									
trialCount:						trialCount (custom variable)
targetLine:						number of the current target line
targetAngle:					the angle of the target line

selectedLine:					number of the selected comparison line (0 = no reponse given; timed-out)
								Note: line 1 and line 15 are both correct responses for line 1 or 15.
										
correctResponse:1 if judgment is correct, 0 if not
latency:						response time (in ms); measured from onset of trial until line is clicked or trial times out


Angle Degree Data:

trial.jlap.responseX:			horizontal pixel of touch/mouse response
trial.jlap.responseY:			vertical pixel of touch/mouse response
responseAngleDegrees:			computed angle of response

angleDiff:						the absolute difference between the computed angle of response and targetAngle
								A) if the area under line 1 is selected, the response Area is determined to be '15'
								and responseAngleDegrees are negative btw. ~-168 > x > -180
								=> the script converts the responseAngleDegrees to the equivalent difference to 180
								in order to calculate the meanAngleDifference
								e.g. -178 => converted to 182
							
								B) line 1 and line 15 are both correct responses for line 1 or 15.
								The calculated angle difference takes this into consideration 	
										

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

totalCorrect:					total number of correct judgments
totalErrors:					total number of erroroneous judgments
sumDiffErrors:					sum of the differences between the target and judgment indices

meanAngleDif:					mean absolute difference between the computed angle of response and targetAngle
									(for all selected lines)
								
								Notes:
								A) if the area under line 1 is selected, the response Area is determined to be '15'
								and responseAngleDegrees are negative btw. ~-168 > x > -180
								=> the script converts the responseAngleDegrees to the equivalent difference to 180
								in order to calculate the meanAngleDifference
								e.g. -178 => converted to 182
							
								B) line 1 and line 15 are both correct responses for line 1 or 15.
								The calculated angle difference takes this into consideration 
									 								
___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
- 15 different angles/lines (though angle/lines 1 and 15 are essentially treated the same)
- 20 line judgment trials, each presented for a max of 10s (editable parameters)
- by default the lines are tested in sequence (same sequence as published by Collaer et al, 2007)
(edit under section Editable Lists)

___________________________________________________________________________________________________________________
STIMULI
___________________________________________________________________________________________________________________							
The lines are provided as images. 	

__________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________								
provided by Millisecond Software as html-files. The html files (see script folder) can be directly edited to
change instructions. Use a simple text editor such as Notepad (windows) or TextEdit (Mac).

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

/timeout:		sets the response deadline (in ms) for each judgment (default: 10000ms = 10s)

/feedback:		true (1): provides performance feedback after each trial 
				false (0): no performance feedback after each trial is provided (default)