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.

nilearn.glm.cluster_level_inference

nilearn.glm.cluster_level_inference(stat_img, mask_img=None, threshold=3.0, alpha=0.05, verbose=0)

Report the proportion of active voxels for all clusters defined by the input threshold.

This implements the method described in Rosenblatt et al.[1].

Parameters:

stat_imgNiimg-like object

statistical image (presumably in z scale)

mask_imgNiimg-like object, default=None

mask image

thresholdlist of float, default=3.0

Cluster-forming threshold in z-scale.

alphafloat or list, default=0.05

Level of control on the true positive rate, aka true discovery proportion.

verboseint or bool, default=0

Verbosity mode.

Returns:

proportion_true_discoveries_imgNifti1Image

The statistical map that gives the true positive.

References

[1]

Jonathan D. Rosenblatt, Livio Finos, Wouter D. Weeda, Aldo Solari, and Jelle J. Goeman. All-resolutions inference for brain imaging. NeuroImage, 181:786–796, November 2018. doi:10.1016/j.neuroimage.2018.07.060.

Examples using nilearn.glm.cluster_level_inference

Second-level fMRI model: true positive proportion in clusters

Second-level fMRI model: true positive proportion in clusters