PennController.PreloadZip

PennController.PreloadZip( url ) or PennController.PreloadZip( url1 , url2, … ) Instead of fetching audio and images from a distant URL for every single one of your PennController trials using one, you can choose to store them in ZIP archives that you upload on your server. Use PreloadZip to tell where to look the ZIP archives …

PennController.InitiateRecorder

PennController.InitiateRecorder( url ) or PennController.InitiateRecorder( url , message ) Use this to specify the URL of the PHP file to upload the audio recordings collected during the experiment. InitiateRecorder creates a PennController trial asking for the participant’s consent to record audio samples. You can specify a message to replace the default one. Use the command …

PennController.Header

PennController.Header( sequenceOfCommands ) (since beta 0.3) Will evaluate and run sequenceOfCommands at the beginning of each trial created with PennController. Note that default commands are immediately evaluated (rather than evaluating upon running). As a consequence, any default command will only have an effect on PennController trials defined after the Header has been set. Example: [js …

PennController.GetURLParameter

PennController.GetURLParameter( parametername ) Retrieves the value of a parameter that was passed after ? in the URL. This is particularly useful if you pass a uniquely identifying code to the URL when you recruit your participants, like http://spellout.net/ibexexps/PennController/Demo/experiment.html?id=abcdefgh Example: [js highlight=”7″ try=”data”] newTrial( “my trial” , newButton(“helloworld”, “Hello world!”) .settings.log() .print() .wait() ) .log( “ID” …

PennController.GetTable().setGroupColumn

PennController.GetTable( tablename ).setGroupColumn( columnname ) Tells which column in the table assigns each row to a given group of participants, i.e. which subset of rows PennController will keep for each group of participants listed in the column. Example: [js highlight=”13″ try=”data”] SetCounter(); AddTable( “test_table” , “Spelling,Text\n”+ “Normal,Hello\n”+ “Reversed,olleH\n”+ “Normal,World\n”+ “Reversed,dlroW” ); Template( GetTable( “test_table” ) …

PennController.GetTable().filter

PennController.GetTable( tablename ).filter( “column” , “match” ) or PennController.GetTable( tablename ).filter( “column” , /match/ ) or PennController.GetTable( tablename ).filter( function ) Returns a filtered version of the table, containing only rows whose specified column’s value is a match. If you use a string then the column’s value must match the text exactly. Alternatively, you can …

PennController.GetTable

PennController.GetTable( tablename ) Refers to a table, where tablename can be the filename of a CSV file you uploaded to Resources (chunk_includes) or the name of a table that was created with . You would typically use GetTable within when your project contains more than one table and/or when you need to use only a …

PennController.Footer

PennController.Footer( sequenceOfCommands ) (since beta 0.3) Will append sequenceOfCommands to the end of the sequence of commands of each trial created with PennController. Example: [js highlight=”1-7″ try=”data”]Footer( newText(“validation instructions”, “Click to go to next trial”) .print() , newButton(“validation button”, “Validate”) .print() .wait() ); newTrial( newText(“test sentence”, “The cat chases the mouse”) .print() , newScale(“natural”, 5) …

PennController.DownloadRecordingButton

PennController.DownloadRecordingButton( text ) (since PennController 1.8) formerly PennController.DownloadVoiceButton( text ), now deprecated Generates a <button> that, when clicked, proposes to download a ZIP archive containing all the media recordings collected during the experiment. This should be used only after the recordings have been sent to the server you specified as described on . You would …