Visible to Intel only — GUID: GUID-C1DE4B39-8B99-4E37-9501-EA78F0211BEB
Visible to Intel only — GUID: GUID-C1DE4B39-8B99-4E37-9501-EA78F0211BEB
df?searchcellscallback
A callback function for user-defined search to be passed into df?interpolateex1d, df?integrateex1d, or df?searchcellsex1d.
Syntax
status = dfssearchcellscallback(n, site, cell, flag, user_params, library_params)
status = dfdsearchcellscallback(n, site, cell, flag, user_params, library_params)
Include Files
- mkl_df.f90
Input Parameters
Name |
Type |
Description |
---|---|---|
n |
INTEGER(KIND=8) |
Number of interpolation sites or integration limits. |
site |
REAL(KIND=4) DIMENSION(*) for dfssearchcellscallback REAL(KIND=8) DIMENSION(*) for dfdsearchcellscallback |
Array, size n, of interpolation sites or integration limits. |
flag |
INTEGER(KIND=4) DIMENSION(*) |
Array of size n, with values set as follows:
|
user_params |
INTEGER DIMENSION(*), optional |
Pointer to user-defined parameters of the callback function. |
library_params |
TYPE(DF_SEARCH_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:
|
cell |
INTEGER(KIND=8) DIMENSION(*) |
Array of size n that returns indices of the cells computed by the callback function. |
Description
When passed into the df?interpolateex1d, df?integrateex1d, or df?searchcellsex1d routine, this function performs a user-defined search.
The library_params parameter allows the library to provide extra parameters, which the callback function can use to organize computations effectively. The df?interpolateex1d, and df?searchcellsex1d routines do not provide extra parameters. The df?integrateex1d routines use this parameter to specify which type of integration limits, left or right, are provided for the callback. To do this the library declares the DF_SEARCH_CALLBACK_LIBRARY_PARAMS derived type. It currently contains one component, limit_type_flag, of type INTEGER(KIND=4). The field is set by the library to one of two possible values: DF_INTEGR_SEARCH_CB_LLIM_FLAG if the left integration limits are provided, or DF_INTEGR_SEARCH_CB_RLIM_FLAG if the right integration limits are provided.