PIP's Brief-IAT

How to use BIAT's extension for PIP

Under /user/yba/pipexample/biat are a few examples how to use PIP's BIAT extension on Project Implicit. 


Here is what to do in order to understand it all:

First, Open the file biat.recommended.full.expt.xml. The important line in that file is the one that defines the BIAT task. It explains how to run BIAT's extension: we run biat.js using a jsp file on our own study. Usually, when we run a PIP script, we create the script and run it using a general jsp file under common. Here, instead of doing that, we created our own jsp file, set the task's settings to the script's global object, and then run the biat.js script.

Next, open the file batindexfull.jsp. It includes all the settings that you can use to modify the task. Read it through (and the comments) to understand what you can modify in the task. 

Usually, you wouldn't want to change all the settings. If you want to keep a setting in its default value, simply don't include it in the script. The exceptions to that rule are properties that are objects (canvas, attribute1, categories, attribute2, practiceTrials). If you don't want to change anything about the canvas of the attributes, then you can indeed not include them at all in your jsp file. However, if you want to change even one of their properties (e.g., maxWidth in the canvas), then you must also define the other properties (i.e., proportions and all other properties).

Hopefully, your jsp will look more like the file batindexsimple.jsp. That file only sets the categories and leaves all the other settings without modifying them at all.

You can also have a look at batindexmulti.jsp to see how to define a BIAT with three categories, and batindeximages.jsp to see how to define BIAT with image stimuli (nothing special there).

Wait, explain to me again: how do I create my own BIAT?

Copy batindexsimple.jsp to your own folder. Enter the details of your own stimuli. If you have images, also change the base_url property. To add the BIAT to your task, copy the relevant line from biat.recommended.simple.expt.xml. That's it. If you want to change anything else in the task, have a look at the full settings in /user/yba/pipexample/biat/batindexfull.jsp or in /common/all/js/pip/piscripts/biat/biat.js

Advanced: modify the biat.js script

You can copy the biat.js script and run it as a usual PIP script. You can change the settings at the beginning of the file, and also change anything you want in the code.

Good luck