HALCON Reference Manual 10.0.2
Table of Contents / Tools / Function ClassesClassesClasses | | | Operators

local_min_max_funct_1dT_local_min_max_funct_1dlocal_min_max_funct_1dLocalMinMaxFunct1dLocalMinMaxFunct1d (Operator)

Name

local_min_max_funct_1dT_local_min_max_funct_1dlocal_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)

Herror local_min_max_funct_1d(const HTuple& Function, const HTuple& Mode, const HTuple& Interpolation, HTuple* Min, HTuple* Max)

HTuple HFunction1D::LocalMinMaxFunct1d(const HTuple& Mode, const HTuple& Interpolation, HTuple* Max) const

void HOperatorSetX.LocalMinMaxFunct1d(
[in] VARIANT Function, [in] VARIANT Mode, [in] VARIANT Interpolation, [out] VARIANT* Min, [out] VARIANT* Max)

VARIANT HFunction1DX.LocalMinMaxFunct1d(
[in] BSTR Mode, [in] BSTR Interpolation, [out] VARIANT* Max)

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_1dlocal_min_max_funct_1dLocalMinMaxFunct1dLocalMinMaxFunct1d 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.

Parallelization

Parameters

FunctionFunctionFunctionFunctionfunction (input_control)  function_1d-array → HFunction1D, HTupleHFunction1D, HTupleHFunction1DX, VARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Input function

ModeModeModeModemode (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Handling of plateaus

Default value: 'strict_min_max' "strict_min_max" "strict_min_max" "strict_min_max" "strict_min_max"

List of values: 'strict_min_max'"strict_min_max""strict_min_max""strict_min_max""strict_min_max", 'plateaus_center'"plateaus_center""plateaus_center""plateaus_center""plateaus_center"

InterpolationInterpolationInterpolationInterpolationinterpolation (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Interpolation of the input function

Default value: 'true' "true" "true" "true" "true"

List of values: 'true'"true""true""true""true", 'false'"false""false""false""false"

MinMinMinMinmin (output_control)  real-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Minimum points of the input function

MaxMaxMaxMaxmax (output_control)  real-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Maximum points of the input function

Possible Predecessors

create_funct_1d_pairscreate_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairs, create_funct_1d_arraycreate_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArray, smooth_funct_1d_gausssmooth_funct_1d_gausssmooth_funct_1d_gaussSmoothFunct1dGaussSmoothFunct1dGauss, smooth_funct_1d_meansmooth_funct_1d_meansmooth_funct_1d_meanSmoothFunct1dMeanSmoothFunct1dMean

Module

Foundation

Table of Contents / Tools / Function ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH