Документация

Где код примера?

Дополнительные сведения о доступе к коду примера из продукта см. в разделе Копирование файла примера.

Обзор

Эта функция обеспечивает легкий интерфейс для простого доступа к данным среды выполнения MATLAB. Это позволяет совместно использовать данные экземпляра среды выполнения MATLAB, кода MATLAB, выполняющегося в этой среде выполнения MATLAB, и кода оболочки, создавшего среду выполнения MATLAB. С помощью вызовов API интерфейса пользовательских данных среды выполнения MATLAB осуществляется доступ к данным среды выполнения MATLAB путем создания ассоциативного массива экземпляра среды выполнения для каждого MATLAB. mxArrays, состоящий из отображения из строковых ключей в mxArray значения. Причины для этого включают, но не ограничиваются:

MATLAB Compiler™ поддерживает доступ к состоянию экземпляра MATLAB Runtime через объектно-ориентированный API. В отличие от компилятора MATLAB, доступ по состоянию экземпляра среды выполнения MATLAB является необязательным, а не включенным по умолчанию. Вы можете получить доступ к этому состоянию, добавив setmcruserdata.m и getmcruserdata.m в проект развертывания или путем их указания в командной строке. Кроме того, для вызова этих методов используется вспомогательная функция, как показано в разделе Предоставление информации о профиле времени выполнения для приложений панели инструментов параллельных вычислений.

Дополнительные сведения см. в Руководстве пользователя компилятора MATLAB.

Предоставление информации о профиле времени выполнения для приложений панели инструментов параллельных вычислений

Ниже приведен полный пример использования интерфейса пользовательских данных среды выполнения MATLAB в качестве механизма определения профиля для приложений Parallel Computing Toolbox.

Шаг 1: Напишите код набора инструментов для параллельных вычислений

Шаг 2: Настройка профиля панели инструментов параллельных вычислений.  Для компиляции кода MATLAB в COM-компонент и использования панели инструментов параллельных вычислений, mcruserdata должен быть установлен непосредственно из MATLAB. Нет API для доступа к MCRUserdata как и для приложений C и C++, построенных с помощью компилятора MATLAB.

Для установки mcruserdata из MATLAB создайте init функция в классе COM. Это отдельная функция MATLAB, которая использует setmcruserdata для однократной установки профиля панели инструментов параллельных вычислений. Затем вы вызываете другие свои функции, чтобы использовать функции Parallel Computing Toolbox.

Создать следующее init функция:

function init_sample_pct
% Set the Parallel Profile:
if(isdeployed)
    [profile] = uigetfile('*.settings'); 
                          % let the USER select file
    setmcruserdata('ParallelProfile',[profile]);
end

Шаг 3. Скомпилировать функцию с помощью инструмента развертывания или командной строки.  Можно скомпилировать функцию из командной строки, введя следующее:

mcc -B 'cexcel:exPctComp,exPctClass,1.0' init_sample_pct.m sample_pct.m

В качестве альтернативы можно использовать средство развертывания следующим образом:

Шаг 4: Изменение созданного приложения драйвера VBA (файла BAS).  После регистрации COM DLL на компьютере развертывания и импорта файла BAS в Excel измените созданный код файла BAS.

Dim MCLUtil As Object
Dim bModuleInitialized As Boolean
Dim exPctClass As Object
 
Private Sub InitModule()
  If Not bModuleInitialized Then
    On Error GoTo Handle_Error
    If MCLUtil Is Nothing Then
      Set MCLUtil = CreateObject("MWComUtil.MWUtil7.10")
    End If
    Call MCLUtil.MWInitApplication(Application)
    bModuleInitialized = True
    Exit Sub
Handle_Error:
    bModuleInitialized = False
  End If
End Sub
 
Function init_sample_pct() As Variant
 
  On Error GoTo Handle_Error
  Call InitModule
  If exPctClass Is Nothing Then
    Set exPctClass = CreateObject("exPctComp.exPctClass.1_0")
  End If
  Call exPctClass.init_sample_pct
  init_sample_pct = Empty
 
  Exit Function
Handle_Error:
  init_sample_pct = "Error in " & 
                         Err.Source & ": " & Err.Description
End Function
 
 
Function sample_pct(Optional pelle As Variant) As Variant
  Dim speedup As Variant
 
  On Error GoTo Handle_Error
  Call InitModule
  If exPctClass Is Nothing Then
    Set exPctClass = CreateObject("exPctComp.exPctClass.1_0")
  End If
  Call exPctClass.sample_pct(1, speedup, pelle)
  sample_pct = speedup
 
  Exit Function
Handle_Error:
  sample_pct = "Error in " & Err.Source 
                         & ": " & Err.Description
End Function

Выходные данные следующие:

Переопределение поведения по умолчанию

Чтобы извлечь развертываемый архив способом до R2008b вместе с компилируемым COM-компонентом, выполните компиляцию с помощью mcc -c вариант.

Вы также можете реализовать это переопределение, добавив -c в разделе Настройки приложения компилятора.

Этот параметр можно использовать для устранения неполадок с развертываемым архивом, например, поскольку журнал и диагностические сообщения гораздо более заметны.

Для получения дополнительной информации

Дополнительные сведения о развертываемом архиве см. в разделе Развертываемый архив.

Какие параметры среды выполнения MATLAB поддерживаются компилятором MATLAB?

Как задать параметры среды выполнения MATLAB?

Если вы скомпилировали надстройку в MATLAB или использовали mcc.  При создании надстройки с помощью компилятора библиотеки MATLAB выберите Создать файл журнала в разделе Дополнительные параметры среды выполнения.

При создании надстройки с помощью mcc, просто укажите -logfile с mcc -R команда

Если функция создана с нуля с помощью мастера функций.  Если функция была создана с нуля с помощью мастера функций и требуется указать параметры среды выполнения MATLAB, необходимо вручную изменить .bas код файла.

Для этого выполните следующие действия. MWUtil Вызовы API, подробно описанные в примерах класса MWUtil: