createSampleTime

Класс: matlab.system

Создайте объект спецификации шага расчета

Синтаксис

sts = createSampleTime(obj)
sts = createSampleTime(obj,'Type',Type)
sts = createSampleTime(obj,'Type',Type,Name,Value)

Описание

sts = createSampleTime(obj) создает объект спецификации шага расчета для наследованного шага расчета для Системы object™ obj. Используйте этот объект спецификации шага расчета в getSampleTimeImpl метод вашего Системного объекта. Спецификация шага расчета влияет на время симуляции, когда Системный объект включен в блок MATLAB System. Если вы не включаете этот метод в свое определение Системного объекта, шаг расчета наследован.

sts = createSampleTime(obj,'Type',Type) создает объект спецификации шага расчета с заданным типом шага расчета.

sts = createSampleTime(obj,'Type',Type,Name,Value) создает объект спецификации шага расчета с дополнительными опциями, заданными одним или несколькими Name,Value парные аргументы. Name имя свойства и Value соответствующее значение. Name должен появиться в кавычках. Можно задать несколько аргументов пары "имя-значение" в любом порядке как Name1,Value1,...,NameN,ValueN.

Зависимости

Можно только вызвать createSampleTime от getSampleTimeImpl метод вашего Системного объекта.

Входные параметры

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

Системный объект, что вы хотите задать шаг расчета.

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: 'Type','Fixed In Minor Step'

Тип шага расчета вы хотите, чтобы Системный объект использовал в Simulink®. Для описаний различных типов шагов расчета см.:

Пример: createSampleTime('Type','Fixed In Minor Step')

Для Inherited шаг расчета только.

Задайте один или несколько шагов расчета, которые вы хотите позволить вашему объекту использовать. Когда тип шага расчета установлен в Inherited и блок MATLAB System получает заданный шаг расчета, блок позволяет шагу расчета распространять. Можно задать несколько типов шага расчета как массив ячеек или массив строк.

Пример: createSampleTime('Type','Inherited','AllowPropagation',{'Controllable','Continuous'})

Для Inherited шаг расчета только.

Задайте один или несколько шагов расчета, которые вы не хотите свой объект использовать. Когда тип шага расчета установлен в Inherited и вы не хотите, чтобы блок MATLAB System использовал заданный наследованный тип шага расчета, альтернативный шаг расчета используется блоком вместо этого. Можно задать несколько типов шага расчета. Для каждого типа шага расчета Simulink заменяет различным типом шага расчета:

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

  • 'Constant' — Базовая ставка модели распространена вместо этого, или самый быстрый дискретный уровень или зафиксирована на мелком шаге.

  • 'Continuous' — Самый быстрый дискретный уровень распространен вместо этого.

Пример: createSampleTime('Type','Inherited','AlternatePropagation','Controllable')

Для Inherited шаг расчета только.

Задайте один или несколько шагов расчета, которые вы не хотите свой объект использовать. Когда тип шага расчета установлен в Inherited и блок MATLAB System получает заданный шаг расчета, Simulink выдает ошибку.

Пример: createSampleTime('Type','Inherited','ErrorOnPropagation','Controllable')

Для Discrete шаг расчета только.

Задайте время между демонстрационными хитами в Simulink.

Пример: createSampleTime('Type','Discrete','SampleTime',1)

Типы данных: single | double

Для Discrete шаг расчета только.

Задайте время смещения для демонстрационного хита. Смещение является временным интервалом, указывающим на задержку обновления. Блок обновляется позже в демонстрационном интервале, чем другие блоки, действующие на уровне той же частоты дискретизации.

Время смещения должно быть неотрицательным и меньше, чем SampleTime.

Пример: createSampleTime('Type','Discrete','SampleTime',2,'OffsetTime',1)

Типы данных: single | double

Требуемый для Controllable шаг расчета только.

Задайте время между управляемыми хитами шага расчета. Время метки деления должно быть положительной скалярной величиной.

Пример: createSampleTime('Type','Controllable','TickTime',obj.TickTime)

Типы данных: single | double

Выходные аргументы

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

Объект спецификации шага расчета. Этот объект имеет следующие свойства:

  • 'Введите' (Simulink) — Тип шага расчета

  • 'SampleTime' (Simulink) — Время между выборками

  • 'OffsetTime' (Simulink) — Возместите от шага расчета

Используйте этот объект в качестве возвращаемого значения getSampleTimeImpl.

Примеры

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

Укажите, что блок MATLAB System наследовал выборку от восходящих блоков. Наследованный шаг расчета является значением по умолчанию, таким образом, никакие дополнительные аргументы не необходимы.

function sts = getSampleTimeImpl(obj)
    sts = createSampleTime(obj);
end

Задайте дискретную спецификацию шага расчета для блока MATLAB System, включая время смещения и шаг расчета.

function sts = getSampleTimeImpl(obj)
    sts = createSampleTime(obj,'Type','Discrete',...
      'SampleTime',10.2,'OffsetTime',0.5);
end
Введенный в R2017b