HistogramPeakEstimate

MLModule

genre

Histogram

author

MeVis Medical Solutions AG

package

MeVisLab/Standard

dll

MLVolumetry

definition

MLVolumetry.def

keywords

position

Purpose

The module HistogramPeakEstimate calculates an estimate of peak positions of a histogram.

Details

The module computes peak positions of a smoothed version of the input histogram. Smoothing is performed by a non-linear diffusion filter with a linear diffusion model (see also SmoothHistogram).

A peak satisfies the following conditions:

  1. The histogram value of a peak is higher than those of his neighbors.

  2. The histogram value of a peak is at least Minimum Height (to remove low peaks).

  3. The difference between the histogram value of a peak and those of the two points with distance Distance for Slope is at least Minimum Slope (to remove flat peaks).

The positions of the peaks are returned, not the bin indices. All bin sizes are supported.

Example:

../../../Modules/ML/MLVolumetry/mhelp/Images/histogramPeakEstimate_result.jpg

Windows

Default Panel

../../../Modules/ML/MLVolumetry/mhelp/Images/Screenshots/HistogramPeakEstimate._default.png

Input Fields

inHistogram

name: inHistogram, type: HistogramObject(MLBase)

Output Fields

outPeakPositions

name: outPeakPositions, type: CurveData(MLBase)

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

outPeakXValues

name: outPeakXValues, type: CurveData(MLBase)

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

Parameter Fields

Field Index

Distance for Slope: Integer

Max Peak Postition: Integer

Min Peak Postition: Integer

Minimum Height: Double

Minimum Slope: Double

Number of Iterations: Integer

Number of Peaks: Integer

Time Step Size: Double

Visible Fields

Number of Iterations

name: numOfIterations, type: Integer, default: 100, minimum: 0, maximum: 300, deprecated name: iterations

Sets the number of iteration steps for the diffusion filter.

The more steps, the longer the diffusion time.

Time Step Size

name: stepSize, type: Double, default: 1, minimum: 0.01, maximum: 10

Sets the time step size.

Minimum Height

name: minHeight, type: Double, default: 0

Sets the minimum histogram value of a peak candidate to be considered.

Minimum Slope

name: minSlope, type: Double, default: 0

Sets the minimum difference between the histogram value of a peak to be considered and those of the two points with distance Distance for Slope.

Distance for Slope

name: distForSlope, type: Integer, default: 1, minimum: 0

Sets the distance between histogram positions that is used for slope estimation.

Number of Peaks

name: numOfPeaks, type: Integer, persistent: no, deprecated name: NumOfPeaks

Shows the number of computed peaks.

Min Peak Postition

name: minPeakPos, type: Integer, persistent: no

Shows the x-position of the first peak.

Max Peak Postition

name: maxPeakPos, type: Integer, persistent: no

Shows the x-position of the last peak.