Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 6/24/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

df?editptr

Modifies a pointer to an array held in a Data Fitting task descriptor.

Syntax

status = dfseditptr(task, ptr_attr, ptr)

status = dfdeditptr(task, ptr_attr, ptr)

Include Files

  • mkl_df.f90

Input Parameters

Name

Type

Description

task

TYPE(DF_TASK)

Descriptor of the task.

ptr_attr

INTEGER

The parameter to change. For details, see the Pointer Attribute column in table "Pointers Supported by the df?editptr Task Editor".

ptr

REAL(KIND=4) DIMENSION(*) for dfseditptr

REAL(KIND=8) DIMENSION(*) for dfdeditptr

New pointer. For details, see the Purpose column in table "Pointers Supported by the df?editptr Task Editor".

Output Parameters

Name

Type

Description

status

INTEGER

Status of the routine:

Description

The df?editptr editor replaces the pointer of type ptr_attr stored in a Data Fitting task descriptor with a new pointer ptr. The table below describes types of pointers supported by the editor:

Pointers Supported by the df?editptr Task Editor

Pointer Attribute

Purpose

DF_X

Partition x of the interpolation interval, an array of strictly sorted breakpoints.

CAUTION:

The array must be strictly sorted. If it is unordered, the results of data fitting routines are not correct.

DF_Y

Vector-valued function y

DF_IC

Internal conditions for spline construction. For details, see table "Internal Conditions Supported by Data Fitting Functions".

DF_BC

Boundary conditions for spline construction. For details, see table "Boundary Conditions Supported by Data Fitting Functions".

DF_PP_SCOEFF

Spline coefficients

You can use df?editptr to modify different types of pointers including pointers to the vector-valued function and spline coefficients stored in contiguous memory. Use the df?editidxptr editor if you need to modify pointers to coordinates of the vector-valued function or spline coefficients stored at non-contiguous memory locations.

If you modify a partition of the interpolation interval, then you should call the dfieditval task editor with the corresponding value of DF_XHINT, even if the structure of the partition remains the same.

If you pass a NULL pointer to the df?editptr task editor, the task remains unchanged and the routine returns an error code. For the predefined error codes, please see "Task Status and Error Reporting".

NOTE:

You must preserve the arrays x (breakpoints), y (vector-valued functions), bc (boundary conditions), ic (internal conditions), and scoeff (spline coefficients) through the entire workflow of the Data Fitting computations which use those arrays, as the task stores the addresses of the arrays for spline-based computations.