ANTsR (version 1.0)

getMask: Get Mask

Description

Get a binary mask image from the given image after thresholding.

Usage

getMask( img = NULL, lowThresh = 1, highThresh = Inf, cleanup = FALSE )

Arguments

img

Input image. Can be a filename of a 3D image or an antsImage of dimension 3. If img is NULL, a file chooser dialog will appear.

lowThresh

An inclusive lower threshold for voxels to be included in the mask.

highThresh

An inclusive upper threshold for voxels to be included in the mask.

cleanup

If TRUE, morphological operations will be applied to clean up the mask by eroding away small or weakly-connected areas, and closing holes.

Value

Object of type antsImage containing the masked image. The voxel intensities will be binarized, 1 for voxels in the mask and 0 outside.

Details

If cleanup is TRUE, the following steps are applied

1. Erosion with radius 2 voxels

2. Retain largest component

3. Dilation with radius 1 voxel

4. Morphological closing

These functions are available in ImageMath, see the operations “ME”, “GetLargestComponent”, “MD”, “FillHoles”.

Examples

# NOT RUN {
# input_img.nii is a 3D image
mask_img <- get_mask( "input_img.nii" , 500 , 1e9 )
# }