dfieditval

Modifies a parameter value in a Data Fitting task descriptor.

Syntax

FORTRAN:

status = dfieditval(task, val_type, val)

status = dfiEditVal(task, val_type, val)

Include Files

Fortran: mkl_df.f90 and mkl_df.f77
C: mkl_df.h

Input Parameters

Name	Type	Description
task	Fortran: TYPE(DF_TASK) C: DFTaskPtr	Descriptor of the task.
val_type	Fortran: INTEGER C: MKL_INT	The parameter to change. See table "Parameters Supported by the dfieditval Task Editor".
val	Fortran: INTEGER C: MKL_INT	A new parameter value. See table "Parameters Supported by the dfieditval Task Editor".

Name

Type

Description

task

Fortran: TYPE(DF_TASK)

C: DFTaskPtr

Descriptor of the task.

val_type

Fortran: INTEGER

C: MKL_INT

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

val

Fortran: INTEGER

C: MKL_INT

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

Output Parameters

Name	Type	Description
status	Fortran: INTEGER C: int	Status of the routine: DF_STATUS_OK if the routine execution completed successfully. Non-zero error code otherwise. See "Task Status and Error Reporting" for error code definitions.

Name

Type

Description

status

Fortran: INTEGER

C: int

Status of the routine:

DF_STATUS_OK if the routine execution completed successfully.
Non-zero error code otherwise. See "Task Status and Error Reporting" for error code definitions.

Description

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

Parameters Supported by the dfieditval Task Editor
Parameter	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.

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".

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.