Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

Fast Poisson Solver Interface Description

All numerical types in this section are either standard C types
float
 and
double
 or
MKL_INT
 integer type.
For more information on the C types, refer to C Datatypes Specific to
oneMKL
 and the
Intel® oneAPI Math Kernel Library
 Developer Guide
.
To better understand usage of the types, see examples in the
examples\pdepoissonc\source
 folderin your
Intel® oneAPI Math Kernel Library
 directory.

Routine Options

All Poisson Solver routines use parameters for passing various options to the routines. These parameters are arrays
ipar
,
dpar
, and
spar
. Values for these parameters should be specified very carefully (see Common Parameters). You can change these values during computations to meet your needs. For more details, see the descriptions of specific routines.
To avoid failure or incorrect results, you must provide correct and consistent parameters to the routines.

User Data Arrays

Poisson Solver routines take arrays of user data as input. For example, the
d_Helmholtz_3D
routine takes user arrays to compute an approximate solution to the 3D Helmholtz problem. To minimize storage requirements and improve the overall run-time efficiency,
Intel® oneAPI Math Kernel Library
 Poisson Solver routines do not make copies of user input arrays.
If you need a copy of your input data arrays, you must save them yourself.
For better performance, align your data arrays as recommended in the
Intel® oneAPI Math Kernel Library
 Developer Guide
 (search the document for coding techniques to improve performance).

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804