table of contents
LIPSIA     Image masking
vimagemask
This program allows to mask an image by using a thresholded mask. The mask image is thresholded using user-supplied lower and upper thresholds, and the other image retains its values only at those voxels where the mask image passes these thresholds.

This program may for instance be used as a first step in a ROI analysis. Here, the mask image contains the ROIs, and the images to be masked may perhaps be a set of contrast images. In this case, 'vimagemask' must be called separately for each contrast image.

The parameter '-type' specifies, whether values between '-min' and '-max' or values below '-min' and exceeding '-max' should be retained.

Example:

vimagemask -in image.v -mask mask.v -out masked_image.v -min 0 -max 1.5 -type inside

In this example, all voxels with values between 0 and 1.5 in the mask remain in the result image.

vimagemask -in image.v -mask mask.v -out masked_image.v -min -3.09 -max 3.09 -type outside

In this example, voxels with values below -3.09 and above 3.09 in the mask remain part of the result image. As the default value of '-type' is 'outside', this parameter could also be omitted in this example.

Parameters of 'vimagemask':
-help
Prints usage information.
-in
Input file.
-out
Output file.
-mask
Mask image. Required.
-min
Minimal (lower) threshold. Required.
-max
Maximal (upper) threshold. Required.
-type [ inside | outside ]
Outside range vs. inside range. Default: outside


Max Planck Institute for Human Cognitive and Brain Sciences. Further Information: lipsia@cbs.mpg.de
Copyright © 2007 Max Planck Institute for Human Cognitive and Brain Sciences. All rights reserved.