Note

This page is a reference documentation. It only explains the function signature, and not how to use it. Please refer to the user guide for the big picture.

brainprep.interfaces.cat12.cat12vbm_morphometry¶

brainprep.interfaces.cat12.cat12vbm_morphometry(output_dir, dryrun=False)[source]¶

Extract ROI-based morphometry features and global tissue volumes from CAT12 VBM outputs.

This function parses CAT12 .mat ROI statistics and .xml report files for all subjects in a BIDS-organized dataset. It generates one TSV file per atlas containing ROI-level gray matter (GM), white matter (WM), and cerebrospinal fluid (CSF) volumes. It also generates a TSV file containing total intracranial volume (TIV) and absolute tissue volumes (GM, WM, CSF).

Parameters:

output_dirDirectory: Working directory containing the outputs.
dryrunbool: If True, skip actual computation and file writing. Default False.

Returns:

morphometry_fileslist[File]: TSV files containing ROI-based GM, WM and CSF features for different atlases. A list containing the paths to all generated TSV files. One TSV is produced per atlas for ROI-based morphometry, plus one TSV summarizing global tissue volumes.

Raises:

ValueError: If the XML structure does not contain the expected CAT12 fields, or if parsing fails for any subject.