Inquisit FAQ. How do I get a Kent Inquisit user account?

Transcription

1 Inquisit FAQ Cntents Hw d I get a Kent Inquisit user accunt?... 1 What is the website fr Inquisit?... 2 Hw d I run an Inquisit IAT?... 3 Will my participants need t install anything t take part in my study?... 3 Hw d I get started creating an IAT experiment?... 4 Hw d I make changes t my IAT experiment?... 4 Hw d I uplad my IAT t the website?... 4 Where are my results files?... 5 Can yu explain the RAWDATA file s cntents?... 5 Can Inquisit wrk with Prlific, Qualtrics & MTurk?... 6 What settings are cnfigurable n the website fr an existing IAT experiment already upladed?... 7 Testing can be time cnsuming, are there any keybard shrtcuts?... 7 Other tips?... 8 Where can I get mre help?... 8 A brief intrductin t the Inquisit script file structure?... 8 Cmmnly used <> elements Hw t setup a list f wrds and reference then frm a <trial> element Hw t setup a list f images and reference then frm a <trial> element Hw t pass a parameter (eg a subject ID) frm Qualtrics int an Inquisit script Hw t access a parameter passed int an Inquisit experiment (e.g. subject ID) Hw t jump t a url at the end f yur Inquisit experiment (e.g. a debrief page) Hw t pass n a parameter at the end t anther prgram (e.g. passing a subject_id t Qualtrics ) Hw t get Qualtrics t pick up a url parameter passed t it frm anther prgram (e.g. passing a subject_id t Qualtrics frm Inquisit ) Hw d I get a Kent Inquisit user accunt? Anyne requiring an accunt t use Inquisit shuld psychsupprt@kent.ac.uk t request ne including : Fullname, address, UK username i.e. Jhn Allen, J.A.Allen@kent.ac.uk, ja Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 1

2 What is the website fr Inquisit? Once yu have yur Inquisit accunt (see abve) yu can lgin n the Millisecnd.cm website In particular nte the fllwing menu ptins: Dwnlad / Inquisit Lab - dwnlad the desktp client fr installatin fr develping experiments and testing lcally. NB yu ll nly need this if yu are ging t develp r mdify a script yurself. Dwnlad / Millisecnd Test Library - see a lng list f pre-written experiments, srted by the academic paper they refer t. Supprt / * - Help, FAQs etc My Accunt / Web scripts - where t access yur wn scripts and where yu can uplad new nes My Accunt / Web data files - access the results frm yur experiments and dwnlad them fr further analysis Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 2

3 Hw d I run an Inquisit IAT? There are 2 ways t run an Inquisit IAT experiment: The usual way is thrugh a web brwser. Yu just need the URL fr yur particular study. Nte this extract frm the dcumentatin files (july 2014): What are the machine requirements fr Inquisit 4 Web? The client must be running Windws XP r later, r Mac OSX 10.5 r later. Srry, n supprt fr Linux. [JA: r Andrid/IOS - ie n phnes] The client must have a wrking Internet cnnectin. The client must be running a reasnably recent versin f Chrme, Firefx, Internet Explrer, r Safari. There is a desktp versin f Inquisit (Inquisit Lab)that can be installed nt PCs/laptps (bth Windws & Mac) It can be dwnladed frm the Dwnlad tab n the millisecnd.cm website. Admin rights are required t install it Once installed, when run, yu will be prmpted yu t register the prduct. Fllw the instructins t d this. A cmputer key will be generated autmatically. Yu will be prmpted t authenticate by prviding yur millisecnd username and passwrd at which pint a registratin key will als be generated fr yu. Will my participants need t install anything t take part in my study? Unfrtunately the answer is Yes. Althugh it runs frm within a brwser (e.g. Firefx, Internet Explrer, Ggle Chrme), it des require that a brwser plugin be installed. This is pretty simple and quick t d hwever it des require administratr privileges. If yu re running it n a Psychlgy lab cmputer then it shuld just wrk hwever if it s run n yur participant s wn cmputer it will need installing as the first step. See this link fr details abut what s invlved: Yu may want t mentin this t yur participants in the initial brief and t include the link s they can check it ut if they have cncerns Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 3

4 Hw d I get started creating an IAT experiment? The best place t start is t lk thrugh the extensive library f dem scripts available n the Inquisit website at Search thrugh t find the example clsest t what yu want, click n the link fr it t take yu thrugh t the dwnlad page. Mst script descriptins reference the primary authr fr any relevant academic papers which can aid searching. Yu can als run a web dem f the script first t see what it des. This requires the installatin f the Inquisit Web Player. This requires administratin rights. (Check with Tech Supprt t find ut which cmputers already have this installed) Use CTRL+Q t abrt a script when yu ve seen enugh Dwnlad versin 4 f yur script and unzip it Hw d I make changes t my IAT experiment? The *.iqx experiment files (r.exp fr lder versins) are nly text files and s simple edits can be made using a text editr, such as ntepad. In practice, this is prbably nly viable fr making changes t text messages r t the wrds/pictures used by the IAT. T develp new scripts r make significant changes t existing scripts yu will need the Inquisit 4 desktp sftware installing n yur PC/Mac. Cntact Psychlgy technical supprt fr help with this. Hw d I uplad my IAT t the website? Once yu have written and tested yur prgram using Inquisit Lab yu can uplad it t the Millisecnd website t run in a brwser. lgin t yur accunt nline at millisecnd.cm Select the Web Scripts link frm the My Accunt drp-dwn menu Either edit an existing script r select t Register New Script and brwse and then uplad it frm yur PC Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 4

5 Nte that separately frm the upladed there are a number f settings that yu cnfigure n the Inquisit/Millisecnd website itself. These include settings fr generating Participant and Grup IDs autmatically; Instructin messages and als Thanks yu messages fr pst experiment. It s mstly self-explanatry s have a g yurself and then test it t see what happens. Seek help if yu have any cncerns befre yu start cllecting live data. Where are my results files? If yu have been running an Inquisit study (e.g. an IAT) and yu want t lk at r dwnlad yur participant s results files: lgin t yur accunt nline at millisecnd.cm Select the Web data Files link frm the My Accunt drp-dwn menu If necessary, select the apprpriate flder In the File Name clumn, select the link fr whichever experiment yu are interested in Select either the summary r the raw data flder as desired The raw data flder cntains the full experiment data with individual respnse timings fr each participant. (see belw fr mre details) The summary flder cntains the summary data: PID, date etc and D scres. (see belw fr mre details) Select the file(s) yu want t dwnlad by ticking the checkbxes in the left-hand clumn Click the Dwnlad link (with the green arrw next t it) Nte that althugh these results files are all <filename>.iqdat files they are actually just nrmal text files and s, nce dwnladed can easily be pened in SPSS/Excel/Ntepad [ using file/pen and remembering t select all files *.* n the file filter; then : delimited ; next; select the Tab checkbx; finish ] Can yu explain the RAWDATA file s cntents? The rawdata file cntains a lt f clumns f data. These are : Date, time, grup, subject, blckcde, blcknum, trialcde, trialnum, respnse, crrect, latency, stimulusnumber1, stimulusitem1, expressins.da, expressins.db, expressins.d This is what they represent: date/time/grup/subject: Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 5

6 built in variables that track date and time when script was run with the assigned subject- and grup number Nte: grup1/grup2 cunterbalance the rder in which the pairings are run blckcde: the name f the current trial blcknum: the number f the current trial trialcde: the name f the current trial trialnum: the number f the current trial respnse: the final trial respnse (scancdes f the keys pressed) Nte: script saves the final and -by design- crrect respnse crrect: the accuracy f the initial respnse 0 = initial respnse was incrrect and needed t be crrected 1 = initial respnse is crrect latency: the latency (time in millisecnds) f the final (crrect) respnse stimulusnumber: the number f the current stimulus stimulusitem: the currently presented item expressins.da: d-scre f the first blcks expressins.db: d-scre f the secnd blcks expressins.d: verall d-scre Can Inquisit wrk with Prlific, Qualtrics & MTurk? Inquisit can be integrated with a number f 3 rd party systems including Prlific and Qualtrics hwever (at the time f writing 2015/12) it cannt be used with MTurk as its use requires the installatin f a brwser plugin which invalidates MTurk s terms and cnditins. Fr mre details see: Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 6

7 What settings are cnfigurable n the website fr an existing IAT experiment already upladed? The *.iqx experiment files cntain details f all the wrds/pictures and messages used DURING yur IAT as well as the rules gverning the rder that the sectins are run. Sme setting abut hw an already upladed IAT experiment are run are cnfigurable n the website, including the fllwing: The pening page displayed at runtime Can be created and specified by yu, r autmatically generated fr yu, accrding t cnfigurable settings. Cnfigurable launch settings include: Title Instructins Participant /Subject IDs: User entered vs autmatically generated Grup IDs: i.e. subject grups yur participant is assigned t Finish page. Optins include: System generated Custm page, specified by yu Redirected t anther website (e.g. RPS t autmatically assign RPS credits) Testing can be time cnsuming, are there any keybard shrtcuts? The fllwing keybard shrtcuts might be f use: CTRL Q quit/abrt the whle experiment CTRL B skip the rest f the current BLOCK and carry n at the start f the next BLOCK CTRL D pen the debug windw which displays the current setting fr all Inquisit attribute. The debug windw must be clsed befre cntinuing with the current IAT Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 7

8 Other tips? Take a lk at the ptins under the Tls menu ptin t find ut sme f the ther capabilities. e.g. Scripts can quickly get t be lng and hard t navigate. Yu can display line numbers fr yur script in the Inquisit editr by ticking the shw line numbers checkbx under the Tls / Preferences menu. This als helps yu rder the pages shuld yu print ur yur script. It s pssible fr yur scripts t interface with the cmputer s serial and parallel prts Inquisit uses keybard scancdes instead f key symbls. E.g. t detect pressing a q yu need t test fr scancde 16. T find ut what the scancde is fr a key yu want t use, use the keybard scancdes menu ptin under Tls. Where can I get mre help? As said abve seek help if yu have any cncerns befre yu start cllecting live data. Inquisit website: {see the Supprt/Dcumentatin link} Inquisit desktp sftware See the HELP ptin n the Menu Psychlgy Technical Team. A brief intrductin t the Inquisit script file structure? Inquisit scripts r prgrams are in fact actually nthing like a traditinal cmputer prgram (ie nt like an e-prime r PsychPy script nr like a Pythn r Javascript prgram.) Its structure is actually far mre like an XML/HTML markup file. Althugh files have the.iqx (r in lder versins.exp ) file tag, they are simply text files and as such can be pened, viewed and edited in any text editr (e.g. Ntepad, Ntepad++) Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 8

9 An example is the main experiment element e.g. <expt> / blcks = [1=practice; 2=trialblck1; 3=trialblck2 ] </expt> The <expt> element can appear anywhere in the file hwever fr mst sample prgrams dwnladed frm the millisecnd.cm tend t be at the end f the file. Ntes n the file structure: 1. All active parts f the script are enclsed between a match pair f tags (just as with XML) These all have an pening and a matching lcsing tag line and typically include ne r mre attribute (/parameter) tags. e.g. <element_type my_element_name> / attribute_name = ( settings ) </element_type> 2. Mst <element> tags include a name. a. e.g. <blck practice_phase> b. This need t be unique WITHIN an element type but it can be the same acrss different element types c. E.g. <blck practice> and <trial practice> is k Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 9

10 Cmmnly used <> elements There are generally a number f ways t achieve any particular piece f functinality within Inquisit and its ften nt clear which is best until yu try it and discver that it cannt quite d what yu want. With that in mind, belw are a few examples shwing cmmn elements Hw t setup a list f wrds and reference then frm a <trial> element Put them in an <item my_items_name> list like this.. <item attributea> /1 = "Marvelus" /2 = "Superb" /3 = "Pleasure" /4 = "Beautiful" </item> Add mre fllwing the bvius pattern. Nte that the inserting any whitespace after the / is ptinal, s /1 and / 1 are equally valid. Call them frm a <text> list like this <text attributea> / items = attributea / txclr = (0, 255, 0) </text> Setting ther ptin display setting as desired (abve we change the clur t green) Then access the <text> frm a <trial> element <trial attributea> / validrespnse = ("E", "I") / crrectrespnse = ("E") / stimulusframes = [1 = attributea] / psttrialpause = 250 </trial> Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 10

11 Hw t setup a list f images and reference then frm a <trial> element <item targeta> /1 = "flwer1.jpg" /2 = "flwer2.jpg" /3 = "flwer3.jpg" /4 = "flwer4.jpg" </item> Very similar t hw wrds are setup. But access them frm a <picture> element instead f a <text> ne.. <picture targeta> / items = targeta / size = (20%, 20%) </picture> Access the <picture> element with a <trial> - <trial attributea> / validrespnse = ("Q", "P") / crrectrespnse = ("Q") / stimulusframes = [1 = targeta] / psttrialpause = 250 </trial> Access the <picture> element frm a <blck element> like this <blck attributepractice> / bgstim = (attributealeft, attributebright) / trials = [1=instructins;2-19 = randm(attributea, attributeb)] / errrmessage = true(errr,200) / respnsemde = crrect </blck> IMPORTANT: Nte that Inquisit isn t capable f cunting s yu need t cunt hw many trials yu have and put the crrect number n the /trials attribute setting that s in the <blck> entity. See the green setting abve. NB it starts at 2 because trial 1 abve is used t present the instructins Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 11

12 Hw t pass a parameter (eg a subject ID) frm Qualtrics int an Inquisit script Nte the Inquisit script will need t be upladed and cnfigured ready t run n the website befre yu can d this part. Once this is dne, then in yur Qualtrics survey: 1. First, find ut the questin that captures the Subject ID. 1. Click n the questin bdy s that the enhanced text editr ptins appear and click n the piped text tab 2. Select Survey Questin and then find the questin that captures the Subject ID and click n the secnd f the ptins that appears (ie NOT the Questin text ptin 3. This shuld cause sme text t be inserted int the questin bdy that lks smething like this: 1. ${q://qid37/chicetextentryvalue} 2. Cpy this text int a separate file temprarily and then delete it frm the questin bdy. 2. Nw select the Survey flw tab 1. In End f Survey select Custmize 2. Select the Redirect t a URL ptin and paste in the runtime link fr yur Inquisit prgram. It shuld lk smething like this: 3. research.millisecnd.cm/lc388/ageiatkent.web/ 4. Nw append this cde: subject_id= and then als append the text yu saved frm 1.3 abve t the end f it s that yu have smething like this: 1. research.millisecnd.cm/lc388/ageiatkent.web/ subject_id=${q://qid37/chicetextentryvalue} 5. subject_id will be the variable name that yu will reference in yur Inquisit study. 3. Nw, when yur Qualtrics study finishes, it will autmatically jump t run yur Inquisit study and will pass acrss yur Subject ID. Hw t access a parameter passed int an Inquisit experiment (e.g. subject ID) 1. Lgin t yur Inquisit accunt at 2. Select the Web Scripts menu ptin 3. Find yur script and click the edit buttn. 4. Advance thrugh t the Cnfigure Launch Page page and find the questin Chse hw subject ids shuld be generated: - change the setting t URLQuery Parameter and in the text bx belw enter the name f the variable yu defined abve e.g. subject_id 5. After making any ther changes t the cnfiguratin click the Finish buttn. Yur Inquisit script is nw ready t be run frm yur Qualtrics questinnaire Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 12

13 Hw t jump t a url at the end f yur Inquisit experiment (e.g. a debrief page) 1. As abve, edit yur script and prgress thrugh t the page titled Select a finish page 2. Select the Redirect t a custm finish page ptin 3. Type in the url that yu wish t jump t 1. e.g it shuld lk smething like this:- 4. If yu want t redirect t a Kent branded debrief page then f yu pass the desired text t Psychlgy technical supprt they can create the page fr yu. Hw t pass n a parameter at the end t anther prgram (e.g. passing a subject_id t Qualtrics ) 1. Any parameters passed INTO an Inquisit script n the url are autmatically frwarded n at the end if yu select t Redirect t a url n a different web server in yur script cnfiguratin. See Hw t jump t a url at the end f yur Inquisit experiment (e.g. a debrief page) abve 1. E.g. if a Qualtrics survey calls yur Inquisit script like this 1. ABC 2. Then Inquisit will pass n subject_id=abc n any frwarding url Hw t get Qualtrics t pick up a url parameter passed t it frm anther prgram (e.g. passing a subject_id t Qualtrics frm Inquisit ) 1. T ensure that Qualtrics captures the passed url parameter and stres it in the results file, d the fllwing: 1. Edit the survey flw fr the survey Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 13

14 2. Click t add a new element 3... f type embedded data : 4. Enter the variable name in EXACTLY as it will appear n the url (case sensitive) 1. E.G. 5. As lng as the variable names match exactly then the value passed will als appear in the Qualtrics result file Jhn Allen j.a.allen@kent.ac.uk, Psychlgy, University f Kent 14