create_funct_1d_pairsT_create_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairs (Operator)

Name

create_funct_1d_pairsT_create_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairs — 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)

Description

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

Alternatively, functions can be created with the operator create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArray. In contrast to this operator, x values with arbitrary positions can be specified with create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairs. 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_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairs 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_1dSampleFunct1dSampleFunct1dSampleFunct1d.

Attention

create_funct_1d_pairscreate_funct_1d_pairsCreateFunct1dPairsCreateFunct1dPairsCreateFunct1dPairs 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

XValuesXValuesXValuesXValuesXValues (input_control)  number(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

X value for function points.

YValuesYValuesYValuesYValuesYValues (input_control)  number(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Y value for function points.

FunctionFunctionFunctionFunctionfunction (output_control)  function_1d HFunction1D, HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Created function.

Possible Successors

write_funct_1dwrite_funct_1dWriteFunct1dWriteFunct1dWriteFunct1d, y_range_funct_1dy_range_funct_1dYRangeFunct1dYRangeFunct1dYRangeFunct1d, get_pair_funct_1dget_pair_funct_1dGetPairFunct1dGetPairFunct1dGetPairFunct1d

Alternatives

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArray, read_funct_1dread_funct_1dReadFunct1dReadFunct1dReadFunct1d

See also

funct_1d_to_pairsfunct_1d_to_pairsFunct1dToPairsFunct1dToPairsFunct1dToPairs

Module

Foundation