Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
Public

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

Document Table of Contents

dfieditval

Modifies a parameter value in a Data Fitting task descriptor.

Syntax

status = dfieditval(task, val_attr, val)

Include Files

  • mkl_df.f90

Input Parameters

Name

Type

Description

task

TYPE(DF_TASK)

Descriptor of the task.

val_attr

INTEGER

The parameter to change. See table "Parameters Supported by the dfieditval Task Editor".

val

INTEGER

A new parameter value. See table "Parameters Supported by the dfieditval Task Editor".

Output Parameters

Name

Type

Description

status

INTEGER

Status of the routine:

Description

The dfieditval task editor replaces the parameter of type val_attr stored in a Data Fitting task descriptor with a new value val. The table below describes valid types of parameter val_attr supported by the editor:

Parameters Supported by the dfieditval Task Editor

Parameter Attribute

Purpose

DF_NX

Number of breakpoints

DF_XHINT

A flag describing the structure of partition. See table "Hint Values for Partition x" for the list of available values.

DF_NY

Dimension of the vector-valued function

DF_YHINT

A flag describing the structure of the vector-valued function. See table "Hint Values for Vector Function y" for the list of available values.

DF_SPLINE_ORDER

Spline order. See table "Spline Orders Supported by Data Fitting Functions" for the list of available values.

DF_SPLINE_TYPE

Spline type. See table "Spline Types Supported by Data Fitting Functions" for the list of available values.

DF_BC_TYPE

Type of boundary conditions used in spline construction. See table "Boundary Conditions Supported by Data Fitting Functions" for the list of available values.

DF_IC_TYPE

Type of internal conditions used in spline construction. See table "Internal Conditions Supported by Data Fitting Functions" for the list of available values.

DF_PP_COEFF_HINT

A flag describing the structure of spline coefficients. See table "Hint Values for Spline Coefficients" for the list of available values.

DF_CHECK_FLAG

A flag which controls checking of Data Fitting parameters. See table "Possible Values for the DF_CHECK_FLAG Parameter" for the list of available values.

If you pass a zero value for the parameter describing the size of the arrays that hold coefficients for a partition, a vector-valued function, or a spline, the parameter held in the Data fitting task remains unchanged and the routine returns an error code. For the predefined error codes, see "Task Status and Error Reporting".

Possible Values for the DF_CHECK_FLAG Parameter
Value Description
DF_ENABLE_CHECK_FLAG

Checks the correctness of parameters of Data Fitting computational routines (default mode).

DF_DISABLE_CHECK_FLAG

Disables checking of the correctness of parameters of Data Fitting computational routines.

Use DF_CHECK_FLAG for val_attr in order to control validation of parameters of Data Fitting computational routines such as df?construct1d, df?interpolate1d/df?interpolateex1d, and df?searchcells1d/df?searchcellsex1d, which can perform better with a small number of interpolation sites or integration limits (fewer than one dozen). The default mode, with checking of parameters enabled, should be used as you develop a Data Fitting-based application. After you complete development you can disable parameter checking in order to improve the performance of your application.

If you modify the parameter describing dimensions of the arrays that hold the vector-valued function or spline coefficients in contiguous memory, you should call the df?editptr task editor with the corresponding pointers to the vector-valued function or spline coefficients even when this pointer remains unchanged. Call the df?editidxptr editor if those arrays are stored in non-contiguous memory locations.

You must call the dfieditval task editor to edit the structure of the partition DF_XHINT every time you modify a partition using df?editptr, even if the structure of the partition remains the same.