# Inport

输入端口

库: Sysblock / Port

# 描述

Inport 模块将信号从系统外部链接到系统内。

软件根据以下规则分配 Inport 模块端口号：

根级系统或子系统中的 Inport 模块按顺序编号，从 1 开始。
如果添加 Inport 模块，标签将是下一个可用的编号。
如果您删除一个 Inport 模块，其他端口号会重新编号，以确保 Inport 模块的连续的且没有遗漏任何编号。
如果将 Inport 模块复制到系统中，其端口号不会重新编号，除非当前编号与系统中已存在的输入端口发生冲突。如果复制的 Inport 模块的端口号不符合顺序，则会对该模块重新进行编号。否则，当您仿真模型或更新模块图时，会出现一条错误消息。

# 顶层系统中的 Inport 模块

您可以在顶层系统中使用 Inport 模块，以进行以下操作：

要使用根级输入端口加载多个信号的数据，请考虑使用根输入端口映射器工具。
通过 linmod 和 trim 分析函数提供模型扰动的方式。

# 子系统中的 Inport 模块

子系统中的 Inport 模块表示子系统的输入。到达 Subsystem 模块上的输入端口的信号从该子系统中的关联 Inport 模块流出。与 Subsystem 模块上的输入端口关联的 Inport 模块是其端口号参数与 Subsystem 模块上输入端口的相对位置匹配的模块。例如，端口号参数为 1 的 Inport 模块从连接到 Subsystem 模块上最顶层端口的模块获取其信号。

如果对 Inport 模块的端口号重新编号，则该模块将连接到其他输入端口。该模块继续从子系统外的同一模块接收其信号。

子系统内的 Inport 模块支持信号标签传播，但根级 Inport 模块不支持。您可以直接编辑 Subsystem 模块上的端口标签。

提示

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

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

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

# 创建重复 Inport 模块

您可以创建任意数量的 Inport 模块副本。副本是原型的图形表示，旨在通过去除不必要的线条来简化模块图。副本与原型具有相同的端口号、属性和输出。

要创建 Inport 模块的副本，请执行以下操作：

在模块图中，选择要复制的未连接的 Inport 模块。
按住 Ctrl 键并拖动模块。
释放指针，然后从上下文菜单中选择生成副本。

您可以选择具有副本的 Inport 模块来突出显示副本模块。要在打开的图或新选项卡中显示相关模块，请使用光标在选择后出现的省略号上暂停。然后，从操作菜单中选择相关模块 。当多个模块对应于所选模块时，将打开一个相关模块列表。您可以通过在文本框中输入搜索词来过滤相关模块列表。从列表中选择相关模块后，窗口焦点转至显示该相关模块的打开的图或新选项卡。

# 将总线连接到根级 Inport 模块

如果您希望模型的根级 Inport 模块生成总线，请将数据类型参数设置为总线对象的名称（该总线对象定义 Inport 模块生成的总线）。

# 示例

将接收外部信号放大两倍。

参考示例模型

Inport.mo

。

# 端口

# 输出

Port_1 — 输入信号

标量 | 向量

通过输入端口流入系统的输入信号。

您可以在子系统中使用 Inport 模块，以结构体或任何其他格式提供定点数据。

# 参数

# 常设

端口号 — 端口在父模块上的位置

1 (默认) | 实整数

指定与模块对应的端口在父级 Subsystem 或 Model 模块上的显示顺序。

如果新添加的模块创建了一个新端口，则其端口号是下一个可用编号。
删除与某端口相关联的所有模块后，该端口也会被删除。其他端口会重新编号，使之依序排列且不跳过任何数字。
如果指定的端口号超过端口数量，则会为该编号和中间跳过的每个序号创建端口。

# 信号属性

数据类型 — 输出数据类型

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

端口维度(-1 表示继承) — 端口维度

-1 (默认) | 整数 | [整数整数]

指定输出信号的维度。

`-1`	端口可以为具有任何维度的信号加载数据。端口从连接的信号继承维度。
`N`	端口可以为大小是 `N` 的向量信号加载数据。
`[R C]`	端口可以为 `R` 行 `C` 列矩阵信号加载数据。

# 执行

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

-1 (默认) | 标量

指定采样时间命中点之间的离散间隔，或指定另一个采样时间类型。

默认情况下，模块根据模型中的模块上下文继承其采样时间。

# 依存关系

仅当模块表示根级输入端口时，此参数才可见。

# 版本历史记录

在 2024b 之前推出

# 限制信息

不支持部分

参数-常设-通过延迟外部信号锁存输入 — 通过延迟锁存信号的选项
参数-常设-针对函数调用子系统输出的反馈信号锁存输入的选项 — 锁存信号以防止更改
参数-常设-连接输入 — 打开根输入端口映射器工具的选项
参数-常设-输出函数调用 — 产生函数调用事件的选项
参数-信号属性-输出函数调用 — 产生函数调用事件的选项
参数-信号属性-最小值 — 最小输出值
参数-信号属性-最大值 — 最大输出值
参数-信号属性-锁定输出数据类型设置以防止被定点工具更改 — 防止定点工具覆盖数据类型
参数-信号属性-以非虚拟总线输出 — 指定总线输出的虚拟性的选项
参数-信号属性-单位(例如，m、m/s^2、N*m) — 模块的输入信号的物理单位
参数-信号属性-可变大小信号 — 允许或不允许可变大小信号的选项
参数-信号属性-信号类型 — 输出信号类型
参数-执行-数据插值 — 对输出数据进行线性插值的选项
参数-执行-事件 — 根据流入端口的数据流触发模型分区的选项

# 另请参阅

Outport