Visible to Intel only — GUID: GUID-1F88CF20-5111-4F67-894F-3BE3D73F3422
Visible to Intel only — GUID: GUID-1F88CF20-5111-4F67-894F-3BE3D73F3422
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:
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".
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.