Программно настройте задачи и папки для Model Advisor

Обзор файла настройки

sl_customization.m файл содержит набор функций для регистрации и определения собственных проверок, задач и групп. Настраивать sl_customization.m файл, следуйте инструкциям в этой таблице.

Примечание

Если папка By Product не отображена в окне Model Advisor, выберите Show By Product Folder из диалогового окна Settings> Preferences.

Функция	Описание	Требуемый или дополнительный
`sl_customization()`	Собственные проверки регистров и задачи, папки с Simulink^® менеджер по индивидуальной настройке при запуске. Смотрите Задают Ваши Собственные Проверки Model Advisor.	Требуемый для индивидуальных настроек к Model Advisor.
Одно или несколько определений проверки	Задает собственные проверки. Смотрите Задают Ваши Собственные Проверки Model Advisor.	Требуемый для собственных проверок и добавить собственные проверки в папку By Product.
Одно или несколько определений задачи	Задает пользовательские задачи. Смотрите Задают Пользовательские Задачи.	Требуемый добавить собственные проверки в Model Advisor, кроме тех случаев, когда, добавляя проверки в папку By Product. Запишите одну задачу для каждой проверки, которую вы добавляете в Model Advisor.
Одна или несколько групп	Задает пользовательские группы. Смотрите Задают Пользовательские Задачи.	Требуемый добавить пользовательские задачи в новые папки в Model Advisor, кроме тех случаев, когда, добавляя новую подпапку в папку By Product. Запишите одно определение группы для каждой новой папки.

Укажите задачи и папки

Создайте Функцию sl_customization

Чтобы добавить задачи и папки к Model Advisor, создайте sl_customization.m файл на вашем MATLAB^® path. Затем создайте sl_customization() функция в sl_customization.m файл на вашем пути MATLAB.

Совет

У вас может быть больше чем один sl_customization.m файл на вашем пути MATLAB.
Не помещайте sl_customization.m файл, который настраивает Model Advisor в вашей корневой папке MATLAB или ее подпапках, за исключением matlabroot/ работают папка. В противном случае Model Advisor игнорирует индивидуальные настройки, которые задает файл.

sl_customization функция принимает один аргумент, менеджер по индивидуальной настройке объект, как в этом примере:

function sl_customization(cm)

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

Укажите задачи и папки

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

addModelAdvisorTaskFcn (@factorygroupDefinitionFcn)
Указывает задачи, которые вы задаете в factorygroupDefinitionFcn к папке By Task Model Advisor.
factorygroupDefinitionFcn аргумент является указателем на функцию, которая задает проверки, чтобы добавить к Model Advisor как экземпляры ModelAdvisor.FactoryGroup класс.
addModelAdvisorTaskAdvisorFcn (@taskDefinitionFcn)
Указывает задачи и папки, которые вы задаете в taskDefinitionFcn к папке в Model Advisor, что вы задаете использование ModelAdvisor.Root.publish метод или ModelAdvisor.Group класс.
taskDefinitionFcn аргумент является указателем на функцию, которая задает пользовательские задачи и папки. Simulink добавляет проверки и папки к Model Advisor как экземпляры ModelAdvisor.Task или ModelAdvisor.Group классы.

Следующий пример показывает, как указать пользовательские задачи и папки:

function sl_customization(cm)

% register custom factory group
cm.addModelAdvisorTaskFcn(@defineModelAdvisorTasks);

% register custom tasks.
cm.addModelAdvisorTaskAdvisorFcn(@defineTaskAdvisor);

Примечание

Если вы добавляете собственные проверки в sl_customization.m файл, включайте методы для регистрации регистраций sl_customization функция.

Задайте пользовательские задачи

Добавьте проверку в пользовательский или несколько папок Используя задачи

Можно использовать пользовательские задачи для добавления проверок к Model Advisor, или в нескольких папках или в одной, пользовательской папке. Вы задаете пользовательские задачи в одной или нескольких функциях, которые задают свойства каждого экземпляра ModelAdvisor.Task класс. Задайте один экземпляр этого класса для каждой пользовательской задачи, которую вы хотите добавить в Model Advisor. Затем укажите пользовательскую задачу. Следующие разделы описывают, как задать пользовательские задачи.

Добавить проверку в несколько папок или одну, пользовательскую папку:

Создайте проверку с помощью ModelAdvisor.Check класс.
Укажите обертку задачи для проверки.
Если вы хотите добавить проверку в папки, которые уже не присутствуют, указывают и создают папки с помощью ModelAdvisor.Group класс.
Добавьте проверку в задачу с помощью ModelAdvisor.Task.setCheck метод.
Добавьте задачу в каждую папку с помощью ModelAdvisor.Group.addTask метод и ID задачи.

Создайте пользовательские задачи Используя MathWorks Checks

Можно добавить MathWorks^® проверки к вашим пользовательским папкам путем определения проверок как пользовательских задач. То, когда вы добавляете проверки как пользовательские задачи, вы идентифицируете, проверяет ID проверки.

Чтобы найти MathWorks проверяют идентификаторы:

В иерархии перейдите к папке, которая содержит проверку MathWorks.
На левой панели Model Advisor выберите проверку.
Щелкните правой кнопкой по имени проверки и выберите Send Check ID to Workspace. ID отображен в Командном окне и отправлен в базовое рабочее пространство.
Выберите и скопируйте ID Проверки проверки, которую вы хотите добавить из Командного окна как задача.

Отобразите и включите задачи

Visible, Enable, и Value свойства взаимодействуют тот же путь к задачам, как они делают для проверок.

Задайте, где задачи появляются

Можно задать, куда Model Advisor помещает задачи в Model Advisor с помощью следующих инструкций:

Чтобы поместить задачу в новую папку в Model Advisor Task Manager, используйте ModelAdvisor.Group класс.
Чтобы поместить задачу в новую папку в папке By Task, используйте ModelAdvisor.FactoryGroup класс.

Функция определения задачи

Следующий пример показывает функцию определения задачи. Эта функция задает три задачи.

% Defines Model Advisor tasks and a custom folder
% Add checks to a custom folder using task definitions
function defineTaskAdvisor
mdladvRoot = ModelAdvisor.Root;

% Define task that uses Sample Check 0: Check whose Results are Viewed as Detailed Result Collections
MAT8 = ModelAdvisor.Task('com.mathworks.sample.TaskSample8');
MAT8.DisplayName='Example task using new check style (recommended style)';
MAT8.setCheck('com.mathworks.sample.Check0');
mdladvRoot.register(MAT8);

% Define task that uses Sample Check 1: Informational check
MAT1 = ModelAdvisor.Task('mathworks.example.task.configManagement');
MAT1.DisplayName = 'Informational check for model configuration management';
MAT1.Description = 'Display model configuration and checksum information.';
setCheck(MAT1, 'mathworks.example.configManagement');
mdladvRoot.register(MAT1);

% Define task that uses Sample Check 2: Basic Check with Pass/Fail Status
MAT2 = ModelAdvisor.Task('mathworks.example.task.unconnectedObjects');
MAT2.DisplayName = 'Check for unconnected objects';
setCheck(MAT2, 'mathworks.example.unconnectedObjects');
MAT2.Description = ['Identify unconnected lines, input ports, and output ' ...
                                      'ports in the model or subsystem.'];
mdladvRoot.register(MAT2);

% Define task that uses Sample Check 3: Check with Subresults and Actions
MAT3 = ModelAdvisor.Task('mathworks.example.task.optimizationSettings');
MAT3.DisplayName = 'Check safety-related optimization settings';
MAT3.Description = ['Check model configuration for optimization ' ...
                    'settings that can impact safety.'];
MAT3.setCheck('mathworks.example.optimizationSettings');
mdladvRoot.register(MAT3);

% Custom folder definition
MAG = ModelAdvisor.Group('mathworks.example.ExampleGroup');
MAG.DisplayName = 'My Group';
% Add tasks to My Group folder
MAG.addTask(MAT8);
addTask(MAG, MAT1);
addTask(MAG, MAT2);
addTask(MAG, MAT3);
% Add My Group folder to the Model Advisor under 'Model Advisor' (root)
mdladvRoot.publish(MAG);

Задайте пользовательские папки

О пользовательских папках

Используйте папки, чтобы сгруппировать регистрации Model Advisor функциональностью или использованием. Вы задаете пользовательские папки в:

Функция определения группы фабрики, которая задает свойства каждого экземпляра ModelAdvisor.FactoryGroup класс.
Функция определения задачи, которая задает свойства каждого экземпляра ModelAdvisor.Group класс.

Задайте один экземпляр классов группы для каждой папки, которую вы хотите добавить в Model Advisor.

Добавьте пользовательские папки

Добавить пользовательскую папку:

Создайте папку с помощью ModelAdvisor.Group или ModelAdvisor.FactoryGroup классы.
Укажите папку.

Задайте, где пользовательские папки появляются

Можно задать местоположение пользовательских папок в Model Advisor с помощью следующих инструкций:

Чтобы задать новую папку в Model Advisor Task Manager, используйте ModelAdvisor.Group класс.
Чтобы задать новую папку в папке By Task, используйте ModelAdvisor.FactoryGroup класс.

Примечание

Чтобы задать новую папку в папке By Product, используйте ModelAdvisor.Root.publish метод в собственной проверке. Если папка By Product не отображена в окне Model Advisor, выберите Show By Product Folder из диалогового окна Settings> Preferences.

Определение группы

Следующие примеры показывают определение группы. Определение помещает задачи в папке под названием My Group под корнем Model Advisor. Функция определения задачи включает это определение группы.

% Custom folder definition
MAG = ModelAdvisor.Group('mathworks.example.ExampleGroup');
MAG.DisplayName='My Group';
% Add tasks to My Group folder
MAG.addTask(MAT8);
MAG.addTask(MAT1);
MAG.addTask(MAT2);
MAG.addTask(MAT3);
% Add My Group folder to the Model Advisor under 'Model Advisor' (root)
mdladvRoot.publish(MAG);

Следующий пример показывает функцию определения группы фабрики. Определение помещает проверки в папку под названием Demo Factory Group в папке By Task.

function defineModelAdvisorTasks
mdladvRoot = ModelAdvisor.Root;

% --- sample factory group
rec = ModelAdvisor.FactoryGroup('com.mathworks.sample.factorygroup');
rec.DisplayName='Demo Factory Group';
rec.Description='Demo Factory Group';
rec.addCheck('com.mathworks.sample.Check0');
rec.addCheck('mathworks.example.configManagement');
rec.addCheck('mathworks.example.unconnectedObjects');
rec.addCheck('mathworks.example.optimizationSettings');
mdladvRoot.publish(rec); % publish inside By Task

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