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.

This module only works on scalar voxel types.

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 Max Value: Double v1U: Integer
= (boxVolume): Double Min Value: Double v1X: Integer
Bounding Box: String Object Size: Integer v1Y: Integer
Box Size: Integer progress: Double v1Z: Integer
eC: Integer Up To Date: Bool v2C: Integer
eT: Integer Update: Trigger v2T: Integer
eU: Integer Update Mode: Enum v2U: Integer
eX: Integer Use (useMin): Bool v2X: Integer
Extent: IntVector6 Use (useMax): Bool v2Y: Integer
eY: Integer v1C: Integer v2Z: Integer
eZ: Integer v1T: 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: IntVector6, 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).

Use (useMin)

name: useMin, type: Bool, default: TRUE

Use minimum voxel value.

Use (useMax)

name: useMax, type: Bool, default: FALSE

Use maximum voxel value.

Min Value

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

Sets the minimum voxel value. Only used if Use Min Value is true.

Max Value

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

Sets the maximum voxel value. Only used if Use Max Value is true.

Update Mode

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

Defines how module reacts to input changes.

Values:

Title Name Deprecated Name Description
Update AutoUpdate TRUE The module updates its output on any input or field change.
Clear AutoClear FALSE,Off 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

progress

name: progress, type: Double, persistent: no

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