Main Content

getSampleTimeImpl

Specify sample time type, offset time, and sample time

Syntax

sts = getSampleTimeImpl(obj)

Description

sts = getSampleTimeImpl(obj) returns the sample time specification created within the method body, sts, for the System object™ obj. Specify the sample time specification within the body of getSampleTimeImpl by calling createSampleTime. The sample time specification affects the simulation time when the System object is included in a MATLAB System block.

Run-Time Details

getSampleTimeImpl is called during setup by setupImpl.

Method Authoring Tips

You must set Access = protected for this method.

Default Behavior

If you do not include this method in your System object definition, the sample time is inherited.

Input Arguments

expand all

System object handle used to access properties, states, and methods specific to the object. If your getSampleTimeImpl method does not use the object, you can replace this input with ~.

Output Arguments

expand all

An object defining the sample time specification values. You create this object with the createSampleTime function.

Examples

expand all

Specify that the MATLAB System block should inherit the sample from upstream blocks, except if the sample time type is controllable.

function sts = getSampleTimeImpl(obj)
    sts = createSampleTime(obj,'ErrorOnPropagation','Controllable');
end

Specify a discrete sample time for the MATLAB System block.

function sts = getSampleTimeImpl(obj)
    sts = createSampleTime(obj,'Type','Discrete',...
      'SampleTime',10.2,'OffsetTime',0.5);
end
Introduced in R2017b