addPort

アーキテクチャにポートを追加

構文

ports = addPort(arch,portNames,portTypes)

ports = addPort(arch,portNames,portTypes,stereotypes)

説明

ports = addPort(arch,portNames,portTypes) は、portNames で指定された名前と portTypes で指定されたタイプをもつ一連のポートを追加します。addPort 関数は、コンポーネントのアーキテクチャまたはモデルのルート アーキテクチャにポートを追加します。コンポーネントのアーキテクチャには <component>.Architecture を使用してアクセスします。

ポートを削除するには、destroy 関数を使用します。

ports = addPort(arch,portNames,portTypes,stereotypes) は、さらに stereotypes で指定されたステレオタイプを一連の新しいポートに適用します。

例

アーキテクチャへのポートの追加

モデルを作成してルート アーキテクチャを取得し、コンポーネントを追加してポートを追加します。

model = systemcomposer.createModel("archModel");
systemcomposer.openModel("archModel");
rootArch = get(model,"Architecture");
newComponent = addComponent(rootArch,"NewComponent");
newPort = addPort(newComponent.Architecture,"NewCompPort","in")

newPort = 

  ArchitecturePort with properties:

                 Parent: [1×1 systemcomposer.arch.Architecture]
                   Name: 'NewCompPort'
              Direction: Input
          InterfaceName: ''
              Interface: [0×0 systemcomposer.interface.DataInterface]
             Connectors: [0×0 systemcomposer.arch.Connector]
              Connected: 0
                  Model: [1×1 systemcomposer.arch.Model]
         SimulinkHandle: 57.0018
    SimulinkModelHandle: 10.0018
                   UUID: 'f3dd03e1-af14-47ed-88c8-0ce301b2da5f'
            ExternalUID: ''

入力引数

arch — アーキテクチャ

アーキテクチャ オブジェクト

アーキテクチャ。systemcomposer.arch.Architecture オブジェクトとして指定します。

portNames — ポートの名前

文字ベクトルの cell 配列 | string の配列 | 文字ベクトル | string

ポートの名前。文字ベクトルの cell 配列または string の配列として指定します。ポート名が 1 つの場合は、文字ベクトルまたは string として指定します。一意性を確保するために、必要に応じてポート名に番号が付加されます。

データ型: char | string

portTypes — ポートのタイプ

文字ベクトルの cell 配列 | string の配列 | 文字ベクトル | string

ポートのタイプ。文字ベクトルの cell 配列または string の配列として指定します。ポート タイプが 1 つの場合は、文字ベクトルまたは string として指定します。使用できるポート タイプには次のものがあります。

• "in"

• "out"

• "physical"

• "client" (ソフトウェア アーキテクチャの場合)

• "server" (ソフトウェア アーキテクチャの場合)

ポート タイプの配列は、ポート名の配列と 1 対 1 で適用されます。

データ型: char | string

stereotypes — ポートに適用するステレオタイプ

string の配列 | string

ポートに適用するステレオタイプ。"<profile>.<stereotype>" の形式の string の配列として指定します。すべてのポートに適用されるステレオタイプを 1 つ指定するか、ポート名の配列と 1 対 1 で適用されるステレオタイプの配列を指定します。

データ型: string

出力引数

ports — 作成されたポート

アーキテクチャ ポート オブジェクトの配列

作成されたポート。systemcomposer.arch.ArchitecturePort オブジェクトの配列として返されます。

詳細

定義

用語	定義	アプリケーション	詳細
アーキテクチャ	System Composer™ の "アーキテクチャ" は、コンポーネントのシステムとそれらの構造および動作の相互インターフェイスを表します。	アーキテクチャのタイプごとに、記述されるシステムの側面がそれぞれ異なります。ビューを使用してアーキテクチャ内のコンポーネントのサブセットを可視化できます。アーキテクチャ レベルのパラメーターはパラメーター エディターを使用して定義できます。	Compose Architectures Visually Author Parameters in System Composer Using Parameter Editor
ルート	"ルート" は、アーキテクチャ階層の最上位にあたります。ルート アーキテクチャの境界は、対象のシステムを囲むアーキテクチャ ポートで定義されます。	ルート アーキテクチャは、アーキテクチャ モデルの周囲をシステムの境界とします。境界をまたぐインターフェイスを定義するアーキテクチャ ポートを追加できます。	Compose Architectures Visually
モデル	System Composer の "モデル" は、コンポーネント、ポート、コネクタ、インターフェイス、動作などのアーキテクチャ情報を含むファイルです。	モデルでは、ルートレベルのアーキテクチャの抽出、プロファイルの適用、インターフェイス データ ディクショナリのリンク、モデル アーキテクチャからのインスタンスの生成などの操作を実行します。System Composer のモデルは SLX ファイルとして保存されます。	インターフェイスと要件リンクを使用したアーキテクチャ モデルの作成
コンポーネント	"コンポーネント" は、アーキテクチャのコンテキストにおいて明確な機能を果たす、システムの交換可能部分です。コンポーネントは、機能、別のシステム、ハードウェア、ソフトウェア、その他の概念項目などのアーキテクチャ要素を定義します。コンポーネントは、サブシステムまたはサブ機能になる場合もあります。	ブロックとして表されるコンポーネントは、再利用可能なアーティファクトに分割可能なアーキテクチャ モデルの一部です。コンポーネント間で情報を転送するには、ポート インターフェイスとパラメーターを使用します。ポート インターフェイスとパラメーターは、インターフェイス エディターおよびパラメーター エディターを使用して構成できます。	Compose Architectures Visually
ポート	"ポート" は、その環境との相互作用点を表すコンポーネントまたはアーキテクチャ上のノードです。ポートにより、他のコンポーネントまたはシステムと情報をやりとりできるようになります。	"コンポーネント ポート" は、他のコンポーネントに対するコンポーネント上の相互作用点です。"アーキテクチャ ポート" はシステムの境界上のポートで、境界はコンポーネント内にある場合と、アーキテクチャ モデル全体の場合があります。ルート アーキテクチャの境界は、そのポートで定義されます。	Compose Architectures Visually
コネクタ	"コネクタ" はポート間の接続を提供するラインです。コネクタは、コンポーネントまたはアーキテクチャ間の情報の流れを表します。	コネクタにより、2 つのコンポーネントは相互作用の性質を定義することなく相互作用できます。ポートにインターフェイスを設定してコンポーネントの相互作用を定義します。	Compose Architectures Visually

用語	定義	アプリケーション	詳細
物理サブシステム	"物理サブシステム" は、Simscape™ 接続をもつ Simulink® サブシステムです。	Simscape 接続をもつ物理サブシステムでは、実際の物理コンポーネントを含むシステムのシミュレーションに適した物理ネットワーク アプローチを使用して数学的なモデルを表します。	Implement Component Behavior Using Simscape
物理ポート	"物理ポート" は、Connection Port (Simscape) という Simscape の物理モデリング コネクタ ポートを表します。	物理ポートは、アーキテクチャ モデルでコンポーネントを接続したり、Simulink サブシステムで物理システムを有効にしたりするために使用します。	Define Physical Ports on Component
物理コネクタ	"物理コネクタ" は、特定の物理ドメインの無方向の保存接続を表すことができます。コネクタで物理量信号を表すこともできます。	物理コネクタは、数学的にシミュレーションするシステムの特徴を表す物理コンポーネントを接続するために使用します。	Architecture Model with Simscape Behavior for a DC Motor
物理インターフェイス	"物理インターフェイス" は、物理ポートを流れる情報の種類を定義します。同じインターフェイスを複数のポートに割り当てることができます。物理インターフェイスは、複数の Simulink.ConnectionElement オブジェクトを指定する Simulink.ConnectionBus と等価の複合インターフェイスです。	物理インターフェイスを使用して複数の物理要素をまとめ、少なくとも 1 つの物理ドメインを使用する物理モデルを表します。	Specify Physical Interfaces on Ports
物理要素	"物理要素" は、物理インターフェイスの分解要素を記述します。物理要素は Simulink.ConnectionElement オブジェクトと同等です。	物理要素の Type を物理ドメインとして定義すると、物理モデルでそのドメインの使用が有効になります。	Describe Component Behavior Using Simscape

用語	定義	アプリケーション	詳細
ステレオタイプ	"ステレオタイプ" は、中核となる言語要素を拡張してドメイン固有のメタデータを追加するメカニズムを提供します。	ステレオタイプは、中核となる要素タイプに適用します。要素は複数のステレオタイプをもつことができます。ステレオタイプにより、さまざまな要素のスタイルを設定できます。ステレオタイプは、質量、コスト、パワーなどの一連の共通のプロパティをもつ要素を提供します。	Define Stereotypes and Perform Analysis for Mobile Robot ステレオタイプを使用したアーキテクチャ設計の拡張 Change Stereotypes Based on Stereotype Hierarchy in Portable Blender Architecture
プロパティ	"プロパティ" はステレオタイプのフィールドです。ステレオタイプが適用される要素ごとにプロパティ値を指定できます。	プロパティを使用して、モデル要素に関連付けられている、重みや速度などの定量的特性を格納します。プロパティは、説明的なものであったり、ステータスを表したりする場合もあります。プロパティ インスペクターを使用して、アーキテクチャ モデルの各要素のプロパティを表示および編集できます。詳細については、Use Property Inspector in System Composerを参照してください。	プロパティの設定 Add Properties with Stereotypes Set Properties for Analysis
プロファイル	"プロファイル" は、ステレオタイプのパッケージです。	プロファイルを使用して特殊な要素タイプのドメインを作成できます。プロファイル エディターを使用して、プロファイルを作成し、プロファイルをモデルに適用します。1 つのプロジェクトのステレオタイプを 1 つ以上のプロファイルに保存できます。プロファイルを保存すると、XML ファイルに保存されます。	Extend System Composer Language Elements Using Profiles Change Stereotype Order Using Manage Profiles Tool

バージョン履歴

R2019a で導入

参考

関数

• iterate | current | getQualifiedName | lookup | systemcomposer.createModel | systemcomposer.loadModel | systemcomposer.openModel | open | save | close | createArchitectureModel | createArchitectureSubsystem | linkToModel | inlineComponent | addComponent | getComponent | getPort | setName | getSubElement | getPortElement | getConnectorTo | connect | setMaskImage | IsAdapterComponent | addAdapter | addInput | getInput | connectTo | updatePosition | addMapping | removeMapping | smartConnect | getUnconnectedPorts | getSmartConnectPolicy | setSmartConnectPolicy | destroy

オブジェクト

• systemcomposer.arch.Element | systemcomposer.arch.Architecture | systemcomposer.arch.Component | systemcomposer.arch.Adapter | systemcomposer.arch.ComponentPort | systemcomposer.arch.ArchitecturePort | systemcomposer.arch.PortElement | systemcomposer.arch.Connector | systemcomposer.arch.PhysicalConnector

ブロック

• Component | Port | Reference Component | Adapter

トピック

• System Composer API の概要
• Compose Architectures Visually
• Build Architecture Models Programmatically
• 小型 UAV のシステム アーキテクチャのモデル化