Если ваша функция MATLAB® готова быть развернутой, и вы уже создали свое дополнение и COM-компонент с Deployment Tool, следуйте за этим рабочим процессом, чтобы включить ваш встроенный COM-компонент в Microsoft Excel с помощью Функционального Мастера. Чтобы следовать за рабочим процессом в этом разделе эффективно, необходимо запустить Create Дополнение Excel из MATLAB.
Функциональный Мастер также позволяет вам итеративно тестировать, разрабатывать, и отлаживать свою функцию MATLAB. Используя этот сквозной рабочий процесс принимает, что вы находитесь все еще в процессе разработки вашей функции MATLAB для развертывания. Смотрите Сквозное Развертывание функции MATLAB для полных инструкций для этого рабочего процесса.
Смотрите Function Deployment Workflow Выбора для получения дальнейшей информации.
Ключевые задачи для конечного пользователя
| Задача | Ссылка |
|---|---|
| 1. Установите функциональный мастер. | Установка функционального мастера |
| 2. Запустите функциональный мастер. | Функциональный запуск мастера |
| 3. Выберите опцию, чтобы включить ваш встроенный COM-компонент в Microsoft Excel. | Выбор рабочего процесса для функций MATLAB, готовых к развертыванию |
| 4. Задайте новую функцию MATLAB, которую вы хотите моделировать путем добавления его в Функциональный Мастер и устанавливающий области значений ввода и вывода. | Определение функций, готовых выполниться |
| 5. Протестируйте свою функцию MATLAB путем выполнения его с Функциональным Мастером. | Функциональное выполнение |
| 6. Создайте макрос. | Макро-создание |
| 7. Выполните макрос, вы создали использование Функционального Мастера. | Макро-выполнение |
| 8. Опционально осмотрите или измените код Microsoft® Visual Basic®, который вы сгенерировали с COM-компонентом. Опционально, присоедините макрос, который вы создали к кнопке GUI. | Код Microsoft Visual Basic доступ (дополнительная усовершенствованная задача) |
Функциональный Мастер позволяет вам передать Microsoft Excel® (Excel 2000 или позже) значения рабочего листа к скомпилированной модели MATLAB и затем возвратить образцовый выходной параметр к ячейке или области значений ячеек в рабочем листе.
Функциональный Мастер обеспечивает интуитивный интерфейс к рабочим листам Excel. Вам не нужны предыдущие знания Microsoft Visual Basic для Приложений (VBA) программирование.
Функциональный Мастер отражает любые изменения, которые вы вносите в рабочих листах, таких как выборы области значений. Вы также используете Функциональный Мастер, чтобы управлять размещением и выводом данных от функций MATLAB до рабочих листов.
Функциональный Мастер в настоящее время не поддерживает sparse MATLAB и типы данных complex.
Прежде чем можно будет использовать Функциональный Мастер, необходимо сначала установить его как дополнение, которое доступно от Microsoft Excel.
После того, как вы установите Функциональный Мастер, запись, MATLAB Functions появляется как доступная дополнительная кнопка Microsoft Excel.
Кликните по вкладке File.
На левой панели навигации выберите Options.
В Окне параметров Excel, на левой панели навигации, выбирают Add-Ins.
В Том, чтобы управлять выпадающим, выберите Excel Add-Ins и нажмите Go.
В диалоговом окне Add-Ins нажмите Browse.
Просмотрите к matlabroot/toolbox/matlabxl/matlabxl/arch FunctionWizard2007.xlam. Нажмите OK.
В диалоговом окне Excel Add-Ins проверьте, что запись MATLAB Compiler Function Wizard выбрана. Нажмите OK.
Вкладка Home Ленты Microsoft Excel должна теперь содержать Функциональную мозаику Мастера. Смотрите вкладку Home Ленты Microsoft Office с Функциональным Установленным Мастером.
Запустите Microsoft Excel, если он уже не запускается.
Нажмите Office Button (
) и выберите Excel Options.
На левой панели Окна параметров Excel нажмите Add-Ins.
На правой панели Окна параметров Excel, select Excel Add-ins от Manage выпадающее поле.
Нажмите Go.
Нажмите Browse. Перейдите к matlabroot\toolbox\matlabxl\matlabxl\arch FunctionWizard2007.xlam. Нажмите OK.
В диалоговом окне Excel Add-Ins проверьте, что запись MATLAB Compiler Function Wizard выбрана. Нажмите OK.
Выберите Tools> Add-Ins из главного меню Excel.
Если Функциональный Мастер был ранее установлен, Мастер Функции MATLAB Compiler появляется в списке. Выберите элемент и нажмите ОК.
Если Функциональный Мастер не был ранее установлен, нажмите Browse и перейдите к папке matlabroot \toolbox\matlabxl\matlabxl. Выберите FunctionWizard.xla. Нажмите ОК, чтобы продолжить.
Запустите Функциональный Мастер одним из следующих способов. Когда мастер инициализировал, отображения диалогового окна Function Wizard Start Page.
В Microsoft Excel, на ленте Microsoft Office, на вкладке Home, выбирают Function Wizard.
Вкладка Home ленты Microsoft Office с функциональным установленным мастером
Вы можете также Мастер функции доступа от вкладки File.
Выберите File> Options> Add-Ins из главного меню Excel.
Выберите Function Wizard.
Функциональное диалоговое окно начальной страницы мастера
После того, как вы установите и запустите Функциональный Мастер, сделайте следующее:
От Функциональной начальной страницы Мастера выберите опцию I have an Add-in component that was built in MATLAB with the Deployment Tool that I want to integrate into a workbook.
Нажмите OK. Функциональная Панель управления Мастера открывается включенной кнопкой Add Function.
Функциональная панель управления мастера для Работы с функциями MATLAB, готовыми к развертыванию
Чтобы возвратиться к Функциональной начальной странице Мастера, нажмите Start Over.
Задайте функцию, которую вы хотите выполнить к Функциональному Мастеру. Нажмите Add Function в области Set Up Functions Функциональной Панели управления Мастера. Диалоговое окно MATLAB Components открывается.
В области Available Components диалогового окна MATLAB Components выберите имя своего компонента (xlmagic) от выпадающего поля.
Выберите функцию, которую вы хотите выполнить (mymagic) от поля маркировал Functions for Class xlmagic.
Нажмите Add Function. Диалоговое окно Function Properties открывается.
Область Function Syntax and Help, в диалоговом окне Function Properties, отображает первую текстовую строку справки (иногда названный H1 line) в функции MATLAB. Отображение этих комментариев в диалоговом окне Function Properties может быть полезным при развертывании новых или незнакомых функций MATLAB на конечных пользователях.
Задайте свойства входного параметра можно следующим образом.
На вкладке Input нажмите Set Input Data. Диалоговое окно Input Data for n открывается.
Задайте Range или Value путем выбора подходящего варианта и ввода значения. Если аргумент относится к structure array (struct), выберите опцию This is a MATLAB structure array argument. Смотрите Работу с Массивами структур для получения информации о присвоении областей значений и значений к полям в массиве структур.
Постарайтесь не выбирать области значений с помощью клавиш со стрелками. Если необходимо использовать клавиши со стрелками, чтобы выбрать области значений, применить необходимую фиксацию от сайта Microsoft: https://support.microsoft.com/kb/291110.
Выберите опцию Auto Recalculate on Change, чтобы обеспечить Microsoft Excel, чтобы автоматически повторно вычислить данные об электронной таблице каждый раз, когда это изменяется.
Нажмите OK.
Чтобы задать как MATLAB Compiler™ для дополнительных ячеек пробела указателей Excel (или ячеек, содержащих данные), смотрите Управление Значением Пустой ячейки.
Задайте свойства выходного аргумента можно следующим образом.
На вкладке Output нажмите Set Output Data. Диалоговое окно Output Data for y появляется, где y является именем выходной переменной, вы задаете свойства.
Можно также задать MATLAB Compiler к Auto Resize, Transpose или вывести данные в формате даты (Output as date). Для этого выберите подходящий вариант в диалоговом окне Argument Properties for y.
Задайте Range. Поочередно, выберите область значений ячеек на вашем листе Excel; область значений будет вводиться для вас в поле Range.
Постарайтесь не выбирать области значений с помощью клавиш со стрелками. Если необходимо использовать клавиши со стрелками, чтобы выбрать области значений, применить необходимую фиксацию от сайта Microsoft: https://support.microsoft.com/kb/291110.
Выберите Auto Resize, если он уже не выбран.
Нажмите Done в диалоговом окне Output Data for y.
Нажмите Done в диалоговом окне Function Properties.
mymagic теперь появляется в списке Active Functions Функциональной Панели управления Мастера.
Можно задать как пустые ячейки процессов MATLAB Compiler, позволив вам присвоить неопределенный или непредставленный (NaN, например) значения данных им.
Чтобы задать, как обработать пустые ячейки, сделайте следующее.
Нажмите Options в диалоговом окне Input Data for N.
Входное Окно параметров Преобразования открывается.
Нажмите Treat Missing Data As выпадающее поле.
Задайте или Zero или NaN (Not a Number), в зависимости от того, как вы хотите обработать пустые ячейки.
Чтобы присвоить области значений полям в массиве структур, сделайте следующее:
Если вы уже не сделали так, выберите This is a MATLAB structure array argument в диалоговом окне Input Data for n и нажмите OK.
Диалоговое окно Input Data for Structure Array Argument n открывается.
Функциональный Мастер поддерживает Векторные и Двумерные массивы структур, организованные или в Поэлементно или в Плоская организация для обоих вводов и выводов.
В диалоговом окне Input Data for Structure Array Argument n сделайте следующее:
В области Structure Array Organization выберите Element by Element Organization или Plane Organization.
Нажмите Add Field, чтобы добавить поля для каждого из ваших аргументов массива структур. Диалоговое окно Field for Structure Array Argument открывается.
В диалоговом окне Field for Argument сделайте следующее:
В поле Name задайте имя поля. Name, который вы задаете, должен совпадать с именем поля массива структур в вашей функции MATLAB.
Задайте Range для поля.
Постарайтесь не выбирать области значений с помощью клавиш со стрелками. Если необходимо использовать клавиши со стрелками, чтобы выбрать области значений, применить необходимую фиксацию от сайта Microsoft: https://support.microsoft.com/kb/291110.
Нажмите Done.
Как поддерживаются Массивы структур. MATLAB Compiler поддерживает один и двумерные массивы структур MATLAB.
Продукт преобразовывает данные, переданные в массивы структур в element-by-element organization или plane organization. См. Основы программирования MATLAB для получения дополнительной информации обо всех типах данных MATLAB, включая структуры.
Развертывание Массивов структур как Вводы и выводы. Если вы - программист MATLAB и хотите развернуть функцию MATLAB с массивами структур в качестве аргументов ввода или вывода, создать макросы Microsoft Excel с помощью Функционального Мастера и передать их (с дополнением Excel и COM-компонентом) конечным пользователям. Если вы не можете сделать этого, сообщите своим конечным пользователям:
Какие аргументы являются массивами структур
Имена полей массивов структур
Используя Макросы с Массивами структур. Макро-функция генерации MATLAB Compiler для дополнений Excel работает с массивами структур в качестве аргументов ввода или вывода. Смотрите Макро-Создание, если у вас есть функция MATLAB, вы готовы развернуться. Смотрите Дополнение Microsoft Excel и Макро-Создание Используя Функциональный Мастер, если вы используете Функциональный Мастер, чтобы создать вашу функцию MATLAB с нуля. Смотрите Function Deployment Workflow Выбора для получения дополнительной информации об обоих рабочих процессах.
В области Execute Functions Функциональной Панели управления Мастера нажмите Execute, чтобы запустить mymagic. Ячейки A1:E5 на листе Excel автоматически заполняются с выводом mymagic (магический квадрат размерности 5).
При продолжении примера создайте макрос Microsoft Excel использование Функциональной Панели управления Мастера:
В области Create Macros панели управления введите mymagic в поле Macro Name.
Выберите местоположение того, где хранить макрос в Store Macro выпадающее поле.
Введите краткое описание функциональности макроса в поле Description.
Нажмите Create Macro.
Макрос создается в текущей рабочей книге Excel.
Запустите макрос, который вы создали в Макро-Создании путем выполнения одного из следующих, после сначала очищающиеся ячейки A1:E5 (которые содержат вывод функции Магического квадрата, которую вы запустили в Функциональном Выполнении).
Вы, возможно, должны включить соответствующие настройки безопасности перед рабочими макросами в Microsoft Excel. Для получения информации о макро-полномочиях и связанных сообщениях об ошибке, см. приложение Ошибок и Решений.
В Microsoft Excel нажмите View > Macros > View Macros.
Выберите mymagic из Macro name выпадающее поле.
Нажмите Run. Ячейки A1:E5 на листе Excel автоматически заполняются с выводом mymagic.
В Microsoft Excel нажмите Tools > Macro > Macros.
Выберите mymagic из Macro name выпадающее поле.
Нажмите Run. Ячейки A1:E5 на листе Excel автоматически заполняются с выводом mymagic.
Опционально, можно хотеть получить доступ к коду Visual Basic или изменить его, в зависимости от экспертного знания программирования или доступности разработчика Excel. Если так, выполните эти шаги.
Из главного окна Excel откройте редактор Microsoft Visual Basic путем выполнения одного из следующих. выберите Tools> Macro> Visual Basic Editor.
Нажмите Developer > Visual Basic.
Когда Visual Basic Editor откроется в окне Project - VBAProject, дважды кликните, чтобы расширить VBAProject (mymagic.xls).
Расширьте папку Modules и дважды кликните модуль Matlab Macros.
Это открывает окно Visual Basic Code с кодом для этого проекта.
Нажмите Tools > Macro > Visual Basic Editor.
Когда Visual Basic Editor откроется в окне Project - VBAProject, дважды кликните, чтобы расширить VBAProject (mymagic.xls).
Расширьте папку Modules и дважды кликните модуль Matlab Macros.
Это открывает окно VB Code с кодом для этого проекта.
Чтобы присоединить макрос к кнопке GUI, сделайте следующее:
Нажмите Developer > Insert.
Из меню Form Controls выберите значок Button (Form Control).
Наведите своя мышь на меню Form Controls, чтобы видеть различные метки управления.
В диалоговом окне Assign Macros выберите макрос, вы хотите присвоить кнопку GUI и нажать OK.
Присоединение макроса к кнопке
| Если вы хотите... | Смотрите... |
|---|---|
| Запишите развертываемый код MATLAB |
| Смотрите больше примеров о создании дополнений и COM-компонентов | Создайте макросы из функций MATLAB |
| Узнать, как настроить и интегрировать COM-компонент вы созданный путем изменения кода Microsoft Visual Basic | Интегрируйте Компоненты с помощью Приложения Visual Basic |
