From b9a20fed1028948dc79c6178f82f65491d98629b Mon Sep 17 00:00:00 2001 From: Josh de Leeuw Date: Mon, 14 Mar 2022 09:15:54 -0400 Subject: [PATCH] update links --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 3ce1556..51c9357 100644 --- a/README.md +++ b/README.md @@ -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](https://github.com/jspsych/simulation-examples/tree/main/basic-testing), [Live Demo](https://jspsych.github.io/simulation-examples/basic-testing/). +**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/use-case-1-testing), [Live Demo](https://jspsych.github.io/simulation-examples/use-case-1-testing/basic/). -**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/). +**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/use-case-1-testing), [Live Demo](https://jspsych.github.io/simulation-examples/use-case-1-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](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/). +**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/use-case-2-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/use-case-2-generate-dataset), [Live Demo](https://jspsych.github.io/simulation-examples/use-case-2-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](https://github.com/jspsych/simulation-examples/tree/main/partial-simulation), [Live Demo](https://jspsych.github.io/simulation-examples/partial-simulation/). +**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/use-case-3-partial-simulation), [Live Demo](https://jspsych.github.io/simulation-examples/use-case-3-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](https://github.com/jspsych/simulation-examples/tree/main/replay), [Live Demo](https://jspsych.github.io/simulation-examples/replay/). +**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/use-case-4-replay), [Live Demo](https://jspsych.github.io/simulation-examples/use-case-4-replay/).