diff --git a/README.md b/README.md index 36b8928..68c4a32 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # Explanations Communicate Optimal Interventions -This repository contains the experiment, data, analyses and figured for the CogSci 2024 paper "Do as I explain" Explanations communiate optimal interventions" by Lara Kirfel, Jacqueline Harding, Jeong Shin, Cindy Wu, Thomas Icard and Tobias Gerstenberg. +This repository contains the experiment, data, analyses and figured for the CogSci 2024 paper "Do as I explain" Explanations communicate optimal interventions" by Lara Kirfel, Jacqueline Harding, Jeong Shin, Cindy Wu, Thomas Icard and Tobias Gerstenberg. ## Abstract @@ -9,8 +9,9 @@ People often select only a few events when explaining what happened. What drives ## Pre-registrations -- the pre-registrations for all experiments may be accessed via the Open Science Framework [here](https://osf.io/fpyst/) -- separate links for each experiment: +The pre-registrations for all experiments may be accessed via the Open Science Framework [here](https://osf.io/fpyst/). + +Here are separate links for each experiment: - [Condition "Hard Intervention / Negative Outcome"](https://osf.io/8k9sy) - [Condition "Hard Intervention / Positive Outcome"](https://osf.io/7qzu9) - [Condition "Soft Intervention / Negative Outcome"](https://osf.io/aw286) @@ -41,31 +42,15 @@ People often select only a few events when explaining what happened. What drives This folder contains two types of R scripts. - The model predictions can be seen [here](https://cicl-stanford.github.io/explanation_intervention/analyses/model/index.html) - - The analyses and plots can be seen [here](https://cicl-stanford.github.io/explanation_intervention/analyses/experiments/index.html) -
R/optimal_intervention_model
- R/optimal_intervention.rmd
creates the model predictions for the intervention model, the truth model and a combined model.explanation_predictions_truth_only.csv
, for example, contains the predictions for a "Truth Only" model.R/experiments
- [...]study_X-responses.csv
contains the response data (i.e., intervention and explanation selection).[...]study_X-participants.csv
contains demographic information and post-experiment feedback/comments from participants.Experiment.rmd
reads in the response data from each experimental condition (e.g., fixed intervention / negative), calculates average responses and outputs these in a new data file (e.g., fixedint_negative.csv
).
- R/optimal_intervention_model
:
+ - R/optimal_intervention.rmd
creates the model predictions for the intervention model, the truth model and a combined model.
+ - explanation_predictions_truth_only.csv
, for example, contains the predictions for a "Truth Only" model.
+- R/experiments
: This folder contains all raw data from all experimental conditions.
+ - [...]study_X-responses.csv
contains the response data (i.e., intervention and explanation selection).
+ - [...]study_X-participants.csv
contains demographic information and post-experiment feedback/comments from participants.
+ - Experiment.rmd
reads in the response data from each experimental condition (e.g., fixed intervention / negative), calculates average responses and outputs these in a new data file (e.g., fixedint_negative.csv
).
### docs
@@ -95,11 +80,11 @@ For example, fixedint_negative.csv
contains the average percentage
### figures
-contains all the figures from the paper (generated using the script in code/R/experiments
).
+Contains all the figures from the paper (generated using the script in code/R/experiments
).
### writeup
-contains a pdf of the CogSci 2024 paper.
+Contains a pdf of the CogSci 2024 paper.
## CRediT