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 and System Identification Toolbox Preferences Editor. For more information about the editor, see Toolbox Preferences Editor.

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 values: 'off' | 'on'
Default: 'off'
GridColorColor of the grid lines, specified as one of the following: Vector of RGB values in the range [0,1]| character vector of color name |'none'. For example, for yellow color, specify as one of the following: [1 1 0], 'yellow', or 'y'.
Default: [0.15,0.15,0.15]
XlimMode, YlimModeLimit modes
Xlim, Ylim Axes limits

IOGrouping

Grouping of input-output pairs, specified as one of the following values: 'none' |'inputs'|'outputs'|'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 values: 'on' |'off'
Default: 'off'
SettleTimeThresholdSettling time threshold
RiseTimeLimits Rise time limits

TimeUnits

Time units, specified as one of the following values:

  • '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

collapse all

Create a default time options set.

opt = timeoptions;

Enable plotting of normalized responses.

opt.Normalize = 'on';

Plot the step response of two transfer function models using the specified options.

sys1 = tf(10,[1,1]);
sys2 = tf(5,[1,5]);
stepplot(sys1,sys2,opt);

The plot shows the normalized step response for the two transfer function models.

Introduced in R2008a