Documentation Center

  • Trials
  • Product Updates

nicholsoptions

Create list of Nichols plot options

Syntax

P = nicholsoptions
P = nicholsoptions('cstprefs')

Description

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

P = nicholsoptions('cstprefs') initializes the plot options with the 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 Nichols plot options.

OptionDescription
Title, XLabel, YLabelLabel text and style
TickLabelTick label style
Grid Show or hide the grid
Specified as one of the following strings: 'off' | 'on'
Default: 'off'
XlimMode, YlimMode Limit modes
Xlim, YlimAxes 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
FreqUnits

Frequency units, specified as one of the following strings:

  • 'Hz'

  • 'rad/second'

  • 'rpm'

  • 'kHz'

  • 'MHz'

  • 'GHz'

  • 'rad/nanosecond'

  • 'rad/microsecond'

  • 'rad/millisecond'

  • 'rad/minute'

  • 'rad/hour'

  • 'rad/day'

  • 'rad/week'

  • 'rad/month'

  • 'rad/year'

  • 'cycles/nanosecond'

  • 'cycles/microsecond'

  • 'cycles/millisecond'

  • 'cycles/hour'

  • 'cycles/day'

  • 'cycles/week'

  • 'cycles/month'

  • 'cycles/year'

Default: 'rad/s'

You can also specify 'auto' which uses frequency units rad/TimeUnit relative to system time units specified in the TimeUnit property. For multiple systems with different time units, the units of the first system are used.

MagLowerLimModeEnables a lower magnitude limit
Specified as one of the following strings: 'auto' | 'manual'
Default: 'auto'
MagLowerLimSpecifies the lower magnitude limit
PhaseUnits Phase units
Specified as one of the following strings: 'deg' | 'rad'
Default: 'deg'
PhaseWrapping Enables phase wrapping
Specified as one of the following strings: 'on' | 'off'
Default: 'off'
PhaseMatching Enables phase matching
Specified as one of the following strings: 'on' | 'off'
Default: 'off'
PhaseMatchingFreqFrequency for matching phase
PhaseMatchingValueThe value to make the phase responses close to

Examples

In this example, you set the phase units and enable the grid option for the Nichols plot.

P = nicholsoptions; % Set phase units to radians and grid to on in options
P.PhaseUnits = 'rad';
P.Grid = 'on'; % Create plot with the options specified by P
h = nicholsplot(tf(1,[1,.2,1,0]),P);

The following Nichols plot is created, with the phase units in radians and the grid enabled.

See Also

| |

Was this topic helpful?