smooth_funct_1d_mean ( : : Function, SmoothSize, Iterations : SmoothedFunction )

Smooth an equidistant 1D function by averaging its values.

The operator smooth_funct_1d_mean smooths a one dimensional function by applying an average (mean) filter multiple times. The function must be equidistant, i.e., created with create_funct_1d_array, sample_funct_1d or similar. At the function borders the function values are mirrored.


Attention

If an even value instead of an odd value is given for SmoothSize, the routine uses the next larger odd value instead (this way the center of the filter mask is always explicitly determined).


Parameters

Function (input_control)
function_1d-array -> integer / real
1D function.

SmoothSize (input_control)
integer -> integer
Size of the averaging mask.
Default value: 9
Suggested values: 1, 3, 5, 7, 9, 11, 13, 15, 21, 31, 51
Typical range of values: 1 <= SmoothSize <= 1001 (lin)
Minimum increment: 1
Recommended increment: 2
Restriction: SmoothSize > 0

Iterations (input_control)
integer -> integer
Number of iterations for the smoothing.
Default value: 3
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9
Typical range of values: 1 <= Iterations <= 100 (lin)
Minimum increment: 1
Recommended increment: 1
Restriction: Iterations >= 1

SmoothedFunction (output_control)
function_1d-array -> real
Smoothed function.


Parallelization Information

smooth_funct_1d_mean is reentrant and processed without parallelization.


Possible Predecessors

create_funct_1d_array


Alternatives

smooth_funct_1d_gauss


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH