# Outport

输出端口

库: Sysblock / Port

# 描述

Outport 模块将信号从系统内链接到系统外部的目标。它们可以连接从子系统流动到模型其他部分的信号。它们还可以在模型层次结构的顶层提供外部输出。

Outport 模块端口号根据以下规则进行分配：

根级系统或子系统中的 Outport 模块按顺序编号，从 1 开始。
如果添加一个 Outport 模块，Sysblock 将为其分配下一个可用的编号。
如果您删除一个 Outport 模块，其他端口号会自动重新编号，以确保 Outport 模块的连续的且没有遗漏任何编号。

# 子系统中的 Outport 模块

子系统中的 Outport 模块表示来自子系统的输出。到达子系统中某个 Outport 模块的信号将从 Subsystem 模块上的关联输出端口流出。与输出端口关联的 Outport 模块是指端口号参数与该输出端口在 Subsystem 模块上的相对位置匹配的模块。例如，端口号参数为 1 的 Outport 模块将其信号发送给与 Subsystem 模块上最上面的输出端口连接的模块。

如果您对 Outport 模块的端口号重新进行编号，模块将连接到一个不同的输出端口。模块会继续将信号发送给子系统外部的同一个模块。

您可以直接编辑 Subsystem 模块上的端口标签。

提示

对于包含总线的模型，如果总线信号中包含很多总线元素，则可以考虑使用 In Bus Element 和 Out Bus Element 模块。这些模块可以：

减少模块图中信号线的复杂度和杂乱无章。
使增量更改接口更容易。
允许访问更靠近使用点的总线元素，避免使用 Bus Selector 和 Goto 模块配置。

In Bus Element 模块属于 Inport 模块类型，Out Bus Element 模块属于 Outport 模块类型。

# 模型层次结构中的顶层 Outport 模块

模型层次结构顶层的 Outport 模块有两种用途。它们可以为基础工作区提供外部输出，为 linmod 和 trim 分析函数提供一种从系统中获取输出的方法。

将 y 写入为矩阵，每一列均包含一个不同 Outport 模块的数据。列顺序与 Outport 模块的端口号顺序匹配。

如果您在第二个 (state) 参量之后指定多个变量名称，系统会将来自每个 Outport 模块的数据写入不同的变量。例如，如果系统有两个 Outport 模块，要将 Outport 模块 1 的数据保存到 speed，将 Outport 模块 2 的数据保存到 dist，请指定以下命令：

# 将总线连接到根级 Outport

只有当虚拟总线中的所有元素均具有相同的数据类型时，模型中的根级 Outport 模块才会接受虚拟总线。Outport 模块自动将总线统一为与总线具有相同元素数的向量并提供该向量作为输出。

如果希望模型的根级 Outport 模块接受包含混合类型的总线，请将 Outport 模块数据类型设置为 Bus: <object name>。

# 示例

输出一个正弦波。

参考示例模型

Outport.mo

。

# 端口

# 输入

Port_1 — 输出端口信号

标量 | 向量

通过输出端口流向外部子系统或模型的输入信号。

当 Outport 模块不是根级输出端口时，可以接受定点和枚举数据类型。模块输出的复/实性和数据类型与其输入相同。

# 参数

数据类型 — 输出数据类型

当数据类型指定对象时，软件会忽略此参数的值。

-->

# 信号属性

数据类型 — 输出数据类型

指定外部输入的输出数据类型。该类型可以继承、直接指定或表示为数据类型对象。

# 执行

采样时间(-1 表示继承) — 指定采样时间的选项

-1 (默认) | 标量

指定采样时间命中点之间的离散间隔，或指定另一个采样时间类型，如连续 (0) 或继承 (-1)。

# 版本历史记录

在 2024b 之前推出

# 限制信息

不支持部分

参数-常设-信号名称 — 信号名称
参数-常设-图标显示 — 图标显示
参数-常设-指定未连接源时的输出 — 指定未连接的输出值
参数-常设-常量值 — 模块未连接时的输出值
参数-常设-将向量参数解释为一维向量 — 将向量视为一维
参数-常设-确保输出端口为虚拟端口 — 确保输出端口为虚拟
参数-常设-初始输出值的源 — 初始输出值的源
参数-常设-禁用时的输出 — 禁用时的输出
参数-常设-初始输出 — 条件执行子系统的初始输出
参数-信号属性-最小值 — 最小输出值
参数-信号属性-最大值 — 最大输出值
参数-信号属性-锁定输出数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型
参数-信号属性-在父模型中以非虚拟总线输出 — 在父模型中以非虚拟总线输出
参数-信号属性-单位(例如，m、m/s^2、N*m) — 模块的输入信号的物理单位
参数-信号属性-可变大小信号 — 允许可变大小信号
参数-信号属性-信号类型 — 输出信号类型

# 另请参阅

Inport