BoundingBoxExt

MacroModule

genre	Subimage
author	Frank Heckel
package	FMEstable/ReleaseMeVis
definition	BoundingBoxExt.def
see also	BoundingBox, Info, ImagePropertyConvert, ImageStatistics, MinMaxScan, CalculateVolume, SubImage
keywords	bounding, box, volume, statistic, interval, count, voxels, volume, cut, reduce, reduction, roi, extract

Purpose

Like the BoundingBox module the BoundingBoxExt module scans the input automatically or on demand and calculates the bounding box of all voxels which are within a given grey level interval. In addition the the BoundingBox this module has an optional margin for each dimension that is added to the image that BoundingBox generates. The found bounding box is cut from the input image and passed to the output. If the resulting subimage lies outside the original image the missing voxels are filled with a given fill value. Also the number of found voxels in the interval, in the box and the corresponding volume in mm^3 is shown.

Usage

See example network.

Details

None.

Windows

Default Panel

Input Fields

inImage

name: inImage, type: Image

The image on which a bounding box should be computed.

Output Fields

outImage

name: outImage, type: Image

The part of the input image that lies inside the bounding box. If the bounding box exceeds the image the missing values will be filled with the given fill value.

Parameter Fields

Field Index

= (objectVolume): Double	C: Integer	U: Integer
= (boxVolume): Double	Clear: Trigger	Update: Trigger
Auto Apply: Bool	Extent: String	Use image cache: Bool
Auto Clear: Bool	Fill Value: Double	Valid: Bool
Auto Update: Bool	Max Value: Double	X: Integer
Bounding Box: String	Min Value: Double	Y: Integer
Bounding Box World: String	Object Size: Integer	Z: Integer
Box Size: Integer	T: Integer

Visible Fields

Min Value

name: objectMin, type: Double, default: 1

The minimum limit of the interval which voxels must fullfil to be counted.

Max Value

name: objectMax, type: Double, default: 255

The maximum limit of the interval which voxels must fullfil to be counted.

X

name: marginX, type: Integer, default: 0

The margin in voxels in x-dimension that is added to the bounding box of the object.

Y

name: marginY, type: Integer, default: 0

The margin in voxels in y-dimension that is added to the bounding box of the object.

Z

name: marginZ, type: Integer, default: 0

The margin in voxels in z-dimension that is added to the bounding box of the object.

C

name: marginC, type: Integer, default: 0

The margin in voxels in c-dimension that is added to the bounding box of the object.

T

name: marginT, type: Integer, default: 0

The margin in voxels in t-dimension that is added to the bounding box of the object.

U

name: marginU, type: Integer, default: 0

The margin in voxels in u-dimension that is added to the bounding box of the object.

Fill Value

name: fillValue, type: Double, default: 0

Voxels in the bounding box that are outside of the input image are filled with this value.

Bounding Box

name: boundingBox, type: String, persistent: no

Shows both corners of the bounding box in voxel-coords which are still within the box.

Bounding Box World

name: boundingBoxWorld, type: String, persistent: no

Shows both corners of the bounding box in world-coords which are still within the box.

Extent

name: boundingBoxExtent, type: String, persistent: no

The extent of the bounding box in voxels.

Object Size

name: objectVoxels, type: Integer, persistent: no

The number of voxels found in [MinValue, MaxValue].

= (objectVolume)

name: objectVolume, type: Double, persistent: no

The total volume of all voxels in [MinValue, MaxValue] in ml.

Box Size

name: boxVoxels, type: Integer, persistent: no

The number of all voxels in the found bounding box.

= (boxVolume)

name: boxVolume, type: Double, persistent: no

The volume of all voxels in the bounding box in ml.

Auto Update

name: autoUpdate, type: Bool, default: TRUE

If enabled the bounding box will be calculated on each change of the input image.

Auto Apply

name: autoApply, type: Bool, default: TRUE

If enabled all parameter changes are applied immediately resulting in a recalculation of the bounding box.

Auto Clear

name: autoClear, type: Bool, default: TRUE

If enabled the internal parameters and the image cache are deleted when the input is disconnected.

Use image cache

name: useMemCache, type: Bool, default: FALSE

If enabled, the result is stored into an internal image cache.

Valid

name: valid, type: Bool, persistent: no

Indicates that the output image is valid.

Update

name: update, type: Trigger

Manually update the bounding box image.

Clear

name: clear, type: Trigger

Deletes the bounding box parameters and the image cache.