DashedSentence in a PennController trial

EDIT: PennController includes Controller elements starting with version 1.7. The preferred method now is:

Example:

newTrial(
  newText("instructions", "Click on the button below to start reading")
    .print()
  ,
  newButton("Start reading")
    .print()
    .wait()
    .remove()
  ,
  getText("instructions")
    .remove()
  ,
  newController("DashedSentence", {s: "The mouse that the cat is chasing runs fast"})
    .print()
    .log()
    .wait()
    .remove()
  ,
  newButton("I'm done")
    .print()
    .wait()
)

Option 2 below is deprecated, unless you have specific needs that cannot be addressed by the native-Ibex DashedSentence controller.

END OF EDIT
—

I am working on a general solution to inject native-Ibex-format controllers inside PennController trials.

In the meantime, this page gives you two options to present self-paced reading tasks along PennController trials.

Option 1: use the native-Ibex DashedSentence controller

Pros: you get all the features of the native controller
Cons: you don’t get the features of PennController, ie. no .log command to store metadata from your table’s columns

Example:

// This line is required for PennController experiments
PennController.ResetPrefix(null)

// Sequence of randomly picked pairs of test + control trials
PennController.Sequence( "practice" , rshuffle("test", "control") )

// This is the standard way of defining items in Ibex
var items = [
    ["practice", "DashedSentence", {s: "This is a practice item"}]
]

// No need to use these if uploading CSV tables to Resources/chunks_includes
PennController.AddTable( "testTable" , `Sentence
Hello world
Bye world
"Yes, or, no"`) // Note the quotes when including commas

PennController.AddTable( "controlTable" , `Equation,Result1,Result2,Result3
7*7,49,53,32
489+256,745,667,233
81/9,9,7,8`)


// Here we use Template to generate trials from testTable
// Note that we use the Ibex-native DashedSentence controller
PennController.Template( "testTable" ,
  row => ["test", "DashedSentence", {s: row.Sentence}]
)


// Here we use Template to generate trials from controlTable
// Now we use a PennController trial
PennController.Template( "controlTable" ,
  row => PennController( "control" ,
    newText("What is the result of "+row.Equation+"?")
        .print()
    ,
    newText("Negative feedback", "Are you sure?")
    ,
    // This is a dirty javascript trick to randomize the answers
    newScale("result", ...[row.Result1, row.Result2, row.Result3].sort(()=>0.5-Math.random()) )
        .settings.labelsPosition("right")
        .print()
        // We wait until the participant selects the right answer
        .wait(
            getScale("result").test.selected(row.Result1)
                .failure( getText("Negative feedback").print() )
        )
  )
)

Option 2: code the task’s logic yourself
EDIT: this method is deprecated since PennController 1.7—

Pros: you get all the features and flexibility of PennContrller
Cons: you have to recode everything from scratch…

Example reproducing the default behavior of DashedSentence (self-paced reading mode and dashed display)

// This function generates an array of PennController commands
// It's basically a sequence of text.settings.text() and key.wait()
// The first parameter is the sentence to display (words should be separated by space characters)
// The second (optional) parameter determines whether the sentence should be removed at the end
//
dashed = (sentence, remove) => {
  let words = sentence.split(' '),  blanks = words.map(w=>w.split('').map(c=>'_').join(''));
  let textName = 'dashed'+words.join('');
  // We'll return cmds: the first command consists in creating (and printing) a Text element with dashes
  let cmds = [ newText(textName, blanks.join(' ')).print() ];
  // We'll go through each word, and add two command blocks per word
  for (let i = 0; i <= words.length; i++)
    cmds = cmds.concat([ newKey('dashed'+i+words[i], " ").settings.log().wait() , // Wait for (and log) a press on Space
                         getText(textName).settings.text(blanks.map((w,n)=>(n==i?words[n]:w)).join(' ')) ]); // Show word
  if (remove)  // Remove the text after the last key.wait() is parameter specified
    cmds.push(getText(textName).remove());
  return cmds;
}

// Illustration
//
PennController(
  newText("instructions", "Click on the button below to start reading")
    .print()
  ,
  newButton("Start reading")
    .print()
    .wait()
    .remove()
  ,
  getText("instructions")
    .remove()
  ,
  // We call the function here
  // Note the ... before dashed because it returns an array, which we want to inject
  //
  ...dashed("The mouse that the cat is chasing runs fast", 'remove')
  ,
  newButton("I'm done")
    .print()
    .wait()
)

• This topic was modified 4 years, 3 months ago by Jeremy. Reason: Added an example using Ibex-native DashedSentence