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

local_min_max_funct_1d( : : Function, Mode, Interpolation : Min, Max)

Herror T_local_min_max_funct_1d(const Htuple Function, const Htuple Mode, const Htuple Interpolation, Htuple* Min, Htuple* Max)

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)

static void HOperatorSet.LocalMinMaxFunct1d(HTuple function, HTuple mode, HTuple interpolation, out HTuple min, out HTuple max)

void HFunction1D.LocalMinMaxFunct1d(string mode, string interpolation, out HTuple min, out HTuple max)

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

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