HistogramPeakEstimate

MLModule

genre	Histogram
status	stable
author	Jan Rexilius
package	MeVisLab/Standard
dll	MLVolumetry
definition	MLVolumetry.def
keywords	histogram, peak, position, estimate

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:

Windows

Default Panel

Input Fields

inHistogram

name: inHistogram, type: MLBase

Output Fields

outPeakPositions

name: outPeakPositions, type: MLBase

outPeakXValues

name: outPeakXValues, type: MLBase

Parameter Fields

Field Index

Distance for Slope: Integer

Max Peak Postition: Integer

Min Peak Postition: Integer

Minimum Height: Float

Minimum Slope: Float

Number of Iterations: Integer

Number of Peaks: Integer

Time Step Size: Float

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: Float, default: 1, minimum: 0.01, maximum: 10

Sets the time step size.

Minimum Height

name: minHeight, type: Float, default: 0

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

Minimum Slope

name: minSlope, type: Float, 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

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

Number of Peaks

name: numOfPeaks, type: Integer, default: 0, deprecated name: NumOfPeaks

Shows the number of computed peaks.

Min Peak Postition

name: minPeakPos, type: Integer, default: 0

Shows the X-position of the first peak.

Max Peak Postition

name: maxPeakPos, type: Integer, default: 0

Shows the X-position of the last peak.