Sovereign 8s.is mirror of standardgalactic/dOccLS
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
drummondmcculloch 4536045625 Add external software section: BASIL, ICA segmentation, PCMCalculator
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-04 12:05:31 +01:00
code Remove old/duplicate files from code/ 2026-03-04 11:58:45 +01:00
data Add GCOR pipeline, occupancy statistics, and QC code 2026-03-04 11:56:42 +01:00
preregistration Rename Prereg_Hypotheses_dOccLS.docx to preregistration/Prereg_Hypotheses_dOccLS.docx 2024-10-18 08:43:17 +02:00
rois Add files via upload 2024-10-18 12:14:13 +02:00
LICENSE Initial commit 2024-09-20 10:26:13 +02:00
README.md Add external software section: BASIL, ICA segmentation, PCMCalculator 2026-03-04 12:05:31 +01:00

dOccLS — Molecular and haemodynamic effects of LSD in the human brain

Code and data accompanying the dOccLS manuscript. This repository contains everything needed to reproduce the receptor occupancy and fMRI Global Correlation (GCOR) analyses.

Repository structure

code/
├── run_gcor_pipeline.m        Main MATLAB wrapper for regional GCOR analysis
├── process_cpac_outputs3.m    Parse C-PAC output tree into a results table
├── process_gcor_regional.m    Regional GCOR (232-region Schaefer+Tian atlas)
├── doccls_stats_gcor.Rmd      R notebook: occupancy curves + GCOR statistics
├── doccls_qc_metrics.m        fMRI QC report (FD, DVARS, QC-FC)
├── preprocessing/             C-PAC preprocessing configuration (YAML)
└── README.md                  Detailed usage instructions

data/
└── occupancy_data.csv         Anonymised PET occupancy and plasma LSD data

rois/
└── Atlas files                Schaefer 200, Schaefer+Tian 232, Yeo-7/17 (3 mm MNI)

Analyses covered

Receptor occupancy (doccls_stats_gcor.Rmd, data/occupancy_data.csv)

  • Plasma LSD concentration vs neocortex 5-HT2A occupancy: Michaelis-Menten NLS fit with 10,000-iteration sign-flipping bootstrap for Occ_max and IC50 confidence intervals
  • LSD dose vs occupancy: same approach, reports ED50
  • Subjective drug intensity vs occupancy: linear mixed model

fMRI Global Correlation (run_gcor_pipeline.m, doccls_stats_gcor.Rmd)

  • C-PAC preprocessing with preprocessing/pipeline_config.yml
  • Regional GCOR computed across 232 brain regions (Schaefer 200 + Tian subcortex)
  • LSD vs baseline delta, correlation with plasma levels and receptor occupancy
  • QC report: mean FD, DVARS, QC-FC distance-dependence

Quick start

Occupancy statistics only — no fMRI data required:

  1. Clone this repository
  2. Open code/doccls_stats_gcor.Rmd in RStudio
  3. Knit — Section 1 runs self-contained from data/occupancy_data.csv

GCOR pipeline with synthetic data — no C-PAC outputs required:

  1. Open code/run_gcor_pipeline.m in MATLAB
  2. Set USE_DUMMY_DATA = true
  3. Run — generates synthetic 232-region timeseries and exercises the full pipeline

Full GCOR pipeline:

  1. Run C-PAC with code/preprocessing/pipeline_config.yml
  2. Edit paths in run_gcor_pipeline.m and run
  3. Set gcor_csv in doccls_stats_gcor.Rmd and knit

See code/README.md for full documentation including dependencies and exclusion criteria.

Preregistration

Study hypotheses and statistical methods were registered prior to data analysis. See the preregistration/ folder.

External software used

Brain entropy measures LZ complexity and geodesic entropy used the CopBET toolbox: https://github.com/anders-s-olsen/CopBET

Cerebral blood flow (pcASL) CBF was quantified using BASIL (part of FSL). The pipeline included label/control subtraction, calibration to absolute CBF (ml/100 g/min) using M0 scans and a single-compartment kinetic model, normalisation to MNI152 space, and 8 mm FWHM spatial smoothing. Regional CBF was extracted using the AAL3 atlas with grey-matter weighted averaging. Software: https://fsl.fmrib.ox.ac.uk/fsl/docs/physiological/basil.html

Internal carotid artery diameter (TOF MRI) ICA diameter was quantified from time-of-flight images using publicly available in-house software that applies background subtraction, anisotropic diffusion filtering, and top-hat filtering, followed by semi-automated 2D region-growing segmentation and 3D diameter estimation. Software: https://github.com/kristian1801/ica-segmentation-tool

Internal carotid artery flow (phase-contrast MRI) ICA flow was quantified from phase-contrast images using PCMCalculator, which measures through-plane flow rate after manual vessel selection. The method has been validated on both 3T Philips and 3T Siemens systems. Software: https://github.com/MarkVestergaard/PCMCalculator