BoundingBox

MLModule

genre

Subimage

author

MeVis Medical Solutions AG

package

MeVisLab/Standard

dll

MLMiscModules

definition

MLMiscModules.def

see also

Info, ImagePropertyConvert, ImageStatistics, MinMaxScan, CalculateVolume, SubImage

keywords

volume, statistic, interval, count, voxels, volume, cut, reduce, reduction, roi, extract

Purpose

The module BoundingBox scans the input automatically or on demand, and calculates the bounding box of all voxels which are within a given gray 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 that 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

When pressed, the module updates its output.

Up To Date

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

Shows whether 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 entire 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