Skip to content

Mask

Mask

Bases: IntensityTransform

Set voxels outside of mask to a constant value.

Parameters:

Name Type Description Default
masking_method TypeMaskingMethod

See NormalizationTransform.

 required
outside_value float

Value to set for all voxels outside of the mask.

 0
labels Sequence[int] | None

If a label map is used to generate the mask, sequence of labels to consider. If None, all values larger than zero will be used for the mask.

 None
**kwargs

See Transform for additional keyword arguments.

 {}

Raises:

Type Description
RuntimeWarning

If a 4D image is masked with a 3D mask, the mask will be expanded along the channels (first) dimension, and a warning will be raised.

Examples:

>>> import torchio as tio
>>> subject = tio.datasets.Colin27()
>>> subject
Colin27(Keys: ('t1', 'head', 'brain'); images: 3)
>>> mask = tio.Mask(masking_method='brain')  # Use "brain" image to mask
>>> transformed = mask(subject)  # Set voxels outside of the brain to 0

__call__(data) 

__call__(data: Subject) -> Subject

__call__(data: ImageT) -> ImageT

__call__(data: torch.Tensor) -> torch.Tensor

__call__(data: np.ndarray) -> np.ndarray

__call__(data: sitk.Image) -> sitk.Image

__call__(data: dict[str, object]) -> dict[str, object]

__call__(data: nib.Nifti1Image) -> nib.Nifti1Image

Transform data and return a result of the same type.

Parameters:

Name Type Description Default
data TypeTransformInput

Instance of torchio.Subject, 4D torch.Tensor or numpy.ndarray with dimensions \((C, W, H, D)\), where \(C\) is the number of channels and \(W, H, D\) are the spatial dimensions. If the input is a tensor, the affine matrix will be set to identity. Other valid input types are a SimpleITK image, a torchio.Image, a NiBabel Nifti1 image or a dict. The output type is the same as the input type.

 required

to_hydra_config()

Return a dictionary representation of the transform for Hydra instantiation.

arguments_are_dict()

Check if main arguments are dict.

Return True if the type of all attributes specified in the args_names have dict type.

plot

Source code 
import torchio as tio
subject = tio.datasets.Colin27()
subject.remove_image('head')
mask = tio.Mask('brain')
masked = mask(subject)
subject.add_image(masked.t1, 'Masked')
subject.plot()