从命令行定制响应图
从命令行自定义图概述
何时从命令行自定义图
您可以从命令行定制任何响应图。命令行是定制大量图的最有效方法。例如,如果您有一个生成许多图的批处理作业,则可以更改x-轴单位自动为所有的情节,只需几行代码。
如何从命令行自定义绘图
可以使用Control System Toolbox™应用程序接口(API)从命令行自定义响应图的绘图选项。
请注意
本节假设您对MATLAB有非常基本的熟悉®图形对象。有关更多信息,请参见图形对象.
从命令行定制图:
获得情节处理,它是绘图的标识符,使用API的绘图语法。
例如,
H = stepplot(sys)
返回图句柄
h
对于阶梯图。有关获取图句柄的详细信息,请参见获取地块句柄.
获得绘图选项处理,它是所有可设置的绘图选项的标识符。若要获得给定绘图的绘图选项句柄,请键入
P = getoptions(h);
p
情节选项句柄是情节句柄吗h
.有关获取绘图选项句柄的详细信息,请参见获取Plot Options句柄.
使用
setoption
,以及plot句柄和plot选项句柄,以访问和修改许多plot选项。
请注意
你也可以使用setoption
使用属性/值对而不是图形选项句柄定制图形。使用属性/值对可以将过程缩短为一行代码。
从命令行更改波德图单位
此示例显示如何将波德图的单位从rad/s更改为Hz。
创建一个系统并生成系统响应的波德图。该图使用默认单位rad/s。
Sys = tf(4,[1 0.5 4]);H = bodeploy (sys);
的bodeplot
命令返回一个绘图句柄,您可以使用该句柄更改绘图的属性。
将单位改为Hz。
P = getoptions(h);p.FreqUnits =“赫兹”;setoption (h p)
x轴标签的更新反映了单位的变化。
有关从命令行定制图的更多示例,请参见从命令行定制图的例子.
获取地块句柄
要以编程方式与响应图交互,需要情节处理.这个句柄是响应图对象的标识符。因为控制系统工具箱绘图命令,波德
,rlocus
,等等,都在内部使用plot句柄,这个API提供了一组命令,显式地将句柄返回到响应图。这些函数都以“plot”结尾,这使它们易于识别。该表列出了相关功能。
返回Plot句柄的函数
函数 |
情节 |
---|---|
波德幅度和相位 |
|
汉克尔奇异值 |
|
脉冲响应 |
|
初始条件 |
|
输入/输出对的极点/零映射 |
|
对任意输入的时间响应 |
|
尼科尔斯图 |
|
尼奎斯特 |
|
极/零 |
|
根轨迹 |
|
频率响应的奇异值 |
|
阶跃响应 |
要获得任何响应图的图句柄,请使用表中的函数。例如,
H = bodeploy (sys)
返回图句柄h
(它也可以渲染波德图)。方法修改绘图属性后,就可以使用setoption
而且getoptions
方法,在本例中是Bode plot句柄。
获取Plot Options句柄
情节选项句柄概述
有了plot句柄之后,就需要绘图选项处理,它是给定响应图的所有可设置的绘图属性的标识符。有两种方法来创建一个plot选项句柄:
检索句柄-使用
getoptions
为了得到控制。创建句柄-使用
< responseplot >
选项
实例化句柄。看到创建绘图选项句柄的函数一个完整的列表。
检索句柄
的getoptions
函数从图形句柄中检索图形选项句柄。
p=getoptions(h) %返回图句柄h的图选项句柄p。
如果指定属性名作为输入参数,getoptions
返回与属性名关联的属性值。
property_value=getoptions(h,PropertyName) %返回属性%值。
创建句柄
的形式的函数可以创建默认的绘图选项句柄
< responseplot >选项
例如,
p = bodeoptions;
实例化波德图的句柄。看到属性和值参考获取默认值的列表。
如果要将默认值设置为“控制系统工具箱”的默认值,请通过cstprefs
对函数。例如,
P = bodeoptions('cstprefs');
将Bode绘图属性/值对设置为“控制系统工具箱”的默认值。
该表列出了创建绘图选项句柄的函数。
创建绘图选项句柄的函数
函数 |
创建的Plot选项句柄类型 |
---|---|
|
波德相位和幅度 |
|
汉克尔奇异值 |
|
尼科尔斯图 |
|
奈奎斯特图 |
|
极/零情节 |
|
Sigma(奇异值)图 |
|
时间响应(脉冲、步长等) |
哪些属性可以修改?
使用
帮助< responseplot >选项
查看可修改的可用属性值对的列表。例如,
帮助bodeoptions
您可以使用setoption
.下一个主题提供修改各种响应图的示例。
看到属性和值参考获取响应图的属性/值对的完整列表。
从命令行定制图的例子
操纵情节选项句柄
有两种基本的方法来操作绘图选项句柄:
点符号-处理句柄像MATLAB结构。
属性值对-显式地指定属性/值对作为
setoption
.
对于一些示例,将同时展示点表示法和属性/值对方法。对于所有示例,使用
Sys = tf(1,[1 1]);
改变地块单位
将波德图的频率单位从rad/s更改为Hz。为此,提取选项p
从plot句柄中编辑选项,并将它们分配回plot。
H = bodeploy (sys);P = getoptions(h);p.FreqUnits =“赫兹”;setoption (h p)
或者,不是提取p
,设置的选项h
直接。
setoption (h,“FreqUnits”,“赫兹”)
使用现有的情节选项句柄创建情节
你可以使用一个现有的plot选项句柄来定制第二个plot:
H1 = bodeploy (sys);P1 = getoptions(h1);H2 = bodeploy (sys,p1);
或
H1 = bodeploy (sys);H2 = bodeploy (sys2);setoption (h2, getoptions (h1))
创建默认绘图选项句柄
用下面的代码实例化一个绘图选项句柄。
P = bodeoptions;
更改频率单位并将更改应用于sys
.
p.FreqUnits =“赫兹”;H = bodeploy (sys,p);
像结构一样使用点符号
您总是可以使用点表示法为属性赋值,并一次更改多个绘图属性。
H1 = bodeploy (sys);P1 = getoptions(h1);p1。FreqUnits =“赫兹”;p1.Title。字符串=“我的名字”;setoption (h1, p1)
在setoptions中设置属性对
中的属性/值对指定频率单位,而不是使用点符号setoption
.
H1 = bodeploy (sys) setoptions(H1,“FreqUnits”,“赫兹”)
验证单位已从rad/s更改为Hz。
getoptions (h1,“FreqUnits”)返回h1的频率单位。
ans = Hz
属性和值参考
所有响应图共有的属性/值对
下表讨论了所有响应图共有的属性/值对。
标题
财产 | 默认值 | 描述 |
---|---|---|
|
没有一个 |
情节标题,如 |
|
8 |
|
|
正常的 |
|
|
正常的 |
|
|
[0 0 0] |
|
X标签
财产 |
默认值 |
描述 |
---|---|---|
|
没有一个 |
x轴标签,如 |
|
8 |
|
|
正常的 |
|
|
正常的 |
|
|
[0 0 0] |
|
Y标签
财产 | 默认值 | 描述 |
---|---|---|
|
没有一个 |
y轴标签,如 |
|
8 |
|
|
正常的 |
|
|
正常的 |
|
|
[0 0 0] |
|
蜱虫的标签
财产 |
默认值 |
描述 |
---|---|---|
|
8 |
|
|
正常的 |
|
|
正常的 |
|
|
[0 0 0] |
|
网格和轴限制
财产 |
默认值 |
描述 |
---|---|---|
|
|
|
|
|
类型的1 × 2双精度单元格数组x当-轴限制 |
|
|
单元格数组,其中每个条目都是 |
|
|
1 × 2的双精度单元格数组指定y当-轴限制 |
|
|
单元格数组,其中每个条目都是 |
I / O分组
财产 |
默认值 |
描述 |
---|---|---|
|
没有一个 |
指定响应的输入/输出分组。 |
输入标签
财产 |
默认值 |
描述 |
---|---|---|
|
8 |
|
|
正常的 |
|
|
正常的 |
|
|
[0 0 0] |
|
输出标签
财产 |
默认值 |
描述 |
---|---|---|
|
8 |
|
|
正常的 |
|
|
正常的 |
|
|
[0 0 0] |
|
输入/输出可见
财产 |
默认值 |
描述 |
---|---|---|
|
在{} |
指定每个输入通道可见性的单元格数组。如果取值为标量,则应用标量展开。 |
|
在{} |
指定每个输出通道可见性的单元格数组。如果取值为标量,则应用标量展开。 |
波德图
财产 |
默认值 |
描述 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
当你设置 |
|
-180年 |
图包裹累积相位时的相位值 |
|
|
|
|
|
|
|
|
通过启用手动的较低幅度限制规格 |
|
0 |
时,指定震级下限 |
|
|
允许调整相位响应的相位效果。 |
|
0 |
|
|
0 |
|
汉克尔奇异值
尼科尔斯情节
财产 |
默认值 |
描述 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
双 |
|
|
当你设置 |
|
-180年 |
双 图包裹累积相位时的相位值 |
|
从 |
[on | off] |
|
0 |
双 |
|
0 |
双 |
奈奎斯特图
财产 |
默认值 |
描述 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
极/零地图
σ情节
财产 |
默认值 |
描述 |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
时间响应图
财产 |
默认值 |
描述 |
---|---|---|
|
|
规范化的y-图中所有反应的规模。 |
|
|
设置时间阈值。 |
|
|
指定用于定义上升时间的限制。 |
|
秒 |