Parallel Computing Toolbox™

mpiLibConf - Location of MPI implementation

Syntax

[primaryLib, extras] = mpiLibConf

Arguments

Description

[primaryLib, extras] = mpiLibConf returns the MPI implementation library to be used by a parallel job. primaryLib is the name of the shared library file containing the MPI entry points. extras is a cell array of other library names required by the MPI library.

To supply an alternative MPI implementation, create an M-file called mpiLibConf, and place it on the MATLAB path. The recommended location is matlabroot/toolbox/distcomp/user.

Remarks

Under all circumstances, the MPI library must support all MPI-1 functions. Additionally, the MPI library must support null arguments to MPI_Init as defined in section 4.2 of the MPI-2 standard. The library must also use an mpi.h header file that is fully compatible with MPICH2.

When used with the MathWorks job manager or the local scheduler, the MPI library must support the following additional MPI-2 functions:

• MPI_Open_port

• MPI_Comm_accept

• MPI_Comm_connect

When used with any third-party scheduler (such as LSF or PBS Pro) it is important to launch the workers using the version of mpiexec corresponding to the MPI library being used. Also, you might need to launch the corresponding process management daemons on the cluster before invoking mpiexec.

Examples

Use the mpiLibConf function to view the current MPI implementation library:

mpiLibConf
    mpich2.dll

methods

mpiprofile