CSOVolume

MLModule
genre CSOModule
author Jan Hendrik Moltz
package FMEwork/ReleaseMeVis
dll MLCSOMiscModules
definition MLCSOMiscModules.def
see also CalculateVolume
keywords volumetry, area, sum

Purpose

Computes the volume of an object defined by CSOs on all slices.

Usage

Connect a CSOList and the image on which the CSOs were created. Press update if autoUpdate is not enabled.

Details

The CSOList has to fulfill the following requirements: it must not be empty, all CSOs must be closed and parallel. The CSOList should contain a single object to be measured. Use a CSOFilter module if necessary. The result is the sum of all CSO areas, multiplied by the slice thickness. The slice thickness is inferred from the voxel size of the input image and the plane normal of the CSOs. If CSOs are embedded into each other, CSOs with odd level of embedding are considered as holes and have a negative contribution to the volume.

Windows

Default Panel

../../../Modules/ML/MLCSOMiscModules/mhelp/Images/Screenshots/CSOVolume._default.png

Input Fields

input0

name: input0, type: Image

Image on which the CSOs were drawn, used to infer the slice thickness.

inCSOList0

name: inCSOList0, type: MLBase

CSOList representing the object to be measured.

Parameter Fields

Field Index

[]: Trigger
Clear: Trigger
Has Valid Output: Bool
On Input Change Behavior: Enum
Status Code: Enum
Status Message: String
Update: Trigger
Volume (in ml): Double

Visible Fields

Update

name: update, type: Trigger

Initiates update of all output field values.

Clear

name: clear, type: Trigger

Clears all output field values to a clean initial state.

On Input Change Behavior

name: onInputChangeBehavior, type: Enum, default: Clear, deprecated name: shouldUpdateAutomatically,shouldAutoUpdate

Declares how the module should react if a value of an input field changes.

Values:

Title Name Deprecated Name
Update Update TRUE
Clear Clear FALSE

Status Code

name: statusCode, type: Enum, persistent: no

Reflects module’s status (successful or failed computations) as one of some predefined enumeration values.

Values:

Title Name
Ok Ok
Invalid input object Invalid input object
Invalid input parameter Invalid input parameter
Internal error Internal error

Status Message

name: statusMessage, type: String, persistent: no

Gives additional, detailed information about status code as human-readable message.

Has Valid Output

name: hasValidOutput, type: Bool, persistent: no

Indicates validity of output field values (success of computation).

[]

name: updateDone, type: Trigger, persistent: no

Notifies that an update was performed (Check status interface fields to identify success or failure).

Volume (in ml)

name: outVolume, type: Double, persistent: no

The sum of areas of the CSOs, multiplied by the voxel size along the CSOs’ plane normals, given in ml.