local_min_max_funct_1dT_local_min_max_funct_1dLocalMinMaxFunct1dLocalMinMaxFunct1d (Operator)
Name
local_min_max_funct_1dT_local_min_max_funct_1dLocalMinMaxFunct1dLocalMinMaxFunct1d — Calculate the local minimum and maximum points of a function.
Signature
void LocalMinMaxFunct1d(const HTuple& Function, const HTuple& Mode, const HTuple& Interpolation, HTuple* Min, HTuple* Max)
void HFunction1D::LocalMinMaxFunct1d(const HString& Mode, const HString& Interpolation, HTuple* Min, HTuple* Max) const
void HFunction1D::LocalMinMaxFunct1d(const char* Mode, const char* Interpolation, HTuple* Min, HTuple* Max) const
void HFunction1D::LocalMinMaxFunct1d(const wchar_t* Mode, const wchar_t* Interpolation, HTuple* Min, HTuple* Max) const
(Windows only)
Description
local_min_max_funct_1dlocal_min_max_funct_1dLocalMinMaxFunct1dLocalMinMaxFunct1dLocalMinMaxFunct1d searches for the local minima
MinMinMinMinmin and maxima MaxMaxMaxMaxmax of the function
FunctionFunctionFunctionFunctionfunction.
Since the function values are only known at discrete sampling
points, the function can interpolated by parabolas between these
points. Setting the parameter InterpolationInterpolationInterpolationInterpolationinterpolation to
'true'"true""true""true""true", enables this feature. If InterpolationInterpolationInterpolationInterpolationinterpolation is
'false'"false""false""false""false", extrema are always sampling points.
If ModeModeModeModemode is set to 'strict_min_max'"strict_min_max""strict_min_max""strict_min_max""strict_min_max", extrema are
only calculated close to points with a function value that is
strictly smaller or strictly greater than the values of its direct
neighbors.
If ModeModeModeModemode is set to 'plateaus_center'"plateaus_center""plateaus_center""plateaus_center""plateaus_center", areas with a
function value that is constant throughout several sampling points
are also considered. If such an area is identified as being a flat
extremum, its center coordinate is returned.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
FunctionFunctionFunctionFunctionfunction (input_control) function_1d → HFunction1D, HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Input function
ModeModeModeModemode (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Handling of plateaus
Default value:
'strict_min_max'
"strict_min_max"
"strict_min_max"
"strict_min_max"
"strict_min_max"
List of values: 'plateaus_center'"plateaus_center""plateaus_center""plateaus_center""plateaus_center", 'strict_min_max'"strict_min_max""strict_min_max""strict_min_max""strict_min_max"
InterpolationInterpolationInterpolationInterpolationinterpolation (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Interpolation of the input function
Default value:
'true'
"true"
"true"
"true"
"true"
List of values: 'false'"false""false""false""false", 'true'"true""true""true""true"
MinMinMinMinmin (output_control) real-array → HTupleHTupleHtuple (real) (double) (double) (double)
Minimum points of the input function
MaxMaxMaxMaxmax (output_control) real-array → HTupleHTupleHtuple (real) (double) (double) (double)
Maximum points of the input function
Possible Predecessors
create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairs,
create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArray,
smooth_funct_1d_gausssmooth_funct_1d_gaussSmoothFunct1dGaussSmoothFunct1dGaussSmoothFunct1dGauss,
smooth_funct_1d_meansmooth_funct_1d_meanSmoothFunct1dMeanSmoothFunct1dMeanSmoothFunct1dMean
Module
Foundation