4.4.1.1. nilearn.masking.compute_epi_mask

nilearn.masking.compute_epi_mask(epi_img, lower_cutoff=0.2, upper_cutoff=0.9, connected=True, opening=2, exclude_zeros=False, ensure_finite=True, target_affine=None, target_shape=None, memory=None, verbose=0)

Compute a brain mask from fMRI data in 3D or 4D ndarrays.

This is based on an heuristic proposed by T.Nichols: find the least dense point of the histogram, between fractions lower_cutoff and upper_cutoff of the total image histogram.

In case of failure, it is usually advisable to increase lower_cutoff.

Parameters :

epi_img: nifti-like image :

EPI image, used to compute the mask. 3D and 4D images are accepted. If a 3D image is given, we suggest to use the mean image

lower_cutoff: float, optional :

lower fraction of the histogram to be discarded.

upper_cutoff: float, optional :

upper fraction of the histogram to be discarded.

connected: bool, optional :

if connected is True, only the largest connect component is kept.

opening: bool or int, optional :

if opening is True, an morphological opening is performed, to keep only large structures. This step is useful to remove parts of the skull that might have been included. If opening is an integer ‘n’, it is performed via ‘n’ erosion followed by ‘n’ dilations.

ensure_finite: bool :

If ensure_finite is True, the non-finite values (NaNs and infs) found in the images will be replaced by zeros

exclude_zeros: bool, optional :

Consider zeros as missing values for the computation of the threshold. This option is useful if the images have been resliced with a large padding of zeros.

target_affine: 3x3 or 4x4 matrix, optional :

This parameter is passed to image.resample_img. Please see the related documentation for details.

target_shape: 3-tuple of integers, optional :

This parameter is passed to image.resample_img. Please see the related documentation for details.

memory: instance of joblib.Memory or string :

Used to cache the function call.

verbose: int, optional :

Returns :

mask: nibabel.Nifti1Image :

The brain mask (3D image)