主要内容

从命令行定制响应图

从命令行定制图概述

何时从命令行自定义绘图

您可以从命令行自定义任何响应图。命令行是定制大量图的最有效方法。例如,如果您有一个生成许多图的批处理作业,您可以更改x只需要几行代码,就可以为所有的图自动设置-axis单元。

如何从命令行自定义图

您可以使用Control System Toolbox™应用程序程序接口(API)从命令行定制响应图的绘图选项。

请注意

本节假设您对MATLAB有一些非常基本的熟悉®图形对象。有关详细信息,请参阅图形对象

从命令行自定义图:

  1. 获得情节处理,它是绘图的标识符,使用API的绘图语法。

    例如,

    h = stepplot(系统)

    返回绘图句柄h对于步骤图。

    有关获取打印句柄的详细信息,请参见获取绘图句柄

  2. 获得情节选项处理,它是所有可设置打印选项的标识符。要获取给定打印的打印选项句柄,请键入

    p = getoptions (h);

    p是打印控制柄的打印选项控制柄h

    有关获取绘图选项句柄的更多信息,请参见获取打印选项句柄

  3. 使用setoption,以及情节句柄和情节选项句柄,以访问和修改许多情节选项。

请注意

你也可以用setoption使用属性/值对而不是绘图选项句柄来定制绘图。使用属性/值对将过程缩短为一行代码。

从命令行更改预兆图单位

此示例显示如何将Bode图的单位从rad/s更改为Hz。

创建一个系统并生成系统响应的波特图。绘图使用默认单位rad/s。

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

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

菩提树命令返回可用于更改绘图属性的绘图句柄。

将单位改为Hz。

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

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

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

有关从命令行定制图形的更多示例,请参见从命令行自定义绘图的示例

获取绘图句柄

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

返回打印句柄的函数

函数

情节

菩提树

波的大小和相位

hsvplot

汉克尔奇异值

脉冲场

脉冲响应

初始图

初始条件

iopzplot

输入/输出对的极/零映射

lsimplot

对任意输入的时间响应

nicholsplot

尼科尔斯图

nyquistplot

奈奎斯特

pzplot

极/零

rlocusplot

根轨迹

西格马普洛特

频率响应的奇异值

stepplot

阶跃响应

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

h = bodeplot(系统)

返回图处理h(它也渲染了波德图)。有了这个句柄后,就可以使用setoptiongetoptions方法,在本例中是Bode绘图句柄。

获取打印选项句柄

Plot Options Handles概述

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

检索句柄

getoptions函数从打印句柄检索打印选项句柄。

p=getoptions(h) %返回绘图选项句柄p作为绘图句柄h。

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

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

创建一个处理

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

< responseplot >选择权

例如,

p = bodeoptions;

实例化波德图的句柄。看到属性和值引用获取默认值列表。

如果您想将默认值设置为Control System Toolbox的默认值,请通过cstprefs到函数。例如,

p = bodeoptions(“cstprefs”);

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

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

用于创建绘图选项句柄的函数

函数

创建的打印选项句柄的类型

bodeoptions

波德相位和幅度

hsvoptions

汉克尔奇异值

尼科尔索普提斯

尼科尔斯图

奈奎斯托普斯酒店

奈奎斯特图

pzoptions

极/零情节

符号选择

(奇异值)图

时间选项

时间响应(脉冲、阶跃等)

可以修改哪些属性?

使用

帮助< responseplot >选择权

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

帮助bodeoptions

可以使用修改这些参数中的任何一个setoption.下一个主题将提供修改各种响应图的示例。

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

从命令行自定义绘图的示例

操作情节选项句柄

有两种操作情节选项手柄的基本方法:

  • 点表示法——将句柄视为MATLAB结构。

  • 属性值对—显式指定属性/值对作为输入参数setoption

对于一些示例,显示了点表示法和属性/值对方法。对于所有示例,请使用

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

变化的情节单元

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

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

或者,不是提取p,设置的选项h直接。

setoption (h,“FreqUnits”“赫兹”

使用现有的绘图选项句柄创建绘图

您可以使用现有的情节选项句柄来定制第二个情节:

h1=博德普洛特(sys);p1=获取选项(h1);h2=波德普洛特(sys,p1);

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

创建默认绘图选项句柄

使用此代码实例化打印选项句柄。

p = bodeoptions;

更改频率单位并将更改应用于系统

p.FreqUnits =“赫兹”; h=波德普洛特(sys,p);

像结构一样使用点表示法

始终可以使用点符号为特性指定值,并一次更改多个打印特性。

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

在设置中设置属性对

中的属性/值对指定频率单位,而不是使用点表示法setoption

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

确认单位已从rad/s更改为Hz。

获取选项(h1,“FreqUnits”%返回h1的频率单位。
ans =赫兹

属性和值引用

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

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

标题

财产 默认值

描述

标题.字符串

没有一个

情节标题,如“我的响应图”

标题。字形大小

8

标题:重量

典型的

[light | normal | demi]

Title.FontAngle

典型的

[正常|斜体|斜体]

标题。颜色

[0 0 0]

1×3 RGB向量

X标签

财产

默认值

描述

包含。字符串

没有一个

x轴标签,如输入频率的

包含。字形大小

8

包含。FontWeight

典型的

[light | normal | demi]

包含。FontAngle

典型的

[正常|斜体|斜体]

Xlabel.颜色

[0 0 0]

1×3 RGB向量

Y标签

财产 默认值

描述

YLabel。字符串

没有一个

y轴标签,如控制信号幅度的

Ylabel。字形大小

8

Ylabel。FontWeight

典型的

[light | normal | demi]

YLabel。FontAngle

典型的

[正常|斜体|斜体]

颜色

[0 0 0]

1×3 RGB向量

蜱虫的标签

财产

默认值

描述

ticklab.FontSize

8

TickLabel。FontWeight

典型的

[light | normal | demi]

TickLabel。FontAngle

典型的

[正常|斜体|斜体]

Ticklabel。颜色

[0 0 0]

1×3 RGB向量

网格和轴的界限

财产

默认值

描述

网格

(|关闭)

Xlim

{[]}

单元格数组,1乘2的双精度浮点数x-当XLimMode设置为手动。当XLim是标量,则应用标量展开;否则,单元数组的长度必须等于绘图的列数(即系统输入数)。1乘2的双打必须是严格递增的一对[xmin, xmax]

XLimMode

{'汽车'}

单元格数组,其中每个条目为“汽车”“手动”.这些条目指定了x-axis限制相应轴的模式。当XLimMode是否设置为手动极限设置为XLim.当XLim是标量,则应用标量展开;否则,单元数组的长度必须等于绘图的列数(即系统输入数)。

叶利姆

{[]}

1×2倍的单元格数组指定y-当叶立明设置为手动。当叶利姆为标量,应用标量展开;否则,单元格数组的长度必须等于图的行数(即系统输出的数量)。1乘2的双打必须是严格递增的一对[ymin ymax]

叶立明

{'汽车'}

单元格数组,其中每个条目为“汽车”“手动”.这些条目指定了y-axis限制相应轴的模式。当叶立明是否设置为手动极限设置为叶利姆.当叶利姆为标量,应用标量展开;否则,单元格数组的长度必须等于图的行数(即系统输出的数量)。

I/O分组

财产

默认值

描述

IOGrouping

没有一个

[无|输入|输出|全部]

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

输入标签

财产

默认值

描述

的inputlabel。字形大小

8

的inputlabel。FontWeight

典型的

[light | normal | demi]

的inputlabel。FontAngle

典型的

[正常|斜体|斜体]

输入标签。颜色

[0 0 0]

1×3 RGB向量

输出标签

财产

默认值

描述

OutputLabel。字形大小

8

OutputLabels.FontWeight

典型的

[light | normal | demi]

OutputLabels。FontAngle

典型的

[正常|斜体|斜体]

OutputLabels。颜色

[0 0 0]

1×3 RGB向量

输入/输出可见

财产

默认值

描述

InputVisible

在{}

(|关闭)

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

输出可见

在{}

(|关闭)

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

波德图

财产

默认值

描述

FreqUnits

rad /秒

可用选项

FreqScale

日志

(线性|日志)

磁单元

dB

(db | abs)

MagScale

线性

(线性|日志)

PhaseUnits

(rad |度)

PhaseWrapping

(|关闭)

当你设定PhaseWrapping“上”,该图将累积阶段包装在PhaseWrappingBranch财产。

PhaseWrappingBranch

–180

当时,情节包裹的累积阶段的相位值PhaseWrapping设置为“上”

MagVisible

(|关闭)

相位可调

(|关闭)

MagLowerLimMode

汽车

(汽车|手册)

使手动较低的幅度限制规格MagLowerLim

MagLowerLim

0

指定时的最低震级限制MagLowerLimMode设置为手册

相位匹配

(|关闭)

启用相位响应调整相位效果。

PhaseMatchingFreq

0

相位匹配值

0

汉克尔奇异值

财产

默认值

描述

Yscale

线性

(线性|日志)

Absol

0

看到hsvdstabsep获取详细信息。

雷托

1 * e-08

看到hsvdstabsep获取详细信息。

抵消

1 * e-08

看到hsvdstabsep获取详细信息。

尼科尔斯情节

财产

默认值

描述

FreqUnits

rad /秒

可用选项

磁单元

dB

(dB | abs)

PhaseUnits

(rad |度)

MagLowerLimMode

汽车

(汽车|手册)

MagLowerLim

0

双重的

PhaseWrapping

(|关闭)

当你设定PhaseWrapping“上”,该图将累积阶段包装在PhaseWrappingBranch财产。

PhaseWrappingBranch

–180

双重的

当时,情节包裹的累积阶段的相位值PhaseWrapping设置为“上”

相位匹配

(|关闭)

PhaseMatchingFreq

0

双重的

相位匹配值

0

双重的

奈奎斯特图

财产

默认值

描述

FreqUnits

rad /秒

可用选项

磁单元

dB

(dB | abs)

PhaseUnits

(rad |度)

华丽的轮廓

(|关闭)

极/零映射

财产

默认值

描述

FreqUnits

rad /秒

可用选项

TimeUnits

可用选项

σ情节

财产

默认值

描述

FreqUnits

rad /秒

可用选项

FreqScale

日志

(线性|日志)

磁单元

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

可用选项