Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
dfieditval 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 dfieditvaldfiEditVal 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-Valued 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?editptrdf?EditPtr task editor with the corresponding pointers to the vector-valued function or spline coefficients even when this pointer remains unchanged. Call the df?editidxptrdf?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 modifies a pointer to an array held in a Data Fitting task descriptor, even if the structure of the partition remains the same.