MRI

THINGS-fMRI

This repository contains code for running the analyses presented in the THINGS-data manuscript.

Installation

The python code can be installed from this repository with pip:

# create a new environment
conda create -n thingsdata python==3.9
conda activate thingsdata
# install the python modules for analyzing the fMRI data
pip install -e .

External requirements

Some of the analyses run non-python neuroimaging software, such as FreeSurfer, ANTS, and FSL.

Jupyter notebooks

• fmri_usage.ipynb: Examples on how to interact with the fMRI data in general, such as: a) loading the single trial responses from the table or the volumetric data, b) using the brain masks to convert data between these two formats, c) plotting data on the cortical flat maps.
• animacy_size.ipynb: Demonstration for fitting an encoding model of object animacy and size to the single trial fMRI responses.
• working_with_rois.ipynb: Demonstration for how to extract data from regions of interest.

Python modules

• reconall.py: Python scrpit wrapping FreeSurfer reconall.
• scenePRF_Fix.py: Experiment code to run used to run the PRF experiment in psychopy.
• prf.py: Analysis code for running a population receptive field model in AFNI, refining the retinotopic estimates with neuropythy, and generating ROIs for retinotopic brain areas.
• localizerGLM_FSL.py: Analysis code for the object category functional localizer, running FSL and nipype.
• melodic.py: Analysis code for the ICA denoising procedure. This includes: a) running ICA (FSL MELODIC) on the preprocessed functional MRI data, b) calculating a list of features which characterize each IC, c) generating visualizations for raters to label, d) output ICA noise regressors based on feature thresholds.
• betas.py: Procedure for estimating single trial responses from the preprocessed volumetric time series data.
• anc.py: Estimation of noise ceilings in single-trial response estimates.
• mds_betas.py: Script for visualizing similarity structure in LOC responses via multidimensional scaling (grouped by object categories).
• utils.py, glm.py, dataset: Miscellaneous helper functions used by the other modules.

Bash scripts

• neurodocker.sh: Recipe for a docker container running FSL and FreeSurfer.
• reconall.sh: Run FreeSurfer recon-all through the neurodocker container.
• run_fmriprep.sh: fMRIPrep command.