Developer Reference

  • 2020.2
  • 07/15/2020
  • Public Content
Contents

df?newtask1d

Creates and initializes a new task descriptor for a one-dimensional Data Fitting task.

Syntax

status
=
dfsnewtask1d
(
task
,
nx
,
x
,
xhint
,
ny
,
y
,
yhint
)
status
=
dfdnewtask1d
(
task
,
nx
,
x
,
xhint
,
ny
,
y
,
yhint
)
Include Files
  • mkl_df.f90
Input Parameters
Name
Type
Description
nx
INTEGER
Number of breakpoints representing partition of interpolation interval [
a
,
b
].
x
REAL(KIND=4) DIMENSION(*)
for
dfsnewtask1d
REAL(KIND=8) DIMENSION(*)
for
dfdnewtask1d
One-dimensional array containing the strictly sorted breakpoints from interpolation interval [
a
,
b
]. The structure of the array is defined by parameter
xhint
:
  • If partition is non-uniform or quasi-uniform, the array should contain
    nx
    strictly ordered values.
  • If partition is uniform, the array should contain two entries that represent endpoints of interpolation interval [
    a
    ,
    b
    ].
The array must be strictly sorted. If it is unordered, the results of data fitting routines are not correct.
xhint
INTEGER
A flag describing the structure of partition
x
.
For the list of possible values of
xhint
, see table
"Hint Values for Partition
x
"
.
If you set the flag to the
DF_NO_HINT
value, the library interprets the partition as non-uniform.
ny
INTEGER
Dimension of vector-valued function
y
.
y
REAL(KIND=4) DIMENSION(*)
for
dfsnewtask1d
REAL(KIND=8) DIMENSION(*)
for
dfdnewtask1d
Vector-valued function
y
, array of size
nx
*
ny
.
The storage format of function values in the array is defined by the value of flag
yhint
.
yhint
INTEGER
A flag describing the structure of array
y
.
Valid hint values are listed in table
"Hint Values for Vector-Valued Function
y
"
.
If you set the flag to the
DF_NO_HINT
value, the library assumes that all
ny
coordinates of the vector-valued function
y
are provided and stored in row-major format.
Output Parameters
Name
Type
Description
task
TYPE(DF_TASK)
Descriptor of the task.
status
INTEGER
Status of the routine:
  • DF_STATUS_OK
    if the task is created successfully.
  • Non-zero error code if the task creation failed.