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

Где находится код примера?

Для получения дополнительной информации о доступе к коду примера из продукта, смотрите Пример копирования файла.

Обзор

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

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

Для получения дополнительной информации см. Руководство пользователя MATLAB Compiler.

Предоставьте информацию о профиле во время выполнения для приложений Parallel Computing Toolbox

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

Шаг 1: Напишите код Parallel Computing Toolbox

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

Чтобы задать mcruserdata из MATLAB создайте init функция в классе COM. Это отдельная функция MATLAB, которая использует setmcruserdata чтобы установить профиль Parallel Computing Toolbox один раз. Затем вы вызываете свои другие функции, чтобы использовать функции 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: Скомпилируйте функцию с помощью Deploytool или командной строки.  Можно скомпилировать функцию из командной строки, введя следующее:

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

Также можно использовать deploytool следующим образом:

Шаг 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 флаг в Settings разделе приложения компилятора.

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

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

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

Какие опции MATLAB Runtime поддерживаются MATLAB Compiler?

Как задать опции MATLAB Runtime?

Если Вы скомпилировали надстройку в MATLAB или использовали mcc.  Если вы создаете надстройку с помощью MATLAB Library Compiler, выберите Create log file в разделе Additional Runtime Settings.

Если вы создаете надстройку с помощью mcc, просто задайте -logfile с mcc -R команда

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

Вы делаете это, вызывая следующее MWUtil Вызовы API, подробно описанные с примерами в Class MWUtil: