bin.opening {espadon}

Binary volume opening

Description

The bin.opening function performs a morphological operation of opening, using a sphere, on a "volume" class object of "binary" modality. Opening is useful for :

• removing volumes that are smaller than the radius,

• smoothing shapes.

Usage

bin.opening(vol, radius = 10, alias = "", description = NULL)

Arguments

vol

"volume" class object, of "binary" modality.

radius

Positive number, in millimeters. By default, radius = 10.

alias

Character string, $object.alias of the created object.

description

Character string, describing the created object. If description = NULL (default value), it will be set to paste (vol$object.alias, "opening r =", radius).

Value

Returns a "volume" class object of "binary" modality (see espadon.class for class definitions), with the same grid as vol, in which $vol3D.data has been transformed by the opening operation.

Note

Opening can be time consuming, try to reduce the binary volume to the strict minimum, before any operations.

See Also

bin.dilation, bin.erosion, bin.closing, add.margin, nesting.cube.

Examples

# loading of toy-patient objects (decrease dxyz for better result)
step <- 4
patient <- toy.load.patient (modality = "mr", roi.name = "", 
                             dxyz = rep (step, 3))
MR <- patient$mr[[1]]

# generation of a binary volume
b <- bin.from.vol(MR, min = 15,max = 30)

b.opening <- bin.opening (b, radius = step)
display.plane (bottom = MR, top = b, main = "Before opening", 
               view.coord = -20, interpolate = FALSE)
display.plane (bottom = MR, top = b.opening, main = "After opening", 
               view.coord = -20, interpolate = FALSE)