linio

为 Simulink 模型、Linear Analysis Plots 模块或 Model Verification 模块创建线性分析点

全页折叠

语法

io = linio(block,port)

io = linio(block,port,type)

io = linio(block,port,type,[],busElement)

说明

示例

io = linio(block,port) 创建一个表示输入扰动分析点的线性化 I/O 对象，该分析点对从 Simulink^® block 指定输出端口 port 发出的信号执行扰动分析。

示例

io = linio(block,port,type) 创建指定 type 的一个分析点。

示例

io = linio(block,port,type,[],busElement) 为总线信号的元素创建一个分析点。

示例

全部折叠

为 Simulink 模型创建分析点

打开脚本

打开 Simulink 模型。

open_system('magball')

要为线性化指定多个分析点，请创建一个由线性化 I/O 对象组成的向量。

在 Controller 模块的输出端口上创建一个输入扰动分析点。

io(1) = linio('magball/Controller',1);

在 Magnetic Ball Plant 模块的输出端上创建一个开环输出分析点。开环输出点是一个后跟环路开口的输出测量。

io(2) = linio('magball/Magnetic Ball Plant',1,'openoutput');

查看指定的分析点。

io

1x2 vector of Linearization IOs: 
--------------------------
1. Linearization input perturbation located at the following signal:
- Block: magball/Controller
- Port: 1
2. Linearization open-loop output located at the following signal:
- Block: magball/Magnetic Ball Plant
- Port: 1

您可以使用这些分析点仅线性化 Magnetic Ball Plant 子系统。为此，请将 io 传递给 linearize 命令或 slLinearizer 接口。

与在 Simulink 模型中直接指定分析点不同，当您使用 linio 创建分析点时，不会向模型添加任何注释。

选择单个总线元素作为分析点

打开脚本

打开 Simulink 模型。

mdl = 'scdbusselection';
open_system(mdl)

源自 COUNTERBUSCreator 模块的 COUNTERBUS 信号包含多个总线元素。

将 upper_saturation_limit 总线元素指定为线性化输入。使用圆点表示法选择此元素，因为它位于嵌套的 limits 总线中。

io = linio('scdbusselection/COUNTERBUSCreator',1,'input',[],...
           'limits.upper_saturation_limit');

输入参数

全部折叠

`block` — Simulink 模块
字符向量 | 字符串

分析点所源自的 Simulink 模块，指定为包含其完整模块路径的字符向量或字符串。例如，要在 magball 模型中 Controller 模块的输出端标记一个分析点，请将 block 指定为 'magball/Controller'。

`port` — 输出端口
正整数

分析点所源自的 block 的输出端口，指定为正整数。

port 必须为指定 block 的有效端口号。

`type` — 分析点类型
`'input'` (默认) | `'output'` | `'loopbreak'` | ...

分析点类型，指定为以下类型之一：

'input' - 输入扰动
'output' - 输出测量
'loopbreak' - 环路中断
'openinput' - 开环输入
'openoutput' - 开环输出
'looptransfer' - 环路传递
'sensitivity' - 灵敏度
'compsensitivity' - 互补灵敏度

有关分析点类型的详细信息，请参阅指定要线性化的模型部分。

`busElement` — 总线元素名称
字符向量 | 字符串

总线元素名称，指定为字符向量或字符串。当在嵌套总线结构体中添加元素时，使用圆点表示法来访问嵌套总线的元素。有关示例，请参阅选择单个总线元素作为分析点。

输出参数

全部折叠

`io` — 分析点
线性化 I/O 对象

分析点，以线性化 I/O 对象形式返回。使用 linearize 命令时，通过 io 指定线性化输入、输出或环路开口。有关详细信息，请参阅指定要线性化的模型部分。

每个线性化 I/O 对象都具有以下属性：

属性	描述
`Active`	指示是否使用分析点进行线性化的标志，指定为以下项之一： `'on'` - 使用分析点进行线性化。此值是默认选项。 `'off'` - 不使用分析点进行线性化。如果您有一组现有分析点，并且要使用这些点的子集来线性化模型，请使用此选项。
`Block`	与分析点相关联的模块的完整模块路径，指定为字符向量。
`PortNumber`	与分析点相关联的输出端口，指定为整数。
`Type`	分析点类型，指定为以下类型之一： `'input'` - 输入扰动 `'output'` - 输出测量 `'loopbreak'` - 环路中断 `'openinput'` - 开环输入 `'openoutput'` - 开环输出 `'looptransfer'` - 环路传递 `'sensitivity'` - 灵敏度 `'compsensitivity'` - 互补灵敏度有关分析点类型的详细信息，请参阅指定要线性化的模型部分。
`BusElement`	与分析点相关联的总线元素名称，指定为字符向量或 `''`（如果分析点不是总线元素）。
`Description`	为方便用户起见指定的分析点描述，指定为字符向量。

替代功能

模型线性化器

您可以使用模型线性化器以交互方式配置分析点。有关详细信息，请参阅Specify Portion of Model to Linearize in Model Linearizer。

Simulink 模型

您也可以在 Simulink 模型中直接指定分析点。在您执行此操作时，分析点会保存在模型中。有关详细信息，请参阅Specify Portion of Model to Linearize in Simulink Model。

`slLinearizer` 和 `slTuner` 接口

如果您想从线性化系统获得多个开环或闭环传递函数而不重新编译模型，可以使用 slLinearizer 接口指定线性分析点。有关详细信息，请参阅Mark Signals of Interest for Batch Linearization。同样，如果您想调节控制系统并从结果系统中获得多个开环或闭环传递函数，可以使用 slTuner 接口指定线性分析点。有关详细信息，请参阅Mark Signals of Interest for Control System Analysis and Design。