Toolbox Preferences Editor

Overview of the Toolbox Preferences Editor

The Toolbox Preferences editor allows you to set plot preferences that will persist from session to session.

Opening the Toolbox Preferences Editor

To open the Toolbox Preferences editor, enter

ctrlpref

at the MATLAB^® prompt.

In the Linear System Analyzer app, you can also open the Toolbox Preferences editor by selecting File > Toolbox Preferences.

Units Pane

Use the Units pane to set preferences for the following:

• Frequency

  The default auto option uses rad/TimeUnit as the frequency units relative to the system time units, where TimeUnit is the system time units specified in the TimeUnit property of the system on frequency-domain plots. For multiple systems with different time units, the units of the first system is used.

  For the frequency axis, you can select logarithmic or linear scales.

   Other Frequency Units Options

  • 'Hz'

  • 'rad/s'

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

• Magnitude — Decibels (dB) or absolute value (abs)

• Phase — Degrees or radians

• Time

  The default auto option uses the time units specified in the TimeUnit property of the system on the time- and frequency-domain plots. For multiple systems with different time units, the units of the first system is used.

   Other Time Units Options

  • 'nanoseconds'

  • 'microseconds'

  • 'milliseconds'

  • 'seconds'

  • 'minutes'

  • 'hours'

  • 'days'

  • 'weeks'

  • 'months'

  • 'years'

Style Pane

Use the Style pane to toggle grid visibility and set font preferences and axes foreground colors for all plots you create. This figure shows the Style pane.

You have the following choices:

• Grid — Activate grids by default in new plots.

• Fonts — Set the font size, weight (bold), and angle (italic). Select font sizes from the menus or type any font-size values in the fields.

• Colors — Specify the color vector to use for the axes foreground, which includes the X-Y axes, grid lines, and tick labels. Use a three-element vector to represent red, green, and blue (RGB) values. Vector element values can range from 0 to 1.

  If you do not want to specify RGB values numerically, click the Select button to open the Select Colors dialog box.

Options Pane

The Options pane has selections for time responses and frequency responses. This figure shows the Options pane with default settings.

For time response plots, the following options are available:

• Show settling time within xx% — Set the threshold of the settling time calculation to any percentage from 0 to 100%. The default is 2%.

• Specify rise time from xx% to yy%— The standard definition of rise time is the time it takes the signal to go from 10% to 90% of the final value. Specify any percentages you like (from 0% to 100%), provided that the first value is smaller than the second.

For frequency response plots, the following options are available:

• Only show magnitude above — Specify a lower limit for magnitude values in response plots so that you can focus on a region of interest.

• Wrap phase — Wrap the phase into the interval [–180º,180º). To wrap accumulated phase at a different value, enter the value in the Branch field. For example, entering 0 causes the plot to wrap the phase into the interval [0º,360º).

SISO Tool Pane

The SISO Tool pane has settings for Control System Designer . This figure shows the SISO Tool pane with default settings.

You can make the following selections:

• Compensator Format — Select the time constant, natural frequency, or zero/pole/gain format. The time constant format is a factorization of the compensator transfer function of the form

  $$K\times \frac{\left(1+T_{z_1}s\right)\left(1+T_{z_2}s\right)}{\left(1+T_{p_1}s\right)\left(1+T_{p_2}s\right)}\cdots$$

  where K is compensator DC gain, Tz₁, Tz₂, ..., are the zero time constants, and Tp₁, Tp₂, ..., are the pole time constants.

  The natural frequency format is

  $$K\times \frac{\left(1+s/{\omega }_{z_1}\right)\left(1+s/{\omega }_{z_2}\right)}{\left(1+s/{\omega }_{p_1}\right)\left(1+s/{\omega }_{p_2}\right)}\cdots$$

  where K is compensator DC gain, ω_z1, and ω_z2, ... and ω_p1, ω_p2, ..., are the natural frequencies of the zeros and poles, respectively.

  The zero/pole/gain format is

  $$K\times \frac{\left(s+z_1\right)\left(s+z_2\right)}{\left(s+p_1\right)\left(s+p_2\right)}$$

  where K is the overall compensator gain, and z₁, z₂, ... and p₁, p₂, ..., are the zero and pole locations, respectively.

• Bode Options — By default, the Control System Designer shows the plant and sensor poles and zeros as blue x's and o's, respectively. Clear this box to eliminate the plant's poles and zeros from the Bode plot. Note that the compensator poles and zeros (in red) will still appear.