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

df?interpcallback

A callback function for user-defined interpolation to be passed into df?interpolateex1d.

Syntax

status = dfsinterpcallback(n, cell, site, r, user_params, library_params)

status = dfdinterpcallback(n, cell, site, r, user_params, library_params)

Include Files

  • mkl_df.f90

Input Parameters

Name

Type

Description

n

INTEGER(KIND=8)

Number of interpolation sites.

cell

INTEGER(KIND=8) DIMENSION(*)

Array of size n containing indices of the cells to which the interpolation sites in array site belong.

site

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

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

Array of interpolation sites of size n.

user_params

INTEGER DIMENSION(*), optional

Pointer to user-defined parameters of the callback function.

library_params

TYPE(DF_INTERP_CALLBACK_LIBRARY_PARAMS), optional

Pointer to library-defined parameters of the callback function.

Output Parameters

Name

Type

Description

status

INTEGER

The status returned by the callback function:

  • Zero indicates successful completion of the callback operation.
  • A negative value indicates an error.
  • A positive value indicates a warning.
See "Task Status and Error Reporting" for error code definitions.

r

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

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

Array of the computed interpolation results packed in row-major format.

Description

When passed into the df?interpolateex1d routine, this function performs user-defined interpolation operation.

The library_params parameter allows the library to provide extra parameters, which the callback function can use to organize computations effectively. Currently no parameters are provided.