User Manual: Inquisit Grammatical Acceptability Judgment Task


___________________________________________________________________________________________________________________	

								LINGUISTIC ACCEPTABILITY JUDGMENTS
___________________________________________________________________________________________________________________	


Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC
Date: 01-03-2014
last updated:  11-10-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC

Script Copyright © 11-10-2023 Millisecond Software

___________________________________________________________________________________________________________________
BACKGROUND INFO 	
___________________________________________________________________________________________________________________

This Inquisit script implements a template to run Linguistic Acceptability Judgments (LAJ).
LAJ take advantage of techniques used in psychophysics and provide a method to make linguistic
judgments consistent and replicable.

Reference:
Bard, E. G., Robertson, D., & Sorace, A. (1996). Magnitude Estimation of Linguistic Acceptability. 
Language, 72(1), 32–68. 
https://doi.org/10.2307/416793
___________________________________________________________________________________________________________________
TASK DESCRIPTION	
___________________________________________________________________________________________________________________
Participants are asked to evaluate linguistic target sentences either on Likert scales (conventional) or/and by
Magnitude Estimations (ME) (psychophysics).

The sentences are presented visually.

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

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

(1) Raw data file: 'linguisticacceptabilityjudgments_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 (winmaciosandroid)
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. Thus, trialNum 
										may not reflect the number of main trials run per block. 
									
judgmentType:						"Likert" vs. "Magnitude Estimation"

countJudgments:						number of judgments made in a block

stimulus:							contains the current stimulus (for practice lines: the relative length of the target line)
response:							the participant's response (depends on task)
logMEJudgments:						log transform of the magnitude judgment (if applicable)
latency: 							the response latency in ms


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

___________________________________________________________________________________________________________________	
EXPERIMENTAL SET-UP 
___________________________________________________________________________________________________________________
Likert Method:
* each likert trial presents a randomly selected target sentence (random selection without replacement)
with a 5 point Likert scale and the following anchors: "extremely unnatural" to "extremely natural"
	=> to change number of anchors and anchors go to TRIALS -> likert.LAJ_likert and follow further instructions
* the Likert Method runs as many trials as specified under parameters.nr_judgments (editable parameter)

Magnitude Estimation
* each magnitude estimations presents the baseline sentence and a randomly selected target sentence (random selection without replacement)
as well as a textbox to collect the judgments
* the Magnitude Estimation Method runs as many judgments as specified under parameters.nr_judgments (editable parameter)

___________________________________________________________________________________________________________________	
STIMULI
___________________________________________________________________________________________________________________
* the baseline sentence for Magnitude Estimations can be set under section Editable Stimuli-> item.ME_baselineSentence
* the target sentences can be set under section Editable Stimuli -> item.target_sentences
	(also set parameters.nr_judgments under Editable Parameters)

___________________________________________________________________________________________________________________	
INSTRUCTIONS 
___________________________________________________________________________________________________________________	
* instructions can be edited under section Editable Instructions
=> LIKERT: item.likertInstructions
=> MAGNITUDE ESTIMATIONS:
	a) item.meInstructions
	b) page.mePractice & page.meTest	

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

/likertMethod:						true = Likert Acceptability Method is run (default)
									false = Likert Acceptability Method is NOT run

/magnitudeEstimation:				true = Magnitude Estimation Acceptability Method is run (default)
									false = Magnitude Estimation Acceptability Method is NOT run

/nrJudgments:						specifies the number of judgments to be made (default: 4)
/fontSizeStimulus:					sets the size of the stimulus in percentage of screen height (default: 5%)
/baselineLength:					the baseline line length in screen height proportion for ME practice (default: 25%)