matlab.system.createSampleTime - Create sample time specification object - MATLAB (original) (raw)
Create sample time specification object
Syntax
sts = createSampleTime(obj) sts = createSampleTime(obj,'Type',Type) sts = createSampleTime(obj,'Type',Type,Name,Value)
Description
[sts](#d126e593503) = createSampleTime([obj](#d126e593137)) creates a sample time specification object for inherited sample time for the System object™obj. Use this sample time specification object in the getSampleTimeImpl method of your System object. The sample time specification affects the simulation time when the System object is included in a MATLAB System block. If you do not include this method in your System object definition, the sample time is inherited.
[sts](#d126e593503) = createSampleTime([obj](#d126e593137),'Type',[Type](#mw%5Ff4b2cdb8-5e5f-4d8f-8322-267a79b86023)) creates a sample time specification object with the specified sample time type.
[sts](#d126e593503) = createSampleTime([obj](#d126e593137),'Type',[Type](#mw%5Ff4b2cdb8-5e5f-4d8f-8322-267a79b86023),[Name,Value](#namevaluepairarguments)) creates a sample time specification object with additional options specified by one or more Name,Value pair arguments. Name is a property name and Value is the corresponding value.Name must appear inside quotes. You can specify several name-value pair arguments in any order asName1,Value1,...,NameN,ValueN.
Dependencies
You can only call createSampleTime from the getSampleTimeImpl method of your System object.
Input Arguments
System object that you want to specify the sample time.
Name-Value Arguments
Specify optional pairs of arguments asName1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose Name in quotes.
Example: 'Type','Fixed In Minor Step'
For Inherited sample time only.
Specify one or more sample times you want to allow your object to use. When the sample time type is set to Inherited and the MATLAB System block receives the specified sample time, the block allows the sample time to propagate. You can specify multiple sample time types as a cell array or string array.
Example: createSampleTime('Type','Inherited','AllowPropagation',{'Controllable','Continuous'})
For Inherited sample time only.
Specify one or more sample times you do not want your object to use. When the sample time type is set to Inherited and you do not want the MATLAB System block to use the specified inherited sample time type, an alternative sample time is used by the block instead. You can specify multiple sample time types. For each sample time type, Simulink substitutes a different sample time type:
'Controllable'— The base rate of the controlled sample is propagated instead. Use this option if your System object depends on having constant time between each sample-time hit.'Constant'— The base rate of the model is propagated instead, either the fastest discrete rate or fixed in minor step.'Continuous'— The fastest discrete rate is propagated instead.
Example: createSampleTime('Type','Inherited','AlternatePropagation','Controllable')
For Inherited sample time only.
Specify one or more sample times you do not want your object to use. When the sample time type is set to Inherited and the MATLAB System block receives the specified sample time, Simulink throws an error.
Example: createSampleTime('Type','Inherited','ErrorOnPropagation','Controllable')
For Discrete sample time only.
Specify the time between sample hits in Simulink.
Example: createSampleTime('Type','Discrete','SampleTime',1)
Data Types: single | double
For Discrete sample time only.
Specify the offset time for the sample hit. The offset is a time interval indicating an update delay. The block is updated later in the sample interval than other blocks operating at the same sample rate.
The offset time must be nonnegative and less thanSampleTime.
Example: createSampleTime('Type','Discrete','SampleTime',2,'OffsetTime',1)
Data Types: single | double
Required for Controllable sample time only.
Specify the time between controllable sample time hits. The tick time must be a positive scalar.
Example: createSampleTime('Type','Controllable','TickTime',obj.TickTime)
Data Types: single | double
Output Arguments
The sample time specification object. This object has the following properties:
- Type — Type of sample time
- SampleTime — Time between samples
- OffsetTime — Offset from sample time
Use this object as the return value of getSampleTimeImpl.
Examples
Specify that the MATLAB System block inherits the sample from upstream blocks. Inherited sample time is the default, so no additional arguments are needed.
function sts = getSampleTimeImpl(obj) sts = createSampleTime(obj); end
Specify a discrete sample time specification for theMATLAB System block, including offset time and the sample time.
function sts = getSampleTimeImpl(obj) sts = createSampleTime(obj,'Type','Discrete',... 'SampleTime',10.2,'OffsetTime',0.5); end
Version History
Introduced in R2017b