Examples of Matlab MEX and Matlab Engine via CMake using Matlab supported compilers.
One-time setup from Matlab:
mex -setup c
mex -setup c++
mex -setup fortran
mex -setup -client engine c
mex -setup -client engine c++
mex -setup -client engine fortranBuild:
cmake -B build
cmake --build build
ctest --test-dir buildCurrently, there is a
known CMake bug
with matlab_add_mex() for Fortran that causes runtime failures of MEX binaries.
This happens on any operating system or Fortran compiler due to the issue with CMake matlab_add_mex().
Invalid MEX-file 'matsq.mexa64': Gateway function is missing
Matlab Engine is available from several languages including C, C++, Fortran, Python, ... Note that even for compiled Matlab Engine programs, the appropriate "matlab" executable must be in environment variable PATH.
Matlab has narrow windows of compiler versions that work for each Matlab release. Especially on Linux, this may require using a specific release of Matlab compatible such that Matlab libstdc++.so and system libstdc++.so are compatible. This is because compiler-switching mechanisms like RHEL Developer Toolset still use system libstdc++ that lack newer GLIBCXX symbols.
- R2022a-R2023a: Linux: GCC 10
- R2020b-R2021b: Linux: GCC 8
A frequent issue on Linux systems is failure to link with libstdc++.so.6 correctly. Depending on the particular Matlab version and system libstdc++, one of the following techniques may help.
Removing Matlab libstdc++:
mv <matlab_root>/sys/os/glnxa64/libstdc++.so.6 <matlab_root>/sys/os/glnxa64/libstdc++.so.6.bakPutting Matlab libstdc++ first in LD_LIBRARY_PATH:
LD_LIBRARY_PATH=<matlab_root>/sys/os/glnxa64/ cmake -BbuildIt may be necessary to try different Matlab versions to find one Linux compatible with the particular Linux operating system vendor and version.
macOS users with Apple Silicon CPU (M1, M2, ....) are recommended to use the native Apple Silicon Matlab. Better performance for Matlab comes by using the native CPU version of Matlab matching the computer CPU. However, if using Intel x86 Matlab on Apple Silicon CPU:
cmake -B build -DCMAKE_OSX_ARCHITECTURES=x86_64Matlab MEX compiler appears to ignore "FFLAGS" environment variable conventionally used for passing Fortran compiler flags. This becomes an issue when needing "-fallow-invalid-boz" for GCC > 10. Newer Matlab versions pass this flag for every GFortran MEX.
