PZPlot Properties

Access pole-zero plot properties

Since R2024b

PZPlot properties control the appearance and behavior of pole-zero plots created using pzplot. By changing property values, you can modify certain aspects of the plot.

pzp = pzplot(sys);
pzp.FrequencyUnit = "Hz";

For more information, see Customize Linear Analysis Plots at Command Line.

Response

Responses — Model responses

PZResponse object | array of PZResponse objects

Model responses, specified as a PZResponse 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 PZResponse object has these properties.

SourceData — Source data

structure

Source data for the response, specified as a structure with these fields.

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.

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.

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

MarkerSize — Marker size

positive scalar

Marker size, specified as a positive scalar.

LineWidth — Line width

positive scalar

Line width, specified as a positive scalar.

Characteristics — Response characteristics

[]

Response characteristics, specified as []. Pole-zero plots have no characteristics to display.

Units

TimeUnit — Time units

"seconds" | "milliseconds" | "minutes" | ...

Time units, specified as one of these values:

• "nanoseconds"

• "microseconds"

• "milliseconds"

• "seconds"

• "minutes"

• "hours"

• "days"

• "weeks"

• "months"

• "years"

Dependencies

By default, the response uses the time 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.

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

Title and Axis Labels

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 specify a title with multiple lines, concatenate the lines into a single string using newline.

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

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 Preferences 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 Preferences 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 Preferences 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.

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 specify a subtitle with multiple lines, concatenate the lines into a single string using newline.

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

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 Preferences 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 Preferences 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 Preferences 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.

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 specify a label with multiple lines, concatenate the lines into a single string using newline.

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

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 Preferences 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 Preferences 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 Preferences 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.

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 specify a label with multiple lines, concatenate the lines into a single string using newline.

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

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 Preferences 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 Preferences 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 Preferences 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.

Axes Limits

XLimits — X-axis limits

two-element vector

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 XLimitsMode is "auto", the X-axis limits are configured automatically based on the system dynamics.

XLimitsMode — X-axis limit selection mode

"auto" | "manual"

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 XLimits, the XLimitsMode value changes to "manual".

YLimits — Y-axis limits

two-element vector

Y-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 YLimits is "auto", the Y-axis limits are configured automatically based on the system dynamics.

YLimitsMode — Y-axis limit selection mode

"auto" | "manual"

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 YLimits, the YLimitsMode value changes to "manual".

Axes Style

AxesStyle — Axes style

AxesStyle object

Axes style, specified as an AxesStyle 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 Preferences for Linear Analysis Plots.

GridType — Custom grid type

"default" | "s-plane" | "z-plane"

Custom grid type, specified as one of these values:

• "default" — Select the grid type based on the time-domain of the responses being plotted.

  • All responses are for continuous-time systems, use an s-plane grid.

  • All responses are for discrete-time systems, use a z-plane grid.

  • For a mix of continuous-time and discrete-time responses or when there are no responses, use a Cartesian grid.

• "s-plane" — Use an s-plane grid.

• "z-plane" — Use a z-plane grid.

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.

Dependencies

This property is supported for pole-zero plots with a default grid type and a mix of continuous-time and discrete-time responses.

GridFrequencySpec — Natural frequencies for plotting grid lines

[] | vector of positive values

Natural frequencies for plotting s-plane and z-plane grid lines, specified as a vector of positive values.

If you do not specify natural frequencies:

• s-plane grid lines use values based on the axes limits.

• z-plane grid lines use values from 0 to π/T_s in steps of 0.1*π/T_s, where T_s is the sample time specified using GridSampleTime.

the chart

Dependencies

This property is supported for pole-zero plots with a nondefault grid type or with all responses in the same time domain.

GridDampingSpec — Damping ratios for plotting grid lines

[] | vector of values in the range (0,1)

Damping ratios for plotting s-plane and z-plane grid lines, specified as a vector of values greater than 0 and less than 1.

If you do not specify damping ratios:

• s-plane grid lines use values based on the axes limits.

• z-plane grid lines use values from 0 to 1 in increments of 0.1.

Dependencies

This property is supported for pole-zero plots with a nondefault grid type or with all responses in the same time domain.

GridSampleTime — Sample time of z-plane grid

-1 | positive scalar

Sample time (T_s) of z-plane grid, specified as -1 or a positive scalar. The natural-frequency grid lines depend on the value of T_s.

When GridSampleTime is a positive scalar, then the natural-frequency grid line labels display the actual frequency values.

When GridSampleTime is -1:

• If all responses have the same sample time, then the grid sample time matches that sample time and the natural-frequency grid line labels display the actual frequency values.

• If the sample times of the responses differ or are all -1, then the grid line labels display normalized factors of w_n/T_s.

Dependencies

This property is supported for pole-zero plots with a nondefault grid type or with all responses in the same time domain.

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.

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 pole-zero plots with a default grid type and a mix of continuous-time and discrete-time responses.

• 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 pole-zero plots with a default grid type and a mix of continuous-time and discrete-time responses.

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 pole-zero plots with a default grid type and a mix of continuous-time and discrete-time responses.

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 pole-zero plots with a default grid type and a mix of continuous-time and discrete-time responses.

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 pole-zero plots with a default grid type and a mix of continuous-time and discrete-time responses.

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.

Legend

LegendAxesMode — 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.

LegendAxes — 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.

Dependencies

When LegendAxesMode is "auto", LegendAxes contains the row and column of the northeast visible axis.

LegendVisible — 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.

LegendLocation — Legend location within the axes

"northeast" (default) | "northwest" | "southeast" | "southwest" | "north" | "south" | "east" | "west" | "best"

Legend location within the axes, specified as one of these values:

• "northeast" — Top-right corner

• "northwest" — Top-left corner

• "southeast" — Bottom-left corner

• "southwest" — Bottom-right corner

• "north" — Top

• "south" — Bottom

• "east" — Right side

• "west" — Left side

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

LegendOrientation — 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.

Chart Layout

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

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.

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.

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.

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.

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];

NextPlot — Properties to reset

"replace" (default) | "add"

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

• 'add' — Add new plots to the existing chart. Do not delete existing plots or reset axes properties before displaying the new plot.

• 'replace' — Delete existing plots and reset chart properties, except Position and Units, to their default values before displaying the new plot.

Version History

Introduced in R2024b

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: Toggle visibility of grid labels

You can now control the visibility of the grid labels for PZ plots using the AxesStyle.GridLabelsVisible property. For example, display the grid for a plot and hide the grid labels.

pzp = pzplot(sys);
pzp.AxesStyle.GridVisible = "on";
pzp.AxesStyle.GridLabelsVisible = "off";

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 Pole-Zero Plots
Major grid line style	GridLineStyle	All
Major grid transparency	GridAlpha	Plots with a default grid type and a mix of continuous-time and discrete-time responses
Minor grid visibility	MinorGridVisible
Minor grid color	MinorGridColor
Minor grid line width	MinorGridLineWidth
Minor grid line style	MinorGridLineStyle
Minor grid transparency	MinorGridAlpha
Custom grid type	GridType	All plots
Custom grid damping ratios	GridDampingSpec	Plots with a nondefault grid type or with all responses in the same time domain
Custom grid natural frequencies	GridFrequencySpec
Custom grid sample time	GridSampleTime