jspsych 6.2.0 → 7.1.0

package/plugins/jspsych-reconstruction.js

@@ -1,134 +0,0 @@
-/**
- * jspsych-reconstruction
- * a jspsych plugin for a reconstruction task where the subject recreates
- * a stimulus from memory
- *
- * Josh de Leeuw
- *
- * documentation: docs.jspsych.org
- *
- */
-
-
-jsPsych.plugins['reconstruction'] = (function() {
-
-  var plugin = {};
-
-  plugin.info = {
-    name: 'reconstruction',
-    description: '',
-    parameters: {
-      stim_function: {
-        type: jsPsych.plugins.parameterType.FUNCTION,
-        pretty_name: 'Stimulus function',
-        default: undefined,
-        description: 'A function with a single parameter that returns an HTML-formatted string representing the stimulus.'
-      },
-      starting_value: {
-        type: jsPsych.plugins.parameterType.FLOAT,
-        pretty_name: 'Starting value',
-        default: 0.5,
-        description: 'The starting value of the stimulus parameter.'
-      },
-      step_size: {
-        type: jsPsych.plugins.parameterType.FLOAT,
-        pretty_name: 'Step size',
-        default: 0.05,
-        description: 'The change in the stimulus parameter caused by pressing one of the modification keys.'
-      },
-      key_increase: {
-        type: jsPsych.plugins.parameterType.KEYCODE,
-        pretty_name: 'Key increase',
-        default: 'h',
-        description: 'The key to press for increasing the parameter value.'
-      },
-      key_decrease: {
-        type: jsPsych.plugins.parameterType.KEYCODE,
-        pretty_name: 'Key decrease',
-        default: 'g',
-        description: 'The key to press for decreasing the parameter value.'
-      },
-      button_label: {
-        type: jsPsych.plugins.parameterType.STRING,
-        pretty_name: 'Button label',
-        default:  'Continue',
-        description: 'The text that appears on the button to finish the trial.'
-      }
-    }
-  }
-
-  plugin.trial = function(display_element, trial) {
-
-    // current param level
-    var param = trial.starting_value;
-
-    // set-up key listeners
-    var after_response = function(info) {
-
-      //console.log('fire');
-
-      var key_i = (typeof trial.key_increase == 'string') ? jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.key_increase) : trial.key_increase;
-      var key_d = (typeof trial.key_decrease == 'string') ? jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.key_decrease) : trial.key_decrease;
-
-      // get new param value
-      if (info.key == key_i) {
-        param = param + trial.step_size;
-      } else if (info.key == key_d) {
-        param = param - trial.step_size;
-      }
-      param = Math.max(Math.min(1, param), 0);
-
-      // refresh the display
-      draw(param);
-    }
-
-    // listen for responses
-    var key_listener = jsPsych.pluginAPI.getKeyboardResponse({
-      callback_function: after_response,
-      valid_responses: [trial.key_increase, trial.key_decrease],
-      rt_method: 'performance',
-      persist: true,
-      allow_held_key: true
-    });
-    // draw first iteration
-    draw(param);
-
-    function draw(param) {
-
-      //console.log(param);
-
-      display_element.innerHTML = '<div id="jspsych-reconstruction-stim-container">'+trial.stim_function(param)+'</div>';
-
-      // add submit button
-      display_element.innerHTML += '<button id="jspsych-reconstruction-next" class="jspsych-btn jspsych-reconstruction">'+trial.button_label+'</button>';
-
-      display_element.querySelector('#jspsych-reconstruction-next').addEventListener('click', endTrial);
-    }
-
-    function endTrial() {
-      // measure response time
-      var endTime =performance.now();
-      var response_time = endTime - startTime;
-
-      // clear keyboard response
-      jsPsych.pluginAPI.cancelKeyboardResponse(key_listener);
-
-      // save data
-      var trial_data = {
-        "rt": response_time,
-        "final_value": param,
-        "start_value": trial.starting_value
-      };
-
-      display_element.innerHTML = '';
-
-      // next trial
-      jsPsych.finishTrial(trial_data);
-    }
-
-    var startTime = performance.now();
-
-  };
-
-  return plugin;
-})();

package/plugins/jspsych-resize.js

@@ -1,166 +0,0 @@
-/**
-* jspsych-resize
-* Steve Chao
-*
-* plugin for controlling the real world size of the display
-*
-* documentation: docs.jspsych.org
-*
-**/
-
-jsPsych.plugins["resize"] = (function() {
-
-  var plugin = {};
-
-  plugin.info = {
-    name: 'resize',
-    description: '',
-    parameters: {
-      item_height: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Item height',
-        default: 1,
-        description: 'The height of the item to be measured.'
-      },
-      item_width: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Item width',
-        default: 1,
-        description: 'The width of the item to be measured.'
-      },
-      prompt: {
-        type: jsPsych.plugins.parameterType.STRING,
-        pretty_name: 'Prompt',
-        default: null,
-        description: 'The content displayed below the resizable box and above the button.'
-      },
-      pixels_per_unit: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Pixels per unit',
-        default: 100,
-        description: 'After the scaling factor is applied, this many pixels will equal one unit of measurement.'
-      },
-      starting_size: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Starting size',
-        default: 100,
-        description: 'The initial size of the box, in pixels, along the larget dimension.'
-      },
-      button_label: {
-        type: jsPsych.plugins.parameterType.STRING,
-        pretty_name: 'Button label',
-        default:  'Continue',
-        description: 'Label to display on the button to complete calibration.'
-      },
-    }
-  }
-
-  plugin.trial = function(display_element, trial) {
-
-    var aspect_ratio = trial.item_width / trial.item_height;
-
-    // variables to determine div size
-    if(trial.item_width >= trial.item_height){
-      var start_div_width = trial.starting_size;
-      var start_div_height = Math.round(trial.starting_size / aspect_ratio);
-    } else {
-      var start_div_height = trial.starting_size;
-      var start_div_width = Math.round(trial.starting_size * aspect_ratio);
-    }
-
-    // create html for display
-    var html ='<div id="jspsych-resize-div" style="border: 2px solid steelblue; height: '+start_div_height+'px; width:'+start_div_width+'px; margin: 7px auto; background-color: lightsteelblue; position: relative;">';
-    html += '<div id="jspsych-resize-handle" style="cursor: nwse-resize; background-color: steelblue; width: 10px; height: 10px; border: 2px solid lightsteelblue; position: absolute; bottom: 0; right: 0;"></div>';
-    html += '</div>';
-    if (trial.prompt !== null){
-      html += trial.prompt;
-    }
-    html += '<a class="jspsych-btn" id="jspsych-resize-btn">'+trial.button_label+'</a>';
-
-    // render
-    display_element.innerHTML = html;
-
-    // listens for the click
-    document.getElementById("jspsych-resize-btn").addEventListener('click', function() {
-      scale();
-      end_trial();
-    });
-
-    var dragging = false;
-    var origin_x, origin_y;
-    var cx, cy;
-
-    var mousedownevent = function(e){
-      e.preventDefault();
-      dragging = true;
-      origin_x = e.pageX;
-      origin_y = e.pageY;
-      cx = parseInt(scale_div.style.width);
-      cy = parseInt(scale_div.style.height);
-    }
-
-    display_element.querySelector('#jspsych-resize-handle').addEventListener('mousedown', mousedownevent);
-
-    var mouseupevent = function(e){
-      dragging = false;
-    }
-
-    document.addEventListener('mouseup', mouseupevent);
-
-    var scale_div = display_element.querySelector('#jspsych-resize-div');
-
-    var resizeevent = function(e){
-      if(dragging){
-        var dx = (e.pageX - origin_x);
-        var dy = (e.pageY - origin_y);
-
-        if(Math.abs(dx) >= Math.abs(dy)){
-          scale_div.style.width = Math.round(Math.max(20, cx+dx*2)) + "px";
-          scale_div.style.height = Math.round(Math.max(20, cx+dx*2) / aspect_ratio ) + "px";
-        } else {
-          scale_div.style.height = Math.round(Math.max(20, cy+dy*2)) + "px";
-          scale_div.style.width = Math.round(aspect_ratio * Math.max(20, cy+dy*2)) + "px";
-        }
-      }
-    }
-
-    document.addEventListener('mousemove', resizeevent);
-
-    // scales the stimulus
-    var scale_factor;
-    var final_height_px, final_width_px;
-    function scale() {
-      final_width_px = scale_div.offsetWidth;
-      //final_height_px = scale_div.offsetHeight;
-
-      var pixels_unit_screen = final_width_px / trial.item_width;
-
-      scale_factor = pixels_unit_screen / trial.pixels_per_unit;
-      document.getElementById("jspsych-content").style.transform = "scale(" + scale_factor + ")";
-    };
-
-
-    // function to end trial
-    function end_trial() {
-
-      // clear document event listeners
-      document.removeEventListener('mousemove', resizeevent);
-      document.removeEventListener('mouseup', mouseupevent);
-
-      // clear the screen
-      display_element.innerHTML = '';
-
-      // finishes trial
-
-      var trial_data = {
-        'final_height_px': final_height_px,
-        'final_width_px': final_width_px,
-        'scale_factor': scale_factor
-      }
-
-      jsPsych.finishTrial(trial_data);
-    }
-  };
-
-  return plugin;
-})();

package/plugins/jspsych-same-different-html.js

@@ -1,168 +0,0 @@
-/**
- * jspsych-same-different
- * Josh de Leeuw
- *
- * plugin for showing two stimuli sequentially and getting a same / different judgment
- *
- * documentation: docs.jspsych.org
- *
- */
-
-jsPsych.plugins['same-different-html'] = (function() {
-
-  var plugin = {};
-
-  plugin.info = {
-    name: 'same-different-html',
-    description: '',
-    parameters: {
-      stimuli: {
-        type: jsPsych.plugins.parameterType.HTML_STRING,
-        pretty_name: 'Stimuli',
-        default: undefined,
-        array: true,
-        description: 'The HTML content to be displayed.'
-      },
-      answer: {
-        type: jsPsych.plugins.parameterType.SELECT,
-        pretty_name: 'Answer',
-        options: ['same', 'different'],
-        default: undefined,
-        description: 'Either "same" or "different".'
-      },
-      same_key: {
-        type: jsPsych.plugins.parameterType.KEYCODE,
-        pretty_name: 'Same key',
-        default: 'Q',
-        description: ''
-      },
-      different_key: {
-        type: jsPsych.plugins.parameterType.KEYCODE,
-        pretty_name: 'Different key',
-        default: 'P',
-        description: 'The key that subjects should press to indicate that the two stimuli are the same.'
-      },
-      first_stim_duration: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'First stimulus duration',
-        default: null,
-        description: 'How long to show the first stimulus for in milliseconds. If null, then the stimulus will remain on the screen until any keypress is made.'
-      },
-      gap_duration: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Gap duration',
-        default: 500,
-        description: 'How long to show a blank screen in between the two stimuli.'
-      },
-      second_stim_duration: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Second stimulus duration',
-        default: null,
-        description: 'How long to show the second stimulus for in milliseconds. If null, then the stimulus will remain on the screen until a valid response is made.'
-      },
-      prompt: {
-        type: jsPsych.plugins.parameterType.STRING,
-        pretty_name: 'Prompt',
-        default: null,
-        description: 'Any content here will be displayed below the stimulus.'
-      }
-    }
-  }
-
-  plugin.trial = function(display_element, trial) {
-
-    display_element.innerHTML = '<div class="jspsych-same-different-stimulus">'+trial.stimuli[0]+'</div>';
-
-    var first_stim_info;
-    if (trial.first_stim_duration > 0) {
-      jsPsych.pluginAPI.setTimeout(function() {
-        showBlankScreen();
-      }, trial.first_stim_duration);
-    } else {
-      function afterKeyboardResponse(info) {
-        first_stim_info = info;
-        showBlankScreen();
-      }
-      jsPsych.pluginAPI.getKeyboardResponse({
-        callback_function: afterKeyboardResponse,
-        valid_responses: trial.advance_key,
-        rt_method: 'performance',
-        persist: false,
-        allow_held_key: false
-      });
-    }
-
-    function showBlankScreen() {
-      display_element.innerHTML = '';
-
-      jsPsych.pluginAPI.setTimeout(function() {
-        showSecondStim();
-      }, trial.gap_duration);
-    }
-
-    function showSecondStim() {
-
-      var html = '<div class="jspsych-same-different-stimulus">'+trial.stimuli[1]+'</div>';
-      //show prompt here
-      if (trial.prompt !== null) {
-        html += trial.prompt;
-      }
-      display_element.innerHTML = html;
-
-      if (trial.second_stim_duration > 0) {
-        jsPsych.pluginAPI.setTimeout(function() {
-          display_element.querySelector('.jspsych-same-different-stimulus').style.visibility = 'hidden';
-        }, trial.second_stim_duration);
-      }
-
-
-
-      var after_response = function(info) {
-
-        // kill any remaining setTimeout handlers
-        jsPsych.pluginAPI.clearAllTimeouts();
-
-        var correct = false;
-
-        var skey = typeof trial.same_key == 'string' ? jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.same_key) : trial.same_key;
-        var dkey = typeof trial.different_key == 'string' ? jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.different_key) : trial.different_key;
-
-        if (info.key == skey && trial.answer == 'same') {
-          correct = true;
-        }
-
-        if (info.key == dkey && trial.answer == 'different') {
-          correct = true;
-        }
-
-        var trial_data = {
-          "rt": info.rt,
-          "answer": trial.answer,
-          "correct": correct,
-          "stimulus": JSON.stringify([trial.stimuli[0], trial.stimuli[1]]),
-          "key_press": info.key
-        };
-        if (first_stim_info) {
-          trial_data["rt_stim1"] = first_stim_info.rt;
-          trial_data["key_press_stim1"] = first_stim_info.key;
-        }
-
-        display_element.innerHTML = '';
-
-        jsPsych.finishTrial(trial_data);
-      }
-
-      jsPsych.pluginAPI.getKeyboardResponse({
-        callback_function: after_response,
-        valid_responses: [trial.same_key, trial.different_key],
-        rt_method: 'performance',
-        persist: false,
-        allow_held_key: false
-      });
-
-    }
-
-  };
-
-  return plugin;
-})();

package/plugins/jspsych-same-different-image.js

@@ -1,169 +0,0 @@
-/**
- * jspsych-same-different
- * Josh de Leeuw
- *
- * plugin for showing two stimuli sequentially and getting a same / different judgment
- *
- * documentation: docs.jspsych.org
- *
- */
-
-jsPsych.plugins['same-different-image'] = (function() {
-
-  var plugin = {};
-
-  jsPsych.pluginAPI.registerPreload('same-different-image', 'stimuli', 'image')
-
-  plugin.info = {
-    name: 'same-different-image',
-    description: '',
-    parameters: {
-      stimuli: {
-        type: jsPsych.plugins.parameterType.IMAGE,
-        pretty_name: 'Stimuli',
-        default: undefined,
-        array: true,
-        description: 'The images to be displayed.'
-      },
-      answer: {
-        type: jsPsych.plugins.parameterType.SELECT,
-        pretty_name: 'Answer',
-        options: ['same', 'different'],
-        default: undefined,
-        description: 'Either "same" or "different".'
-      },
-      same_key: {
-        type: jsPsych.plugins.parameterType.KEYCODE,
-        pretty_name: 'Same key',
-        default: 'Q',
-        description: ''
-      },
-      different_key: {
-        type: jsPsych.plugins.parameterType.KEYCODE,
-        pretty_name: 'Different key',
-        default: 'P',
-        description: 'The key that subjects should press to indicate that the two stimuli are the same.'
-      },
-      first_stim_duration: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'First stimulus duration',
-        default: null,
-        description: 'How long to show the first stimulus for in milliseconds. If null, then the stimulus will remain on the screen until any keypress is made.'
-      },
-      gap_duration: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Gap duration',
-        default: 500,
-        description: 'How long to show a blank screen in between the two stimuli.'
-      },
-      second_stim_duration: {
-        type: jsPsych.plugins.parameterType.INT,
-        pretty_name: 'Second stimulus duration',
-        default: null,
-        description: 'How long to show the second stimulus for in milliseconds. If null, then the stimulus will remain on the screen until a valid response is made.'
-      },
-      prompt: {
-        type: jsPsych.plugins.parameterType.STRING,
-        pretty_name: 'Prompt',
-        default: null,
-        description: 'Any content here will be displayed below the stimulus.'
-      }
-    }
-  }
-
-  plugin.trial = function(display_element, trial) {
-
-    display_element.innerHTML = '<img class="jspsych-same-different-stimulus" src="'+trial.stimuli[0]+'"></img>';
-
-    var first_stim_info;
-    if (trial.first_stim_duration > 0) {
-      jsPsych.pluginAPI.setTimeout(function() {
-        showBlankScreen();
-      }, trial.first_stim_duration);
-    } else {
-      function afterKeyboardResponse(info) {
-        first_stim_info = info;
-        showBlankScreen();
-      }
-      jsPsych.pluginAPI.getKeyboardResponse({
-        callback_function: afterKeyboardResponse,
-        valid_responses: trial.advance_key,
-        rt_method: 'performance',
-        persist: false,
-        allow_held_key: false
-      });
-    }
-
-    function showBlankScreen() {
-      display_element.innerHTML = '';
-
-      jsPsych.pluginAPI.setTimeout(function() {
-        showSecondStim();
-      }, trial.gap_duration);
-    }
-
-    function showSecondStim() {
-
-      var html = '<img class="jspsych-same-different-stimulus" src="'+trial.stimuli[1]+'"></img>';
-      //show prompt
-      if (trial.prompt !== null) {
-        html += trial.prompt;
-      }
-
-      display_element.innerHTML = html;
-
-      if (trial.second_stim_duration > 0) {
-        jsPsych.pluginAPI.setTimeout(function() {
-          display_element.querySelector('.jspsych-same-different-stimulus').style.visibility = 'hidden';
-        }, trial.second_stim_duration);
-      }
-
-      var after_response = function(info) {
-
-        // kill any remaining setTimeout handlers
-        jsPsych.pluginAPI.clearAllTimeouts();
-
-        var correct = false;
-
-        var skey = typeof trial.same_key == 'string' ? jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.same_key) : trial.same_key;
-        var dkey = typeof trial.different_key == 'string' ? jsPsych.pluginAPI.convertKeyCharacterToKeyCode(trial.different_key) : trial.different_key;
-
-        if (info.key == skey && trial.answer == 'same') {
-          correct = true;
-        }
-
-        if (info.key == dkey && trial.answer == 'different') {
-          correct = true;
-        }
-
-        var trial_data = {
-          "rt": info.rt,
-          "answer": trial.answer,
-          "correct": correct,
-          "stimulus": JSON.stringify([trial.stimuli[0], trial.stimuli[1]]),
-          "key_press": info.key
-        };
-        if (first_stim_info) {
-          trial_data["rt_stim1"] = first_stim_info.rt;
-          trial_data["key_press_stim1"] = first_stim_info.key;
-        }
-
-        display_element.innerHTML = '';
-
-        jsPsych.finishTrial(trial_data);
-      }
-
-      jsPsych.pluginAPI.getKeyboardResponse({
-        callback_function: after_response,
-        valid_responses: [trial.same_key, trial.different_key],
-        rt_method: 'performance',
-        persist: false,
-        allow_held_key: false
-      });
-
-    }
-
-  };
-
-  return plugin;
-})();