Purpose

The module BoundingBox scans the input automatically or on demand and calculates the bounding box of all voxels which are within a given grey level interval. The found bounding box is cut from the input image and passed to the output. Also the number of found voxels in the interval, in the box and the corresponding volume in ml is shown.

If no voxels in the bounding box are found the output image is empty, i.e. it has extent 0.

All voxels of the output image will have the same world coordinates as in the input image.

Details

Example

The example network shows a small medical data set with a segmented liver which has much higher voxel values. The bounding box module is used to scan the volume, determine the bounding box around the liver and to show only the liver at the output.

Windows

Default Panel

../../../Modules/ML/MLMiscModules/mhelp/Images/Screenshots/BoundingBox._default.png

Input Fields

input0

name: input0, type: Image

Output Fields

output0

name: output0, type: Image

Parameter Fields

Field Index

= (objectVolume): Double eZ: Integer v1X: Integer
= (boxVolume): Double Max Value: Double v1Y: Integer
Bounding Box: String Min Value: Double v1Z: Integer
Box Size: Integer Object Size: Integer v2C: Integer
eC: Integer Up To Date: Bool v2T: Integer
eT: Integer Update: Trigger v2U: Integer
eU: Integer Update Mode: Enum v2X: Integer
eX: Integer v1C: Integer v2Y: Integer
Extent: String v1T: Integer v2Z: Integer
eY: Integer v1U: Integer  

Visible Fields

Bounding Box

name: boundingBox, type: String, persistent: no

Shows both corners of the bounding box which are still within the box.

If not defined the values are (0, 0, 0, 0, 0, 0) and (-1, -1, -1, -1, -1, -1).

Extent

name: boundingBoxExtent, type: String, persistent: no

Shows the extent of the bounding box in voxels.

If the bounding box is empty, the value is (0, 0, 0, 0, 0, 0).

Min Value

name: objectMin, type: Double, default: 1, deprecated name: IntMin

Sets the minimum voxel value.

Max Value

name: objectMax, type: Double, default: 1, deprecated name: IntMax

Sets the maximum voxel value.

Update Mode

name: updateMode, type: Enum, default: AutoUpdate, deprecated name: AutoCompute

Defines how module reacts to input changes.

Values:

Title Name Description
Update AutoUpdate The module updates its output on any input or field change.
Clear AutoClear The module invalidates its output on any input or field change.

Update

name: update, type: Trigger, deprecated name: CalcBox,Calculate

If pressed, the module updates its output.

Up To Date

name: upToDate, type: Bool, persistent: no, deprecated name: ResultsValid

Shows if the module's output is up-to-date.

Object Size

name: objectVoxels, type: Integer, persistent: no, deprecated name: numVox

Shows the number of voxels within the interval [Min Value, Max Value].

= (objectVolume)

name: objectVolume, type: Double, persistent: no, deprecated name: voxVol

Shows the volume of voxels in ml within the interval [Min Value, Max Value].

Box Size

name: boxVoxels, type: Integer, persistent: no, deprecated name: boxVox

Shows the number of all voxels in the found bounding box.

Note that this can also include voxels which are not within [Min Value, Max Value].

= (boxVolume)

name: boxVolume, type: Double, persistent: no, deprecated name: boxVol

Shows the volume of voxels in ml within the whole output box.

Hidden Fields

v1X

name: v1X, type: Integer, persistent: no, deprecated name: V1X

v1Y

name: v1Y, type: Integer, persistent: no, deprecated name: V1Y

v1Z

name: v1Z, type: Integer, persistent: no, deprecated name: V1Z

v1C

name: v1C, type: Integer, persistent: no, deprecated name: V1C

v1T

name: v1T, type: Integer, persistent: no, deprecated name: V1T

v1U

name: v1U, type: Integer, persistent: no, deprecated name: V1U

v2X

name: v2X, type: Integer, persistent: no, deprecated name: V2X

v2Y

name: v2Y, type: Integer, persistent: no, deprecated name: V2Y

v2Z

name: v2Z, type: Integer, persistent: no, deprecated name: V2Z

v2C

name: v2C, type: Integer, persistent: no, deprecated name: V2C

v2T

name: v2T, type: Integer, persistent: no, deprecated name: V2T

v2U

name: v2U, type: Integer, persistent: no, deprecated name: V2U

eX

name: eX, type: Integer, persistent: no, deprecated name: EX

eY

name: eY, type: Integer, persistent: no, deprecated name: EY

eZ

name: eZ, type: Integer, persistent: no, deprecated name: EZ

eC

name: eC, type: Integer, persistent: no, deprecated name: EC

eT

name: eT, type: Integer, persistent: no, deprecated name: ET

eU

name: eU, type: Integer, persistent: no, deprecated name: EU