HALCON 17.12 / HALCON Operator Reference / Tools / Function
ClassesClasses | | Operators

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

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

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH