fmri_regiontable

Description

FMRI_REGIONTABLE Cluster and ROI table for a thresholded statistical map. For a binary thresholded brain map, identifies all clusters, labels each voxel with its atlas region, and returns a structured summary table. Useful for reporting activation results: lists cluster size, peak coordinate, peak statistic, MNI location, and atlas region for every cluster.

Usage

[clust, s, ROI, list, roi, clus] = fmri_regiontable(data_thres, data)
[clust, s, ROI, list, roi, clus] = fmri_regiontable(data_thres, data, clsize, roisize, atlas)

Inputs

  • DATA_THRES: Binary brain map (228453 x 1): 1 = suprathreshold voxel.

  • DATA: Continuous statistical map (228453 x 1): used for peak values.

  • CLSIZE: Minimum cluster size in voxels. Default: 0 (all clusters).

  • ROISIZE: Minimum ROI size in voxels to appear in table. Default: 0.

  • ATLAS: Atlas number (see atlas list below). Default: 1 (AAL).

Outputs

  • CLUST: Struct array: one element per cluster, fields: centroid, n, region.

  • S: Table of ROI information (printed to command window).

  • ROI: Cell array: each cell is a (228453 x K) binary matrix of atlas regions within cluster k.

  • LIST: Cell array: region name strings corresponding to ROI columns.

  • ROI: Same as ROI but stores voxel indices rather than binary maps.

  • CLUS: (228453 x nClusters) matrix: column k = binary map of cluster k. Fast plotting: fmri_show3d(clus(:,[1 3]))

Examples

[c, s] = fmri_regiontable(thresh_map, z_map);
[c, s] = fmri_regiontable(thresh_map, z_map, 50, 10, 3);
Atlas numbers:
1  = AAL / MarsBar (Automated Anatomical Labeling, 116 ROIs, default)
2  = Harvard-Oxford Subcortical Structural Atlas (21 ROIs)
3  = Harvard-Oxford Cortical Structural Atlas (48 ROIs)
4  = Cerebellar Atlas (MNI152, FLIRT affine, 28 ROIs)
5  = Cerebellar Atlas (MNI152, FNIRT nonlinear, 28 ROIs)
6  = JHU ICBM-DTI-81 White-Matter Labels (48 ROIs)
7  = JHU White-Matter Tractography Atlas (20 ROIs)
8  = Juelich Histological Atlas (62 ROIs)
9  = MNI Structural Atlas (9 ROIs)
10  = Oxford-Imanova Striatal Structural Atlas (3 ROIs)
11  = Oxford-Imanova Striatal Connectivity Atlas, 3 sub-regions
12  = Oxford-Imanova Striatal Connectivity Atlas, 7 sub-regions
13  = Oxford Thalamic Connectivity Probability Atlas (25 ROIs)
14  = Craddock Parcellation 200 ROI
15  = Craddock Parcellation 400 ROI
16  = Craddock Parcellation 500 ROI
17  = Craddock Parcellation 600 ROI
18  = Craddock Parcellation 950 ROI
19  = Brodmann Areas (48 regions)

See Also

  • fmri_cleanclusters

  • fmri_regionnumber

  • fmri_csthreshold