MpiFx - Modern Fortran Interface for MPI
The open source library MpiFx provides modern Fortran (Fortran 2003) wrappers around routines of the MPI library to make their use as simple as possible. Currently several data distribution routines are covered.
The documentation is included inside the repository, but is also available at dftbplus.github.io.
- CMake (version >= 3.16)
- Fortran 2003 compatible Fortran compiler
- MPI-library and wrappers for your compiler
- Fypp preprocessor
Building and installing the library
The library can be built and installed with the usual CMake-workflow:
FC=gfortran cmake -B _build -DCMAKE_INSTALL_PREFIX=$HOME/opt/mpifx cmake --build _build cmake --install _build
You can influence the configuration via CMake-variables, which are listed in config.cmake. You can either modify the values directly there or pass them as command line options at the configuration phase, e.g.:
FC=ifort cmake -B _build -DBUILD_LIBRARY_ONLY=True
A few tests / usage examples can be found in the test/ subdirectory. The compiled test programs will be in the test/ subfolder of your build directory.
Using the library
Make sure to add the root folder of the installed library to the
find_package()in CMakeLists.txt to locate the library and link
MpiFx::MpiFxto every target which relies directly on the library
cmake_minimum_required(VERSION 3.16) project(TestMpiFx LANGUAGES Fortran) find_package(MpiFx REQUIRED) add_executable(test_mpifx test_mpifx.f90) target_link_libraries(test_mpifx MpiFx::MpiFx)
Make sure to add the lib/pkgconfig folder of the installed library to the
Query the include and library options needed for the build with the usual
mpifort $(pkg-config --cflags mpifx) test_mpifx.f90 $(pkg-config --libs mpifx)
Note, that neither
--libsreturn any options related to your MPI-framework nor is the MPI-framework specified as dependency in the pkg-config file. Use the MPI-wrapper of your compiler to compile and link your executable or pass the additional include and library options by hand.
MpiFx is licensed under the 2-Clause BSD License.