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.