Skip to content

Commit

Permalink
add links
Browse files Browse the repository at this point in the history
  • Loading branch information
jodeleeuw committed Mar 10, 2022
1 parent 93c9c34 commit f2f2383
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,27 +10,27 @@ The paper describes the motivation for and implementation of a tool that allows

Researchers can use simulation mode to automatically test the behavior of experiments under different conditions.

**Example 1: Testing Manually**. This example involves running an experiment with an instructions comprehension check. The test verifies that when the subject fails the comprehension check, the instructions are repeated. The test also verifies that the correct number of trials appear after randomization. [Code](), [Live Demo]().
**Example 1: Testing Manually**. This example involves running an experiment with an instructions comprehension check. The test verifies that when the subject fails the comprehension check, the instructions are repeated. The test also verifies that the correct number of trials appear after randomization. [Code](https://github.com/jspsych/simulation-examples/tree/main/basic-testing), [Live Demo](https://jspsych.github.io/simulation-examples/basic-testing/).

**Example 2: Testing with a Framework**. This example uses the same experiment, but uses the Jasmine testing library to run the tests. [Code](), [Live Demo]().
**Example 2: Testing with a Framework**. This example uses the same experiment, but uses the [Jasmine testing library](https://jasmine.github.io/) to run the tests. [Code](https://github.com/jspsych/simulation-examples/tree/main/testing-with-jasmine), [Live Demo](https://jspsych.github.io/simulation-examples/testing-with-jasmine/).

## Use Case 2: Generating Simulated Datasets

Simulation can be used to generate datasets that will have the same exact structure as the final data, ensuring that analysis scripts built prior to data collection will work properly. Customizing the parameters of the simulation also allows the researcher to generate datasets with known properties, such as effect sizes or the frequency of outliers.

**Example: Customizing Parameters**. This simulation of a Stroop task uses the `simulation_options` and a [configuration file]() to control the response time distributions for incongruent and congruent trials. It also includes a parameter to control the probability that a subject will be inattentive and just respond as quickly as possible to everything. [Code](), [Live Demo]().
**Example: Customizing Parameters**. This simulation of a Stroop task uses the `simulation_options` and a [configuration file](https://github.com/jspsych/simulation-examples/blob/main/generate-dataset/simulation_options.js) to control the response time distributions for incongruent and congruent trials. It also includes a parameter to control the probability that a subject will be inattentive and just respond as quickly as possible to everything. [Code](https://github.com/jspsych/simulation-examples/tree/main/generate-dataset), [Live Demo](https://jspsych.github.io/simulation-examples/generate-dataset/).

## Use Case 3: Speeding Up Development

When building experiments it can be helpful to skip over portions of the experiment that are already complete to test the piece that is being actively developed. In some cases, earlier portions of the experiment can simply be commented out, but sometimes there are complex dependencies where the piece under development depends on information generated during a previous section. Simulation can help by simulating *part* of an experiment, generating the data that is needed to test a later portion.

**Example: Developing a Feedback Screen**. This example simulates a visual search task but skips the simulation for the final feedback screen, allowing the researcher to get quick feedback on changes being made to that piece of the experiment. [Code](), [Live Demo]().
**Example: Developing a Feedback Screen**. This example simulates a visual search task but skips the simulation for the final feedback screen, allowing the researcher to get quick feedback on changes being made to that piece of the experiment. [Code](https://github.com/jspsych/simulation-examples/tree/main/partial-simulation), [Live Demo](https://jspsych.github.io/simulation-examples/partial-simulation/).

## Use Case 4: Visualizing Participant Behavior

jsPsych's simulation mode can execute in two modes. In all the other examples we used `data-only` mode, which generates simulated data quickly without running the actual trials. The other option, `visual` mode, runs the experiment in real time so that the researcher can watch the experiment progress. This has a variety of potential uses, such as a rapid timelapse-style playthrough of the experiment for demo purposes, but here we highlight one particularly intriguing possibility: the ability to "playback" participant behavior. By running the simulation with parameters taken from a an actual run of the experiment, the visual simulation becomes a movie of what a participant actually did in the experiment.

**Example: Replaying a Serial Response Time Task**. This example requires you to complete the short experiment, after which your behavior will be played back to you via simulation. [Code](), [Live Demo]().
**Example: Replaying a Serial Response Time Task**. This example requires you to complete the short experiment, after which your behavior will be played back to you via simulation. [Code](https://github.com/jspsych/simulation-examples/tree/main/replay), [Live Demo](https://jspsych.github.io/simulation-examples/replay/).



0 comments on commit f2f2383

Please sign in to comment.