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

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

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

Во время симуляции параметр Gain теперь использует значение 15.23.

Для совместного использования данных интерполяционной таблицы при помощи Simulink.LookupTable и Simulink.Breakpoint объекты, см. «Упаковать общие данные точек по оси Х» и «Данные таблицы» для интерполяционных таблиц.

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

Можно связать сигнальную линию или состояние блока, например состояние Unit Delay блока, с сигнальным объектом.

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

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

% 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')

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

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

% 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, чтобы изменить свойства объекта

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

В Model Explorer отображается диалоговое окно свойств объекта на панели Диалоговое окно (если панель видна).

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

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

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

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

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

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

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

gain.CoderInfo.StorageClass = 'ExportedGlobal';

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

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

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

% 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, не берут аргументов.

Значение, возвращаемое конструктором, зависит от того, является ли его класс классом handle или классом value. Конструктор класса handle возвращает указатель на образец, который он создает, если класс образца является классом handle; в противном случае возвращается сам образец (см. Указатель Versus Значения Классов).

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

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

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

x = Simulink.NumericType;
y = x;

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

Сведения о классах Handle

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

x = Simulink.Parameter;
y = x;

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

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

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);