主要内容

nyquistoptions

创建奈奎斯特情节选项列表

描述

使用nyquistoptions命令创建一个NyquistPlotOptions对象来自定义您的Nyquist情节外观。您还可以使用该命令覆盖MATLAB中的绘图首选项设置®会话中创建奈奎斯特图。

创建

描述

例子

plotoptions= nyquistoptions控件使用的默认绘图选项集nyquistplot命令。您可以使用这些选项使用命令行自定义Nyquist图的外观。当您想要编写脚本以生成看起来相同的图,而不管运行脚本的MATLAB会话的首选项设置如何时,此语法非常有用。

例子

plotoptions= nyquistoptions(“cstprefs”)使用您在“控制系统工具箱™”和“系统标识工具箱™首选项编辑器”中选择的选项初始化绘图选项。有关编辑器的更多信息,请参见工具箱首选项编辑器.当您希望更改一些绘图选项但在其他情况下使用默认首选项时,此语法非常有用。使用此语法的脚本在具有不同首选项的会话中运行时,可能会生成不同的结果。

属性

全部展开

频率单位,指定为以下值之一:

  • “赫兹”

  • “rad /秒”

  • “转”

  • “赫兹”

  • “兆赫”

  • “GHz”

  • “rad /纳秒”

  • rad /微秒的

  • 的rad /毫秒

  • 的rad /分钟

  • “rad /小时”

  • rad /天的

  • “rad /周”

  • “rad /月”

  • “rad /年”

  • “周期/纳秒”

  • 的周期/微秒

  • 的周期/毫秒

  • “周期/小时”

  • “周期/天”

  • “周期/周”

  • “周期/月”

  • “周期/年”

量级单位,指定为dB“或绝对值”腹肌”。

相位单位,指定为'或'rad,分别改为角度或弧度。

切换显示负频率的响应,指定为'或'”。

用于绘制置信区域的标准差数,指定为一个标量。这只适用于已识别的模型。

置信度椭圆的频率间距,用于绘制作为标量指定的置信度区域。这只适用于已识别的模型。默认值为5,这意味着每5个频率样本都显示置信椭圆

输入输出(I/O)对的分组,指定为以下之一:

  • 没有一个-没有输入输出分组。

  • 输入-只对输入进行分组。

  • 输出-只对输出进行分组。

  • 所有—将所有I/O对分组。

输入标签样式,指定为具有以下字段的结构:

  • 字形大小-字体大小,指定为大于零的标量值。默认字体大小取决于特定的操作系统和地区。一分等于1/72英寸。

  • FontWeight-字符厚度,指定为'正常的'或'大胆的”。MATLAB使用FontWeight属性从系统上可用的字体中选择一种字体。并非所有字体都有粗体权重。因此,指定粗体字体权重仍然可以得到正常字体权重。

  • FontAngle-字符倾斜,指定为'正常的'或'斜体”。不是所有字体都有两种字体样式。因此,斜体字体看起来可能与正常字体相同。

  • 颜色-文本颜色,指定为RGB三元组。默认的颜色是深灰色和RGB三联(0.4, 0.4, 0.4)

  • 翻译-文本解释器,指定为以下值之一:

    • 特克斯' -使用TeX标记的子集解释字符。的默认值翻译

    • 乳胶-使用LaTeX标记解释字符。

    • 没有一个-显示文字字符。

输出标签样式,指定为具有以下字段的结构:

  • 字形大小-字体大小,指定为大于零的标量值。默认字体大小取决于特定的操作系统和地区。一分等于1/72英寸。

  • FontWeight-字符厚度,指定为'正常的'或'大胆的”。MATLAB使用FontWeight属性从系统上可用的字体中选择一种字体。并非所有字体都有粗体权重。因此,指定粗体字体权重仍然可以得到正常字体权重。

  • FontAngle-字符倾斜,指定为'正常的'或'斜体”。不是所有字体都有两种字体样式。因此,斜体字体看起来可能与正常字体相同。

  • 颜色-文本颜色,指定为RGB三元组。默认的颜色是深灰色和RGB三联(0.4, 0.4, 0.4)

  • 翻译-文本解释器,指定为以下值之一:

    • 特克斯' -使用TeX标记的子集解释字符。的默认值翻译

    • 乳胶-使用LaTeX标记解释字符。

    • 没有一个-显示文字字符。

切换输入的显示,指定为两者之一{'在'}{‘off’}或者一个包含多个元素的单元格数组。

切换输出的显示,指定为两者之一{'在'}{‘off’}或者一个包含多个元素的单元格数组。

标题文本和样式,指定为具有以下字段的结构:

  • 字符串-标签文本,指定为字符向量。默认情况下,情节是有标题的“波德图”

  • 字形大小-字体大小,指定为大于零的标量值。默认字体大小取决于特定的操作系统和地区。一分等于1/72英寸。

  • FontWeight-字符厚度,指定为'正常的'或'大胆的”。MATLAB使用FontWeight属性从系统上可用的字体中选择一种字体。并非所有字体都有粗体权重。因此,指定粗体字体权重仍然可以得到正常字体权重。

  • FontAngle-字符倾斜,指定为'正常的'或'斜体”。不是所有字体都有两种字体样式。因此,斜体字体看起来可能与正常字体相同。

  • 颜色-文本颜色,指定为RGB三元组。默认颜色是由RGB三元组指定的黑色[0,0,0]

  • 翻译-文本解释器,指定为以下值之一:

    • 特克斯' -使用TeX标记的子集解释字符。的默认值翻译

    • 乳胶-使用LaTeX标记解释字符。

    • 没有一个-显示文字字符。

x轴标签文本和样式,指定为具有以下字段的结构:

  • 字符串-标签文本,指定为字符向量。默认情况下,轴是有标题的实轴

  • 字形大小-字体大小,指定为大于零的标量值。默认字体大小取决于特定的操作系统和地区。一分等于1/72英寸。

  • FontWeight-字符厚度,指定为'正常的'或'大胆的”。MATLAB使用FontWeight属性从系统上可用的字体中选择一种字体。并非所有字体都有粗体权重。因此,指定粗体字体权重仍然可以得到正常字体权重。

  • FontAngle-字符倾斜,指定为'正常的'或'斜体”。不是所有字体都有两种字体样式。因此,斜体字体看起来可能与正常字体相同。

  • 颜色-文本颜色,指定为RGB三元组。默认颜色是由RGB三元组指定的黑色[0,0,0]

  • 翻译-文本解释器,指定为以下值之一:

    • 特克斯' -使用TeX标记的子集解释字符。的默认值翻译

    • 乳胶-使用LaTeX标记解释字符。

    • 没有一个-显示文字字符。

y轴标签文本和样式,指定为具有以下字段的结构:

  • 字符串-标签文本,指定为字符向量的单元格数组。默认情况下,轴是有标题的虚轴

  • 字形大小-字体大小,指定为大于零的标量值。默认字体大小取决于特定的操作系统和地区。一分等于1/72英寸。

  • FontWeight-字符厚度,指定为'正常的'或'大胆的”。MATLAB使用FontWeight属性从系统上可用的字体中选择一种字体。并非所有字体都有粗体权重。因此,指定粗体字体权重仍然可以得到正常字体权重。

  • FontAngle-字符倾斜,指定为'正常的'或'斜体”。不是所有字体都有两种字体样式。因此,斜体字体看起来可能与正常字体相同。

  • 颜色-文本颜色,指定为RGB三元组。默认颜色是由RGB三元组指定的黑色[0,0,0]

  • 翻译-文本解释器,指定为以下值之一:

    • 特克斯' -使用TeX标记的子集解释字符。的默认值翻译

    • 乳胶-使用LaTeX标记解释字符。

    • 没有一个-显示文字字符。

勾号标签样式,指定为具有以下字段的结构:

  • 字形大小-字体大小,指定为大于零的标量值。默认字体大小取决于特定的操作系统和地区。一分等于1/72英寸。

  • FontWeight-字符厚度,指定为'正常的'或'大胆的”。MATLAB使用FontWeight属性从系统上可用的字体中选择一种字体。并非所有字体都有粗体权重。因此,指定粗体字体权重仍然可以得到正常字体权重。

  • FontAngle-字符倾斜,指定为'正常的'或'斜体”。不是所有字体都有两种字体样式。因此,斜体字体看起来可能与正常字体相同。

  • 颜色-文本颜色,指定为RGB三元组。默认颜色是由RGB三元组指定的黑色[0,0,0]

切换图上的网格显示,指定为'或'”。

网格线的颜色,指定为RGB三元组。默认颜色是由RGB三元组指定的浅灰色(0.15, 0.15, 0.15)

x轴限制的选择模式,指定为以下值之一:

  • 汽车-启用自动限制选择,这是基于绘制数据的总跨度。

  • 手册-手动指定轴的限制。要指定轴限制,请设置XLim财产。

y轴限制的选择模式,指定为以下值之一:

  • 汽车-启用自动限制选择,这是基于绘制数据的总跨度。

  • 手册-手动指定轴的限制。要指定轴限制,请设置YLim财产。

x轴限制,指定为形式的双元素向量的单元格数组(最小,最大)

y轴限制,指定为形式的双元素向量的单元格数组(最小,最大)

对象的功能

nyquistplot 奈奎斯特情节与额外的情节定制选项

例子

全部折叠

对于本例,使用plot句柄将相位单位更改为弧度并打开网格。

生成一个包含5个状态的随机状态空间模型,并创建带有plot句柄的Nyquist图h

rng (“默认”sys = rss(5);H = nyquistplot(sys);

图中包含一个axes对象。axis对象包含一个类型为line的对象。该节点表示sys。

将相位单位更改为弧度并打开网格。为此,编辑plot句柄的属性,h使用setoption

setoption (h,“PhaseUnits”rad的“网格”“上”);

图中包含一个axes对象。axis对象包含一个类型为line的对象。该节点表示sys。

当您调用时,奈奎斯特图会自动更新setoption

或者,您也可以使用nyquistoptions命令指定所需的绘图选项。首先,根据工具箱首选项创建一个选项集。

Plotoptions = nyquistoptions(“cstprefs”);

通过将相位单位设置为弧度并启用网格来更改设置的选项的属性。

plotoptions。PhaseUnits =rad的;plotoptions。网格=“上”;nyquistplot (sys plotoptions);

图中包含一个axes对象。axis对象包含一个类型为line的对象。该节点表示sys。

您可以使用相同的选项集以相同的自定义创建多个Nyquist图。根据您自己的工具箱首选项,您获得的图可能与此图不同。仅在本例中显式设置的属性PhaseUnits而且网格,覆盖工具箱首选项。

比较识别的2阶和6阶状态空间模型的频率响应及其1-std每50个频率样本呈现置信区域。

加载识别的模型数据并估计状态空间模型n4sid.然后绘制奈奎斯特图。

负载iddata1Sys1 = n4sid(z1,2);Sys2 = n4sid(z1,6);W = linspace(10,10*pi,256);H = nyquistplot(sys1,sys2,w);

图中包含一个axes对象。标题为From: u1 To: y1的axes对象包含两个类型为line的对象。这些对象表示sys1、sys2。

两个模型的拟合度都在76%左右。然而,sys2其频率响应具有较高的不确定性,尤其接近奈奎斯特频率。要了解这一点,请在显示Nyquist响应的点的子集处显示置信区域。

setoption (h,“ConfidenceRegionDisplaySpacing”, 50岁,...“ShowFullContour”“关闭”);

图中包含一个axes对象。标题为From: u1 To: y1的axes对象包含两个类型为line的对象。这些对象表示sys1、sys2。

要打开置信度区域显示,右键单击绘图并选择特征>置信区域

对于本例,考虑一个具有3个输入、3个输出和3个状态的MIMO状态空间模型。创建一个奈奎斯特图,只显示部分等高线并打开网格。

创建MIMO状态空间模型sys_mimo

J = [8 -3 -3;-3 8 -3;-3 -3 8];F = 0.2*眼(3);A = -j \ f;B = inv(J);C =眼睛(3);D = 0;sys_mimo = ss(A,B,C,D);大小(sys_mimo)
具有3个输出、3个输入和3个状态的状态空间模型。

创建一个带有情节句柄的奈奎斯特情节h和使用getoptions以获取可用选项的列表。

H = nyquistplot(sys_mimo);

图中包含9个轴对象。In(1)包含一个类型为line的对象。该对象表示sys\_mimo。Axes对象2包含一个类型为line的对象。该对象表示sys\_mimo。Axes对象3包含一个类型为line的对象。该对象表示sys\_mimo。In(2)包含一个类型为line的对象。该对象表示sys\_mimo。axis对象5包含一个类型为line的对象。 This object represents sys\_mimo. Axes object 6 contains an object of type line. This object represents sys\_mimo. Axes object 7 with title From: In(3) contains an object of type line. This object represents sys\_mimo. Axes object 8 contains an object of type line. This object represents sys\_mimo. Axes object 9 contains an object of type line. This object represents sys\_mimo.

P = getoptions(h)
p = FreqUnits: 'rad/s' MagUnits: 'dB' PhaseUnits: 'deg' ShowFullContour: 'on' ConfidenceRegionNumberSD: 1 ConfidenceRegionDisplaySpacing: 5 IOGrouping: 'none' InputLabels: [1x1 struct] OutputLabels: [1x1 struct] InputVisible: {3x1 cell} OutputVisible: {3x1 cell} Title: [1x1 struct] XLabel: [1x1 struct] YLabel: [1x1 struct] TickLabel: [1x1 struct] Grid: 'off' GridColor: [0.1500 0.1500 0.1500] XLim: {3x1 cell} YLimMode: {3x1 cell} YLimMode: {3x1 cell}

使用setoption更新情节需要自定义。

setoption (h,“ShowFullContour”“关闭”“网格”“上”);

图中包含9个轴对象。In(1)包含一个类型为line的对象。该对象表示sys\_mimo。Axes对象2包含一个类型为line的对象。该对象表示sys\_mimo。Axes对象3包含一个类型为line的对象。该对象表示sys\_mimo。In(2)包含一个类型为line的对象。该对象表示sys\_mimo。axis对象5包含一个类型为line的对象。 This object represents sys\_mimo. Axes object 6 contains an object of type line. This object represents sys\_mimo. Axes object 7 with title From: In(3) contains an object of type line. This object represents sys\_mimo. Axes object 8 contains an object of type line. This object represents sys\_mimo. Axes object 9 contains an object of type line. This object represents sys\_mimo.

当您调用时,奈奎斯特图会自动更新setoption.对于MIMO模型,nyquistplot生成一个奈奎斯特图数组,每个图显示一个I/O对的频率响应。

在R2012a中介绍