JointHistogram

MLModule
genre Histogram
author MeVis Medical Solutions AG
package MeVisLab/Standard
dll MLJointHist
definition MLJointHist.def
keywords 2D

Purpose

The module JointHistogram generates a 2D histogram and the associated 1D histograms from two input images.

Details

For an example we use simulated T1- and T2-weighted MR images. The images were obtained from the BrainWeb MR simulator.

T1-weighted image:

../../../Modules/ML/MLJointHist/mhelp/Images/t1.JPG

T2-weighted image:

../../../Modules/ML/MLJointHist/mhelp/Images/t2.JPG

Resulting 2D histogram:

../../../Modules/ML/MLJointHist/mhelp/Images/histogram.JPG

Windows

Default Panel

../../../Modules/ML/MLJointHist/mhelp/Images/Screenshots/JointHistogram._default.png

Input Fields

input0

name: input0, type: Image

input1

name: input1, type: Image

Output Fields

output0

name: output0, type: Image

The 2D histogram of the two input images.

outputHistogramX

name: outputHistogramX, type: CurveData(MLBase)

The 1D histogram of the first input image.

For accessing this object via scripting see the Scripting Reference: MLCurveDataWrapper.

outputHistogramY

name: outputHistogramY, type: CurveData(MLBase)

The 1D histogram of the second input image.

For accessing this object via scripting see the Scripting Reference: MLCurveDataWrapper.

Parameter Fields

Visible Fields

Auto update (autoUpdateImgX)

name: autoUpdateImgX, type: Bool, default: TRUE

If checked, the module computes the minimum and the maximum values anew if the first input image is changed.

Auto update (autoUpdateImgY)

name: autoUpdateImgY, type: Bool, default: TRUE

If checked, the module computes the minimum and the maximum values anew if the second input image is changed.

Auto

name: autoApply, type: Bool, default: FALSE

If checked, the module computes anew on any field change.

Output Size X

name: binsX, type: Integer, default: 512

Shows the number of bins of the (x-) histogram.

Output Size Y

name: binsY, type: Integer, default: 512

Shows the number of bins of the (y-) histogram.

Step Size X

name: stepSizeX, type: Double, default: 1

Sets the step size of the x-histogram.

Use this parameter to change the overall size of the histogram.

Step Size Y

name: stepSizeY, type: Double, default: 1

Sets the step size of the y-histogram.

Use this parameter to change the overall size of the histogram.

Maximum (maxImgX)

name: maxImgX, type: Double, default: 2000

Sets the maximum treshold value for voxel values in the first image.

Maximum (maxImgY)

name: maxImgY, type: Double, default: 2000

Sets the maximum treshold value for voxel values in the second image.

Minimum (minImgX)

name: minImgX, type: Double, default: 0

Sets the minimum treshold value for voxel values in the first image.

Minimum (minImgY)

name: minImgY, type: Double, default: 0

Sets the minimum treshold value for voxel values in the second image.

&Apply

name: computeHistograms, type: Trigger

If pressed, the module computes anew.

Reset (resetMinMaxValuesX)

name: resetMinMaxValuesX, type: Trigger

If pressed, the minimum and the maximum value of the first image are reset to the actual image range.

The values are set to 0 if no image is attached.

Reset (resetMinMaxValuesY)

name: resetMinMaxValuesY, type: Trigger

If pressed, the minimum and the maximum value of the second image are reset to the actual image range.

The values are set to 0 if no image is attached.

Use integer values (wholeNumberedImgX)

name: wholeNumberedImgX, type: Bool, default: TRUE

If checked, the step size is being calculated with integer precision.

Otherwise, it is calculated in float precision.

Use integer values (wholeNumberedImgY)

name: wholeNumberedImgY, type: Bool, default: TRUE

If checked, the step size is being calculated with integer precision.

Otherwise, it is calculated in float precision.

Y-Image Mode

name: secondDimensionMode, type: Enum, default: InputImage

Defines the dimension that is read out of the second inout image.

Values:

Title Name
input0 - X Coordinate XDimension
input0 - Y Coordinate YDimension
input0 - Z Coordinate ZDimension
input0 - C Coordinate CDimension
input0 - T Coordinate TDimension
input0 - U Coordinate UDimension
input1 - Image Values InputImage

Status

name: status, type: String, persistent: no

Shows status information about the module.

Out Of Range Count

name: outOfRangeCount, type: Integer, persistent: no

Shows the number of values that lie out of the minimum and maximum range.

Those values do not influence the resulting histogram.

Hidden Fields

debugLevel

name: debugLevel, type: Integer, default: 0

outputbinSizeX

name: outputbinSizeX, type: Double, default: 1

outputbinSizeY

name: outputbinSizeY, type: Double, default: 1