11.2.1. Task FMRI processing: the MACAQUE_DEMO

Overview

Welcome to the homepage of the demo for processing task FMRI macaque data.

The demo dataset contains an anatomical dataset and several EPIs collected during a visual stimulus with four stimulus classes related to specific faces and objects shown to the subject.

The processing scripts include calculating nonlinear alignment between the subject’s anatomical (using AFNI’s @animal_warper) and the stereotaxic NMT template. Additionally, a full single subject processing pipeline is constructed with afni_proc.py, including an HRF appropriate for this EPI data that had been collected with MION.

These scripts are meant to providing and example and starting point of task processing. Many features can (and, in general, will) be adjusted for your own study’s design. Please feel free to ask question on the AFNI Message Board, even with regards to setting up your study.

Thanks go to Adam Messinger, Ben Jung and Jakob Seidlitz for both the accompanying macaque data set and many processing suggestions/advice.

Updated Oct 23, 2021: MACAQUE_DEMO v4.0.

Download the MACAQUE_DEMO

To get the demo, copy+paste:

@Install_MACAQUE_DEMO

This will both download and unpack the demo in the directory where the command is run.

There is a README.txt describing the contents and how to execute the scripts.

Demo datasets: Provided inputs

The demo contains one subject’s initial data:

  • a standard, high-res anatomical (T1w) dataset

  • a set of task FMRI (EPI) datasets; these are raw EPIs, with “place correction” already performed

  • a set of stimulus timing files; these have already been adjusted for the TR removal that will be performed during processing

  • reference template and atlas: here, the stereotaxic NMT and the D99 template in that space

Proc: nonlinear alignment with @animal_warper

All demo scripts are distributed in a directory called scripts/. See the README.txt in the main demo directory for dsecriptions of what each contains and how to run them.

Some processed datasets are also included. In particular, AFNI’s @animal_warper command was run on the anatomical dataset to perform both skullstripping and nonlinear alignment to template space (here, the stereotaxic NMT template). This has been performed with the included do_13_aw.tcsh script. Some of the functionality and output of this step can be seen in the automatically generated QC images:

Alignment check: warped anatomical overlaying reference base edges

../../_images/qc_00_e_temp%2Bwrpd_inp.sag.png

Skullstripping check: native space anatomical underlaying brain mask

../../_images/qc_02_orig_inp%2Bmask.sag.png

Atlas ROIs mapped to native space

../../_images/qc_03_ee_orig_inp%2Bwrpd_atlas.sag.png

SUMA view of ROI parcellation in native space (some ROIs have been made nearly transparent to show show inner regions)

../../_images/d99.gif

Outputs from this step are included as inputs for afni_proc.py.


Proc: FMRI preprocessing with afni_proc.py

A full preprocessing script for the subject, including motion correction and regression modeling, is generated using afni_proc.py. The do_20_ap.tcsh script contains an example of including 4 EPI datasets for processing, and the do_21_ap_all.tcsh script runs over all 15 EPIs included in the demo (the latter takes notably longer to run).

The outputs of the the afni_proc.py-generated scripts are not included, but their automatically generated QC HTML files are.

QC blocks: anat-to-template and stat modeling (full F-stat)

QC block: motion and outliers

../../_images/apqc_va2t_vstat.png ../../_images/apqc_mot.png

QC block: warnings (collinearity, censoring, etc.)

QC block: regression (ideal response, DF counts, etc.)

../../_images/apqc_warns.png ../../_images/apqc_regr.png

Additional reading

For more information about @animal_warper, please see:

For more information about the NMTv2 template and CHARM and SARM atlas, please see:

For more information about the PRIME-RE (the PRIMatE Resource Exchange), please see:

  • Messinger A, Sirmpilatze N, Heuer K, Loh K, Mars R, Sein J, Xu T, Glen D, Jung B, Seidlitz J, Taylor P, Toro R, Garza-Villareal E, Sponheim C, Wang X, Benn A, Cagna B, Dadarwal R, Evrard H, Garcia-Saldivar P, Giavasis S, Hartig R, Lepage C, Liu C, Majka P, Merchant H, Milham M, Rosa M, Tasserie J, Uhrig L, Margulies D, Klink PC (2020). A collaborative resource platform for non-human primate neuroimaging. Neuroimage, 226:117519.