Main Content

BodeView Properties

Access Bode editor view properties

Since R2025a

BodeView properties control the appearance and behavior of Bode plots in standalone open-loop editors.

To create an open-loop editor, use the openloopeditor function, which creates an OpenLoopEditor object. When the ViewType property of an OpenLoopEditor object is "bode", then the View property is a BodeView object.

To customize the appearance of the Bode plot, modify the properties of the BodeView object.

ole = openloopeditor(Plant=sys,ViewType="bode");
ole.View.FrequencyUnit = "Hz";

Response

expand all

Response characteristics to display in the plot, specified as a CharacteristicsManager object with these properties.

Visibility of peak response in magnitude plot, specified as a CharacteristicOption object with this property.

Peak response visibility, specified as one of these logical on/off values:

  • "on", 1, or true — Display the peak response.

  • "off", 0, or false — Do not display the peak response.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Visibility of all stability margins, specified as a CharacteristicOption object with this property.

Margin visibility, specified as one of these logical on/off values:

  • "on", 1, or true — Display the margins.

  • "off", 0, or false — Do not display the margins.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Visibility of minimum stability margins, specified as a CharacteristicOption object with this property.

Margin visibility, specified as one of these logical on/off values:

  • "on", 1, or true — Display the margins.

  • "off", 0, or false — Do not display the margins.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Option to display magnitude plot, specified as one of these logical on/off values:

  • "on", 1, or true — Display the magnitude plot.

  • "off", 0, or false — Hide the magnitude plot.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Option to display phase plot, specified as one of these logical on/off values:

  • "on", 1, or true — Display the phase plot.

  • "off", 0, or false — Hide the phase plot.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Option to enable minimum gain for plotting, specified as one of these logical on/off values:

  • "on", 1, or true — Set the minimum gain for plotting to the MinimumGainValue property value.

  • "off", 0, or false — Set the minimum gain for plotting automatically based on the system dynamics.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Dependencies

The default minimum-gain configuration depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Minimum gain value for plotting, specified as a scalar.

Dependencies

Dependencies

Units and Scaling

expand all

Frequency units, specified as one of these values:

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

Dependencies

By default, the response uses the frequency units of the plotted linear system. You can override the default units by specifying toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Magnitude units, specified as one of these values:

  • "dB" — Decibels

  • "abs" — Absolute value

Dependencies

  • If MagnitudeScale is "log" when you set MagnitudeUnit to "dB", the software automatically changes MagnitudeScale to "linear".

  • The default magnitude units depend on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Magnitude scale, specified as either "log" or "linear".

Dependencies

Phase units, specified as one of these values:

  • "deg" — Degrees

  • "rad" — Radians

Dependencies

The default phase units depend on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Phase Wrapping and Branching

expand all

Option to enable phase wrapping, specified as one of these logical on/off values:

  • "on", 1, or true — Enable phase wrapping. The phase shown in the response wraps to remain in the range defined by PhaseWrappingBranch.

  • "off", 0, or false — Disable phase wrapping.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Dependencies

  • The default phase-wrapping configuration depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

  • When both phase wrapping and phase matching are enabled, the software performs the phase matching followed by the phase wrapping.

Lower limit of phase-wrapping range, specified as a scalar value in degrees. The phase-wrapping range is [B,B+360), where B is equal to PhaseWrappingBranch.

Dependencies

Option to enable phase matching, specified as one of these logical on/off values:

  • "on", 1, or true — Enable phase matching such that the phase response matches the value specified in PhaseMatchingValue at the frequency specified in PhaseMatchingFrequency. The remaining phase response shifts to maintain the same phase profile.

  • "off", 0, or false — Disable phase matching.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Dependencies

When both phase wrapping and phase matching are enabled, the software performs the phase matching followed by the phase wrapping.

Phase matching frequency, specified as a scalar.

Dependencies

This value is ignored when PhaseMatchingEnabled is "off".

Phase matching response value, specified as a scalar.

Dependencies

This value is ignored when PhaseMatchingEnabled is "off".

Title and Axis Labels

expand all

Title text and style, specified as an AxesLabel object with these properties.

Text value, specified as a string or character vector and stored as a string.

To specify a title with multiple lines, concatenate the lines into a single string using newline.

myplot.Title.String = "first line" + newline + "second line";

Font size in point units, specified as positive scalar. One point equals 1/72 inch.

Dependencies

The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character thickness, specified as "bold" or "normal".

Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.

Dependencies

The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character slant, specified as "normal" or "italic".

Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.

Dependencies

The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Font name, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts.

Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Text interpreter, specified as one of these values:

  • "tex" — Interpret characters using a subset of TeX markup.

  • "latex" — Interpret characters using LaTeX markup.

  • "none" — Display literal characters.

Subtitle text and style, specified as an AxesLabel object with these properties.

Text value, specified as a string or character vector and stored as a string.

To specify a subtitle with multiple lines, concatenate the lines into a single string using newline.

myplot.Subtitle.String = "first line" + newline + "second line";

Font size in point units, specified as positive scalar. One point equals 1/72 inch.

Dependencies

The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character thickness, specified as "bold" or "normal".

Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.

Dependencies

The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character slant, specified as "normal" or "italic".

Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.

Dependencies

The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Font name, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts.

Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Text interpreter, specified as one of these values:

  • "tex" — Interpret characters using a subset of TeX markup.

  • "latex" — Interpret characters using LaTeX markup.

  • "none" — Display literal characters.

X-axis label text and style, specified as an AxesLabel object with these properties.

Text value, specified as a string or character vector and stored as a string.

To specify a label with multiple lines, concatenate the lines into a single string using newline.

myplot.XLabel.String = "first line" + newline + "second line";

Font size in point units, specified as positive scalar. One point equals 1/72 inch.

Dependencies

The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character thickness, specified as "bold" or "normal".

Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.

Dependencies

The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character slant, specified as "normal" or "italic".

Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.

Dependencies

The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Font name, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts.

Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Text interpreter, specified as one of these values:

  • "tex" — Interpret characters using a subset of TeX markup.

  • "latex" — Interpret characters using LaTeX markup.

  • "none" — Display literal characters.

Y-axis label text and style, specified as an AxesLabel object with these properties.

Text value, specified as a two-element string array or cell array of character vectors and stored as a string array. The first element is the label for the magnitude plot and the second element is the label for the phase plot.

To specify either a magnitude or phase label with multiple lines, concatenate the lines into a single string using newline.

myplot.YLabel.String(1) = "first line" + newline + "second line";

Font size in point units, specified as positive scalar. One point equals 1/72 inch.

Dependencies

The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character thickness, specified as "bold" or "normal".

Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.

Dependencies

The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Character slant, specified as "normal" or "italic".

Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.

Dependencies

The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Font name, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts.

Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Text interpreter, specified as one of these values:

  • "tex" — Interpret characters using a subset of TeX markup.

  • "latex" — Interpret characters using LaTeX markup.

  • "none" — Display literal characters.

Axes Limits

expand all

X-axis limits, specified as a two-element vector of the form [min,max], where min is the minimum axis limit and max is the maximum axis limit.

Dependencies

  • When the XLimitsMode property is "auto", the X-axis limits are configured automatically based on the system dynamics.

X-axis limit selection mode, specified as one of these strings:

  • "auto" — Enable automatic limit selection, which is based on the total span of the plotted data.

  • "manual" — Manually specify the axis limits by setting the XLimits property.

Dependencies

  • If you modify the XLimits property, the XLimitsMode value changes to "manual".

Y-axis limits, specified as a cell array of two-element vectors of the form [min,max], where min is the minimum axis limit and max is the maximum axis limit. The first element of YLimits contains the limits for the magnitude plot and the second element contains the limits for the phase plot.

Dependencies

  • When an entry in the YLimits property is "auto", the corresponding Y-axis limits are configured automatically based on the system dynamics.

  • YLimits contains limits only for visible axes. When MagnitudeVisible or PhaseVisible is off, then the corresponding limits are removed from YLimits.

Y-axis limit selection mode, specified as one of these values:

  • "auto" — Enable automatic limit selection, which is based on the total span of the plotted data.

  • "manual" — Manually specify the axis limits by setting the YLimits property.

Dependencies

  • If you modify an entry in the YLimits property, the corresponding YLimitsMode value changes to "manual".

  • YLimitsMode contains selection modes only for visible axes. When MagnitudeVisible or PhaseVisible is off, then the corresponding selection mode is removed from YLimitsMode.

Axes Style

expand all

Axes style, specified as an AxesStyle object with these properties.

Axes background color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Option to display axes outline, specified as one of these logical on/off values.

  • "on", 1, or true — Display outline.

  • "off", 0, or false — Hide outline.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Line width of axes outline and tick marks, specified as a positive scalar value in point units.

Ruler color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet. The ruler color affects axes lines, tick marks, and tick labels.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Font size for tick labels in point units, specified as positive scalar. One point equals 1/72 inch.

Character thickness for tick labels, specified as "bold" or "normal".

Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.

Character slant for tick labels, specified as "normal" or "italic".

Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.

Font name for tick labels, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts.

Option to display major grid lines, specified as one of these logical on/off values.

  • "on", 1, or true — Display major grid lines.

  • "off", 0, or false — Hide major grid lines.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Dependencies

The default grid visibility depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.

Grid color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Width of major grid lines, specified as a positive scalar in point units.

Grid line style, specified as one of these values.

Line StyleDescription
"-"Solid line
"--"Dashed line
":"Dotted line
"-."Dash-dotted line

Grid line transparency, specified as a scalar value in the range [0,1], where a smaller value indicates more transparency.

Option to display minor grid lines, specified as one of these logical on/off values.

  • "on", 1, or true — Display minor grid lines.

  • "off", 0, or false — Hide minor grid lines.

The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Dependencies

Minor grid lines are not displayed by default.

Minor grid color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.

Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.

Color NameRGB TripletHexadecimal Color Code

"red" or "r"

[1 0 0]#FF0000

"green" or "g"

[0 1 0]#00FF00

"blue" or "b"

[0 0 1]#0000FF

"cyan" or "c"

[0 1 1]#00FFFF

"magenta" or "m"

[1 0 1]#FF00FF

"yellow" or "y"

[1 1 0]#FFFF00

"black" or "k"

[0 0 0]#000000

"white" or "w"

[1 1 1]#FFFFFF

Width of minor grid lines, specified as a positive scalar in point units.

Minor grid line style, specified as one of these values.

Line StyleDescription
"-"Solid line
"--"Dashed line
":"Dotted line
"-."Dash-dotted line

Minor grid line transparency, specified as a scalar value in the range [0,1], where a smaller value indicates more transparency.

Version History

Introduced in R2025a