Skip to contents

Load DMT-imaging dataset (Timmermann et al. 2023)

Source: R/entheo_data.R
load_dmt_imaging.Rd

R parity of morie.entheo.data.load_dmt_imaging. Reads the Carhart-Harris / Timmermann DMT-imaging dataset (20 subjects EEG + parcellated fMRI; 15 motion-survived) from a local mirror. Falls back to a reproducible synthetic record when the dataset is absent or when R.matlab is not installed, so downstream code keeps running in CI.

Usage

load_dmt_imaging(subject_id = NULL, root = NULL)

Arguments

subject_id

integer or character (zero-padded 2-digit). NULL means "all available subjects on disk".

root

character. Override path to the DMT_Imaging mirror. Defaults to $MORIE_DMT_IMAGING_ROOT, else a DMT_Imaging folder in the per-user cache directory.

Value

Named list with components:

  • records list of subject records (eeg, fmri, behavioural).

  • root resolved dataset root path (or NA).

  • synthetic TRUE if any record is the fallback.

  • warnings character vector of advisories.

References

Timmermann, C. et al. (2023). Neural correlates of the DMT experience assessed with multivariate EEG. Scientific Reports.

Examples

res <- load_dmt_imaging(subject_id = 7, root = tempfile("no-dmt-"))
res$synthetic
#> [1] TRUE
res$subject_ids
#> [1] "07"