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

Add options (randomize_item_locations and location_first_item) to allow for fixed locations of the item array across trials.

Browse Source
This commit is contained in:
Josh de Leeuw 2022-12-06 17:07:20 -05:00
parent 4533e3d012
commit 8759217f0e
3 changed files with 22 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
.changeset/nervous-carrots-raise.md Normal file
View File

@ -0,0 +1,5 @@
---
"@jspsych/plugin-visual-search-circle": minor
---
Add options (`randomize_item_locations` and `location_first_item`) to allow for fixed locations of the item array across trials.

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

@ -32,6 +32,8 @@ The `target_present` and `fixation_image` parameters must always be specified. O
| target_absent_key | string | 'f' | The key to press if the target is not present in the search array. | | target_absent_key | string | 'f' | The key to press if the target is not present in the search array. |
| 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. | | 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). | | 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.
## Data Generated ## Data Generated

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

@ -89,6 +89,18 @@ const info = <const>{
pretty_name: "Fixation duration", pretty_name: "Fixation duration",
default: 1000, default: 1000,
}, },
/** 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`. */
randomize_item_locations: {
type: ParameterType.BOOL,
pretty_name: "Randomize item locations",
default: true,
},
/** If `randomize_item_locations` is `false`, the location of the first item on the circle, in degrees. */
location_first_item: {
type: ParameterType.INT,
pretty_name: "Location first item",
default: 0,
},
}, },
}; };
@ -263,10 +275,11 @@ class VisualSearchCirclePlugin implements JsPsychPlugin<Info> {
var display_locs = []; var display_locs = [];
var random_offset = Math.floor(Math.random() * 360); var random_offset = Math.floor(Math.random() * 360);
var offset = trial.randomize_item_locations ? random_offset : trial.location_first_item;
for (var i = 0; i < n_locs; i++) { for (var i = 0; i < n_locs; i++) {
display_locs.push([ display_locs.push([
Math.floor(paper_size / 2 + this.cosd(random_offset + i * (360 / n_locs)) * radi - hstimw), Math.floor(paper_size / 2 + this.cosd(offset + i * (360 / n_locs)) * radi - hstimw),
Math.floor(paper_size / 2 - this.sind(random_offset + i * (360 / n_locs)) * radi - hstimh), Math.floor(paper_size / 2 - this.sind(offset + i * (360 / n_locs)) * radi - hstimh),
]); ]);
} }
return display_locs; return display_locs;