Организуйте проверки файла настройки и папки

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

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

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

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

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

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

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

Совет

  • У вас может быть больше чем один файл sl_customization.m на вашем пути MATLAB.

  • Не помещайте файл sl_customization.m, который настраивает Model Advisor в вашей корневой папке MATLAB или ее подпапках, за исключением папки matlabroot/work. В противном случае 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.Group или ModelAdvisor.Task.

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

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. Затем укажите пользовательскую задачу. Следующие разделы описывают, как задать пользовательские задачи.

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

  1. Создайте проверку с помощью класса ModelAdvisor.Check.

  2. Укажите обертку задачи для проверки.

  3. Если вы хотите добавить проверку в папки, которые уже не присутствуют, указывают и создают папки с помощью класса ModelAdvisor.Group.

  4. Добавьте проверку в задачу с помощью метода ModelAdvisor.Task.setCheck.

  5. Добавьте задачу в каждую папку с помощью метода ModelAdvisor.Task.addTask и ID задачи.

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

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

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

  1. В Model Advisor выберите вкладку View> Source .

  2. Перейдите к папке, которая содержит проверку MathWorks.

  3. На правой панели нажмите Source. Model Advisor отображает Title, TitleID и информацию о Source для каждой регистрации папки.

  4. Выберите и скопируйте TitleID проверки, которую вы хотите добавить как задача.

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

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.

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

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

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

  2. Укажите папку.

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

Можно задать местоположение пользовательских папок в 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

Пример индивидуальной настройки

Программное обеспечение Simulink Check™ обеспечивает пример, который показывает, как настроить Model Advisor путем добавления:

  • Собственные проверки

  • Проверяйте входные параметры

  • Проверяйте действия

  • Контрольный список просматривает, чтобы вызвать Проводник Результата Model Advisor

  • Пользовательские задачи включать собственные проверки в Model Advisor

  • Пользовательские папки для группировки проверок

  • Пользовательские процедуры

Пример также предоставляет исходный код файла sl_customization.m, который выполняет индивидуальные настройки.

Запускать пример:

  1. В командной строке MATLAB, typeslvnvdemo_mdladv.

  2. Следуйте инструкциям в модели.

Смотрите также

| | | |

Связанные примеры

Больше о

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