matlab.Системный класс

Базовый класс для системных объектов

Описание

matlab.System является базовым классом для системных объектов. В файле определения класса необходимо выполнить подкласс объекта из этого базового класса (или из другого класса, производного от этого базового класса). Подкласс позволяет использовать методы реализации и сервисные методы, предоставляемые этим базовым классом, для построения объекта. Введите этот синтаксис в качестве первой строки файла определения класса для прямого наследования от matlab.System базовый класс, где ObjectName - имя объекта:

classdef ObjectName < matlab.System

Примечание

Необходимо установить Access = protected для каждого matlab.System метод, используемый в коде.

matlab.System класс является handle класс.

Атрибуты класса

`Abstract`	`true`
`HandleCompatible`	`true`
`StrictDefaults`	`false`

Сведения об атрибутах класса см. в разделе Атрибуты класса.

Методы

развернуть все

Специализированные операторы и функции

Эти методы специализируются на стандартных операторах и функциях MATLAB ® для объектов данного класса.

`nargin`	Количество входных аргументов
`nargout`	Количество выходных аргументов

Защищенные методы

Инициализация, выполнение, сброс

`setupImpl`	Инициализация объекта System
`stepImpl`	Уравнения вывода и обновления состояния системы
`resetImpl`	Сброс состояний объекта System
`releaseImpl`	Высвобождать ресурсы

Свойства и состояния

`getDiscreteStateImpl`	Дискретные значения свойств состояния
`infoImpl`	Сведения об объекте System
`isDoneImpl`	Флаг окончания данных
`isInactivePropertyImpl`	Состояние неактивного свойства
`isTunablePropertyDataTypeMutableImpl`	Укажите, могут ли настраиваемые свойства изменять тип данных
`isDiscreteStateSpecificationMutableImpl`	Управление возможностью изменения типа данных в дискретных состояниях
`processTunedPropertiesImpl`	Действие при изменении настраиваемых свойств
`setProperties`	Задание значений свойств с помощью пар «имя-значение» при создании объекта System
`validatePropertiesImpl`	Проверка значений свойств объекта System

Ввод и вывод

`getNumInputsImpl`	Количество входов в объект System
`getNumOutputsImpl`	Количество выходов из объекта System
`getNumInputs`	Количество входов, необходимых для вызова объекта System
`getNumOutputs`	Количество выходов при вызове объекта System
`getInterfaceImpl` (Симулинк)	Установка системного объекта в качестве сообщения или данных
`isInputComplexityMutableImpl`	Определение возможности изменения сложности ввода системных объектов
`isInputDataTypeMutableImpl`	Укажите, может ли тип входных данных объекта системы изменяться
`isInputSizeMutableImpl`	Укажите, может ли размер ввода системного объекта изменяться
`nargin`	Количество входных аргументов для объекта System
`nargout`	Количество выходных аргументов для объекта System
`processInputSpecificationChangeImpl`	Выполнение действий при изменении размера, сложности ввода или типа данных
`validateInputsImpl`	Проверка входных данных для объекта System

Загрузить и сохранить

`loadObjectImpl`	Загрузить объект System из файла MAT
`saveObjectImpl`	Сохранить системный объект в MAT-файле

Поддержка системных блоков MATLAB

`allowModelReferenceDiscreteSampleTimeInheritanceImpl`	Статус наследования эталонного времени выборки модели для дискретного времени выборки
`getSimulateUsingImpl`	Укажите значение для Simulate с помощью параметра
`getSimulinkFunctionNamesImpl`	Регистрация имен функций Simulink, используемых в объекте System
`showFiSettingsImpl`	Видимость вкладки «Тип данных фиксированной точки» для системных объектов
`supportsMultipleInstanceImpl`	Объект Support System в Simulink для каждой подсистемы
`getSimulateUsingImpl`	Укажите значение для Simulate с помощью параметра
`supportsMultipleInstanceImpl`	Объект Support System в Simulink для каждой подсистемы

Однонаправленный канал Simulink

`isInputDirectFeedthroughImpl`	Состояние прямого прохождения входного сигнала
`outputImpl`	Расчет выходных данных из входного или внутреннего состояния объекта System
`updateImpl`	Обновление состояний объектов на основе входных данных

Распространение Simulink

`getDiscreteStateSpecificationImpl`	Размер дискретного состояния, тип данных и сложность
`getOutputDataTypeImpl`	Типы данных выходных портов
`getOutputSizeImpl`	Размеры выходных портов
`isOutputComplexImpl`	Сложность выходных портов
`isOutputFixedSizeImpl`	Порты вывода фиксированного или переменного размера
`propagatedInputComplexity`	Сложность ввода при распространении Simulink
`propagatedInputDataType`	Тип данных ввода при распространении Simulink
`propagatedInputFixedSize`	Статус ввода фиксированного размера при распространении Simulink
`propagatedInputSize`	Размер входного сигнала при распространении Simulink

Настройка внешнего вида системного блока MATLAB

`getIconImpl`	Имя для отображения в виде значка блока
`getHeaderImpl`	Заголовок для отображения системных объектов
`matlab.system.display.Action`	Пользовательская кнопка
`matlab.system.display.Header`	Заголовок свойств системных объектов
`matlab.system.display.Icon`	Пользовательское изображение значка
`matlab.system.display.Section`	Раздел «Группа свойств» для системных объектов
`matlab.system.display.SectionGroup`	Группа сечений для системных объектов
`getInputNamesImpl`	Имена входных портов системных блоков MATLAB
`getOutputNamesImpl`	Имена выходных портов системных блоков MATLAB
`getGlobalNamesImpl`	Имена глобальных переменных для системного блока MATLAB
`showSimulateUsingImpl`	Видимость Simulate с использованием параметра

Время образца Simulink

`createSampleTime`	Создать объект спецификации времени образца
`getSampleTime`	Время запроса образца
`getSampleTimeImpl`	Укажите тип времени выборки, время смещения и время выборки
`getCurrentTime`	Текущее время моделирования в системном блоке MATLAB
`allowModelReferenceDiscreteSampleTimeInheritanceImpl`	Статус наследования эталонного времени выборки модели для дискретного времени выборки

Поток данных Simulink

`getImpulseResponseLengthImpl`	Определение длины входных эффектов для подсистем потока данных
`getInputDimensionConstraintImpl`	Определение ограничений входных размеров для подсистем потока данных
`getOutputDimensionConstraintImpl`	Определение ограничений выходных размеров для подсистем потока данных

Примеры

свернуть все

Создание базового системного объекта

Открыть сценарий в реальном времени

В этом примере показано, как создать базовый объект System с именем AddOne.

В MATLAB выберите New > System object > Basic. Откроется новое окно редактора с синтаксисом по умолчанию и комментариями для нового объекта System.

Переименование класса AddOne. Измените шаблон по умолчанию, чтобы класс выглядел следующим образом:

classdef AddOne < matlab.System
% ADDONE Compute an output value that increments the input by one

    methods (Access = protected)
       % Implement algorithm. Calculate y as a function of input x.
       function y = stepImpl(~,x)
          y = x + 1;
       end    
    end
end

Используйте этот объект, создав экземпляр AddOne и запуск объекта с вводом.

addingObject = AddOne;
x = 5;
addingObject(x)

ans = 6

Подробнее

развернуть все

Признаки

Можно применить атрибуты к классу и свойствам System object™. Дополнительные сведения об атрибутах см. в разделе Атрибуты класса или Атрибуты свойства.

Атрибут класса

В этой таблице представлены атрибуты, которые можно применить к классу объектов MATLAB System.

Имя атрибута Описание

StrictDefaults

Управление значениями по умолчанию для методов, ограничивающих изменения изменений спецификации:

isInputSizeMutableImpl
isInputComplexityMutableImpl
isInputDataTypeMutableImpl
isTunablePropertyDataTypeMutableImpl
isDiscreteStateDataTypeMutableImpl

По умолчанию эти методы возвращаются true. При добавлении этого атрибута класса эти методы возвращают false по умолчанию. Заставляя эти методы возвращаться false, указанные аспекты входных данных, настраиваемые свойства или дискретные состояния не могут изменяться. Эти методы всегда можно реализовать по отдельности. Настроенные методы имеют приоритет над StrictDefaults атрибут.

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

Укажите значение атрибута класса в скобках, за которым следует имя класса, например:

classdef (StrictDefaults) MySystemObject < matlab.System

Атрибуты свойства

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

Nontunable Использовать Nontunable для предотвращения изменения значения свойства во время использования объекта. По умолчанию все свойства настраиваются. Nontunable используется для блокировки свойства, которое имеет побочные эффекты при изменении. Этот атрибут также полезен для блокировки значения свойства, которое считается постоянным во время обработки. Необходимо всегда указывать свойства, влияющие на количество входных или выходных портов, как Nontunable.

DiscreteState Использовать DiscreteState чтобы отметить свойство так, чтобы оно отображало свое значение состояния при использовании getDiscreteState способ.

См. также

matlab.system.mixin.FiniteSource

Темы

Представлен в R2011b

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