Herror ::create_funct_1d_array (
    const HTuple &YValues,
    HTuple *Function
)

Create a function from a sequence of y-values.

::create_funct_1d_array creates a one-dimensional function from a set of y-values YValues. The resulting function can then be processed and analyzed with the operators for 1d functions. YValues is interpreted as follows: the first value of YValues is the function value at zero, the second value is the function value at one, etc. Thus, the values define a function at equidistant x values (with distance 1), starting at 0.

Alternatively, the operator ::create_funct_1d_pairs can be used to create a function. ::create_funct_1d_pairs also allows to define a function with non-equidistant x valus by specifiying them explicitely. Thus to get the same definition as with ::create_funct_1d_array, one would pass a tuple of x values to ::create_funct_1d_pairs that has the same length as YValues and contains values starting at 0 and increasing by 1 in each position. Note, however, that ::create_funct_1d_pairs leads to a different internal representation of the function which needs more storage (because all (x,y) pairs are stored) and sometimes cannot be processed as efficiently as functions created by ::create_funct_1d_array.


Parameters

YValues (input_control)
number(-array) -> HTuple.double / long
X value for function points.

Function (output_control)
function_1d-array -> HTuple.double * / long *
Created function.


Possible Successors

::write_funct_1d, ::gnuplot_plot_funct_1d, ::y_range_funct_1d, ::get_pair_funct_1d, ::transform_funct_1d


Alternatives

::create_funct_1d_pairs, ::read_funct_1d


See also

::funct_1d_to_pairs


Module

Tools



Copyright © 1996-2002 MVTec Software GmbH