create_funct_1d_pairsT_create_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs (Operator)

Name

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_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairscreate_funct_1d_pairs creates a one-dimensional function from a set of pairs of (x,y) values. The XValuesXValuesXValuesXValuesXValuesxvalues 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 XValuesXValuesXValuesXValuesXValuesxvalues and YValuesYValuesYValuesYValuesYValuesyvalues with .

Alternatively, functions can be created with the operator create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array. In contrast to this operator, x values with arbitrary positions can be specified with create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairscreate_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_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairscreate_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_1dSampleFunct1dSampleFunct1dSampleFunct1dsample_funct_1d.

Attention

create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairscreate_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

Parameters

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

X value for function points.

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

Y value for function points.

FunctionFunctionFunctionFunctionfunctionfunction (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_1dWriteFunct1dWriteFunct1dWriteFunct1dwrite_funct_1d, y_range_funct_1dy_range_funct_1dYRangeFunct1dYRangeFunct1dYRangeFunct1dy_range_funct_1d, get_pair_funct_1dget_pair_funct_1dGetPairFunct1dGetPairFunct1dGetPairFunct1dget_pair_funct_1d

Alternatives

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array, read_funct_1dread_funct_1dReadFunct1dReadFunct1dReadFunct1dread_funct_1d

See also

funct_1d_to_pairsfunct_1d_to_pairsFunct1dToPairsFunct1dToPairsFunct1dToPairsfunct_1d_to_pairs

Module

Foundation