Main Content

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, at the MATLAB® command line, enter the following command.

identpref

Units Tab

Use the Units tab 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

  • Magnitude

    • dB — Decibels

    • absolute value — Absolute value, which you can plot on a linear on logarithmic scale

  • 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

Style Tab

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

You have the following choices:

  • Grids — 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 Color dialog box.

Response Tab

The Response pane has selections for time responses and frequency responses.

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 at — 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º).

Control System Designer Tab

The Control System Designer tab has settings for the Control System Designer app (requires Control System Toolbox™ license).

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×(1+Tz1s)(1+Tz2s)(1+Tp1s)(1+Tp2s)

    where K is compensator DC gain, Tz1, Tz2, ..., are the zero time constants, and Tp1, Tp2, ..., are the pole time constants.

    The natural frequency format is

    K×(1+s/ωz1)(1+s/ωz2)(1+s/ωp1)(1+s/ωp2)

    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×(s+z1)(s+z2)(s+p1)(s+p2)

    where K is the overall compensator gain, and z1, z2, ... and p1, p2, ..., 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 option to eliminate the plant's poles and zeros from the Bode plot. Note that the compensator poles and zeros (in red) will still appear.