This repository contains code and analysis for the study presented in the scientific paper untitled "What Makes a Scent Trigger a Memory? A Cognitive Decomposition of Odor-Evoked Retrieval"
requirements.txt: Python packages required to run the Jupyter notebooks.install_packages.R: R packages required to run the Jupyter notebooks.
data:
raw_data.csv: The original dataset, to be downloaded (see instructions below).
scripts:
preprocessing.ipynb: Jupyter notebook for data cleaning and preparation.exceptions_lemma.py: Lemmatization mapping script used in preprocessing.machine_learning.ipynb: Machine learning analysis on the processed data.statistics.Rmd: R Markdown file containing statistical analyses and visualizations.
The dataset used in this study is publicly available on OSF under the CC-BY 4.0 International License.
Please cite appropriately if you use it.
- Clone this repository:
git clone https://github.com/jltt-grc/memorable_scents.git
cd memorable_scents- Download the dataset:
- Go to the OSF dataset page.
- Download the dataset file (raw_data.csv).
- Place it inside the data/ folder without renaming it.
- Install dependencies:
- For Python:
pip install -r requirements.txt- For R (in RStudio or R console):
source("install_packages.R")- Launch the notebooks:
jupyter notebook-
Run the notebooks in the following order:
preprocessing.ipynbmachine_learning.ipynb
-
Open and knit
statistics.Rmdin RStudio for statistical analysis.
- Juliette Greco-Vuilloud & Anne-Lise Saive
- Code: BSD-3-Clause license.
- Dataset: CC-BY 4.0 International.
If you use this work in your research, please cite the following paper: Greco-Vuilloud J, Ruby P, Plailly J, Saive A-L. 2026. What makes a scent trigger a memory? A cognitive decomposition of odor-evoked retrieval. iScience. 29(1) 2026 https://doi.org/10.1016/j.isci.2025.114467
Feel free to open issues or contribute by submitting a pull request.