From 48b31f0a40c1ff1efb4bdf23d323b8498cdcc7cb Mon Sep 17 00:00:00 2001
From: LaraKirfel <49881806+LaraKirfel@users.noreply.github.com>
Date: Thu, 25 Apr 2024 17:48:08 +0200
Subject: [PATCH 1/8] Update README.md
---
README.md | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/README.md b/README.md
index ca66377..46e67ce 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,10 @@ People often select only a few events when explaining what happened. What drives
### code
This folder contains two types of R scripts.
-The model predictions can be seen here. The analyses and plots can be seen here
+
+The model predictions can be seen here.
+
+The analyses and plots can be seen here
R/optimal_intervention_model
From 1a4644fb7cf0b376bd241da339de3c693ee74e21 Mon Sep 17 00:00:00 2001
From: Tobias Gerstenberg
Date: Mon, 29 Apr 2024 10:01:25 -0700
Subject: [PATCH 2/8] .
---
README.md | 29 ++++++++++++++++++++++++-----
1 file changed, 24 insertions(+), 5 deletions(-)
diff --git a/README.md b/README.md
index 46e67ce..0cf909d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Explanations Communiate Optimal Interventions
+# 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.
@@ -7,7 +7,7 @@ This repository contains the experiment, data, analyses and figured for the Cog
People often select only a few events when explaining what happened. What drives people's explanation selection? Prior research argued that people's explanation choices are affected by event normality and causal structure. Here, we propose a new model of these existing findings and test its predictions in a novel experiment. The model predicts that speakers value accuracy and relevance. They choose explanations that are true, and that communicate useful information to the listener. We test the model's predictions empirically by manipulating what goals a listener has and what actions they can take. Across twelve experimental conditions, we find that our model accurately predicts that people like to choose explanations that communicate optimal interventions.
-## Pre-registrations
+## Pre-registrations
- the pre-registrations for all experiments may be accessed via the Open Science Framework here.
@@ -23,7 +23,7 @@ People often select only a few events when explaining what happened. What drives
-## Repository structure
+## Repository structure
```
├── code
@@ -86,7 +86,7 @@ Condition "Fixed Intervention / Positive Outcome": Click here!
-### data
+### data
Contains anonymized combined data for all experimental conditions (hard / soft / fixed intervention x positive / negative outcome) (for raw data and how these were computed, see code/R/).
@@ -95,10 +95,29 @@ For example, fixedint_negative.csv contains the average percentage
data_int.csv combines all four dataframes (hardint_pos, hardint_neg, softint_pos, softint_neg, fixedint_pos, fixedint_neg)
-### figures
+### figures
contains all the figures from the paper (generated using the script in code/R/experiments).
### writeup
contains a pdf of the CogSci 2024 paper.
+
+## CRediT
+
+| Term | Definition | Lara | Jacqueline | Jeong | Cindy | Thomas | Tobias |
+|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------|------------|-------|-------|--------|--------|
+| Conceptualization | Ideas; formulation or evolution of overarching research goals and aims | X | | | | x | x |
+| Methodology | Development or design of methodology; creation of models | X | X | X | | | x |
+| Software | Programming, software development; designing computer programs; implementation of the computer code and supporting algorithms; testing of existing code components | X | X | X | x | | x |
+| Validation | Verification, whether as a part of the activity or separate, of the overall replication/ reproducibility of results/experiments and other research outputs | X | | | | | x |
+| Formal analysis | Application of statistical, mathematical, computational, or other formal techniques to analyze or synthesize study data | X | X | | | | x |
+| Investigation | Conducting a research and investigation process, specifically performing the experiments, or data/evidence collection | X | | X | | | |
+| Resources | Provision of study materials, reagents, materials, patients, laboratory samples, animals, instrumentation, computing resources, or other analysis tools | | | | | | |
+| Data Curation | Management activities to annotate (produce metadata), scrub data and maintain research data (including software code, where it is necessary for interpreting the data itself) for initial use and later reuse | X | | | | | x |
+| Writing - Original Draft | Preparation, creation and/or presentation of the published work, specifically writing the initial draft (including substantive translation) | X | X | | | | |
+| Writing - Review & Editing | Preparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre-or postpublication stages | X | X | X | x | x | x |
+| Visualization | Preparation, creation and/or presentation of the published work, specifically visualization/ data presentation | | | | | | x |
+| Supervision | Oversight and leadership responsibility for the research activity planning and execution, including mentorship external to the core team | | | | | x | x |
+| Project administration | Management and coordination responsibility for the research activity planning and execution | | | | | | x |
+| Funding acquisition | Acquisition of the financial support for the project leading to this publication | | | | | | x |
\ No newline at end of file
From c63d14f51bb7f491bf22c0821233448c8ae6467d Mon Sep 17 00:00:00 2001
From: Tobias Gerstenberg
Date: Mon, 29 Apr 2024 10:02:59 -0700
Subject: [PATCH 3/8] .
---
README.md | 34 ++++++++++++++++++----------------
1 file changed, 18 insertions(+), 16 deletions(-)
diff --git a/README.md b/README.md
index 0cf909d..cf2f15b 100644
--- a/README.md
+++ b/README.md
@@ -105,19 +105,21 @@ contains a pdf of the CogSci 2024 paper.
## CRediT
-| Term | Definition | Lara | Jacqueline | Jeong | Cindy | Thomas | Tobias |
-|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------|------------|-------|-------|--------|--------|
-| Conceptualization | Ideas; formulation or evolution of overarching research goals and aims | X | | | | x | x |
-| Methodology | Development or design of methodology; creation of models | X | X | X | | | x |
-| Software | Programming, software development; designing computer programs; implementation of the computer code and supporting algorithms; testing of existing code components | X | X | X | x | | x |
-| Validation | Verification, whether as a part of the activity or separate, of the overall replication/ reproducibility of results/experiments and other research outputs | X | | | | | x |
-| Formal analysis | Application of statistical, mathematical, computational, or other formal techniques to analyze or synthesize study data | X | X | | | | x |
-| Investigation | Conducting a research and investigation process, specifically performing the experiments, or data/evidence collection | X | | X | | | |
-| Resources | Provision of study materials, reagents, materials, patients, laboratory samples, animals, instrumentation, computing resources, or other analysis tools | | | | | | |
-| Data Curation | Management activities to annotate (produce metadata), scrub data and maintain research data (including software code, where it is necessary for interpreting the data itself) for initial use and later reuse | X | | | | | x |
-| Writing - Original Draft | Preparation, creation and/or presentation of the published work, specifically writing the initial draft (including substantive translation) | X | X | | | | |
-| Writing - Review & Editing | Preparation, creation and/or presentation of the published work by those from the original research group, specifically critical review, commentary or revision – including pre-or postpublication stages | X | X | X | x | x | x |
-| Visualization | Preparation, creation and/or presentation of the published work, specifically visualization/ data presentation | | | | | | x |
-| Supervision | Oversight and leadership responsibility for the research activity planning and execution, including mentorship external to the core team | | | | | x | x |
-| Project administration | Management and coordination responsibility for the research activity planning and execution | | | | | | x |
-| Funding acquisition | Acquisition of the financial support for the project leading to this publication | | | | | | x |
\ No newline at end of file
+Please see [here](https://www.elsevier.com/researcher/author/policies-and-guidelines/credit-author-statement) for definitions of the different terms.
+
+| Term | Lara | Jacqueline | Jeong | Cindy | Thomas | Tobias |
+|----------------------------|------|------------|-------|-------|--------|--------|
+| Conceptualization | X | | | | x | x |
+| Methodology | X | X | X | | | x |
+| Software | X | X | X | x | | x |
+| Validation | X | | | | | x |
+| Formal analysis | X | X | | | | x |
+| Investigation | X | | X | | | |
+| Resources | | | | | | |
+| Data Curation | X | | | | | x |
+| Writing - Original Draft | X | X | | | | |
+| Writing - Review & Editing | X | X | X | x | x | x |
+| Visualization | | | | | | x |
+| Supervision | | | | | x | x |
+| Project administration | | | | | | x |
+| Funding acquisition | | | | | | x |
\ No newline at end of file
From 2f827fa62826d2b96dc66a6f7b41fa573249364b Mon Sep 17 00:00:00 2001
From: Tobias Gerstenberg
Date: Mon, 29 Apr 2024 10:04:15 -0700
Subject: [PATCH 4/8] .
---
README.md | 22 +++++++++++-----------
1 file changed, 11 insertions(+), 11 deletions(-)
diff --git a/README.md b/README.md
index cf2f15b..6d50419 100644
--- a/README.md
+++ b/README.md
@@ -109,17 +109,17 @@ Please see [here](https://www.elsevier.com/researcher/author/policies-and-guidel
| Term | Lara | Jacqueline | Jeong | Cindy | Thomas | Tobias |
|----------------------------|------|------------|-------|-------|--------|--------|
-| Conceptualization | X | | | | x | x |
-| Methodology | X | X | X | | | x |
-| Software | X | X | X | x | | x |
-| Validation | X | | | | | x |
-| Formal analysis | X | X | | | | x |
+| Conceptualization | X | | | | X | X |
+| Methodology | X | X | X | | | X |
+| Software | X | X | X | X | | X |
+| Validation | X | | | | | X |
+| Formal analysis | X | X | | | | X |
| Investigation | X | | X | | | |
| Resources | | | | | | |
-| Data Curation | X | | | | | x |
+| Data Curation | X | | | | | X |
| Writing - Original Draft | X | X | | | | |
-| Writing - Review & Editing | X | X | X | x | x | x |
-| Visualization | | | | | | x |
-| Supervision | | | | | x | x |
-| Project administration | | | | | | x |
-| Funding acquisition | | | | | | x |
\ No newline at end of file
+| Writing - Review & Editing | X | X | X | X | X | X |
+| Visualization | | | | | | X |
+| Supervision | | | | | X | X |
+| Project administration | | | | | | X |
+| Funding acquisition | | | | | | X |
\ No newline at end of file
From f085ee21c7d57e9e38b5469291245a3492ba24a1 Mon Sep 17 00:00:00 2001
From: Tobias Gerstenberg
Date: Mon, 29 Apr 2024 10:09:40 -0700
Subject: [PATCH 5/8] .
---
README.md | 52 +++++++++++++++++++++++++---------------------------
1 file changed, 25 insertions(+), 27 deletions(-)
diff --git a/README.md b/README.md
index 6d50419..c6d3750 100644
--- a/README.md
+++ b/README.md
@@ -9,42 +9,40 @@ 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.
- - separate links for each experiment:
-
-
-
+- the pre-registrations for all experiments may be accessed via the Open Science Framework [here](https://osf.io/fpyst/)
+- 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)
+ - [Condition "Soft Intervention / Positive Outcome"](https://osf.io/dmgcw)
+ - [Condition "Fixed Intervention / Negative Outcome"](https://osf.io/49bfq)
+ - [Condition "Fixed Intervention / Positive Outcome"](https://osf.io/rbu7y)
## Repository structure
```
+.
├── code
-│ ├── R
+│ └── R
├── data
├── docs
-│ ├── experiment1 (Hard Intervention)
-│ ├── experiment2 (Soft Intervention)
-│ └── experiment3 (Fixed Intervention)
-└── figures
-│ └── plots
+│ ├── analyses
+│ ├── experiment_1
+│ ├── experiment_2
+│ └── experiment_3
+├── figures
+│ └── plots
└── writeup
+ └── cogsci
```
### code
This folder contains two types of R scripts.
-The model predictions can be seen here.
+- 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
+- The analyses and plots can be seen [here](https://cicl-stanford.github.io/explanation_intervention/analyses/experiments/index.html)
R/optimal_intervention_model
@@ -73,17 +71,17 @@ The analyses and plots can be seen Click here!
+- [Condition "Hard Intervention / Positive Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_1/index.html?condition=1)
-Condition "Hard Intervention / Negative Outcome": Click here!
+- [Condition "Hard Intervention / Negative Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_1/index.html?condition=3)
-Condition "Soft Intervention / Positive Outcome": Click here!
+- [Condition "Soft Intervention / Positive Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_2/index.html?condition=1)
-Condition "Soft Intervention / Negative Outcome": Click here!
+- [Condition "Soft Intervention / Negative Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_2/index.html?condition=3)
-Condition "Fixed Intervention / Positive Outcome": Click here!
+- [Condition "Fixed Intervention / Positive Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_3/index.html?condition=1)
-Condition "Fixed Intervention / Negative Outcome": Click here!
+- [Condition "Fixed Intervention / Negative Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_3/index.html?condition=3)
### data
From bc8ec2d30b6fdad66b1043895a5b78a8f6bc12e7 Mon Sep 17 00:00:00 2001
From: Tobias Gerstenberg
Date: Mon, 29 Apr 2024 10:10:03 -0700
Subject: [PATCH 6/8] .
---
README.md | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/README.md b/README.md
index c6d3750..a93c4cc 100644
--- a/README.md
+++ b/README.md
@@ -71,17 +71,17 @@ This folder contains two types of R scripts.
Contains all the experiment code. You can preview the experiments below:
-- [Condition "Hard Intervention / Positive Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_1/index.html?condition=1)
+- [Condition "Hard Intervention / Positive Outcome"](https://cicl-stanford.github.io/explanation_intervention/experiment_1/index.html?condition=1)
-- [Condition "Hard Intervention / Negative Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_1/index.html?condition=3)
+- [Condition "Hard Intervention / Negative Outcome"](https://cicl-stanford.github.io/explanation_intervention/experiment_1/index.html?condition=3)
-- [Condition "Soft Intervention / Positive Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_2/index.html?condition=1)
+- [Condition "Soft Intervention / Positive Outcome"](https://cicl-stanford.github.io/explanation_intervention/experiment_2/index.html?condition=1)
-- [Condition "Soft Intervention / Negative Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_2/index.html?condition=3)
+- [Condition "Soft Intervention / Negative Outcome"](https://cicl-stanford.github.io/explanation_intervention/experiment_2/index.html?condition=3)
-- [Condition "Fixed Intervention / Positive Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_3/index.html?condition=1)
+- [Condition "Fixed Intervention / Positive Outcome"](https://cicl-stanford.github.io/explanation_intervention/experiment_3/index.html?condition=1)
-- [Condition "Fixed Intervention / Negative Outcome](https://cicl-stanford.github.io/explanation_intervention/experiment_3/index.html?condition=3)
+- [Condition "Fixed Intervention / Negative Outcome"](https://cicl-stanford.github.io/explanation_intervention/experiment_3/index.html?condition=3)
### data
From b892e55367ff2c9f77e0fa5435f0ed6c727f9317 Mon Sep 17 00:00:00 2001
From: Tobias Gerstenberg
Date: Mon, 29 Apr 2024 10:11:25 -0700
Subject: [PATCH 7/8] .
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index a93c4cc..36b8928 100644
--- a/README.md
+++ b/README.md
@@ -105,7 +105,7 @@ contains a pdf of the CogSci 2024 paper.
Please see [here](https://www.elsevier.com/researcher/author/policies-and-guidelines/credit-author-statement) for definitions of the different terms.
-| Term | Lara | Jacqueline | Jeong | Cindy | Thomas | Tobias |
+| | Lara | Jacqueline | Jeong | Cindy | Thomas | Tobias |
|----------------------------|------|------------|-------|-------|--------|--------|
| Conceptualization | X | | | | X | X |
| Methodology | X | X | X | | | X |
From 07f80dfa04d80df7998607040e6e1f1452c83a5c Mon Sep 17 00:00:00 2001
From: Tobias Gerstenberg
Date: Tue, 30 Apr 2024 09:02:05 -0700
Subject: [PATCH 8/8] .
---
README.md | 41 +++++++++++++----------------------------
1 file changed, 13 insertions(+), 28 deletions(-)
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
-
- - 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).
-
-
-
-
+- 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