Improving Data Access Using the MCR User Data Interface, COM Components, and MATLAB Builder EX

Overview

This feature provides a lightweight interface for easily accessing MCR data. It allows data to be shared between an MCR instance, the M-code running on that MCR, and the wrapper code that created the MCR. Through calls to the MCR User Data interface API, you access MCR data by creating a per-MCR-instance associative array of mxArrays, consisting of a mapping from string keys to mxArray values. Reasons for doing this include, but are not limited to:

• You need to supply run-time configuration information to a client running an application created with the Parallel Computing Toolbox. Configuration information may be supplied (and change) on a per-execution basis. For example, two instances of the same application may run simultaneously with different configuration files.

• You want to initialize the MCR with constant values that can be accessed by all your M applications.

• You want to set up a global workspace — a global variable or variables that MATLAB and your client can access.

• You want to store the state of any variable or group of variables.

MATLAB Builder EX supports per-MCR instance state access through an object-oriented API. Unlike MATLAB Compiler, access to per-MCR instance state is optional, rather than on by default. You can access this state by adding setmcruserdata.m and getmcruserdata.m to your deployment project or by specifying them on the command line.

For more information, see the MATLAB Compiler User's Guide.

Back to Top

Code Snippets

The following code snippets demonstrate storing and retrieving MCR state while working with the MagicMatrix function.

 MagicMatrix Function

function magicmatrix
    key = 'MagicMatrix';
    m = getmcruserdata(key);
    disp(m);
    m = m + 1;
    setmcruserdata(key, m);

 Building the MagicMatrix Component

mcc -v -B 'cexcel:MagicMatrixComponent,MagicMatrix,1.0' \
              magicmatrix.m getmcruserdata setmcruserdata 

 Calling setmcruserdata and getmcruserdata

Function tryMcrUserData()

Dim r1 As Range
Set r1 = Range("A1:C3")
a = setmcruserdata("MagicMatrix", r1)
a = magicmatrix()
a = getmcruserdata("MagicMatrix")
Application.Worksheets("Sheet1").Range("A5:C7") = a

End Function

Back to Top

Modifying Flags

Overriding Default CTF Archive Embedding for Components Using the MCR Component Cache

Recommended Products

• MATLAB
• Signal Processing Toolbox
• Optimization Toolbox
• Statistics Toolbox
• Control System Toolbox

Get MATLAB trial software

Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.

Get the Interactive Kit