df?integrcallback

A callback function that you can pass into df?integrateex1d to define integration computations.

Syntax

FORTRAN:

status = dfsintegrcallback(n, lcell, llim, rcell, rlim, r, params)

status = dfdintegrcallback(n, lcell, llim, rcell, rlim, r, params)

status = dfsIntegrCallBack(n, lcell, llim, rcell, rlim, r, params)

status = dfdIntegrCallBack(n, lcell, llim, rcell, rlim, r, params)

Include Files

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

Input Parameters

Name	Type	Description
n	Fortran: INTEGER(KIND=8) C: long long*	Number of pairs of integration limits.
lcell	Fortran: INTEGER(KIND=8) DIMENSION() C: long long	Array of size n with indices of the cells that contain the left-side integration limits in array llim.
llim	Fortran: REAL(KIND=4) DIMENSION() for dfsintegrcallback REAL(KIND=8) DIMENSION() for dfdintegrcallback C: float* for dfsIntegrCallBack double* for dfdIntegrCallBack	Array of size n that holds the left-side integration limits.
rcell	Fortran: INTEGER(KIND=8) DIMENSION() C: long long	Array of size n with indices of the cells that contain the right-side integration limits in array rlim.
rlim	Fortran: REAL(KIND=4) DIMENSION() for dfsintegrcallback REAL(KIND=8) DIMENSION() for dfdintegrcallback C: float* for dfsIntegrCallBack double* for dfdIntegrCallBack	Array of size n that holds the right-side integration limits.
r	Fortran: REAL(KIND=4) DIMENSION() for dfsintegrcallback REAL(KIND=8) DIMENSION() for dfdintegrcallback C: float* for dfsIntegrCallBack double* for dfdIntegrCallBack	Array of integration results. For packing the results in row-major format, follow the instructions described in df?interpolate1d/df?interpolateex1d.
params	Fortran: INTEGER DIMENSION() C: void	Pointer to user-defined parameters of the callback function.

Output Parameters

Name	Type	Description
status	Fortran: INTEGER C: int	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.

Name

Type

Description

status

Fortran: INTEGER

C: int

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.

Description

When passed into the df?integrateex1d routine, this function defines integration computations. If at least one of the integration limits is outside the interpolation interval [a, b], the library decomposes the integration into sub-intervals that belong to the extrapolation range to the left of a, the extrapolation range to the right of b, and the interpolation interval [a, b], as follows:

If the left integration limit is to the left of the interpolation interval (llim< a), the df?integrateex1d routine passes llim as the left integration limit and min(rlim, a) as the right integration limit to the user-defined callback function.
If the right integration limit is to the right of the interpolation interval (rlim> b), the df?integrateex1d routine passes max(llim, b) as the left integration limit and rlim as the right integration limit to the user-defined callback function.
If the left and the right integration limits belong to the interpolation interval, the df?integrateex1d routine passes them to the user-defined callback function unchanged.

The value of the integral is the sum of integral values obtained on the sub-intervals.

df?integrcallback

Syntax

Include Files

Input Parameters

Output Parameters

Description

See Also