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

Использовать объекты параметров

Для задания значений параметров блока можно использовать объекты параметров вместо числовых переменных MATLAB ®. Например, для создания и использования Simulink.Parameter объект с именем myParam для задания параметра усиления блока усиления:

Во время моделирования параметр «Коэффициент усиления» теперь использует значение 15.23.

Совместное использование данных таблицы подстановки с помощью Simulink.LookupTable и Simulink.Breakpoint см. раздел Общие точки останова пакета и данные таблицы для таблиц подстановки.

Использовать сигнальные объекты

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

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

Программная настройка сигнала:

% Create the signal object.
mySig = Simulink.Signal;
mySig.DataType = 'boolean';

% Get a handle to the block port that creates the
% target signal.
portHandles = get_param('myModel/myBlock','portHandles');
outportHandle = portHandles.Outport;

% Specify the programmatic port parameter 'Name'.
set_param(outportHandle,'Name','mySig')

% Set the port parameter 'MustResolveToSignalObject'.
set_param(outportHandle,'MustResolveToSignalObject','on')

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

% Create the signal object.
mySig = Simulink.Signal;
mySig.DataType = 'boolean';

% Specify the programmatic block parameter 'SignalName'.
set_param('myModel/myOutport','SignalName','mySig')

% Set the block parameter 'MustResolveToSignalObject'.
set_param('myModel/myOutport','MustResolveToSignalObject','on')

Для государств.  Объект сигнала можно использовать для управления характеристиками состояния блока, например, для блока дискретного интегратора времени.

Чтобы сконфигурировать состояние программно, выполните следующие действия.

% Create the signal object.
myState = Simulink.Signal;
myState.DataType = 'int16';

% Set the state name in the block.
set_param('myModel/myBlock','StateName','myState')

% Set the port parameter 'StateMustResolveToSignalObject'.
set_param('myModel/myBlock','StateMustResolveToSignalObject','on')

Изменение свойств объекта с помощью обозревателя моделей

Чтобы использовать обозреватель моделей для изменения свойств объекта, выберите рабочую область, содержащую объект, на панели «Иерархия моделей». Затем выберите объект на панели Содержимое проводника моделей (Model Explorer's Contents).

Обозреватель моделей отображает диалоговое окно свойств объекта на диалоговой панели (если панель видна).

Обозреватель моделей можно настроить на отображение некоторых или всех свойств объекта на панели Содержимое (Contents) (см. Обозреватель моделей). Чтобы изменить свойство, щелкните его значение на панели «Содержимое» или «Диалоговое окно». Значение заменяется элементом управления, который позволяет изменить значение.

Использование команд MATLAB для изменения свойств объекта

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

value = obj.property;
obj.property = value;

где obj - переменная, которая ссылается на объект, если он является экземпляром класса значений, или на дескриптор объекта, если объект является экземпляром класса дескрипторов (см. раздел Класс дескрипторов и классов значений), PROPERTY является именем свойства, и VALUE - значение свойства. Например, следующий код MATLAB создает объект псевдонима типа данных (т.е. экземпляр Simulink.AliasType) и устанавливает его базовый тип в uint8:

gain = Simulink.AliasType;
gain.BaseType = 'uint8';

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

gain.CoderInfo.StorageClass = 'ExportedGlobal';

Создание объектов данных

Создать Simulink.LookupTable и Simulink.Breakpoint на панели инструментов Обозревателя моделей используйте кнопку.

Программно создавать объекты данных

% Create a Simulink.Parameter object named myParam whose value is 15.23.
myParam = Simulink.Parameter(15.23);

% Create a Simulink.Signal object named mySig.
mySig = Simulink.Signal;

Преобразовать числовую переменную в объект параметра

Числовую переменную можно преобразовать в Simulink.Parameter объект следующим образом.

/* Define numeric variable in base workspace
myVar = 5; 
/* Create data object and assign variable value
myObject = Simulink.Parameter(myVar); 

Создание объектов данных из другого пакета

Предположим, что определен пакет классов данных с именем myPackage. Перед созданием объектов данных из пакета необходимо включить папку, содержащую папку пакета, в путь MATLAB.

Программно создавать объекты данных из другого пакета

Предположим, что определен пакет классов данных с именем myPackage. Перед созданием объектов данных из пакета необходимо включить папку, содержащую папку пакета, в путь MATLAB.

% Create a myPackage.Parameter object named 
% myParam whose value is 15.23.
myParam = myPackage.Parameter(15.23);

% Create a myPackage.Signal object named mySig.
mySig = myPackage.Signal;

Диалоговое окно «Создание объекта-параметра из блока»

Диалоговое окно «Создание сигнального объекта из свойств сигнала»

Устранение неполадок мастера объектов данных

Динамические методы

Динамический метод - это метод, идентичность которого зависит от его имени и класса объекта, неявно или явно указанного в качестве первого аргумента. Можно использовать функцию или точечную нотацию для указания этого объекта, который должен быть экземпляром класса, определяющего метод, или экземпляром подкласса класса, определяющего метод. Например, предположим, что класс A определяет метод, вызываемый setName который назначает имя экземпляру A. Кроме того, предположим, что рабочая область MATLAB содержит экземпляр A, назначенный переменной obj. Затем можно использовать любой из следующих операторов для присвоения имени 'foo' кому obj:

obj.setName('foo');
setName(obj, 'foo');

Класс может определять набор методов, имеющих то же имя, что и метод, определенный одним из его суперклассов. В этом случае метод, определенный подклассом, переопределяет поведение метода, определенного родительским классом. Simulink определяет метод для вызова во время выполнения из класса объекта, указанного в качестве первого или неявного аргумента. Следовательно, термин динамический метод.

Статические методы

Статический метод - это метод, идентификатор которого зависит только от его имени и, следовательно, не может быть изменен во время выполнения. Чтобы вызвать статический метод, используйте его полное имя, включающее имя определяющего его класса, за которым следует имя самого метода. Например, Simulink.ModelAdvisor класс определяет статический метод с именем getModelAdvisor. Полное имя этого статического метода: Simulink.ModelAdvisor.getModelAdvisor. Следующий пример иллюстрирует вызов статического метода.

ma = Simulink.ModelAdvisor.getModelAdvisor('vdp');

Конструкторы

Каждый класс данных определяет метод создания экземпляров этого класса. Имя метода совпадает с именем класса. Например, имя Simulink.Parameter конструктором класса является Simulink.Parameter. Конструкторы, определенные классами данных Simulink, не принимают аргументов.

Значение, возвращаемое конструктором, зависит от того, является ли его класс классом дескриптора или классом значения. Конструктор класса дескриптора возвращает дескриптор экземпляру, который он создает, если класс экземпляра является классом дескриптора; в противном случае он возвращает сам экземпляр (см. раздел Обработка классов значений).

Сведения о классах значений

Конструктор для класса значений (см. Конструкторы) возвращает экземпляр класса, и экземпляр постоянно связан с переменной MATLAB, которой он первоначально назначен. Переназначение или передача переменной функции приводит к тому, что MATLAB создает, назначает или передает копию исходного объекта.

Например, Simulink.NumericType является классом значений. Выполнение следующих операторов

x = Simulink.NumericType;
y = x;

создает два экземпляра класса Simulink.NumericType в рабочей области, назначенной переменной x а другой - y.

Сведения о классах дескрипторов

Конструктор класса дескрипторов возвращает объект дескриптора. Дескриптор может быть назначен нескольким переменным или передан функциям без создания копии исходного объекта. Например, Simulink.Parameter класс является классом дескриптора. Выполнение

x = Simulink.Parameter;
y = x;

создает только один экземпляр Simulink.Parameter в рабочей области MATLAB. Переменные x и y ссылаются на экземпляр через его дескриптор.

Программа может изменить экземпляр класса дескриптора, изменив любую переменную, которая ссылается на него, например, продолжая предыдущий пример,

x.Description = 'input gain';
y.Description

ans =
input gain

Большинство классов объектов данных Simulink являются классами значений. Исключения включают Simulink.Signal и Simulink.Parameter класс.

Чтобы определить, является ли значение переменной объектом (класс значений) или дескриптором объекта, см. раздел Определение, является ли объект дескриптором.

Копировать объекты-дескрипторы

Используйте метод копирования объекта-дескриптора для создания копий экземпляров этого объекта. Например, ConfigSet - объект дескриптора, представляющий наборы конфигурации модели. Следующий код создает копию активного набора конфигурации текущей модели и присоединяет ее к модели в качестве альтернативной конфигурации, предназначенной для разработки модели.

activeConfig = getActiveConfigSet(gcs);
develConfig = copy(activeConfig);
develConfig.Name = 'develConfig';
attachConfigSet(gcs, develConfig);