MATLAB: Do I get an error saying “Undefined function or variable ‘matlabrc'” when executing a program that uses a MATLAB-compiled shared library

MATLAB Compiler

I am trying to use a MATLAB-compiled shared library in a C++ program. There are no issues when I use the same code with the libraries compiled using MATLAB Compiler 4.7 (R2007b). However, when I recompile all the MATLAB libraries using MATLAB Compiler 4.9 (R2008b) and then try to execute the same program, the <libName>Initialize() function fails with the following error:

??? Undefined function or variable 'matlabrc'

Best Answer

This change has been incorporated into the documentation in MATLAB Compiler 4.11 (R2009b). For previous releases, read below for any additional information:

Starting MATLAB Compiler 4.8 (R2008a), CTF data is now automatically embedded directly in the C/C++, main and Winmain, shared libraries and standalones by default. In order to override this default functionality, you must compile with the -C 'Do Not Embed CTF Archive By Default 'option.

Since the MATLABRC script is usually included in the CTF archive, you may receive this error if the application is unable to find the CTF archive. Conventionally, some application build procedures strip all binary files involved in the process. If the embedded CTF archives in shared libraries are stripped in this process, the driver application may not be able to find the CTF data during execution.

If your application build process performs such a process, please compile with the -C 'Do Not Embed CTF Archive By Default 'option.

Another workaround here is to delete the CTF extraction folder, and run the EXE again. If the MCR_CACHE_ROOT environment variable is not set, the CTF extraction location can be found at:

C:\Users\[username]\AppData\Local\Temp\[username]\mcrCache[version]

If neither of these resolves the issue, follow these additional troubleshooting steps, previously found at http://www.mathworks.com/help/compiler/deployed-applications.html :

1) Ensure that your application runs in MATLAB (uncompiled) without this error.

2) Ensure that MATLAB starts up without this error.

3) Verify that the generated deployable archive contains a file called matlabrc.m

4) Verify that the generated code (in the * _mcc_component_data.c * file) adds the deployable archive folder containing matlabrc.m to the MATLAB runtime path

5) Delete the *_mcr folder and rerun the application.

6) Recompile the application.

Related Solutions

MATLAB: Do I get a “could not find version 7.14 of the MCR…” error when running the compiled compiled .exe

There are really 2 things that need to happen to run an application created by the MATLAB compiler.

The files for the MCR need to be in place
The system path variable needs to point to those files.

The mcrinstaller command can be used from the MATLAB command line to find the mcrinstaller.exe binary. For example:

>> mcrinstaller
The WIN64 MCR Installer, version 7.14, is:
  C:\Program Files\MATLAB\R2010b\toolbox\compiler\deploy\win64\MCRInstaller.exe
MCR installers for other platforms are located in:
  C:\Program Files\MATLAB\R2010b\toolbox\compiler\deploy\<ARCH>
<ARCH> is the value of COMPUTER('arch') on the target machine.

It is also possible to test your application against your MATLAB install if the MATLAB Compiler is also installed. You can do this from the MATLAB command line like:

>>!myexe.exe

Or from a CMD shell as long as the PATH contains the runtime directory from your MATLAB install like:

 C:\work\myexe>set PATH=C:\Program Files\MATLAB\R2010b\runtime\win64
 C:\work\myexe>myexe
 hello
 C:\work\myexe>

MATLAB: Do I receive an error regarding missing mclmcrrt7x.dll when I run the stand-alone application compiled with MATLAB Compiler

mclmcrrt7x.dll is a run-time library needed to run MATLAB Compiler generated applications on deployment machines that do not have MATLAB and MATLAB Compiler installed. This library is installed during the course of the MATLAB Compiler Runtime (MCR) installation.

This error typically results from one of two situations:

1. The correct version of MATLAB Compiler Runtime (MCR) is not installed.

Applications generated with MATLAB Compiler depend on the version of the run-time library specific to the version of the MATLAB Compiler that generated the application.

You can find the install program for the MCR in the following sub directory of the MATLAB installation which created the program.

 $MATLABROOT\toolbox\compiler\deploy\win32\mcrInstaller.exe

 $MATLABROOT\toolbox\compiler\deploy\win64\mcrInstaller.exe

(where $MATLABROOT is the MATLAB root directory on your machine, as returned by typing:

matlabroot

at the MATLAB command prompt.)

Instructions for installing the MCR are located in the documentation:

Deploying to End Users :: Deployment Process (MATLAB Compiler)

http://www.mathworks.com/help/compiler/deploying-to-end-users.html

Running MCRInstaller.exe on the deployment machine will install the MCR, including the mclmcrrt7x.dll:

 $MCRROOT\v$VER\runtime\win32\mclmcrrt$VER.dll

($MCRROOT is the MATLAB Compiler Runtime root directory that was chosen during the MATLAB Component Runtime installation process. This typically defaults to something like C:\Program Files\MATLAB\MATLAB Compiler Runtime. $VER is the MCR version number without the periods.)

The “missing mclmcrrt7x.dll” error message will result if you have not installed the version of the MCR that corresponds to the version of MATLAB Compiler the application was compiled with. For example, if you have installed the MCR for MATLAB Compiler 4.9 (R2008b), version 7.9 of the mclmccrt DLL will be installed in, for example:

 C:\Program Files\MATLAB\MATLAB Compiler Runtime\v79\runtime\win32\mclmcrrt79.dll.

For releases prior to R2008a the runtime libraries will be located in a slightly different directory tree:

 C:\Program Files\MATLAB\MATLAB Component Runtime\

Now, if an application generated using MATLAB Compiler 4.6 (R2007a) is executed on this computer without installing that version of the MCR, the "missing mclmcrrt76.dll" error would result.

2. A second option is that the system's PATH environment variable was not set correctly.

During the course of the MATLAB Compiler Runtime installation, the following directory should have been added to your system path:

   $MCRROOT\v$VER\runtime\win32

To work around this issue, manually update the PATH environment variable on your deployment machine to include the following directory:

   $MCRROOT\v$VER\runtime\win32

For instructions on modifying your system PATH environment variable, refer to the solution referenced below.

Also note that since these DLLs have different names for each version of the MCR, multiple versions of the MCR can be installed on the same machine.

Best Answer

Related Solutions

MATLAB: Do I get a “could not find version 7.14 of the MCR…” error when running the compiled compiled .exe

MATLAB: Do I receive an error regarding missing mclmcrrt7x.dll when I run the stand-alone application compiled with MATLAB Compiler

Related Question