NyquistPlot Properties

Access Nyquist plot properties

Since R2024b

NyquistPlot properties control the appearance and behavior of Nyquist plots created using the nyquistplot function. By changing property values, you can modify certain aspects of the plot.

np = nyquistplot(sys);
np.Characteristics.FrequencyPeakResponse.Visible = "on";

For more information, see Customize Linear Analysis Plots at Command Line (Control System Toolbox).

Response

expand all

`Responses` — Model responses
`NyquistResponse` object | array of `NyquistResponse` objects

Model responses, specified as a NyquistResponse object or an array of such objects. Use this property to modify the dynamic system model or appearance for each response in the plot. Each NyquistResponse object has these properties.

`Model` — Dynamic system
dynamic system model | model array

Dynamic system, specified as a SISO or MIMO dynamic system model or an array of dynamic system models.

When you initially create a plot, Model matches the value you specify for sys.

Before R2026a: Specify the dynamic system using the Responses.SourceData.Model property.

`FrequencySpec` — Frequencies
`{wmin,wmax}` | vector | `[]`

Frequencies at which to compute the response, specified as one of these values:

Cell array of the form {wmin,wmax} — Compute the response at frequencies in the range from wmin to wmax.
Vector of frequencies — Compute the response at each specified frequency. For example, use logspace to generate a row vector with logarithmically spaced frequency values. The vector w can contain both positive and negative frequencies.
[] — Automatically select frequencies based on system dynamics.

Specify frequencies in units of rad/TimeUnit, where TimeUnit is the TimeUnit property of the model.

When you initially create a plot:

FrequencySpec matches the value you specify for the w argument.
If you do not specify w, FrequencySpec is empty and frequencies are selected based on the system dynamics.

Before R2026a: Specify frequencies using the Responses.SourceData.FrequencySpec property.

`Name` — Response name
string | character vector

Response name, specified as a string or character vector and stored as a string.

`Visible` — Response visibility
`"on"` (default) | on/off logical value

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

"on", 1, or true — Display the response in the plot.
"off", 0, or false — Do not display the response in the plot.

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

`LegendDisplay` — Option to list response in legend
`"on"` (default) | on/off logical value

Option to list the response in the legend, specified as one of these logical on/off values:

"on", 1, or true — List the response in the legend.
"off", 0, or false — Do not list the response in the legend.

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

`MarkerStyle` — Marker style
`"none"` | `"o"` | `"+"` | `"*"` | `"."` | ...

Marker style, specified as one of these values.

Marker	Description
`"none"`	No marker
`"o"`	Circle
`"+"`	Plus sign
`"*"`	Asterisk
`"."`	Point
`"x"`	Cross
`"_"`	Horizontal line
`"\|"`	Vertical line
`"s"`	Square
`"d"`	Diamond
`"^"`	Upward-pointing triangle
`"v"`	Downward-pointing triangle
`">"`	Right-pointing triangle
`"<"`	Left-pointing triangle
`"p"`	Pentagram
`"h"`	Hexagram

`MarkerStyleMode` — Marker style selection mode
`"auto"` (default) | `"manual"`

Since R2026a

Marker style selection mode, specified as one of these values:

"auto" — Automatically set the marker style based on the marker order of the parent chart object.
"manual" — Manually specify the marker style order using the MarkerStyle property.

Dependencies

If you modify the MarkerStyle property, the value of the MarkerStyleMode changes to "manual".

`Color` — Plot color
RGB triplet | hexadecimal color code | color name

Plot 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 Name	RGB Triplet	Hexadecimal 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`

`ColorMode` — Color selection mode
`"auto"` (default) | `"manual"`

Since R2026a

Color selection mode, specified as one of these values:

"auto" — Automatically set the color based on the color order of the parent chart object.
"manual" — Manually specify the color order using the Color property.

Dependencies

If you modify the Color property, the value of the ColorMode changes to "manual".

`LineStyle` — Line style
`"-"` | `"--"` | `":"` | `"-."`

Line style, specified as one of these values.

Line Style	Description
`"-"`	Solid line
`"--"`	Dashed line
`":"`	Dotted line
`"-."`	Dash-dotted line
`"none"`	No line

`LineStyleMode` — Line style selection mode
`"auto"` (default) | `"manual"`

Since R2026a

Line style selection mode, specified as one of these values:

"auto" — Automatically set the line style based on the line style order of the parent chart object.
"manual" — Manually specify the line style order using the LineStyle property.

Dependencies

If you modify the LineStyle property, the value of the LineStyleMode changes to "manual".

`MarkerSize` — Marker size
positive scalar

Marker size, specified as a positive scalar.

`LineWidth` — Line width
positive scalar

Line width, specified as a positive scalar.

`SeriesIndex` — Series index
positive integer | `"none"`

Since R2026a

Series index, specified as a positive integer or "none".

By default, the SeriesIndex property is a number that corresponds to the order in which the response was added to the chart, starting at 1. MATLAB^® uses the number to calculate indices for automatically assigning color, line style, or markers for responses. The indices refer to the rows of the arrays stored in the ColorOrder and LineStyleOrder, and MarkerStyleOrder properties of the parent chart. Any responses in the chart that have the same SeriesIndex number also have the same color, line style, and markers.

A SeriesIndex value of "none" indicates that a response does not participate in the indexing scheme.

`SeriesIndexMode` — Series index specification mode
`"auto"` (default) | `"manual"`

Since R2026a

Series index specification mode, specified as one of these values:

"auto" — Automatically set the series index based on the order in which the response was added to the chart.
"manual" — Manually specify the series index using the SeriesIndex property.

Dependencies

If you modify the SeriesIndex property, the value of the SeriesIndexMode changes to "manual".

`Characteristics` — Response characteristics
`CharacteristicsManager` object

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

`PeakResponse` — Visibility of peak response
`CharacteristicOption` object

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

Before R2026a: Specify the visibility of the peak response characteristic using the FrequencyPeakResponse property.

`Visible` — Peak response visibility
`"off"` (default) | on/off logical value

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.

`AllStabilityMargins` — Visibility of all stability margins
`CharacteristicOption` object

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

`Visible` — Margin visibility
`"off"` (default) | on/off logical value

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.

`MinimumStabilityMargins` — Visibility of minimum stability margins
`CharacteristicOption` object

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

`Visible` — Margin visibility
`"off"` (default) | on/off logical value

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.

`ConfidenceRegion` — Confidence region
`CharacteristicOption` object

Confidence region for identified models, specified as a CharacteristicOption object with these properties.

`Visible` — Confidence region visibility
`"off"` (default) | on/off logical value

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

"on", 1, or true — Display the confidence region.
"off", 0, or false — Do not display the confidence region.

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

`DisplaySampling` — Frequency spacing of confidence ellipses
`5` (default) | positive integer

Frequency spacing of confidence ellipses used to plot the confidence region, specified as a positive integer. For example, when DisplaySampling is 5 the confidence ellipses are shown at every fifth frequency sample.

`NumberOfStandardDeviations` — Number of standard deviations
`1` (default) | positive scalar

Number of standard deviations to display for the confidence region, specified as a positive scalar.

Dependencies

ConfidenceRegion is supported only for identified models.

`ShowNegativeFrequencies` — Option to show response for negative frequencies
`"on"` (default) | on/off logical value

Option to show response for negative frequencies, specified as one of these logical on/off values:

"on", 1, or true — Display the response for negative frequencies.
"off", 0, or false — Do not display the response for negative frequencies.

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

Units

expand all

`FrequencyUnit` — Frequency units
`"Hz"` | `"rad/s"` | `"rpm"` | ...

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 Settings for Linear Analysis Plots.

`FrequencyUnitMode` — Frequency unit selection mode
`"auto"` (default) | `"manual"`

Since R2026a

Frequency unit selection mode, specified as one of these values:

"auto" — Automatically set the frequency unit to the units of the first system in Responses.Model.
"manual" — Manually specify the frequency unit using the FrequencyUnit property.

Dependencies

If you modify the FrequencyUnit property, the value of the FrequencyUnitMode property changes to "manual".

`MagnitudeUnit` — Magnitude units
`"dB"` | `"abs"`

Magnitude units, specified as one of these values:

"dB" — Decibels
"abs" — Absolute value

Dependencies

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

`PhaseUnit` — Phase units
`"deg"` | `"rad"`

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 Settings for Linear Analysis Plots.

Inputs and Outputs

expand all

`InputLabels` — Input label text and style
`AxesLabel` object | array of `AxesLabel` objects

Input label text and style, specified as an AxesLabel object or an array of such objects. Each AxesLabel object has these properties.

`String` — Text value
string | character vector

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

`FontSize` — Font size
positive scalar

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 Settings for Linear Analysis Plots.

`FontWeight` — Character thickness
`"bold"` | `"normal"`

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 Settings for Linear Analysis Plots.

`FontAngle` — Character slant
`"normal"` | `"italic"`

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 Settings for Linear Analysis Plots.

`FontName` — Font name
string | character vector

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.

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

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.

`OutputLabels` — Output label text and style
`AxesLabel` object | array of `AxesLabel` objects

Output label text and style, specified as an AxesLabel object or an array of such objects. Each AxesLabel object has these properties.

`String` — Text value
string | character vector

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

`FontSize` — Font size
positive scalar

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 Settings for Linear Analysis Plots.

`FontWeight` — Character thickness
`"bold"` | `"normal"`

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 Settings for Linear Analysis Plots.

`FontAngle` — Character slant
`"normal"` | `"italic"`

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 Settings for Linear Analysis Plots.

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

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.

`InputVisible` — Option to display inputs
on/off logical value | array of on/off logical values

Option to display inputs, specified as one of these logical on/off values or an array of such values:

"on", 1, or true — Display the corresponding input.
"off", 0, or false — Hide the corresponding input.

InputVisible is an array when the plotted system has multiple inputs. By default, all inputs are visible in the plot.

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

`OutputVisible` — Option to display outputs
on/off logical value | array of on/off logical values

Option to display outputs, specified as one of these logical on/off values or an array of such values:

"on", 1, or true — Display the corresponding output.
"off", 0, or false — Hide the corresponding output.

OutputVisible is an array when the plotted system has multiple outputs. By default, all outputs are visible in the plot.

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

`IOGrouping` — Grouping of input and output pairs
`"none"` (default) | `"inputs"` | `"outputs"` | `"all"`

Grouping of inputs and outputs pairs, specified as one of these values:

"none" — Do not group inputs or outputs.
"inputs" — Group only inputs.
"outputs" — Group only outputs.
"all" — Group all input-output pairs.

Labels

expand all

`Title` — Title text and style
`AxesLabel` object

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

`String` — Text value
string | character vector

Text value, specified as a string or character vector and stored as a string. To set the label text, you can set the String property directly or use the title function.

`FontSize` — Font size
positive scalar

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 Settings for Linear Analysis Plots.

`FontWeight` — Character thickness
`"bold"` | `"normal"`

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 Settings for Linear Analysis Plots.

`FontAngle` — Character slant
`"normal"` | `"italic"`

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 Settings for Linear Analysis Plots.

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

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` — Subtitle text and style
`AxesLabel` object

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

`String` — Text value
string | character vector

Text value, specified as a string or character vector and stored as a string. To set the label text, you can set the String property directly or use the subtitle function.

`FontSize` — Font size
positive scalar

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 Settings for Linear Analysis Plots.

`FontWeight` — Character thickness
`"bold"` | `"normal"`

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 Settings for Linear Analysis Plots.

`FontAngle` — Character slant
`"normal"` | `"italic"`

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 Settings for Linear Analysis Plots.

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

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.

`XLabel` — X-axis label text and style
`AxesLabel` object

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

`String` — Text value
string | character vector

Text value, specified as a string or character vector and stored as a string. To set the label text, you can set the String property directly or use the xlabel function.

`FontSize` — Font size
positive scalar

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 Settings for Linear Analysis Plots.

`FontWeight` — Character thickness
`"bold"` | `"normal"`

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 Settings for Linear Analysis Plots.

`FontAngle` — Character slant
`"normal"` | `"italic"`

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 Settings for Linear Analysis Plots.

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

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.

`YLabel` — Y-axis label text and style
`AxesLabel` object

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

`String` — Text value
string | character vector

Text value, specified as a string or character vector and stored as a string. To set the label text, you can set the String property directly or use the ylabel function.

`FontSize` — Font size
positive scalar

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 Settings for Linear Analysis Plots.

`FontWeight` — Character thickness
`"bold"` | `"normal"`

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 Settings for Linear Analysis Plots.

`FontAngle` — Character slant
`"normal"` | `"italic"`

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 Settings for Linear Analysis Plots.

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

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.

`Legend` — Plot legend
`Legend` object

Since R2026a

Plot legend, specified as a Legend object with these properties.

`Axes` — Legend axes
two-element vector

Legend axes, specified as a two-element vector of integers indicating the row and column of the axes in which to display the legend.

Before R2026a: Specify the legend axes using the LegendAxes property.

Dependencies

When Legend.AxesMode is "auto", Legend.Axes contains the row and column of the northeast visible axis.

`Location` — Legend location within the axes
`"northeast"` (default) | `"northwest"` | `"southeast"` | `"southwest"` | `"north"` | `"south"` | `"east"` | `"west"` | `"best"` | ...

Legend location within the axes, specified as one of he location values listed in this table.

Location Value	Description
`"north"`	Inside top of axes
`"south"`	Inside bottom of axes
`"east"`	Inside right of axes
`"west"`	Inside left of axes
`"northeast"`	Inside top-right of axes
`"northwest"`	Inside top-left of axes
`"southeast"`	Inside bottom-right of axes
`"southwest"`	Inside bottom-left of axes
`"northoutside"`	Above the axes
`"southoutside"`	Below the axes
`"eastoutside"`	To the right of the axes
`"westoutside"`	To the left of the axes
`"northeastoutside"`	Outside top-right corner of the axes
`"northwestoutside"`	Outside top-left corner of the axes
`"southeastoutside"`	Outside bottom-right corner of the axes
`"southwestoutside"`	Outside bottom-left corner of the axes
`"best"`	Location where the least conflict occurs with the plot data at the time that you create the legend. If the plot data changes, you might need to reset the location to `"best"`.
`"bestoutside"`	Outside top-right corner of the axes (when the legend has a vertical orientation) or below the axes (when the legend has a horizontal orientation)

Before R2026a: Specify the legend location using the LegendLocation property.

`AxesMode` — Legend axes selection mode
`"auto"` (default) | `"manual"`

Legend axes selection mode, specified as one of these values:

"auto" — Show the legend in the northeast visible axes.
"manual" — Show the legend in the axes indicated by the LegendAxes property.

Before R2026a: Specify the legend axes selection mode using the LegendAxesMode property.

`Orientation` — Orientation for stacking legend items
`"vertical"` (default) | `"horizontal"`

Orientation for stacking legend items, specified as one of these values:

"vertical" — Stack items vertically.
"horizontal" — Stack items horizontally.

Before R2026a: Specify the legend orientation using the LegendOrientation property.

`Visible` — Option to display the legend
`"off"` (default) | on/off logical value

Option to display the legend, specified as one of these logical on/off values:

"on", 1, or true — Display the legend.
"off", 0, or false — Hide the legend.

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

Before R2026a: Specify the legend visibility using the LegendVisible property.

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

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.

`FontSize` — Font size
positive scalar

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

`FontWeight` — Character thickness
`"bold"` | `"normal"`

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.

`FontAngle` — Character slant
`"normal"` | `"italic"`

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.

`FontName` — Font name
string | character vector

Axes Limits

expand all

`XLimits` — X-axis limits
two-element vector | cell array of two-element vectors

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

If XLimitsSharing is:

"all", then XLimits is a two-element vector that specifies the X-axis limits for all visible axes in the chart.
"column", then XLimits is a cell array, where each element specifies the X-axis limits for one visible column of axes in the chart.
"none", then XLimits is a cell array, where each element specifies the X-axis limits for one visible axes in the chart.

Dependencies

When an entry in the XLimitsMode property is "auto", the corresponding X-axis limits are configured automatically based on the system dynamics.
XLimits contains limits only for visible inputs. For example, when an entry in InputVisible is off, the corresponding limits are removed from XLimits.

`XLimitsMode` — X-axis limit selection mode
`"auto"` | `"manual"` | cell array of strings

X-axis limit selection mode, specified as one of these strings or a cell array of such 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

The dimensions of XLimitsMode match the dimensions of XLimits.
If you modify an entry in the XLimits property, the corresponding XLimitsMode value changes to "manual".
XLimitsMode contains selection modes only for visible inputs. For example, when an entry in InputVisible is off, the corresponding selection modes are removed from XLimitsMode.

`XLimitsSharing` — X-axis limit sharing
`"all"` (default) | `"column"` | `"none"`

X-axis limit sharing, specified as one of these strings.

"all" — All axes use the same X-axis limits.
"column" — All axes in the same input column use the same X-axis limits.
"none" — Each axes uses its own X-axis limits.

`YLimits` — Y-axis limits
two-element vector | cell array of two-element vectors

Y-axis limits, specified as a two-element vector of the form [min,max] or a cell array of such vectors, where min is the minimum axis limit and max is the maximum axis limit.

If YLimitsSharing is:

"all", then YLimits is a two-element vector that specifies the Y-axis limits for all visible axes in the chart.
"row", then YLimits is a cell array, where each element specifies the Y-axis limits for one visible row of axes in the chart.
"none", then YLimits is a cell array, where each element specifies the Y-axis limits for one visible axes in the chart.

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 outputs. For example, when an entry in OutputVisible is off, the corresponding limits are removed from YLimits.

`YLimitsMode` — Y-axis limit selection mode
`"auto"` | `"manual"` | cell array of strings

Y-axis limit selection mode, specified as one of these strings or a cell array of such 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 YLimits property.

Dependencies

The dimensions of YLimitsMode match the dimensions of YLimits.
If you modify an entry in the YLimits property, the corresponding YLimitsMode value changes to "manual".
YLimitsMode contains selection modes only for visible outputs. For example, when an entry in OutputVisible is off, the corresponding selection modes are removed from YLimitsMode.

`YLimitsSharing` — Y-axis limit sharing
`"row"` (default) | `"all"` | `"none"`

Y-axis limit sharing, specified as one of these strings.

"all" — All axes use the same Y-axis limits.
"row" — All axes in the same output row use the same Y-axis limits.
"none" — Each axes uses its own Y-axis limits.

Axes Style

expand all

`AxesStyle` — Axes style
`NGridAxesStyle` object

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

`BackgroundColor` — Axes background color
`[1 1 1]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`Box` — Option to display axes outline
`"on"` | on/off logical value

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.

`BoxLineWidth` — Line width of axes outline
`0.5` (default) | positive scalar

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

`RulerColor` — Ruler color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`FontSize` — Font size for tick labels
positive scalar

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

`FontWeight` — Character thickness for tick labels
`"bold"` (default) | `"normal"`

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.

`FontAngle` — Character slant for tick labels
`"normal"` (default) | `"italic"`

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.

`FontName` — Font name for tick labels
string | character vector

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.

`GridVisible` — Option to display grid
on/off logical value

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

"on", 1, or true — Display grid.
"off", 0, or false — Hide grid.

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 Settings for Linear Analysis Plots.

`GridType` — Grid type
`"n-grid"` | `"cartesian"`

Since R2026a

Grid type, specified as one of these values:

"n-grid" — Use a grid with contours for constant gain and phase values.
"cartesian" — Use a Cartesian grid.

Dependencies

When the GridTypeMode property is "auto", the grid type is configured automatically based on the properties of the system.

`GridTypeMode` — Grid type selection mode
`"auto"` (default) | `"manual"`

Since R2026a

Grid type selection mode, specified as one of these values:

"auto" — Enable automatic grid type selection according to these rules:
- For SISO systems, set GridType to "n-grid".
- For MIMO systems, set GridType to "cartesian".
"manual" — Manually specify the grid type using the GridType property.

Dependencies

If you modify the GridType property, the value of the GridTypeMode changes to "manual".

`GridMagnitudeSpec` — Gain values for grid contours
`[]` (default) | vector

Since R2026a

Gain values for grid contours, specified as one of these values:

[] — Automatically select gain contour values based on system dynamics.
Vector of gain values, specified in the units indicated by the MagnitudeUnit property of the chart object.

Dependencies

The chart uses this property only when the GridType property is "n-grid".
If you modify the MagnitudeUnit property of the chart object, the software converts the values in GridMagnitudeSpec to the specified units.

`GridPhaseSpec` — Phase values for grid contours
`[]` (default) | vector

Since R2026a

Phase values for grid contours, specified as one of these values:

[] — Automatically select phase contour values based on system dynamics.
Vector of phase values, specified in the units indicated by the PhaseUnit property of the chart object.

Dependencies

The chart uses this property only when the GridType property is "n-grid".
If you modify the PhaseUnit property of the chart object, the software converts the values in GridPhaseSpec to the specified units.

`GridColor` — Grid color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

`GridLineWidth` — Grid line width
`0.5` (default) | positive scalar

Grid line width, specified as a positive scalar in point units.

`GridLineStyle` — Grid line style
`"-"` | `"--"` | `":"` | `"-."`

Grid line style, specified as one of these values.

Line Style	Description
`"-"`	Solid line
`"--"`	Dashed line
`":"`	Dotted line
`"-."`	Dash-dotted line

`GridAlpha` — Grid line transparency
`0.15` (default) | scalar value in range [0,1]

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

`GridLabelsVisible` — Option to display grid labels
on/off logical value

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

"on", 1, or true — Display grid labels.
"off", 0, or false — Hide grid labels.

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

Dependencies

This property is supported for plots of SISO systems.

`MinorGridVisible` — Option to display minor grid lines
on/off logical value

Option to display minor grid lines in plots of MIMO systems, 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

This property is supported for plots of MIMO systems.
Minor grid lines are not displayed by default.

`MinorGridColor` — Minor grid line color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

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 Name	RGB Triplet	Hexadecimal 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`

Dependencies

This property is supported for plots of MIMO systems.

`MinorGridLineWidth` — Width of minor grid lines
`0.5` (default) | positive scalar

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

Dependencies

This property is supported for plots of MIMO systems.

`MinorGridLineStyle` — Minor grid line style
`"-"` | `"--"` | `":"` | `"-."`

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

Line Style	Description
`"-"`	Solid line
`"--"`	Dashed line
`":"`	Dotted line
`"-."`	Dash-dotted line

Dependencies

This property is supported for plots of MIMO systems.

`MinorGridAlpha` — Minor grid line transparency
`0.15` (default) | scalar value in range [0,1]

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

Dependencies

This property is supported for plots of MIMO systems.

`DataAxes` — Active data axes
two-element vector

Since R2025a

Active data axes for hold workflows on MIMO linear analysis plots or a SISO Bode plots, specified as a two-element vector of integers indicating the row and column of the active axes. When you first create a chart, the bottom right axes is active. If you reduce the number of visible axes, the active axes automatically updates to a visible axes if necessary.

The DataAxes property affects only hold workflows that do not include adding new responses.

Multiple Responses

expand all

`ColorOrder` — Color order
three-column matrix of RGB triplets

Since R2026a

Color order for creating responses, specified as a three-column matrix, where each row is an RGB triplet.

MATLAB assigns colors to responses according to their order of creation. The first response uses the first color, the second response uses the second color, and so on. If there are more responses than colors, then the cycle repeats.

You can change the color order for a chart object in either of these ways:

Set the ColorOrder property directly. In this case, you must specify the color array as a three-column matrix of RGB triplets. For example, the following command sets the color order to red, green, and blue.
```
mychart.ColorOrder = [1 0 0;0 1 0;0 0 1];
```
Call the colororder function, specifying the chart object as the target. In this case, you can specify the colors using one of these methods:
- Array of color names
  colororder(mychart,["red","green","blue"])
- Array of hexadecimal codes
  colororder(mychart,["#FF0000","#00FF00","#0000FF"])
- Palette name
  colororder(mychart,"gem12")
For more information on setting color order, see colororder.

`ColorOrderMode` — Color order definition mode
`"auto"` (default) | `"manual"`

Since R2026a

Color order definition mode, specified as one of these values:

"auto" — Automatically set the color order based on the color order of the parent graphics object.
"manual" — Manually specify the color order using the ColorOrder property.

Dependencies

If you modify the ColorOrder property, the value of the ColorOrderMode changes to "manual".

`LineStyleOrder` — Line style order
string | string array

Since R2026a

Line style order for creating responses, specified as one of the following values or an array of such values.

Line Style	Description
`"-"`	Solid line
`"--"`	Dashed line
`":"`	Dotted line
`"-."`	Dash-dotted line
`"none"`	No line

MATLAB assigns line styles to responses according to their order of creation. The first response uses the first line style, the second response uses the second line style, and so on. If there are more responses than line styles, then the cycle repeats.

`LineStyleOrderMode` — Line style order definition mode
`"auto"` (default) | `"manual"`

Since R2026a

Line style order definition mode, specified as one of these values:

"auto" — Automatically set the line style order based on the line style order of the parent graphics object.
"manual" — Manually specify the line style order using the LineStyleOrder property.

Dependencies

If you modify the LineStyleOrder property, the value of the LineStyleOrderMode changes to "manual".

`MarkerStyleOrder` — Marker style order
string | string array

Since R2026a

Marker style order for creating responses, specified as one of the following values or an array of such values.

Marker	Description
`"none"`	No marker
`"o"`	Circle
`"+"`	Plus sign
`"*"`	Asterisk
`"."`	Point
`"x"`	Cross
`"_"`	Horizontal line
`"\|"`	Vertical line
`"s"`	Square
`"d"`	Diamond
`"^"`	Upward-pointing triangle
`"v"`	Downward-pointing triangle
`">"`	Right-pointing triangle
`"<"`	Left-pointing triangle
`"p"`	Pentagram
`"h"`	Hexagram

MATLAB assigns marker styles to responses according to their order of creation. The first response uses the first marker style, the second response uses the second marker style, and so on. If there are more responses than marker styles, then the cycle repeats.

`MarkerStyleOrderMode` — Marker style order definition mode
`"auto"` (default) | `"manual"`

Since R2026a

Marker style order definition mode, specified as one of these values:

"auto" — Automatically set the marker style order based on the marker style order of the parent graphics object.
"manual" — Manually specify the marker style order using the MarkerStyleOrder property.

Dependencies

If you modify the MarkerStyleOrder property, the value of the MarkerStyleOrderMode changes to "manual".

`NextSeriesIndex` — `SeriesIndex` value for next response
Read-only: positive integer

Since R2026a

This property is read-only.

SeriesIndex value for the next response added to the chart, returned as a positive integer. This property is useful when you want to track how the responses cycle through the color, line, and marker styles. This property maintains a count of the objects in the axes that have a numeric SeriesIndex property value. MATLAB uses NextSeriesIndex to assign a SeriesIndex value to each new response. The count starts at 1 when you create the chart, and it increases by 1 for each response added to the chart.

`NextPlot` — Properties to reset
`"replace"` (default) | `"add"`

Properties to reset when adding a new response to the chart, specified as one of these values:

"replace" — Delete existing responses and reset chart properties, except Position and Units, to their default values before displaying the new response.
"add" — Add new responses to the existing chart. Do not delete existing responses or reset axes properties before displaying the new response.

Position

expand all

`OuterPosition` — Chart size and location, including margins
`[left bottom width height]`

Chart size and location, including the margins for decorations such as axis labels and tick marks. Specify this property as a vector of form [left bottom width height]. The values are in the units specified by the Units property.

left — Distance from the left edge of the parent container to the outer-left edge of the chart that includes the margins. Typically, the parent container is a figure, panel, or tab.
bottom — Distance from the bottom edge of the parent container to the outer-bottom edge of the chart that includes the margins.
width — Width of chart, including the margins.
height — Height of chart, including the margins.

Note

Setting this property has no effect when the parent of the chart is a TiledChartLayout.

`InnerPosition` — Chart size and location, excluding margins
`[left bottom width height]`

Chart size and location, excluding the margins for decorations such as axis labels and tick marks. Specify this property as a vector of form [left bottom width height]. The values are in the units specified by the Units property.

left — Distance from the left edge of the parent container to the inner-left edge of the chart that excludes the margins. Typically, the parent container is a figure, panel, or tab.
bottom — Distance from the bottom edge of the parent container to the inner-bottom edge of the chart that excludes the margins.
width — Width of the chart, excluding the margins.
height — Height of the chart, excluding the margins.

Note

Setting this property has no effect when the parent of the chart is a TiledChartLayout.

`Position` — Chart size and location, excluding margins
`[left bottom width height]`

Chart size and location, excluding the margins for decorations such as axis labels and tick marks. Specify this property as a vector of form [left bottom width height]. This property is equivalent to the InnerPosition property.

Note

Setting this property has no effect when the parent of the chart is a TiledChartLayout.

`Units` — Position units
`'normalized'` (default) | `'inches'` | `'centimeters'` | `'characters'` | `'points'` | `'pixels'`

Position units, specified as a value from the following table. To change the position of the chart in specific units, set the Units property before specifying the Position property. If you specify the Units and Position properties in a single command (using name-value pairs), be sure to specify Units before Position.

`Units`	Description
`'normalized'`	Normalized with respect to the parent container, which is typically the figure, panel, or tab. The lower left corner of the container maps to `(0,0)`, and the upper right corner maps to `(1,1)`.
`'inches'`	Inches
`'centimeters'`	Centimeters
`'characters'`	Based on the default font of the graphics root object: Character width = width of letter `x`. Character height = distance between the baselines of two lines of text.
`'points'`	Typography points. One point equals 1/72 inch.
`'pixels'`	On Windows^® and Macintosh systems, the size of a pixel is 1/96th of an inch. This size is independent of your system resolution. On Linux^® systems, the size of a pixel is determined by your system resolution.

`PositionConstraint` — Position to hold constant
`'outerposition'` | `'innerposition'`

Position property to hold constant when adding, removing, or changing decorations, specified as one of these values:

'outerposition' — The OuterPosition property remains constant when you add, remove, or change decorations such as a title or an axis label. If any positional adjustments are needed, MATLAB adjusts the InnerPosition property.
'innerposition' — The InnerPosition property remains constant when you add, remove, or change decorations such as a title or an axis label. If any positional adjustments are needed, MATLAB adjusts the OuterPosition property.

Note

Setting this property has no effect when the parent of the chart is a TiledChartLayout.

`Layout` — Layout options
empty `LayoutOptions` array (default) | `TiledChartLayoutOptions` | `GridLayoutOptions`

Layout options, specified as a TiledChartLayoutOptions object or GridLayoutOptions object. This property specifies options when an instance of your chart is a child of a tiled chart layout or gridded layout. If the instance is not a child of one of these layouts (for example, it is a child of a figure or panel), then this property is empty and has no effect. Otherwise, you can position the chart within the layout by configuring the layout options.

This code places chart object c into the third tile of a tiled chart layout and makes the chart span 2 rows and 3 columns.

c.Layout.Tile = 3;
c.Layout.TileSpan = [2 3];

This code places chart object c into row 2 of a gridded layout and makes the chart span columns 3 and 4.

c.Layout.Row = 2;
c.Layout.Column = [3 4];

Visibility

expand all

`Visible` — Chart visibility
`"on"` (default) | on/off logical value

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

"on", 1, or true — Display the chart.
"off", 0, or false — Hide the chart without deleting it. You can still access the properties of chart when it is not visible.

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

Parent

expand all

`Parent` — Parent container
`Figure` object (default) | `TiledChartLayout` object | `UIFigure` object | `UIGridLayout` object | `UIPanel` object | `UITab` object

Parent container of the chart, specified as one of these objects:

Figure
TiledChartLayout
UIFigure
UIGridLayout
UIPanel
UITab

`HandleVisibility` — Visibility of object handle
`'on'` (default) | `'off'` | `'callback'`

Visibility of the chart object handle in the list of children for its parent, specified as one of these values:

'on' — Chart object handle is always visible.
'off' — Chart object handle is invisible at all times. This option is useful for preventing unintended changes to the chart by another function. To temporarily hide the handle during the execution of that function, set the HandleVisibility to 'off'.
'callback' — Chart object handle is visible from within callbacks or functions invoked by callbacks, but not from within functions invoked from the command line. This option blocks access to the object in the Command Window, but it allows callback functions to access it.

Tips

You can also interactively modify response plot properties using the:

Property Editor — For more information, see Customize Linear Analysis Plots Using Property Editor (Control System Toolbox).
Property Inspector

Version History

Introduced in R2024b

expand all

R2026a: Specify grid styling with new properties

You can now specify grid styling using the following new chart object properties.

Property	Description of Change
`AxesStyle.GridType`	Set the grid type of to one of these values: `"n-grid"` — Use a grid with contours for constant gain and phase values. `"cartesian"` — Use a Cartesian grid.
`AxesStyle.GridTypeMode`	Indicate whether the `AxesStyle.GridType` property is user-specified (`"manual"`) or automatically specified by the software (`"auto"`).
`AxesStyle.GridMagnitudeSpec`	Specify gain values of grid contours when `AxesStyle.GridType` is `"n-grid"`
`AxesStyle.GridPhaseSpec`	Specify phase values of grid contours when `AxesStyle.GridType` is `"n-grid"`

R2026a: Source data properties are now direct subproperties of `Responses` property

Source data properties under the Responses.SourceData property are now direct subproperties of the Responses property. The Responses.SourceData property has been removed.

Previous Property	New Property
`Responses.SourceData.Model`	`Responses.Model`
`Responses.SourceData.FrequencySpec`	`Responses.FrequencySpec`

R2026a: Configure legend using `Legend` property

Starting in R2026a, you can configure legends using the Legend property of the chart object. Also, you can now configure legend properties using name-value arguments with the legend function.

You can now configure the following legend properties:

Axes
Location
AxesMode
Orientation
Visible
Interpreter
FontSize
FontWeight
FontAngle
FontName

The following chart object properties are now subproperties of the Legend property and their names have changed. The previous property names still work, but using them is not recommended.

Previous Property	New Property
`LegendAxes`	`Legend.Axes`
`LegendAxesMode`	`Legend.AxesMode`
`LegendVisible`	`Legend.Visible`
`LegendLocation`	`Legend.Location`
`LegendOrientation`	`Legend.Orientation`

R2026a: `FrequencyPeakResponse` characteristic renamed to `PeakResponse`

The Characteristics.FrequencyPeakResponse property has been renamed to Characteristics.PeakResponse. The behavior of the property remains the same.

R2026a: Control automatic styling of responses

You can now control the automatic color, line style, and marker style of responses in the plot using the new chart object properties in this table.

New Chart Object Property	Description
`ColorOrder`	Color order for multiple response plots
`LineStyleOrder`	Line style order for multiple response plots
`MarkerStyleOrder`	Marker style order for multiple response plots
`ColorOrderMode`	Indicates whether the property value of `ColorOrder`, `LineStyleOrder`, or `MarkerStyleOrder` is user-specified (`"manual"`) or automatically specified by the software (`"auto"`).
`LineStyleOrderMode`
`MarkerStyleOrderMode`
`NextSeriesIndex`	Series index for the next response that you add to the chart. Once the software assigns this series index to a response, it increments `NextSeriesIndex` by one.

The Responses property of each chart object contains one response object for each response in a chart. This table shows the new style properties for response objects.

New Response Object Property	Description
`ColorMode`	Indicates whether the property value of `Color`, `LineStyle`, or `MarkerStyle` is user-specified (`"manual"`) or automatically specified by the software (`"auto"`).
`LineStyleMode`
`MarkerStyleMode`
`SeriesIndex`	Series index, which determines the color, line style, and marker style to select from the corresponding order property of the chart object. When you add a response to a chart, the software sets its series index to the value of the `NextSeriesIndex` property of the chart object.
`SeriesIndexMode`	Indicates whether the property value of `SeriesIndex` is user-specified (`"manual"`) or automatically specified by the software (`"auto"`).

R2025a: Specify active data axes

When using hold-on workflows, you can now programmatically specify the active data axes for a chart. To specify the active data axes, set the DataAxes property of the corresponding chart object.

R2025a: Specify background color and box line width for axes

You can now specify these style properties for chart objects:

Background color — Use the AxesStyle.BackgroundColor property.
Box outline width — Use the AxesStyle.BoxLineWidth property.

R2025a: Configure grid line style

You can now customize grid line appearance for using new style properties. To specify a style property, set the corresponding AxesStyle subproperty of the chart object. This table lists the new style properties and their subproperties and supported plots.

Style Property	`AxesStyle` Subproperty	Supported Nyquist Plots
Major grid line style	`GridLineStyle`	All plots
Major grid transparency	`GridAlpha`	MIMO only
Minor grid visibility	`MinorGridVisible`
Minor grid color	`MinorGridColor`
Minor grid line width	`MinorGridLineWidth`
Minor grid line style	`MinorGridLineStyle`
Minor grid transparency	`MinorGridAlpha`

R2025a: Toggle visibility of grid labels

You can now control the visibility of the grid labels for Nyquist plots of SISO systems using theAxesStyle.GridLabelsVisible property. For example, display the grid for a plot and hide the grid labels.

np = nyquistplot(sys);
np.AxesStyle.GridVisible = "on";
np.AxesStyle.GridLabelsVisible = "off";

NyquistPlot Properties

Response

Responses — Model responses NyquistResponse object | array of NyquistResponse objects

Model — Dynamic system dynamic system model | model array

FrequencySpec — Frequencies {wmin,wmax} | vector | []

Name — Response name string | character vector

Visible — Response visibility "on" (default) | on/off logical value

LegendDisplay — Option to list response in legend "on" (default) | on/off logical value

MarkerStyle — Marker style "none" | "o" | "+" | "*" | "." | ...

MarkerStyleMode — Marker style selection mode "auto" (default) | "manual"

Dependencies

Color — Plot color RGB triplet | hexadecimal color code | color name

ColorMode — Color selection mode "auto" (default) | "manual"

Dependencies

LineStyle — Line style "-" | "--" | ":" | "-."

LineStyleMode — Line style selection mode "auto" (default) | "manual"

Dependencies

MarkerSize — Marker size positive scalar

LineWidth — Line width positive scalar

SeriesIndex — Series index positive integer | "none"

SeriesIndexMode — Series index specification mode "auto" (default) | "manual"

Dependencies

Characteristics — Response characteristics CharacteristicsManager object

PeakResponse — Visibility of peak response CharacteristicOption object

Visible — Peak response visibility "off" (default) | on/off logical value

AllStabilityMargins — Visibility of all stability margins CharacteristicOption object

Visible — Margin visibility "off" (default) | on/off logical value

MinimumStabilityMargins — Visibility of minimum stability margins CharacteristicOption object

Visible — Margin visibility "off" (default) | on/off logical value

ConfidenceRegion — Confidence region CharacteristicOption object

Visible — Confidence region visibility "off" (default) | on/off logical value

DisplaySampling — Frequency spacing of confidence ellipses 5 (default) | positive integer

NumberOfStandardDeviations — Number of standard deviations 1 (default) | positive scalar

Dependencies

ShowNegativeFrequencies — Option to show response for negative frequencies "on" (default) | on/off logical value

Units

FrequencyUnit — Frequency units "Hz" | "rad/s" | "rpm" | ...

Dependencies

FrequencyUnitMode — Frequency unit selection mode "auto" (default) | "manual"

Dependencies

MagnitudeUnit — Magnitude units "dB" | "abs"

Dependencies

PhaseUnit — Phase units "deg" | "rad"

Dependencies

Inputs and Outputs

InputLabels — Input label text and style AxesLabel object | array of AxesLabel objects

String — Text value string | character vector

FontSize — Font size positive scalar

Dependencies

FontWeight — Character thickness "bold" | "normal"

Dependencies

FontAngle — Character slant "normal" | "italic"

Dependencies

FontName — Font name string | character vector

Color — Text color [0.1294 0.1294 0.1294] (default) | RGB triplet | hexadecimal color code | color name

Interpreter — Text interpreter "tex" (default) | "latex" | "none"

OutputLabels — Output label text and style AxesLabel object | array of AxesLabel objects

String — Text value string | character vector

FontSize — Font size positive scalar

Dependencies

FontWeight — Character thickness "bold" | "normal"

Dependencies

FontAngle — Character slant "normal" | "italic"

Dependencies

FontName — Font name string | character vector

Color — Text color [0.1294 0.1294 0.1294] (default) | RGB triplet | hexadecimal color code | color name

Interpreter — Text interpreter "tex" (default) | "latex" | "none"

InputVisible — Option to display inputs on/off logical value | array of on/off logical values

OutputVisible — Option to display outputs on/off logical value | array of on/off logical values

IOGrouping — Grouping of input and output pairs "none" (default) | "inputs" | "outputs" | "all"

Labels

Title — Title text and style AxesLabel object

String — Text value string | character vector

FontSize — Font size positive scalar

Dependencies

FontWeight — Character thickness "bold" | "normal"

Dependencies

FontAngle — Character slant "normal" | "italic"

Dependencies

FontName — Font name string | character vector

`Responses` — Model responses
`NyquistResponse` object | array of `NyquistResponse` objects

`Model` — Dynamic system
dynamic system model | model array

`FrequencySpec` — Frequencies
`{wmin,wmax}` | vector | `[]`

`Name` — Response name
string | character vector

`Visible` — Response visibility
`"on"` (default) | on/off logical value

`LegendDisplay` — Option to list response in legend
`"on"` (default) | on/off logical value

`MarkerStyle` — Marker style
`"none"` | `"o"` | `"+"` | `"*"` | `"."` | ...

`MarkerStyleMode` — Marker style selection mode
`"auto"` (default) | `"manual"`

`Color` — Plot color
RGB triplet | hexadecimal color code | color name

`ColorMode` — Color selection mode
`"auto"` (default) | `"manual"`

`LineStyle` — Line style
`"-"` | `"--"` | `":"` | `"-."`

`LineStyleMode` — Line style selection mode
`"auto"` (default) | `"manual"`

`MarkerSize` — Marker size
positive scalar

`LineWidth` — Line width
positive scalar

`SeriesIndex` — Series index
positive integer | `"none"`

`SeriesIndexMode` — Series index specification mode
`"auto"` (default) | `"manual"`

`Characteristics` — Response characteristics
`CharacteristicsManager` object

`PeakResponse` — Visibility of peak response
`CharacteristicOption` object

`Visible` — Peak response visibility
`"off"` (default) | on/off logical value

`AllStabilityMargins` — Visibility of all stability margins
`CharacteristicOption` object

`Visible` — Margin visibility
`"off"` (default) | on/off logical value

`MinimumStabilityMargins` — Visibility of minimum stability margins
`CharacteristicOption` object

`Visible` — Margin visibility
`"off"` (default) | on/off logical value

`ConfidenceRegion` — Confidence region
`CharacteristicOption` object

`Visible` — Confidence region visibility
`"off"` (default) | on/off logical value

`DisplaySampling` — Frequency spacing of confidence ellipses
`5` (default) | positive integer

`NumberOfStandardDeviations` — Number of standard deviations
`1` (default) | positive scalar

`ShowNegativeFrequencies` — Option to show response for negative frequencies
`"on"` (default) | on/off logical value

`FrequencyUnit` — Frequency units
`"Hz"` | `"rad/s"` | `"rpm"` | ...

`FrequencyUnitMode` — Frequency unit selection mode
`"auto"` (default) | `"manual"`

`MagnitudeUnit` — Magnitude units
`"dB"` | `"abs"`

`PhaseUnit` — Phase units
`"deg"` | `"rad"`

`InputLabels` — Input label text and style
`AxesLabel` object | array of `AxesLabel` objects

`String` — Text value
string | character vector

`FontSize` — Font size
positive scalar

`FontWeight` — Character thickness
`"bold"` | `"normal"`

`FontAngle` — Character slant
`"normal"` | `"italic"`

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

`OutputLabels` — Output label text and style
`AxesLabel` object | array of `AxesLabel` objects

`String` — Text value
string | character vector

`FontSize` — Font size
positive scalar

`FontWeight` — Character thickness
`"bold"` | `"normal"`

`FontAngle` — Character slant
`"normal"` | `"italic"`

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

`InputVisible` — Option to display inputs
on/off logical value | array of on/off logical values

`OutputVisible` — Option to display outputs
on/off logical value | array of on/off logical values

`IOGrouping` — Grouping of input and output pairs
`"none"` (default) | `"inputs"` | `"outputs"` | `"all"`

`Title` — Title text and style
`AxesLabel` object

`String` — Text value
string | character vector

`FontSize` — Font size
positive scalar

`FontWeight` — Character thickness
`"bold"` | `"normal"`

`FontAngle` — Character slant
`"normal"` | `"italic"`

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

`Subtitle` — Subtitle text and style
`AxesLabel` object

`String` — Text value
string | character vector

`FontSize` — Font size
positive scalar

`FontWeight` — Character thickness
`"bold"` | `"normal"`

`FontAngle` — Character slant
`"normal"` | `"italic"`

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

`XLabel` — X-axis label text and style
`AxesLabel` object

`String` — Text value
string | character vector

`FontSize` — Font size
positive scalar

`FontWeight` — Character thickness
`"bold"` | `"normal"`

`FontAngle` — Character slant
`"normal"` | `"italic"`

`FontName` — Font name
string | character vector

`Color` — Text color
`[0.1294 0.1294 0.1294]` (default) | RGB triplet | hexadecimal color code | color name

`Interpreter` — Text interpreter
`"tex"` (default) | `"latex"` | `"none"`

`YLabel` — Y-axis label text and style
`AxesLabel` object

`String` — Text value
string | character vector

`FontSize` — Font size
positive scalar

`FontWeight` — Character thickness
`"bold"` | `"normal"`

`FontAngle` — Character slant
`"normal"` | `"italic"`