connect

创建架构模型连接

全页折叠

语法

connectors = connect(srcComponent,destComponent)

connectors = connect(arch,[srcComponent,srcComponent,...],[destComponent,destComponent,...])

connectors = connect(arch,[],destComponent)

connectors = connect(arch,srcComponent,[])

connectors = connect(srcPort,destPort)

connectors = connect(srcPort,destPort,stereotype)

connectors = connect(___,Name=Value)

说明

connectors = connect(srcComponent,destComponent) 根据匹配的端口名称，将源组件 srcComponent 未连接的输出端口连接到目的组件 destComponent 未连接的输入端口，并返回连接器的句柄。对于物理连接，连接器是非定向的，因此源组件和目标组件可以互换。

要移除连接器，请使用 destroy 函数。

示例

connectors = connect(arch,[srcComponent,srcComponent,...],[destComponent,destComponent,...]) 连接架构中的组件数组。

connectors = connect(arch,[],destComponent) 连接父架构输入端口和目标子组件。

connectors = connect(arch,srcComponent,[]) 连接源子组件和父架构输出端口。

connectors = connect(srcPort,destPort) 连接一个源端口和一个目的端口，或连接两个非定向物理端口。

示例

connectors = connect(srcPort,destPort,stereotype) 连接了两个端口，并为连接器应用了一个构造型。

connectors = connect(___,Name=Value) 支持上述语法中的输入参量，且可使用一个或多个名称-值参量指定选项。

示例

全部折叠

连接 System Composer 组件

创建并连接两个组件。

创建顶层架构模型。

modelName = "archModel";
arch = systemcomposer.createModel(modelName);
rootArch = get(arch,"Architecture");

创建两个新组件。

names = ["Component1","Component2"];
newComponents = addComponent(rootArch,names);

为组件添加端口。

outPort1 = addPort(newComponents(1).Architecture,"testSig","out"); 
inPort1 = addPort(newComponents(2).Architecture,"testSig","in");

连接组件。

conns = connect(newComponents(1),newComponents(2));

改进模型布局。

Simulink.BlockDiagram.arrangeSystem(modelName)

连接 System Composer 端口

创建并连接两个端口。

创建顶层架构模型。

modelName = "archModel";
arch = systemcomposer.createModel(modelName);
rootArch = get(arch,"Architecture");

创建两个新组件。

names = ["Component1","Component2"];
newComponents = addComponent(rootArch,names);

为组件添加端口。

outPort1 = addPort(newComponents(1).Architecture,"testSig","out"); 
inPort1 = addPort(newComponents(2).Architecture,"testSig","in");

提取组件端口。

srcPort = getPort(newComponents(1),"testSig");
destPort = getPort(newComponents(2),"testSig");

连接端口。

conns = connect(srcPort,destPort);

改进模型布局。

Simulink.BlockDiagram.arrangeSystem(modelName)

通过选择目标元素进行连接

创建目标架构端口接口元素并将其连接到组件。

创建顶层架构模型。

modelName = "archModel";
arch = systemcomposer.createModel(modelName);
rootArch = get(arch,"Architecture");

创建一个新组件。

newComponent = addComponent(rootArch,"Component1");

为组件和架构添加目标架构端口。

outPortComp = addPort(newComponent.Architecture,"testSig","out");
outPortArch = addPort(rootArch,"testSig","out");

提取相应的端口对象。

compSrcPort = getPort(newComponent,"testSig");
archDestPort = getPort(rootArch,"testSig");

添加接口和接口元素，并将接口与架构端口关联。

interface = arch.InterfaceDictionary.addInterface("interface");
interface.addElement("x");
archDestPort.setInterface(interface);

在架构端口上选择一个元素并建立连接。

conns = connect(compSrcPort,archDestPort,DestinationElement="x");

改进模型布局。

Simulink.BlockDiagram.arrangeSystem(modelName)

输入参数

全部折叠

`stereotype` — 构造型
字符向量 | 字符串

要应用于连接的构造型，指定为 "<profile>.<stereotype>" 形式。

数据类型: char | string

名称-值参数

全部折叠

将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: connect(archPort,compPort,SourceElement="a")

`Stereotype` — 将构造型应用于连接器的选项
字符向量 | 字符串

将构造型应用于连接器的选项，以 "<profile>.<stereotype>" 的形式指定。

此名称-值参量仅适用于连接组件时。

示例: conns = connect(srcComp,destComp,Stereotype="GeneralProfile.ConnStereotype")

数据类型: char | string

`Rule` — 指定连接规则的选项
`"name"` (默认) | `"interface"`

用于指定连接规则的选项，可根据端口名称指定为 "name"，或根据端口上的接口名称指定为 "interface"。

此名称-值参量仅适用于连接组件时。

示例: conns = connect([srcComp1,srcComp2],[destComp1,destComp2],Rule="interface")

数据类型: char | string

`MultipleOutputConnectors` — 允许多个目标组件的选项
`0` (`false`) (默认) | `1` (`true`)

允许同一源组件有多个目标组件的选项，指定为 1 (true) 或 0 (false)。

此名称-值参量仅适用于连接组件时。

示例: conns = connect(srcComp,[destComp1,destComp2],MultipleOutputConnectors=true)

数据类型: logical

`SourceElement` — 选择连接源元素的选项
字符向量 | 字符串

选择连接源元素的选项，指定为数据元素名称的字符向量或字符串。

此名称-值参量仅适用于连接端口时。

示例: conns = connect(archSrcPort,compDestPort,SourceElement="x")

数据类型: char | string

`DestinationElement` — 选择连接目标元素的选项
字符向量 | 字符串

为连接选择目标元素的选项，指定为数据元素名称的字符向量或字符串。

此名称-值参量仅适用于连接端口时。

示例: conns = connect(compSrcPort,archDestPort,DestinationElement="x")

数据类型: char | string

`Routing` — 指定自动线路路由类型的选项
`"smart"` (默认) | `"on"` | `"off"`

用于指定自动线路路由类型的选项，指定为以下之一：

"smart" - 使用自动线路路由，充分利用画布上的空白空间，避免与其他线路和标签重叠。
"on" - 使用自动线路路由。
"off" - 不使用自动线路路由。

示例: conns = connect(srcPort,destPort,Routing="on")

数据类型: char | string

输出参量

全部折叠

`connectors` — 创建的连接
连接器对象数组

创建的连接，以 systemcomposer.arch.Connector 或 systemcomposer.arch.PhysicalConnector 对象数组的形式返回。

详细信息

全部折叠

定义

术语	定义	应用	更多信息
架构	System Composer™ 架构代表由组件组成的系统，以及这些组件在结构上和行为上如何相互关联。	不同类型的架构描述系统的不同方面。您可以使用视图来可视化架构中的组件子集。您可以使用参数编辑器在架构层级上定义参数。	可视化构建架构在 System Composer 中使用参数编辑器编写参数
根	根位于架构层次结构的顶层。根架构的边界由围绕相关系统的架构端口定义。	根架构的系统边界包围着您的架构模型。您可以添加架构端口来定义跨边界接口。	可视化构建架构
模型	System Composer 模型是包含架构信息的文件，涵盖组件、端口、连接器、接口和行为等信息。	对模型执行操作，包括提取根级架构、应用配置文件、链接接口数据字典或从模型架构生成实例。System Composer 模型存储为 SLX 文件。	创建带接口和需求链接的架构模型
组件	组件是系统中可替换的部分，用于在架构环境中实现明确的函数。组件定义架构元素，例如函数、另一个系统、硬件、软件或其他概念实体。组件也可以是子系统或子函数。	组件以模块的形式表示，是架构模型的一部分，并且可以分离成可重用的工件。使用接口编辑器通过端口接口在组件之间传输信息，使用参数编辑器传输参数。	可视化构建架构
端口	端口是组件或架构上的节点，表示与其环境的交互点。通过端口，信息可以流向其他组件或系统，或者从其他组件或系统流入。	组件端口是组件上与其他组件之间的交互点。架构端口是系统边界上的端口，无论该边界是在组件内还是在整体架构模型内。根架构具有由其端口定义的边界。	可视化构建架构
连接器	连接器是提供端口之间连接的线路。连接器描述信息如何在组件或架构之间流动。	通过连接器，两个组件可以进行交互，而无需定义交互的性质。在端口上设置接口来定义组件之间的交互方式。	可视化构建架构

术语	定义	应用	更多信息
物理子系统	物理子系统是具有 Simscape™ 连接的 Simulink^® 子系统。	具有 Simscape 连接的物理子系统采用物理网络方法，适合仿真具有真实物理组件的系统，代表一个数学模型。	使用 Simscape 实现组件行为
物理端口	物理端口代表 Simscape 物理建模连接器端口，称为 Connection Port (Simscape)。	使用物理端口连接架构模型中的组件或启用 Simulink 子系统中的物理系统。	定义组件上的物理端口
物理连接器	物理连接器可以表示特定物理域的非定向守恒连接。连接器也可以表示物理信号。	使用物理连接器连接表示系统特征的物理组件，以实现数学仿真。	带直流电机行为的架构模型 Simscape
物理接口	物理接口定义流经物理端口的信息类型。可以将同一个接口分配给多个端口。物理接口是复合接口，相当于一个 `Simulink.ConnectionBus` 对象，该对象指定多个 `Simulink.ConnectionElement` 对象。	使用物理接口来捆绑物理元素，以便使用至少一个物理域来描述物理模型。	指定端口上的物理接口
物理元素	物理元素描述物理接口的分解。物理元素等同于 `Simulink.ConnectionElement` 对象。	将物理元素的 `Type` 定义为物理域，以便在物理模型中使用该域。	使用 Simscape 描述组件行为

版本历史记录

在 R2019a 中推出

connect

语法

说明

示例

连接 System Composer 组件

连接 System Composer 端口

通过选择目标元素进行连接

输入参数

`arch` — 架构
架构对象

`srcComponent` — 源组件
组件对象 | 变体组件对象

`destComponent` — 目标组件
组件对象 | 变体组件对象

`srcPort` — 源端口
端口对象

`destPort` — 目标端口
端口对象

`stereotype` — 构造型
字符向量 | 字符串

名称-值参数

`Stereotype` — 将构造型应用于连接器的选项
字符向量 | 字符串

`Rule` — 指定连接规则的选项
`"name"` (默认) | `"interface"`

`MultipleOutputConnectors` — 允许多个目标组件的选项
`0` (`false`) (默认) | `1` (`true`)

`SourceElement` — 选择连接源元素的选项
字符向量 | 字符串

`DestinationElement` — 选择连接目标元素的选项
字符向量 | 字符串

`Routing` — 指定自动线路路由类型的选项
`"smart"` (默认) | `"on"` | `"off"`

输出参量

`connectors` — 创建的连接
连接器对象数组

详细信息

定义

版本历史记录

另请参阅

函数

对象

模块

主题

connect

语法

说明

示例

连接 System Composer 组件

连接 System Composer 端口

通过选择目标元素进行连接

输入参数

arch — 架构 架构对象

srcComponent — 源组件 组件对象 | 变体组件对象

destComponent — 目标组件 组件对象 | 变体组件对象

srcPort — 源端口 端口对象

destPort — 目标端口 端口对象

stereotype — 构造型 字符向量 | 字符串

名称-值参数

Stereotype — 将构造型应用于连接器的选项 字符向量 | 字符串

Rule — 指定连接规则的选项 "name" (默认) | "interface"

MultipleOutputConnectors — 允许多个目标组件的选项 0 (false) (默认) | 1 (true)

SourceElement — 选择连接源元素的选项 字符向量 | 字符串

DestinationElement — 选择连接目标元素的选项 字符向量 | 字符串

Routing — 指定自动线路路由类型的选项 "smart" (默认) | "on" | "off"

输出参量

connectors — 创建的连接 连接器对象数组

详细信息

定义

版本历史记录

另请参阅

函数

对象

模块

主题

`arch` — 架构
架构对象

`srcComponent` — 源组件
组件对象 | 变体组件对象

`destComponent` — 目标组件
组件对象 | 变体组件对象

`srcPort` — 源端口
端口对象

`destPort` — 目标端口
端口对象

`stereotype` — 构造型
字符向量 | 字符串

`Stereotype` — 将构造型应用于连接器的选项
字符向量 | 字符串

`Rule` — 指定连接规则的选项
`"name"` (默认) | `"interface"`

`MultipleOutputConnectors` — 允许多个目标组件的选项
`0` (`false`) (默认) | `1` (`true`)

`SourceElement` — 选择连接源元素的选项
字符向量 | 字符串

`DestinationElement` — 选择连接目标元素的选项
字符向量 | 字符串

`Routing` — 指定自动线路路由类型的选项
`"smart"` (默认) | `"on"` | `"off"`

`connectors` — 创建的连接
连接器对象数组