Documentation

timeoptions

Create list of time plot options

Syntax

P = timeoptions
P = timeoptions('cstprefs')

Description

P = timeoptions returns a list of available options for time plots with default values set. You can use these options to customize the time value plot appearance from the command line.

P = timeoptions('cstprefs') initializes the plot options you selected in the Control System Toolbox™ Preferences Editor. For more information about the editor, see Toolbox Preferences Editor in the User's Guide documentation.

This table summarizes the available time plot options.

Option Description
Title, XLabel, YLabel Label text and style
TickLabelTick label style

Grid

Show or hide the grid
Specified as one of the following strings: 'off' | 'on'
Default: 'off'
XlimMode, YlimModeLimit modes
Xlim, Ylim Axes limits

IOGrouping

Grouping of input-output pairs
Specified as one of the following strings: 'none' |'inputs'|'output'|'all'
Default: 'none'
InputLabels, OutputLabels Input and output label styles
InputVisible, OutputVisibleVisibility of input and output channels
Normalize Normalize responses
Specified as one of the following strings: 'on' |'off'
Default: 'off'
SettleTimeThresholdSettling time threshold
RiseTimeLimits Rise time limits

TimeUnits

Time units, specified as one of the following strings:
  • 'nanoseconds'

  • 'microseconds'

  • 'milliseconds'

  • 'seconds'

  • 'minutes'

  • 'hours'

  • 'days'

  • 'weeks'

  • 'months'

  • 'years'

Default: 'seconds'

You can also specify 'auto' which uses time units specified in the TimeUnit property of the input system. For multiple systems with different time units, the units of the first system is used.

Examples

In this example, enable the normalized response option before creating a plot.

P = timeoptions; 
% Set normalize response to on in options
P.Normalize = 'on'; 
% Create plot with the options specified by P
h = stepplot(tf(10,[1,1]),tf(5,[1,5]),P);       

The following step plot is created with the responses normalized.

Was this topic helpful?