HoshinoKoji/jsPsych
1
0
Fork 0
mirror of https://github.com/jspsych/jsPsych.git synced 2025-05-10 03:00:54 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

clarify location_first_item direction, add example

Browse Source
This commit is contained in:
jade 2024-11-04 20:01:57 -05:00
parent 7b0c99f72a
commit 4723f57eac
3 changed files with 23 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/plugins/visual-search-circle.md
View File

@ -33,7 +33,7 @@ The `target_present` and `fixation_image` parameters must always be specified. O
| trial_duration | numeric | null | The maximum amount of time the participant is allowed to search before the trial will continue. A value of null will allow the participant to search indefinitely. |
| fixation_duration | numeric | 1000 | How long to show the fixation image for before the search array (in milliseconds). |
| randomize_item_locations | bool | true | Whether to use randomized locations on the circle for the items. If `false`, then the first item will always show at the location specified by `location_first_item`.
| location_first_item | numeric | 0 | If `randomize_item_locations` is `false`, the location of the first item on the circle, in degrees.
| location_first_item | numeric | 0 | If `randomize_item_locations` is `false`, the location of the first item on the circle, in degrees. 0 degrees is above the fixation, and moving clockwise in the positive direction.
| response_ends_trial| boolean | true | If true, the trial will end when the participant makes a response. |
## Data Generated

16
examples/jspsych-visual-search-circle.html
View File

@ -51,15 +51,27 @@
timeline: [trial_1, trial_2, trial_3]
};
// example using arbitrary image array
// example putting the first location at 90 degrees (right of the fixation)
var trial_4 = {
type: jsPsychVisualSearchCircle,
target: 'img/backwardN.gif',
foil: 'img/normalN.gif',
fixation_image: 'img/fixation.gif',
target_present: true,
set_size: 3,
randomize_item_locations: false,
location_first_item: 90
};
// example using arbitrary image array
var trial_5 = {
type: jsPsychVisualSearchCircle,
stimuli: ['img/backwardN.gif', 'img/normalN.gif', 'img/1.gif', 'img/2.gif', 'img/3.gif'],
fixation_image: 'img/fixation.gif',
target_present: true
};
jsPsych.run([preload_images, intro, trials, trial_4]);
jsPsych.run([preload_images, intro, trials, trial_4, trial_5]);
</script>
</html>

16
packages/plugin-visual-search-circle/src/index.ts
View File

@ -106,7 +106,10 @@ const info = <const>{
pretty_name: "Randomize item locations",
default: true,
},
/** If `randomize_item_locations` is `false`, the location of the first item on the circle, in degrees. */
/**
* If `randomize_item_locations` is `false`, the location of the first item on the circle, in degrees.
* 0 degrees is above the fixation, and moving clockwise in the positive direction.
*/
location_first_item: {
type: ParameterType.INT,
pretty_name: "Location first item",
@ -152,7 +155,7 @@ type Info = typeof info;
/**
* This plugin presents a customizable visual-search task modelled after [Wang, Cavanagh, & Green (1994)](http://dx.doi.org/10.3758/BF03206946).
* The participant indicates whether or not a target is present among a set of distractors. The stimuli are displayed in a circle, evenly-spaced,
* equidistant from a fixation point. Here is an example using normal and backward Ns:
* equidistant from a fixation point.
*
* @author Josh de Leeuw
* @see {@link https://www.jspsych.org/latest/plugins/visual-search-circle/ visual-search-circle plugin documentation on jspsych.org}
@ -287,10 +290,6 @@ class VisualSearchCirclePlugin implements JsPsychPlugin<Info> {
end_trial();
}, trial.trial_duration);
}
function clear_display() {
display_element.innerHTML = "";
}
};
}
@ -315,8 +314,9 @@ class VisualSearchCirclePlugin implements JsPsychPlugin<Info> {
var hstimw = stimw / 2;
var display_locs = [];
var random_offset = Math.floor(Math.random() * 360);
var offset = trial.randomize_item_locations ? random_offset : trial.location_first_item;
var offset = trial.randomize_item_locations
? Math.floor(Math.random() * 360)
: trial.location_first_item - 180; // makes it so 0 is up, moving clockwise
for (var i = 0; i < n_locs; i++) {
display_locs.push([
Math.floor(paper_size / 2 + this.cosd(offset + i * (360 / n_locs)) * radi - hstimw),