Creating the Wrapper Library

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 10/31/2024

Version

Public

Visible to Intel only — GUID: GUID-2E413992-3DB0-4AB1-9BAD-DD8D5195FB81

View Details

Creating the Wrapper Library

Three header files are used to compile the Fortran wrapper library: fftw2_mkl.h, fftw2_f77_mkl.h, and fftw.h. The fftw2_mkl.h and fftw2_f77_mkl.h files are located in the .\share\mkl\interfaces\fftw2xf\wrapperssubdirectory in the Intel® oneAPI Math Kernel Library (oneMKL) directory.

The file fftw.h, used to compile libraries and located in the .\include\fftw subdirectory within the Intel® oneAPI Math Kernel Library (oneMKL) directory, slightly differs from the original FFTW (www.fftw.org) header filefftw.h.

The source code for the wrappers, makefiles, and files with lists of functions are located in the .\share\mkl\interfaces\fftw2xf subdirectory within the Intel® oneAPI Math Kernel Library (oneMKL) directory.

A wrapper library contains wrappers for complex and real transforms in a serial and multi-threaded mode for double- or single-precision floating-point data types. A makefile parameter manages the data type.

Parameters of a makefile also specify the platform (required), compiler, and data precision. The makefile comment heading provides the exact description of these parameters.

Because a C compiler builds the Fortran wrapper library, function names in the wrapper library and Fortran object module may be different. The file fftw2_f77_mkl.h in the .\share\mkl\interfaces\fftw2xf\wrappers subdirectory within the Intel® oneAPI Math Kernel Library (oneMKL) directory defines function names according to the names in the Fortran module. If a required name is missing in the file, you can modify the file to add the name before building the library.

To build the library, run the make command on Linux* OS or the nmake command on Windows* OS with appropriate parameters.

For example, on Linux OS the command

make libintel64

builds a double-precision wrapper library for Intel® 64 architecture based applications using the Intel® oneAPI DPC++/C++ Compiler or the Intel® Fortran Compiler (Compilers and data precision are chosen by default.)

The makefile creates the library in the lib subdirectory of the Intel® oneAPI Math Kernel Library (oneMKL) directory.

In the names of a wrapper library, the suffix corresponds to the compiler used and the letter preceding the underscore is "f" for the Fortran programming language.

For example,

fftw2xf_double_intel.lib (on Windows OS); libfftw2xf_double_intel.a (on Linux OS);

fftw2xf_single_msvs.lib (on Windows OS); libfftw2xf_single_gnu.a (on Linux OS).

Parent topic: Installing FFTW2 Interface Wrappers

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Creating the Wrapper Library