Searches sub-intervals containing interpolation sites.
FORTRAN:
status = dfssearchcells1d(task, method, nsite, site, sitehint, datahint, cell)
status = dfdsearchcells1d(task, method, nsite, site, sitehint, datahint, cell)
status = dfssearchcellsex1d(task, method, nsite, site, sitehint, datahint, cell, search_cb, search_params)
status = dfdsearchcellsex1d(task, method, nsite, site, sitehint, datahint, cell, search_cb, search_params)
C:
status = dfsSearchCells1D(task, method, nsite, site, sitehint, datahint, cell)
status = dfdSearchCells1D(task, method, nsite, site, sitehint, datahint, cell)
status = dfsSearchCellsEx1D(task, method, nsite, site, sitehint, datahint, cell, search_cb, search_params)
status = dfdSearchCellsEx1D(task, method, nsite, site, sitehint, datahint, cell, search_cb, search_params)
Name |
Type |
Description |
|---|---|---|
task |
Fortran: TYPE(DF_TASK) C: DFTaskPtr |
Descriptor of the task. |
method |
Fortran: INTEGER C: MKL_INT |
Search method. The supported value is DF_METHOD_STD. |
nsite |
Fortran: INTEGER C: MKL_INT* |
Number of interpolation sites. |
site |
Fortran: REAL(KIND=4) DIMENSION(*) for dfssearchcells1d/dfssearchcellsex1d REAL(KIND=8) DIMENSION(*) for dfdsearchcells1d/dfdsearchcellsex1d C: float* for dfsSearchCells1D/dfsSearchCellsEx1D double* for dfdSearchCells1D/dfdSearchCellsEx1D |
Array of interpolation sites of size nsite. The structure of the array is defined by the sitehint parameter:
|
sitehint |
Fortran: INTEGER C: MKL_INT |
A flag describing the structure of the interpolation sites. For the list of possible values of sitehint, see table "Hint Values for Interpolation Sites". If you set the flag to DF_NO_HINT, the library interprets the site-defined partition as non-uniform. |
datahint |
Fortran: REAL(KIND=4) DIMENSION(*) for dfssearchcells1d/dfssearchcellsex1d REAL(KIND=8) DIMENSION(*) for dfdsearchcells1d/dfdsearchcellsex1d C: float* for dfsSearchCells1D/dfsSearchCellsEx1D double* for dfdSearchCells1D/dfdSearchCellsEx1D |
Array that contains additional information about the structure of partition x and interpolation sites. This data helps to speed up the computation. If you provide a NULL pointer, the routine uses the default settings for computations. For details on the datahint array, see table "Structure of the datahint Array". |
cell |
Fortran: INTEGER DIMENSION(*) C: MKL_INT* |
Array of cell indices in partition x that contain the interpolation sites. |
search_cb |
Fortran: INTEGER C: dfsSearchCellsCallBack for dfsSearchCellsEx1D dfdSearchCellsCallBack for dfdSearchCellsEx1D |
User-defined callback function for computing indices of cells that can contain interpolation sites. |
search_params |
Fortran: INTEGER DIMENSION(*) C: void* |
Pointer to additional user-defined parameters passed by the library to the search_cb function. |
Name |
Type |
Description |
|---|---|---|
status |
Fortran: INTEGER C: int |
Status of the routine:
|
The df?searchcells1d/df?searchcellsex1d routines return array cell of indices of sub-intervals (cells) in partition x that contain interpolation sites available in array site. For details on the cell indexing scheme, see the description of the df?interpolate1d/df?interpolateex1d computation routines.
Use the datahint parameter to provide additional information about the structure of the partition and/or interpolation sites. The definition of the datahint parameter is availalbe in the description of the df?interpolate1d/df?interpolateex1d computation routines.
For description of the user-defined callback for computation of cell indices, see df?searchcellscallback.