Operator Reference

HALCON Operator Reference / Tools / Function

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

create_funct_1d_pairsT_create_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs (Operator)

create_funct_1d_pairsT_create_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs — Create a function from a set of (x,y) pairs.

Signature

create_funct_1d_pairs( : : XValues, YValues : Function)

Herror T_create_funct_1d_pairs(const Htuple XValues, const Htuple YValues, Htuple* Function)

void CreateFunct1dPairs(const HTuple& XValues, const HTuple& YValues, HTuple* Function)

void HFunction1D::HFunction1D(const HTuple& XValues, const HTuple& YValues)

void HFunction1D::HFunction1D(double XValues, double YValues)

void HFunction1D::CreateFunct1dPairs(const HTuple& XValues, const HTuple& YValues)

void HFunction1D::CreateFunct1dPairs(double XValues, double YValues)

static void HOperatorSet.CreateFunct1dPairs(HTuple XValues, HTuple YValues, out HTuple function)

public HFunction1D(HTuple XValues, HTuple YValues)

public HFunction1D(double XValues, double YValues)

void HFunction1D.CreateFunct1dPairs(HTuple XValues, HTuple YValues)

void HFunction1D.CreateFunct1dPairs(double XValues, double YValues)

def create_funct_1d_pairs(xvalues: MaybeSequence[Union[float, int]], yvalues: MaybeSequence[Union[float, int]]) -> Sequence[Union[float, int]]

Description

create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs creates a one-dimensional function from a set of pairs of (x,y) values. The XValuesXValuesXValuesXValuesxvalues of the functions have to be passed in ascending order. The resulting function can then be processed and analyzed with the operators for 1d functions.

The created function is composed like this:

where

denotes the function type as a one-dimensional function from a set of pairs and

are pairs of (x,y) values passed in XValuesXValuesXValuesXValuesxvalues and YValuesYValuesYValuesYValuesyvalues with .

Alternatively, functions can be created with the operator create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array. In contrast to this operator, x values with arbitrary positions can be specified with create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs. Hence, it is the more general operator. It should be noted, however, that because of this generality the processing of a function created with create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs cannot be carried out as efficiently as for equidistant functions. In particular, not all operators accept such functions. If necessary, a function can be transformed into an equidistant function with the operator sample_funct_1dsample_funct_1dSampleFunct1dSampleFunct1dsample_funct_1d.

Attention

create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs examines whether the x values of type 'double' are ascending. Some other operators apply the same check but use the type 'float' instead of 'double'. If such an operator is called as successor, it might happen that two consecutive x values seem to be equal for the 'float' variant, although they were ascending in the 'double' variant. If this happens, an error is thrown.

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

XValuesXValuesXValuesXValuesxvalues (input_control)  number(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

X value for function points.

YValuesYValuesYValuesYValuesyvalues (input_control)  number(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Y value for function points.

FunctionFunctionFunctionfunctionfunction (output_control)  function_1d → HFunction1D, HTupleSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Created function.

Possible Successors

write_funct_1dwrite_funct_1dWriteFunct1dWriteFunct1dwrite_funct_1d, y_range_funct_1dy_range_funct_1dYRangeFunct1dYRangeFunct1dy_range_funct_1d, get_pair_funct_1dget_pair_funct_1dGetPairFunct1dGetPairFunct1dget_pair_funct_1d

Alternatives

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array, read_funct_1dread_funct_1dReadFunct1dReadFunct1dread_funct_1d

See also

funct_1d_to_pairsfunct_1d_to_pairsFunct1dToPairsFunct1dToPairsfunct_1d_to_pairs

Module

Foundation

---

ClassesClasses | | Operators