/** * jspsych-palmer * Josh de Leeuw (October 2013) * * a jspsych plugin for presenting and querying about stimuli modeled after * * Palmer, S. (1977). Hierarchical Structure in Perceptual Representation. Cognitive Psychology, 9, 441. * * and * * Goldstone, R. L., Rogosky, B. J., Pevtzow, R., & Blair, M. (2005). Perceptual and semantic reorganization during category learning. * In H. Cohen & C. Lefebvre (Eds.) Handbook of Categorization in Cognitive Science. (pp. 651-678). Amsterdam: Elsevier. * * documentation: docs.jspsych.org * */ (function($) { jsPsych.palmer = (function() { var plugin = {}; plugin.create = function(params) { var trials = []; for (var i = 0; i < params.configurations.length; i++) { var trial = { configurations: params.configurations[i], show_feedback: (typeof params.show_feedback === 'undefined') ? false : params.show_feedback, grid_spacing: params.grid_spacing || 75, square_size: params.square_size || 3, circle_radius: params.circle_radius || 20, timing_item: params.timing_item || 1000, timing_feedback: params.timing_feedback || 1000, prompt: (typeof params.prompt === 'undefined') ? "" : params.prompt }; trials.push(trial); } return trials; }; plugin.trial = function(display_element, trial) { // if any trial variables are functions // this evaluates the function and replaces // it with the output of the function trial = jsPsych.pluginAPI.normalizeTrialVariables(trial); // variables to keep track of user interaction var start_circle = -1; var end_circle = -1; var line_started = false; var size = trial.grid_spacing * (trial.square_size + 1); display_element.append($("")); var paper = Snap("#jspsych-palmer-snapCanvas"); // create the circles at the vertices. var circles = []; var node_idx = 0; for (var i = 1; i <= trial.square_size; i++) { for (var j = 1; j <= trial.square_size; j++) { var circle = paper.circle(trial.grid_spacing * j, trial.grid_spacing * i, trial.circle_radius); circle.attr("fill", "#000").attr("stroke-width", "0").attr("stroke", "#000").data("node", node_idx); circle.hover( function() { this.attr("stroke-width", "2"); //this.attr("stroke", "#000"); }, function() { this.attr("stroke-width", "0"); //this.attr("stroke", "#fff") }).click( function() { if (!line_started) { line_started = true; start_circle = this.data("node"); this.attr("fill", "#777").attr("stroke", "#777"); } else { end_circle = this.data("node"); draw_connection(start_circle, end_circle); } }); node_idx++; circles.push(circle); } } function draw_connection(start_circle, end_circle) { var the_line = getLineIndex(start_circle, end_circle); if (the_line > -1) { toggle_line(the_line); } // reset highlighting on circles for (var i = 0; i < circles.length; i++) { circles[i].attr("fill", "#000").attr("stroke", "#000"); } // cleanup the variables line_started = false; start_circle = -1; end_circle = -1; } // create all possible lines that connect circles var horizontal_lines = []; var vertical_lines = []; var backslash_lines = []; var forwardslash_lines = []; for (var i = 0; i < trial.square_size; i++) { for (var j = 0; j < trial.square_size; j++) { var current_item = (i * trial.square_size) + j; // add horizontal connections if (j < (trial.square_size - 1)) { horizontal_lines.push([current_item, current_item + 1]); } // add vertical connections if (i < (trial.square_size - 1)) { vertical_lines.push([current_item, current_item + trial.square_size]); } // add diagonal backslash connections if (i < (trial.square_size - 1) && j < (trial.square_size - 1)) { backslash_lines.push([current_item, current_item + trial.square_size + 1]); } // add diagonal forwardslash connections if (i < (trial.square_size - 1) && j > 0) { forwardslash_lines.push([current_item, current_item + trial.square_size - 1]); } } } var lines = horizontal_lines.concat(vertical_lines).concat(backslash_lines).concat(forwardslash_lines); // actually draw the lines var lineIsVisible = []; var lineElements = []; for (var i = 0; i < lines.length; i++) { var line = paper.path("M" + circles[lines[i][0]].attr("cx") + " " + circles[lines[i][0]].attr("cy") + "L" + circles[lines[i][1]].attr("cx") + " " + circles[lines[i][1]].attr("cy")).attr("stroke-width", "8").attr("stroke", "#000"); line.hide(); lineElements.push(line); lineIsVisible.push(0); } // define some helper functions to toggle lines on and off // this function gets the index of a line based on the two circles it connects function getLineIndex(start_circle, end_circle) { var the_line = -1; for (var i = 0; i < lines.length; i++) { if ((start_circle == lines[i][0] && end_circle == lines[i][1]) || (start_circle == lines[i][1] && end_circle == lines[i][0])) { the_line = i; break; } } return the_line; } // this function turns a line on/off based on the index (the_line) function toggle_line(the_line) { if (the_line > -1) { if (lineIsVisible[the_line] === 0) { lineElements[the_line].show(); lineElements[the_line].toBack(); lineIsVisible[the_line] = 1; } else { lineElements[the_line].hide(); lineElements[the_line].toBack(); lineIsVisible[the_line] = 0; } } } // this function takes an array of length = num lines, and displays the line whereever there // is a 1 in the array. function showConfiguration(configuration) { for (var i = 0; i < configuration.length; i++) { if (configuration[i] != lineIsVisible[i]) { toggle_line(i); } } } // highlight a line function highlightLine(line) { lineElements[line].attr("stroke", "#f00"); } // start recording the time var startTime = (new Date()).getTime(); display_element.append($('')); $('#jspsych-palmer-submitButton').click(function() { save_data(); }); if (trial.prompt !== "") { display_element.append($('
" + feedback + "
")); setTimeout(function() { next_trial(); }, trial.timing_feedback); } else { next_trial(); } } function next_trial() { display_element.html(''); // next trial if (trial.timing_post_trial > 0) { setTimeout(function() { jsPsych.finishTrial(); }, trial.timing_post_trial); } else { jsPsych.finishTrial(); } } }; // method for drawing palmer stimuli. // returns the string description of svg element containing the stimulus plugin.generate_stimulus = function(square_size, grid_spacing, circle_radius, configuration) { var size = grid_spacing * (square_size + 1); // create a div to hold the generated svg object var stim_div = $('body').append('