从命令行定制响应图- MATLAB & Simulink - 卡塔尔世界杯8强比赛直播

从命令行定制响应图

从命令行自定义情节概述

何时从命令行自定义情节

您可以从命令行自定义任何响应图。命令行是定制大量图的最有效方式。例如，如果您有一个生成许多图的批作业，您可以更改x-轴单元自动为所有的情节，只需几行代码。

如何从命令行自定义情节

您可以使用控制系统工具箱™应用程序程序接口(API)从命令行为响应图定制绘图选项。

请注意

本节假设您对MATLAB有非常基本的熟悉^®图形对象。有关更多信息，请参见图形对象。

从命令行自定义情节:

获得情节处理，它是绘图的标识符，使用API的绘图语法。
例如,
```
h = stepplot(系统)
```
返回剧情句柄h对于步进图。
有关获取情节句柄的更多信息，请参见获得情节处理。
获得情节选项处理，它是所有可设置的情节选项的标识符。要获取给定情节的情节选项句柄，请键入
```
p = getoptions (h);
```
p是否为plot句柄的plot选项句柄h。
有关获取情节选项句柄的更多信息，请参见获取情节选项句柄。
使用setoption，以及绘图手柄和绘图选项手柄，来访问和修改许多绘图选项。

请注意

你也可以使用setoption使用属性/值对而不是plot选项句柄自定义plot。使用属性/值对将过程缩短到一行代码。

从命令行更改Bode Plot Units

打开生活的脚本

这个例子展示了如何将波德图的单位从rad/s改为Hz。

创建一个系统，生成系统响应的波德图。该图使用默认单位rad/s。

Sys = tf(4，[1 0.5 4]);h = bodeplot(系统);

图中包含2个轴对象。坐标轴对象1包含一个类型为line的对象。该对象表示sys。axis对象2包含一个类型为line的对象。该对象表示sys。

的bodeplot命令返回一个plot句柄，你可以用它来改变plot的属性。

将单位改为Hz。

p = getoptions (h);p.FreqUnits =“赫兹”;setoption (h p)

图中包含2个轴对象。坐标轴对象1包含一个类型为line的对象。该对象表示sys。axis对象2包含一个类型为line的对象。该对象表示sys。

x轴标签更新，以反映单位的变化。

有关从命令行定制图的更多示例，请参见从命令行自定义情节的例子。

获得情节处理

要以编程方式与响应图交互，您需要情节处理。此句柄是响应图对象的标识符。因为控制系统工具箱的绘图命令，波德,rlocus等等，都在内部使用绘图句柄，这个API提供了一组命令，显式地将句柄返回到您的响应图。这些函数都以“plot”结尾，这使得它们很容易识别。下表列出了这些函数。

返回Plot句柄的函数

函数	情节
`bodeplot`	波德量级和相位
`hsvplot`	汉克尔奇异值
`impulseplot`	脉冲响应
`initialplot`	初始条件
`iopzplot`	输入/输出对的极点/零映射
`lsimplot`	对任意输入的时间响应
`nicholsplot`	尼科尔斯图
`nyquistplot`	尼奎斯特
`pzplot`	极/零
`rlocusplot`	根轨迹
`sigmaplot`	频率响应的奇异值
`stepplot`	阶跃响应

要获得任何响应图的图句柄，请使用表中的函数。例如,

h = bodeplot(系统)

返回图处理h(它也会渲染Bode图)。一旦你有了这个句柄，你就可以使用setoption和getoptions方法的情节对象，在本例中，一个博德情节句柄。

获取情节选项句柄

Plot Options句柄的概述

一旦你掌握了剧情，你就需要情节选项处理，它是给定响应图的所有可设置的plot属性的标识符。有两种方法可以创建一个plot选项句柄:

检索句柄-使用getoptions得到手柄。
创建句柄-使用< responseplot >选项实例化句柄。看到用于创建情节选项句柄的函数获取完整的列表。

检索处理

的getoptions函数从一个情节句柄中检索一个情节选项句柄。

p=getoptions(h) %返回情节句柄h的情节选项句柄p。

如果你指定一个属性名作为输入参数，getoptions返回与属性名关联的属性值。

property_value=getoptions(h,PropertyName) %返回属性%值。

创建一个处理

可以使用形式的函数来创建默认的plot选项句柄

< responseplot >选项

例如,

p = bodeoptions;

实例化Bode情节的句柄。看到属性和值参考的默认值列表。

如果您想将默认值设置为“控制系统工具箱”的默认值，请传递cstprefs的函数。例如,

p = bodeoptions(“cstprefs”);

将Bode plot属性/值对设置为控制系统工具箱的默认值。

该表列出了创建plot选项句柄的函数。

用于创建情节选项句柄的函数

函数	创建的情节选项句柄类型
`bodeoptions`	兆相和量级
`hsvoptions`	汉克尔奇异值
`nicholsoptions`	尼科尔斯图
`nyquistoptions`	奈奎斯特图
`pzoptions`	极/零情节
`sigmaoptions`	西格玛(奇异值)图
`timeoptions`	时间响应(冲量、步数等)

哪些属性可以修改?

使用

帮助< responseplot >选项

查看可修改的可用属性值对列表。例如,

帮助bodeoptions

您可以使用setoption。下一个主题提供了修改各种响应图的例子。

看到属性和值参考获取响应图的属性/值对的完整列表。

从命令行自定义情节的例子

操纵情节选项手柄

有两种操作plot选项句柄的基本方法:

点表示法-把句柄当成MATLAB结构。
属性值对-显式指定属性/值对作为的输入参数setoption。

对于一些例子，点表示法和属性/值对方法都展示了。对于所有的例子，使用

Sys = tf(1，[1 1]);

变化的情节单元

将波德图的频率单位从rad/s改为Hz。为此，提取选项p从情节句柄，编辑选项，并将它们分配回情节。

h = bodeplot(系统);p = getoptions (h);p.FreqUnits =“赫兹”;setoption (h p)

或者，代替提取p，设置选项h直接。

setoption (h,“FreqUnits”,“赫兹”)

使用现有的情节选项句柄创建情节

你可以使用一个现有的情节选项句柄来自定义第二个情节:

h1 = bodeplot(系统);p1 = getoptions (h1);h2 = bodeplot (sys, p1);

或

h1 = bodeplot(系统);h2 = bodeplot (sys2);setoption (h2, getoptions (h1))

创建一个默认的Plot Options句柄

用下面的代码实例化一个plot options句柄。

p = bodeoptions;

更改频率单位，并将更改应用于sys。

p.FreqUnits =“赫兹”;h = bodeplot (sys, p);

像结构一样使用点符号

你总是可以使用点表示法来为属性赋值，并一次更改多个plot属性。

h1 = bodeplot(系统);p1 = getoptions (h1);p1。FreqUnits =“赫兹”;p1.Title。字符串=“我的名字”;setoption (h1, p1)

设置setoptions中的属性对

而不是使用点表示法，指定频率单位作为属性/值对setoption。

H1 = bodeplot(sys) setoptions(H1，“FreqUnits”,“赫兹”)

验证单位已经从rad/s变为Hz。

getoptions (h1,“FreqUnits”)%返回频率单位为h1。

ans =赫兹

属性和值参考

所有响应图通用的属性/值对

下表讨论了所有响应图共有的属性/值对。

标题

财产	默认值	描述
`标题。字符串`	没有一个	情节标题，如`“我的响应图”`。
`标题。字形大小`	8	`双`
`标题。FontWeight`	正常的	`[light \| normal \| demi]`
`标题。FontAngle`	正常的	`[正常\|斜体\|斜体]`
`标题。颜色`	(0 0 0)	`1×3 RGB向量`

X标签

财产	默认值	描述
`包含。字符串`	没有一个	x轴标签，如`输入频率的`。
`包含。字形大小`	8	`双`
`包含。FontWeight`	正常的	`[light \| normal \| demi]`
`包含。FontAngle`	正常的	`[正常\|斜体\|斜体]`
`包含。颜色`	(0 0 0)	`1×3 RGB向量`

Y标签

财产	默认值	描述
`YLabel。字符串`	没有一个	y轴标签，如`控制信号幅度的`。
`Ylabel。字形大小`	8	`双`
`Ylabel。FontWeight`	正常的	`[light \| normal \| demi]`
`YLabel。FontAngle`	正常的	`[正常\|斜体\|斜体]`
`Ylabel。颜色`	(0 0 0)	`1×3 RGB向量`

蜱虫的标签

财产	默认值	描述
`TickLabel。字形大小`	8	`双`
`TickLabel。FontWeight`	正常的	`[light \| normal \| demi]`
`TickLabel。FontAngle`	正常的	`[正常\|斜体\|斜体]`
`Ticklabel。颜色`	(0 0 0)	`1×3 RGB向量`

网格和轴限

财产	默认值	描述
`网格`	`从`	`(\|关闭)`
`Xlim`	`{[]}`	一个1 × 2的双精度单元格数组，指定x设在限制时`XLimMode`设置为manual。当`XLim`为标量，应用标量展开;否则，单元格数组的长度必须等于图的列数(即系统输入的数量)。1 × 2的双精度必须是一个严格递增的对`[xmin, xmax]`。
`XLimMode`	`{'汽车'}`	一个单元格数组，其中每个条目是`“汽车”`或`“手动”`。这些条目指定x-axis限制相应轴的模式。当`XLimMode`设置为手动，则限制设置为`XLim`。当`XLim`为标量，应用标量展开;否则，单元格数组的长度必须等于图的列数(即系统输入的数量)。
`YLim`	`{[]}`	一个1 × 2的双精度单元格数组指定y设在限制时`YLimMode`设置为manual。当`YLim`为标量，应用标量展开;否则，单元格数组的长度必须等于图的行数(即系统输出的数量)。1 × 2的双精度必须是一个严格递增的对[`ymin ymax]`。
`YLimMode`	`{'汽车'}`	一个单元格数组，其中每个条目是`“汽车”`或`“手动”`。这些条目指定y-axis限制相应轴的模式。当`YLimMode`设置为手动，则限制设置为`YLim`。当`YLim`为标量，应用标量展开;否则，单元格数组的长度必须等于图的行数(即系统输出的数量)。

I / O分组

财产	默认值	描述
`IOGrouping`	没有一个	`[none \| input \| output \| all]` 为响应指定输入/输出分组。

财产

默认值

描述

IOGrouping

没有一个

[none | input | output | all]

为响应指定输入/输出分组。

输入标签

财产	默认值	描述
`的inputlabel。字形大小`	8	`双`
`的inputlabel。FontWeight`	正常的	`[light \| normal \| demi]`
`的inputlabel。FontAngle`	正常的	`[正常\|斜体\|斜体]`
`的inputlabel。颜色`	(0 0 0)	`1×3 RGB向量`

输出标签

财产	默认值	描述
`OutputLabel。字形大小`	8	`双`
`OutputLabels。FontWeight`	正常的	`[light \| normal \| demi]`
`OutputLabels。FontAngle`	正常的	`[正常\|斜体\|斜体]`
`OutputLabels。颜色`	(0 0 0)	`1×3 RGB向量`

输入/输出可见

财产	默认值	描述
`InputVisible`	在{}	`(\|关闭)` 一个单元格数组，指定每个输入通道的可见性。如果值是标量，则应用标量展开。
`OutputVisible`	在{}	`(\|关闭)` 指定每个输出通道可见性的单元格数组。如果值是标量，则应用标量展开。

财产

默认值

描述

InputVisible

在{}

(|关闭)

一个单元格数组，指定每个输入通道的可见性。如果值是标量，则应用标量展开。

OutputVisible

在{}

(|关闭)

指定每个输出通道可见性的单元格数组。如果值是标量，则应用标量展开。

波德图

财产	默认值	描述
`FreqUnits`	`rad /秒`	可用选项 `“赫兹”` `“rad / s”` `“转”` `“赫兹”` `“兆赫”` `“GHz”` `“rad /纳秒”` `rad /微秒的` `的rad /毫秒` `的rad /分钟` `“rad /小时”` `rad /天的` `“rad /周”` `“rad /月”` `“rad /年”` `“周期/纳秒”` `的周期/微秒` `的周期/毫秒` `“周期/小时”` `“周期/天”` `“周期/周”` `“周期/月”` `“周期/年”`
`FreqScale`	`日志`	`(线性\|日志)`
`MagUnits`	`dB`	`(db \| abs)`
`MagScale`	`线性`	`(线性\|日志)`
`PhaseUnits`	`度`	`(rad \|度)`
`PhaseWrapping`	`从`	`(\|关闭)` 当您设置`PhaseWrapping`来`“上”`，情节以指定的值包装累积阶段`PhaseWrappingBranch`财产。
`PhaseWrappingBranch`	-180年	`双` 阶段值，在该阶段的情节包装累积阶段时`PhaseWrapping`被设置为`“上”`
`MagVisible`	`在`	`(\|关闭)`
`PhaseVisible`	`在`	`(\|关闭)`
`MagLowerLimMode`	`汽车`	`(汽车\|手册)` 启用手动低震级限制规格通过`MagLowerLim`。
`MagLowerLim`	0	`双` 当`MagLowerLimMode`被设置为`手册`。
`PhaseMatching`	`从`	`(\|关闭)` 启用调整相位响应的相位效果。
`PhaseMatchingFreq`	0	`双`
`PhaseMatchingValue`	0	`双`

汉克尔奇异值

财产	默认值	描述
`Yscale`	`线性`	`(线性\|日志)`
`AbsTol`	`0`	`双` 看到`hsvd`和`stabsep`获取详细信息。
`RelTol`	`1 * e-08`	`双` 看到`hsvd`和`stabsep`获取详细信息。
`抵消`	`1 * e-08`	`双` 看到`hsvd`和`stabsep`获取详细信息。

尼科尔斯情节

财产	默认值	描述
`FreqUnits`	`rad /秒`	可用选项 `“赫兹”` `“rad / s”` `“转”` `“赫兹”` `“兆赫”` `“GHz”` `“rad /纳秒”` `rad /微秒的` `的rad /毫秒` `的rad /分钟` `“rad /小时”` `rad /天的` `“rad /周”` `“rad /月”` `“rad /年”` `“周期/纳秒”` `的周期/微秒` `的周期/毫秒` `“周期/小时”` `“周期/天”` `“周期/周”` `“周期/月”` `“周期/年”`
`MagUnits`	`dB`	`(dB \| abs)`
`PhaseUnits`	`度`	`(rad \|度)`
`MagLowerLimMode`	`汽车`	`(汽车\|手册)`
`MagLowerLim`	`0`	双
`PhaseWrapping`	`从`	`(\|关闭)` 当您设置`PhaseWrapping`来`“上”`，情节以指定的值包装累积阶段`PhaseWrappingBranch`财产。
`PhaseWrappingBranch`	-180年	双阶段值，在该阶段的情节包装累积阶段时`PhaseWrapping`被设置为`“上”`
`PhaseMatching`	从	(\|关闭)
`PhaseMatchingFreq`	0	双
`PhaseMatchingValue`	0	双

奈奎斯特图

财产	默认值	描述
`FreqUnits`	`rad /秒`	可用选项 `“赫兹”` `“rad / s”` `“转”` `“赫兹”` `“兆赫”` `“GHz”` `“rad /纳秒”` `rad /微秒的` `的rad /毫秒` `的rad /分钟` `“rad /小时”` `rad /天的` `“rad /周”` `“rad /月”` `“rad /年”` `“周期/纳秒”` `的周期/微秒` `的周期/毫秒` `“周期/小时”` `“周期/天”` `“周期/周”` `“周期/月”` `“周期/年”`
`MagUnits`	`dB`	`(dB \| abs)`
`PhaseUnits`	`度`	`(rad \|度)`
`ShowFullContour`	`在`	`(\|关闭)`

极/零地图

财产	默认值	描述
`FreqUnits`	`rad /秒`	可用选项 `“赫兹”` `“rad / s”` `“转”` `“赫兹”` `“兆赫”` `“GHz”` `“rad /纳秒”` `rad /微秒的` `的rad /毫秒` `的rad /分钟` `“rad /小时”` `rad /天的` `“rad /周”` `“rad /月”` `“rad /年”` `“周期/纳秒”` `的周期/微秒` `的周期/毫秒` `“周期/小时”` `“周期/天”` `“周期/周”` `“周期/月”` `“周期/年”`
`TimeUnits`	`秒`	可用选项 `“纳秒”` `微秒的` `的毫秒` `“秒”` `“分钟”` `“小时”` `“天”` `“周”` `“月”` `“年”`

σ情节

财产	默认值	描述
`FreqUnits`	`rad /秒`	可用选项 `“赫兹”` `“rad / s”` `“转”` `“赫兹”` `“兆赫”` `“GHz”` `“rad /纳秒”` `rad /微秒的` `的rad /毫秒` `的rad /分钟` `“rad /小时”` `rad /天的` `“rad /周”` `“rad /月”` `“rad /年”` `“周期/纳秒”` `的周期/微秒` `的周期/毫秒` `“周期/小时”` `“周期/天”` `“周期/周”` `“周期/月”` `“周期/年”`
`FreqScale`	`日志`	`(线性\|日志)`
`MagUnits`	`dB`	`(dB \| abs)`
`MagScale`	`线性`	`(线性\|日志)`

时间响应图

财产	默认值	描述
`正常化`	`从`	`(\|关闭)` 规范化的y-情节中所有反应的尺度。
`SettleTimeThreshold`	`0.02`	`双` 沉淀时间阈值。`0.02 = 2%`。
`RiseTimeLimits`	`[0.1, 0.9]`	`1×2双` 用于定义上升时间的限制。`[0.1, 0.9]`为10%至90%。
`TimeUnits`	`秒`	可用选项 `“纳秒”` `微秒的` `的毫秒` `“秒”` `“分钟”` `“小时”` `“天”` `“周”` `“月”` `“年”`