Return to the Judgment of Line and Position Task page
___________________________________________________________________________________________________________________	

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

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

Script Copyright © 10-31-2019 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 FILE INFORMATION 
___________________________________________________________________________________________________________________	
The default data stored 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
script.sessionid:				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
									
values.trialCount:			trialcount (custom variable)
expressions.targetLine:		number of the current target line
values.targetAngle:			the angle of the target line

values.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.
										
expressions.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
expressions.responseAngleDegrees:computed angle of response

expressions.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)

computer.platform:			the platform the script was run on (win/mac/ios/android)
script.startdate:				date script was run
script.starttime:				time script was started
script.subjectid:				assigned subject id number
script.groupid:				assigned group id number
script.sessionid:				assigned session id number
script.elapsedtime:			time it took to run script (in ms); measured from onset to offset of script
script.completed:			0 = script was not completed (prematurely aborted); 
								1 = script was completed (all conditions run)

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

expressions.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)