Input Port
Subsystems
运行在线示例
免费 · 无需注册 · 直接在浏览器中运行
InPort(输入端口)模块用于为 Subsystem(子系统)容器建立外部输入接口。它接收到达子系统边界外部的输入信号,并将其透明穿透传递给子系统内部的下游算法模块。
在子系统内部放置一个 InPort 模块,会自动在其父级 Subsystem 模块外层边界上生成一个对应的物理输入引脚,从而支持模块化、多层级的复杂动态系统拓扑构建与清晰封装。
数学模型
InPort 模块在数学上表现为理想透明的跨层级边界信号穿透传递:
其中:
- 为连接至父级 Subsystem 外部输入引脚上的连续或离散信号。
- 为配置的
defaultValue缺省回退值。 - 信号穿透层级边界的过程是瞬时发生的,无任何数值相位滞后:
输入与输出
| Direction | ID | Label | 类型 | Status |
|---|---|---|---|---|
| ← Out | out |
Internal Output | number | Output |
参数
| 参数 | Label | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
portName |
Port Name | text | input1 |
|
defaultValue |
Default Value | number | 0 |
使用示例
示例 1: 闭环速度控制器子系统边界输入端口定义
构建包含误差计算与 PID 校正的模块化速度控制子系统。在子系统内部添加分别命名为 "setpoint" 和 "feedback" 的两个 InPort 模块,即会在顶层父模块外壳上自动暴露两个清晰的输入引脚,支持整洁连接参考设定值信号与转速计测量信号。
示例 2: 三轴机器人运动学解算多输入端口阵列
将三自由度机器人机械臂逆运动学算法封装至子系统内部。使用三个分别命名为 "x_ref"、"y_ref" 与 "z_ref" 且配置 defaultValue = 0.0 的 InPort 模块,在子系统边界上清晰暴露笛卡尔空间参考坐标输入。
说明与最佳实践
- 外壳引脚动态自适应生成: 在子系统内每添加或删除一个 InPort 模块,父级 Subsystem 外观图块上都会动态创建或移除对应的连线端子。
- 零传播延迟: 信号在同一解算步长内即时由外层穿越至内层,不存在任何计算延迟或多余的数据缓存复制。
- 安全缺省回退: 当外部未连接信号线时,
defaultValue可确保内部模块获得受控的确定性初始值,杜绝空指针或 NaN 异常。 - 子系统布局规范: 建议将 InPort 模块整齐排列在子系统画布的左侧区域,以契合自左向右(西到东)的标准信号流向。