NicholsView Properties
NicholsView
properties control the appearance and behavior of
Nichols plots in standalone open-loop editors.
To create an open-loop editor, use the openloopeditor
function, which creates an OpenLoopEditor
object. When the
ViewType
property of an OpenLoopEditor
object is
"nichols"
, then the View
property is a
NicholsView
object.
To customize the appearance of the Nichols plot, modify the properties of the
NicholsView
object.
ole = openloopeditor(Plant=sys,ViewType="nichols"); ole.View.FrequencyUnit = "Hz";
Response
Response characteristics to display in the plot, specified as a
CharacteristicsManager
object with these properties.
Visibility of peak response in plot, specified as a CharacteristicOption
object with this property.
Peak response visibility, specified as one of these logical on/off values:
"on"
,1
, ortrue
— Display the peak response."off"
,0
, orfalse
— Do not display the peak response.
The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
Visibility of all stability margins, specified as a CharacteristicOption
object with this property.
Margin visibility, specified as one of these logical on/off values:
"on"
,1
, ortrue
— Display the margins."off"
,0
, orfalse
— Do not display the margins.
The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
Visibility of minimum stability margins, specified as a CharacteristicOption
object with this property.
Margin visibility, specified as one of these logical on/off values:
"on"
,1
, ortrue
— Display the margins."off"
,0
, orfalse
— Do not display the margins.
The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
Option to enable minimum gain for plotting, specified as one of these logical on/off values:
"on"
,1
, ortrue
— Set the minimum gain for plotting to theMinimumGainValue
property value."off"
,0
, orfalse
— Set the minimum gain for plotting automatically based on the system dynamics.
The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
Dependencies
The default minimum-gain configuration depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Minimum gain value for plotting, specified as a scalar.
Dependencies
To apply the minimum gain value, set the
MinimumGainEnabled
property to"on"
.The default minimum-gain configuration depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Dependencies
Units and Scaling
Frequency units, specified as one of these values:
"Hz"
"rad/s"
"rpm"
"kHz"
"MHz"
"GHz"
"rad/nanosecond"
"rad/microsecond"
"rad/millisecond"
"rad/minute"
"rad/hour"
"rad/day"
"rad/week"
"rad/month"
"rad/year"
"cycles/nanosecond"
"cycles/microsecond"
"cycles/millisecond"
"cycles/hour"
"cycles/day"
"cycles/week"
"cycles/month"
"cycles/year"
Dependencies
By default, the response uses the frequency units of the plotted linear system. You can override the default units by specifying toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Magnitude units, specified as one of these values:
"dB"
— Decibels"abs"
— Absolute value
Dependencies
If
MagnitudeScale
is"log"
when you setMagnitudeUnit
to"dB"
, the software automatically changesMagnitudeScale
to"linear"
.The default magnitude units depend on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Magnitude scale, specified as either "log"
or "linear"
.
Dependencies
Setting
MagnitudeScale
to"log"
is not supported whenMagnitudeUnit
is"dB"
.The default magnitude scale depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Phase units, specified as one of these values:
"deg"
— Degrees"rad"
— Radians
Dependencies
The default phase units depend on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Phase Wrapping and Branching
Option to enable phase wrapping, specified as one of these logical on/off values:
"on"
,1
, ortrue
— Enable phase wrapping. The phase shown in the response wraps to remain in the range defined byPhaseWrappingBranch
."off"
,0
, orfalse
— Disable phase wrapping.
The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
Dependencies
The default phase-wrapping configuration depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
When both phase wrapping and phase matching are enabled, the software performs the phase matching followed by the phase wrapping.
Lower limit of phase-wrapping range, specified as a scalar value in degrees. The phase-wrapping range is [B,B+360), where B is equal to PhaseWrappingBranch
.
Dependencies
This value is ignored when
PhaseMatchingEnabled
is"off"
.The default phase-wrapping configuration depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Option to enable phase matching, specified as one of these logical on/off values:
"on"
,1
, ortrue
— Enable phase matching such that the phase response matches the value specified inPhaseMatchingValue
at the frequency specified inPhaseMatchingFrequency
. The remaining phase response shifts to maintain the same phase profile."off"
,0
, orfalse
— Disable phase matching.
The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
Dependencies
When both phase wrapping and phase matching are enabled, the software performs the phase matching followed by the phase wrapping.
Phase matching frequency, specified as a scalar.
Dependencies
This value is ignored when PhaseMatchingEnabled
is "off"
.
Phase matching response value, specified as a scalar.
Dependencies
This value is ignored when PhaseMatchingEnabled
is "off"
.
Title and Axis Labels
Title text and style, specified as an AxesLabel
object with these
properties.
Text value, specified as a string or character vector and stored as a string.
To specify a title with multiple lines, concatenate the lines into a single string using newline
.
myplot.Title.String = "first line" + newline + "second line";
Font size in point units, specified as positive scalar. One point equals 1/72
inch.
Dependencies
The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character thickness, specified as "bold"
or "normal"
.
Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.
Dependencies
The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character slant, specified as "normal"
or "italic"
.
Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.
Dependencies
The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Font name, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts
.
Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.
Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.
Color Name | RGB Triplet | Hexadecimal Color Code |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Text interpreter, specified as one of these values:
"tex"
— Interpret characters using a subset of TeX markup."latex"
— Interpret characters using LaTeX markup."none"
— Display literal characters.
Subtitle text and style, specified as an AxesLabel
object with these
properties.
Text value, specified as a string or character vector and stored as a string.
To specify a subtitle with multiple lines, concatenate the lines into a
single string using newline
.
myplot.Subtitle.String = "first line" + newline + "second line";
Font size in point units, specified as positive scalar. One point equals 1/72
inch.
Dependencies
The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character thickness, specified as "bold"
or "normal"
.
Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.
Dependencies
The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character slant, specified as "normal"
or "italic"
.
Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.
Dependencies
The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Font name, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts
.
Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.
Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.
Color Name | RGB Triplet | Hexadecimal Color Code |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Text interpreter, specified as one of these values:
"tex"
— Interpret characters using a subset of TeX markup."latex"
— Interpret characters using LaTeX markup."none"
— Display literal characters.
X-axis label text and style, specified as an
AxesLabel
object with these properties.
Text value, specified as a string or character vector and stored as a string.
To specify a label with multiple lines, concatenate the lines into a
single string using newline
.
myplot.XLabel.String = "first line" + newline + "second line";
Font size in point units, specified as positive scalar. One point equals
1/72
inch.
Dependencies
The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character thickness, specified as "bold"
or
"normal"
.
Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.
Dependencies
The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character slant, specified as "normal"
or
"italic"
.
Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.
Dependencies
The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Font name, specified as a string or character vector containing the name
of a system-supported font name. The default font depends on the specific
operating system and locale. To view a list of available system fonts, use
listfonts
.
Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.
Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.
Color Name | RGB Triplet | Hexadecimal Color Code |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Text interpreter, specified as one of these values:
"tex"
— Interpret characters using a subset of TeX markup."latex"
— Interpret characters using LaTeX markup."none"
— Display literal characters.
Y-axis label text and style, specified as an
AxesLabel
object with these properties.
Text value, specified as a 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";
Font size in point units, specified as positive scalar. One point equals
1/72
inch.
Dependencies
The default font size depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character thickness, specified as "bold"
or
"normal"
.
Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.
Dependencies
The default font weight depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Character slant, specified as "normal"
or
"italic"
.
Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.
Dependencies
The default font angle depends on the toolbox preferences. For more information, see Specify Toolbox Preferences for Linear Analysis Plots.
Font name, specified as a string or character vector containing the name
of a system-supported font name. The default font depends on the specific
operating system and locale. To view a list of available system fonts, use
listfonts
.
Text color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.
Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.
Color Name | RGB Triplet | Hexadecimal Color Code |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Text interpreter, specified as one of these values:
"tex"
— Interpret characters using a subset of TeX markup."latex"
— Interpret characters using LaTeX markup."none"
— Display literal characters.
Axes Limits
X-axis limits, specified as a two-element vector of the form
[min,max]
, where min
is the minimum axis limit
and max
is the maximum axis limit.
Dependencies
When the
XLimitsMode
property is"auto"
, the X-axis limits are configured automatically based on the system dynamics.
X-axis limit selection mode, specified as one of these strings:
"auto"
— Enable automatic limit selection, which is based on the total span of the plotted data."manual"
— Manually specify the axis limits by setting theXLimits
property.
Dependencies
If you modify the
XLimits
property, theXLimitsMode
value changes to"manual"
.
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 the
YLimitsMode
property is"auto"
, the Y-axis limits are configured automatically based on the system dynamics.
Y-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 theYLimits
property.
Dependencies
If you modify the
YLimits
property, theYLimitsMode
value changes to"manual"
.
Axes Style
Axes style, specified as an AxesStyle
object with these properties.
Axes background color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet.
Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.
Color Name | RGB Triplet | Hexadecimal Color Code |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Option to display axes outline, specified as one of these logical on/off values.
"on"
,1
, ortrue
— Display outline."off"
,0
, orfalse
— Hide outline.
The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState
.
Line width of axes outline and tick marks, specified as a positive scalar value in point units.
Ruler color, specified as an RGB triplet or a hexadecimal color code and stored as an RGB triplet. The ruler color affects axes lines, tick marks, and tick labels.
Alternatively, you can specify some common colors by name. This table lists these colors and their corresponding RGB triplets and hexadecimal color codes.
Color Name | RGB Triplet | Hexadecimal Color Code |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Font size for tick labels in point units, specified as positive scalar. One point equals 1/72
inch.
Character thickness for tick labels, specified as "bold"
or "normal"
.
Not all fonts have a bold weight. Therefore, the bold font might look the same as the normal font.
Character slant for tick labels, specified as "normal"
or "italic"
.
Not all fonts have an italic font styles. Therefore, the italic font might look the same as the normal font.
Font name for tick labels, specified as a string or character vector containing the name of a system-supported font name. The default font depends on the specific operating system and locale. To view a list of available system fonts, use listfonts
.
Option to display grid, specified as one of these logical on/off values.
"on"
,1
, ortrue
— Display grid."off"
,0
, orfalse
— 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.
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 |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Grid line width, specified as a positive scalar in point units.
Grid line style, specified as one of these values.
Line Style | Description |
---|---|
"-" | Solid line |
"--" | Dashed line |
":" | Dotted line |
"-." | Dash-dotted line |
Grid line transparency, specified as a scalar value in the range [0,1], where a smaller value indicates more transparency.
Dependencies
This property is supported for plots of MIMO systems.
Option to display grid labels, specified as one of these logical on/off values.
"on"
,1
, ortrue
— Display grid labels."off"
,0
, orfalse
— 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.
Option to display minor grid lines in plots of MIMO systems, specified as one of these logical on/off values.
"on"
,1
, ortrue
— Display minor grid lines."off"
,0
, orfalse
— 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.
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 |
---|---|---|
| [1 0 0] | #FF0000 |
| [0 1 0] | #00FF00 |
| [0 0 1] | #0000FF |
| [0 1 1] | #00FFFF |
| [1 0 1] | #FF00FF |
| [1 1 0] | #FFFF00 |
| [0 0 0] | #000000 |
| [1 1 1] | #FFFFFF |
Dependencies
This property is supported for plots of MIMO systems.
Width of minor grid lines, specified as a positive scalar in point units.
Dependencies
This property is supported for plots of MIMO systems.
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.
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.
Version History
Introduced in R2025a
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: United States.
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)