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

add deepCopy warning messages for randomization/sample functions

Browse Source
This commit is contained in:
jade 2025-01-11 11:31:25 -07:00
parent 36e64efbfb
commit 8834532fc9
1 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/reference/jspsych-randomization.md
View File

@ -89,7 +89,7 @@ output:
full_design = {
stimulus: ['a.jpg','b.jpg','b.jpg','a.jpg'],
ms_delay: [200, 100, 200, 100]
]
}
*/
```
@ -182,6 +182,8 @@ This method takes an array of values and generates a new random order of the arr
If the array elements are objects with the same set of properties, then this method can optionally return a single object where each property is a randomized order of the properties defined in the original set of objects. This is useful for randomizing sets of parameters that are used to define a jsPsych block.
This returns a shallow copy of the array, i.e. modifications to arrays/objects within this array will affect the original. If this is not desired, consider taking a [`deepCopy`](./jspsych-utils.md#jspsychutilsdeepcopy).
### Examples
#### Shuffle an array, no repeats
@ -414,6 +416,8 @@ An array containing the sample.
This method returns a sample drawn at random from a set of values with replacement. The relative probability of drawing each item can be controlled by specifying the `weights`.
This returns a shallow copy of the array, i.e. modifications to arrays/objects within this array will affect the original. If this is not desired, consider taking a [`deepCopy`](./jspsych-utils.md#jspsychutilsdeepcopy).
### Examples
#### Sample with equal probability
@ -455,6 +459,8 @@ An array containing the sample.
This method returns a sample drawn at random from a set of values without replacement. The sample size must be less than or equal to the length of the array.
This returns a shallow copy of the array, i.e. modifications to arrays/objects within this array will affect the original. If this is not desired, consider taking a [`deepCopy`](./jspsych-utils.md#jspsychutilsdeepcopy).
### Examples
#### Sample without replacement
@ -532,6 +538,8 @@ Returns an array with the same elements as the input array in a random order.
A simple method for shuffling the order of an array.
This returns a shallow copy of the array, i.e. modifications to arrays/objects within this array will affect the original. If this is not desired, consider taking a [`deepCopy`](./jspsych-utils.md#jspsychutilsdeepcopy).
### Examples
#### Shuffle an array
@ -565,6 +573,8 @@ Returns an array with the same elements as the input array in a random order, wi
Shuffle an array, ensuring that neighboring elements in the array are different.
This returns a shallow copy of the array, i.e. modifications to arrays/objects within this array will affect the original. If this is not desired, consider taking a [`deepCopy`](./jspsych-utils.md#jspsychutilsdeepcopy).
*Warning: if you provide an array that has very few valid permutations with no neighboring elements, then this method will fail and cause the browser to hang.*
### Examples