ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

Outport

サブシステムの出力端子または外部出力を作成

ライブラリ

Ports & Subsystems、Sinks

説明

Outport ブロックは、システムからそのシステム外部の出力先へのリンクです。

Simulink® は、以下のルールに従って Outport ブロック端子番号を割り当てます。

  • ルートレベル システム内またはサブシステム内の Outport ブロックに自動的に 1 から順番に番号を付けます。

  • Outport ブロックを追加する場合、使用可能な次の番号が割り当てられます。

  • Outport ブロックを削除する場合、端子番号が省略されることなく Outport ブロックが順番どおり並ぶように、他の端子番号に番号が自動的に再度付けられます。

サブシステム内の Outport ブロック

サブシステムの Outport ブロックは、サブシステムからの出力を表します。Subsystem ブロックの出力端子に接続されている信号は、そのサブシステムの対応する Outport ブロックから出力されます。Subsystem ブロックの出力端子に対応する Outport ブロックは、[端子番号] パラメーターが Subsystem ブロックの出力端子の対応する場所に一致するブロックです。たとえば、[端子番号] パラメーターが 1 に等しい Outport ブロックは、その信号を Subsystem ブロック一番上の出力端子に接続されているブロックに出力します。

Outport ブロックの [端子番号] に関して再度番号付けを行うと、そのブロックは異なる出力端子に関連付けられますが、サブシステム外部の同じブロックへの信号が接続されたまま残ります。

既存のブロックを選択してサブシステムを作成するときに、グループ化したブロックに 1 つを超える Outport ブロックが含まれている場合、Simulink はそれらのブロック上の端子に対して自動的に再度番号付けを実行します。

Outport ブロック名は、端子ラベルとして Subsystem アイコンに表示されます。そのラベルが表示されないようにするには、Outport ブロックをクリックしてから、[書式][ブロック名の非表示] を選択します。

条件付きで実行されるコンテキスト内の Outport ブロックの初期化

条件付きで実行されるサブシステム内の Outport ブロックの初期条件を設定するには、次のいずれかの方法を使用します。

  • サブシステムの入力信号から初期値を継承する。

  • 初期値を明示的に指定する。

詳細は、「条件付きサブシステムの初期値の指定と継承」を参照してください。

    メモ:   条件付きサブシステムが同じモデル内の Merge ブロックを駆動する場合は、サブシステムの Outport ブロックの初期条件 (IC) を指定する必要はありません。詳細は、「指定不足の初期化の検出」を参照してください。

モデルの階層構造内の最上位 Outport ブロック

モデルの階層構造の最上位にある Outport ブロックには 2 つの用途があります。1 つは [コンフィギュレーション パラメーター] ペインのパラメーターまたは sim コマンドのいずれかを使って MATLAB® のベース ワークスペースに外部出力を供給することです。もう 1 つはシステムから出力を取得する方法を解析関数に提供することです。

  • ワークスペースに外部出力を供給するには、[コンフィギュレーション パラメーター][データのインポート/エクスポート] ペイン (「MATLAB ワークスペースへのデータのエクスポート」を参照) または sim コマンド ( を参照) を使用します。たとえば、システムに 1 つを超える Outport ブロックが存在し、保存形式が配列の場合、以下のコマンドが

    [t,x,y] = sim(...);

    y を行列として書き込みます。各列には異なる Outport ブロックのデータが含まれます。列の順序は、Outport ブロックの端子番号の順序と一致します。

    2 番目の (状態) 引数の後ろに 1 つを超える変数名を指定した場合、各 Outport ブロックからのデータは異なる変数に書き込まれます。たとえば、システムが 2つの Outport ブロック (Outport ブロック 1 からのデータを speed に保存するブロックと Outport ブロック 2 からのデータを dist に保存するブロック) をもっている場合、以下の用途のためにこのコマンドを指定できます。

    [t,x,speed,dist] = sim(...);
  • システムから出力を取得する方法を解析関数 linmod および trim に提供します (「モデルの線形化」を参照)。

ルートレベルの Outport へのバスの接続

モデルのルートレベルの Outport にバス オブジェクトを指定しない場合、バスのすべての要素が同じデータ型をもつ場合に限り、バーチャル バスを受け取ることができます。Outport ブロックは、バスを自動的にバスと同じ要素数をもつベクトルにまとめ、ベクトルを出力します。

モデルのルートレベルの Outport が混在する型を含むバス信号を受け取るようにする場合、Outport ブロックの [データ型] パラメーターを Bus: <object name> または <data type expression> オプションのバス オブジェクト名を使用するように設定して、Outport が生成するバスの型を定義しなければなりません。バス信号がバーチャルである場合、「バスの自動変換」で説明しているように、非バーチャルに変換されます。詳細は、「バス オブジェクト」を参照してください。

サポートするデータ型

Outport ブロックは、Simulink がサポートする任意のデータ型の複素数値信号または実数値信号を受け入れます。ルート レベルの出力端子でない場合、Outport ブロックは固定小数点データ型と列挙型のデータ型も受け入れることができます。ブロックの出力の実数/複素数とデータ型は、その入力と同じです。また、Outport ブロックは、バス オブジェクトもデータ型として受け入れます。

    メモ:   このブロックのデータ型としてバス オブジェクトを指定した場合、ブロックのバス データの最小値および最大値を設定しないでください。Simulink はこれらの設定を無視します。代わりに、データ型として指定したバス オブジェクトのバス要素の最小値と最大値を設定してください。値は有限の実数で倍精度のスカラー値にする必要があります。

    バス要素の最小および最大プロパティの詳細は、Simulink.BusElement を参照してください。

詳細は、「Simulink でサポートされているデータ型」を参照してください。

Outport ブロックに接続されている信号配列の要素は、以下の環境にある場合を除き、異なる実数/複素数およびデータ型で構成されていてもかまいません。その環境とは、出力端子が条件付き実行サブシステムに存在し、初期出力が指定してある場合で、このとき入力配列のすべての要素は同じ実数/複素数およびデータ型で構成されていなければなりません。

代表的な Simulink データ型変換ルールは、出力端子の [初期出力] パラメーターに適用されます。初期出力値がこのブロックの出力データ型の範囲内にある場合、Simulink は初期出力を出力データ型に変換します。指定した初期出力が出力データ型の範囲外にある場合、Simulink はシミュレーションを停止し、エラーを表示します。

パラメーターとダイアログ ボックス

Outport ブロックのダイアログ ボックスの [メイン] ペインは、条件付きで実行されるサブシステム内にある場合、次のように表示されます。

端子番号

ブロックの端子番号を指定します。

設定

既定の設定: 1

このパラメーターは、ブロックに対応する端子が親サブシステムまたは Model ブロックに現れる順序を制御します。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

アイコン表示

入力端子のアイコン上に表示される情報を指定します。

設定

既定の設定: 端子番号

信号名

端子に連結している信号 (入力がバスの場合は複数の信号) の名前を表示します。

端子番号

端子の端子番号を表示します。

端子番号と信号名

端子番号と端子に連結している信号の名前の両方を表示します。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

初期出力の値のソース

ブロックの初期出力値のソースを選択します。

設定

既定の設定: [ダイアログ]

[ダイアログ]

初期出力値は、ダイアログの [初期出力] パラメーターで指定されます。

[入力信号]

初期出力値は、入力信号から継承されます。「条件付きサブシステムの初期値の指定と継承」を参照してください。

ヒント

  • クラシック初期化モードを使用している場合、[入力信号] を選択するとエラーが発生します。初期出力値を入力信号から継承するには、このパラメーターを [ダイアログ] に設定して [初期出力] の値に [] (空行列) を指定します。詳細は、「条件付きサブシステムの初期値の指定と継承」を参照してください。

依存関係

このパラメーターは、Outport が条件付きサブシステム内に存在する場合に有効になります。

[ダイアログ] を選択すると、以下のパラメーターが有効になります。

  • ディセーブル時の出力

  • 初期出力

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

ディセーブル時の出力

サブシステムがディセーブルになったときのブロック出力に何が起こるのかを指定します。

設定

既定の設定: 保持

保持

サブシステムがディセーブルになる場合に出力が保持されます。

リセット

サブシステムがディセーブルになる場合に出力は [初期出力] で指定された値にリセットされます。

ヒント

  • 条件付きサブシステムの出力を Merge ブロックに接続するときは、このパラメーターを 保持 に設定します。リセット に設定するとエラーが返されます。

依存関係

  • [初期出力の値のソース][ダイアログ] を選択するとこのパラメーターが有効になります。

  • このパラメーターは、Outport が有効化と無効化の有効なセマンティクスのある条件付きサブシステム内に存在する場合に有効になります。たとえば、このパラメーターは Outport が Triggered Subsystem 内に配置されている場合無効になりますが、Outport が Enabled Subsystem 内に配置されている場合は有効になります。

  • Outport が Function-Call Subsystem 内に配置されている場合、このパラメーターは Stateflow チャートで Function-Call Subsystem がステートにバインドされている場合にのみ意味があります。詳細は、「Function-Call Subsystem のステートへのバインド」を参照してください。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

初期出力

条件付き実行サブシステムの場合は、そのサブシステムを実行する前とそのサブシステムが実行不能になっている間にブロック出力を指定します。

設定

既定の設定: [ ]

このブロックの初期状態として、inf または NaN にすることはできません。

ヒント

依存関係

  • [初期出力の値のソース][ダイアログ] を選択するとこのパラメーターが有効になります。

  • このパラメーターは、Outport が条件付きサブシステム内に存在する場合に有効になります。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

最小値

ブロックが出力する最小値を指定します。

設定

既定の設定: [] (指定なし)

この数値は有限の実数で double のスカラー値でなければなりません。

    メモ:   このブロックのデータ型としてバス オブジェクトを指定した場合、ブロックのバス データの最小値を設定しないでください。Simulink によりこの設定は無視されます。代わりに、データ型として指定したバス オブジェクトのバス要素の最小値を設定してください。バス要素の最小値プロパティの詳細は、Simulink.BusElement を参照してください。

Simulink ソフトウェアは、以下を行う際にこの値を使用します。

  • シミュレーション範囲のチェック (「信号範囲」を参照)

  • 固定小数点データ型の自動スケーリング

コマンド ライン情報

「ブロック固有のパラメーター」を参照してください。

最大値

ブロックが出力する最大値を指定します。

設定

既定の設定: [] (指定なし)

この数値は有限の実数で double のスカラー値でなければなりません。

    メモ:   このブロックのデータ型としてバス オブジェクトを指定した場合、ブロックのバス データの最大値を設定しないでください。Simulink によりこの設定は無視されます。代わりに、データ型として指定したバス オブジェクトのバス要素の最大値を設定します。バス要素の最大プロパティの詳細は、Simulink.BusElement を参照してください。

Simulink ソフトウェアは、以下を行う際にこの値を使用します。

  • シミュレーション範囲のチェック (「信号範囲」を参照)

  • 固定小数点データ型の自動スケーリング

コマンド ライン情報

「ブロック固有のパラメーター」を参照してください。

データ型

外部入力の出力データ型を指定します。

設定

既定の設定:Inherit: auto

Inherit: auto

データ型を継承するルールです。

double

データ型は double です。

single

データ型は single です。

int8

データ型は int8 です。

uint8

データ型は uint8 です。

int16

データ型は int16 です。

uint16

データ型は uint16 です。

int32

データ型は int32 です。

uint32

データ型は uint32 です。

boolean

データ型は boolean です。

fixdt(1,16,0)

データ型は固定小数点 fixdt(1,16,0) です。

fixdt(1,16,2^0,0)

データ型は固定小数点 fixdt(1,16,2^0,0) です。

Enum:<class name>

データ型は列挙型です。たとえば、Enum: BasicColors などです。

Bus:<object name>

データ型はバス オブジェクトです。

<data type expression>

データ型オブジェクトの名前です。たとえば、Simulink.NumericType などです。

バス オブジェクトを式として指定しないでください。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

データ型アシスタントを表示

[データ型アシスタント] を表示します。

設定

[データ型アシスタント] を使用すると、[出力データ型] パラメーターを設定できます。

詳細は、「信号のデータ型の制御」を参照してください。

モード

指定するデータのカテゴリを選択します。

設定

既定の設定: 継承

継承

データ型の規則の継承。[継承] を選択すると、右側にある 2 番目のメニュー/テキスト ボックスが有効になります。

組み込み

組み込みのデータ型。[組み込み] を選択すると、右側にある 2 番目のメニュー/テキスト ボックスが有効になります。次の選択肢からいずれかを選択します。

  • double (既定の設定)

  • single

  • int8

  • uint8

  • int16

  • uint16

  • int32

  • uint32

  • boolean

固定小数点

固定小数点データ型。

列挙型

列挙型データ。[列挙型] を選択すると、右側から 2 番目のメニュー/テキスト ボックスが有効になります。そこにクラス名を入力することができます。

バス

バス オブジェクト。[バス] を選択すると、右側にある [バス オブジェクト] パラメーターが有効になり、バスの構造を定義するために使用するバス オブジェクトの名前を入力できます。バス オブジェクトを作成または変更する必要がある場合は、[バス オブジェクト] フィールドの右側にある [編集] をクリックして、Simulink バス エディターを開きます。バス エディターの詳細は、「バス エディターによるバス オブジェクトの管理」を参照してください。

データ型を評価する式。[式] を選択すると、右側から 2 番目のメニュー/テキスト ボックスが有効になります。そこに式を入力することができます。

バス オブジェクトを式として指定しないでください。

依存関係

[データ型アシスタントを表示] ボタンをクリックすると、このパラメーターが有効になります。

コマンド ライン情報

「ブロック固有のパラメーター」を参照してください。

参考

「データ型アシスタントを利用したデータ型の指定」を参照してください。

データ型オーバーライド

この信号のデータ型オーバーライド モードを指定します。

設定

既定の設定: 継承

継承

コンテキストからデータ型オーバーライド設定を継承します。コンテキストとはブロックのことで、信号を使用している Simulink の Simulink.Signal オブジェクトまたは Stateflow® チャートです。

オフ

コンテキストのデータ型オーバーライド設定を無視し、信号に対して指定された固定小数点データ型を使用します。

ヒント

個々のデータ型に対してデータ型オーバーライドをオフにする機能により、データ型オーバーライドを適用する際に、モデル内のデータ型をさらに効果的に制御できます。たとえば、このオプションを使用すると、データ型オーバーライド設定にかかわらず、データ型が下流ブロックの要件を満たすことを確認できます。

依存関係

このパラメーターは、[モード]組み込み または 固定小数点 の場合にのみ表示されます。

符号付き/なし

固定小数点データを符号付きにするか、符号なしにするかを指定します。

設定

既定の設定: 符号付き

符号付き

符号付き固定小数点データを指定します。

符号なし

符号なし固定小数点データを指定します。

依存関係

[モード]固定小数点を選択すると、このパラメーターが有効になります。

参考

詳細は、「固定小数点データ型の指定」を参照してください。

語長

量子化された整数をもつ語のビット サイズを指定します。

設定

既定の設定: 16

最小値: 0

最大値: 32

依存関係

[モード]固定小数点を選択すると、このパラメーターが有効になります。

参考

詳細は、「固定小数点データ型の指定」を参照してください。

スケーリング

オーバーフローを避け、量子化誤差を最小限に抑えるための固定小数点データのスケーリング方法を指定します。

設定

既定の設定: 最高精度

2 進小数点

2 進小数点の位置を指定します。

勾配とバイアス

勾配とバイアスを入力します。

最高精度

最高精度値を指定します。

依存関係

[モード]固定小数点を選択すると、このパラメーターが有効になります。

[2 進小数点] を選択すると、以下が有効になります。

  • 小数部の長さ

  • 最高精度のスケーリングを計算

勾配とバイアス を選択すると、以下が有効になります。

  • 勾配

  • バイアス

  • 最高精度のスケーリングを計算

参考

詳細は、「固定小数点データ型の指定」を参照してください。

小数部の長さ

固定小数点データ型の小数部の長さを指定します。

設定

既定の設定: 0

2 進小数点は正または負の整数になります。

依存関係

[スケーリング][2 進小数点] を選択すると、このパラメーターが有効になります。

参考

詳細は、「固定小数点データ型の指定」を参照してください。

勾配

固定小数点データ型の勾配を指定します。

設定

既定の設定: 2^0

任意の正の実数を指定します。

依存関係

[スケーリング]勾配とバイアス を選択すると、このパラメーターが有効になります。

参考

詳細は、「固定小数点データ型の指定」を参照してください。

バイアス

固定小数点データ型のバイアスを指定します。

設定

既定の設定: 0

任意の実数を指定します。

依存関係

[スケーリング]勾配とバイアス を選択すると、このパラメーターが有効になります。

参考

詳細は、「固定小数点データ型の指定」を参照してください。

固定小数点ツールによる変更に対して出力データ型の設定をロックする

固定小数点ツールや固定小数点アドバイザーによる変更を避けるために、このブロックの出力データ型の設定をロックします。

設定

既定の設定: オフ

オン

このブロックの出力データ型設定をロックします。

オフ

固定小数点ツールや固定小数点アドバイザーがこのブロックの出力データ型の設定を変更できます。

コマンド ライン情報

パラメーター: LockScale
タイプ: 文字列
値: 'off' | 'on'
既定の設定: 'off'

参考

詳細は、「[出力データ型の設定をロックする] の使用」を参照してください。

親モデル内の非バーチャル バスとして出力

親モデルに現れるバスが非バーチャルであるようにする場合、このパラメーターを選択します。[親モデル内の非バーチャル バスとして出力] の設定にかかわらず、端子への入力であるバスは、バーチャルまたは非バーチャルになることができます。

設定

既定の設定: オフ

オン

親モデルに現れるバスが非バーチャルであるようにする場合、このパラメーターを選択します。

オフ

親モデルに現れるバスがバーチャルであるようにする場合、このパラメーターの選択を解除します。

ヒント

  • 非バーチャル バスでは、すべての信号が、関連するバス オブジェクトの要素が継承されたサンプル時間を指定する場合でも、同じサンプル時間をもたなければなりません。この条件を満たさない非バーチャル バスになるバス演算は、エラーになります。詳細については、「参照モデルへのマルチレート バスの接続」を参照してください。

  • バーチャル バスで、マルチレート信号を使用するには、ルートレベルの Outport ブロックで、[サンプル時間] パラメーターを [継承] (-1) に設定します。

  • モデル参照階層の最上位モデルでは、コードの生成によって、このブロックによるバス信号出力を表す C 構造体が作成されます。

  • 参照モデルでは、このオプションを選択して C 構造体を作成します。それ以外の場合は、コード生成によって、バスの各リーフ要素の引数が作成されます。

依存関係

[データ型][Bus: <object name>] を選択すると、このパラメーターが有効になります。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

単位 (m、m/s^2、N*m など)

ブロックに対する入力信号の物理単位を指定します。

設定

既定の設定: inherit

単位を指定するには、テキスト ボックスに入力します。入力中、パラメーターには一致する可能性のある単位文字列が表示されます。サポートされる単位のリストについては、「Allowed Units」を参照してください。

単位系を制約するには、パラメーターの右側にあるリンクをクリックします。

  • Unit System Configuration ブロックがコンポーネントに存在する場合は、そのダイアログ ボックスが表示されます。そのダイアログ ボックスを使用して、コンポーネントに対して許可される単位系と許可されない単位系を指定します。

  • Unit System Configuration ブロックがコンポーネントに存在しない場合は、モデルの [コンフィギュレーション パラメーター] ダイアログ ボックスが表示されます。そのダイアログ ボックスを使用して、モデルに対して許可される単位系と許可されない単位系を指定します。

コマンド ライン情報

「ブロック固有のパラメーター」を参照してください。

端子の次元 (継承は -1)

信号がもつ次元をこの Outport ブロックに接続される順序で指定します。

設定

既定の設定: -1

有効な値は次のとおりです。

-1

任意の次元の信号をこの端子に接続できます。

N

この端子に接続される信号は、サイズ N のベクトルです。

[R C]

この端子に接続される信号は、RC 列の行列です。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

可変サイズの信号

この端子から許可される信号のタイプを指定します。

設定

既定の設定: 継承

継承

可変サイズの信号と固定サイズの信号を許可します。

いいえ

可変サイズの信号は許可しません。

[はい]

可変サイズの信号のみを許可します。

依存関係

この端子の信号が可変サイズの信号である場合、[端子の次元] パラメーターにより信号の最大次元が指定されます。

コマンド ライン情報

パラメーター: VarSizeSig
タイプ: 文字列
値: 'Inherit'| 'No' | 'Yes'
既定の設定: 'Inherit'

サンプル時間 (継承は -1)

サンプル時間の離散間隔を入力します。あるいは、連続または継承などの他の適切なサンプル時間を指定します。

設定

既定の設定: -1

既定の設定では、ブロックはモデル内の前後関係に基づいてサンプル時間を継承します。他のサンプル時間を設定するには、「サンプル時間のタイプ」の表に基づいて有効なサンプル時間を入力します。

詳細は、オンライン ドキュメンテーションの「サンプル時間の指定」を参照してください。

コマンド ライン情報

「ブロック固有のパラメーター」を参照してください。

信号タイプ

このブロックが出力する信号の数値タイプを指定します。

設定

既定の設定: 自動

自動

そのブロックの入力に接続している信号の数値タイプを出力します。

実数

実数値信号を出力します。このブロックに接続される信号は、実数でなければなりません。複素数でない場合にブロック線図を更新するかこのブロックを含んでいるモデルをシミュレートしようとすると、Simulink はエラーを表示します。

複素数

複素数信号を出力します。このブロックに接続される信号は、複素数でなければなりません。複素数でない場合にブロック線図を更新するかこのブロックを含んでいるモデルをシミュレートしようとすると、Simulink はエラーを表示します。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

サンプリング モード

入力信号が一致しなければならないサンプリング モード ([サンプル ベース] または [フレーム ベース]) を指定します。

設定

既定の設定: 自動

自動

任意のサンプリング モードが可能です。

サンプル ベース

出力信号はサンプルベースです。

フレーム ベース

出力信号はフレームベースです。

依存関係

フレームベースの処理には、DSP System Toolbox™ のライセンスが必要になります。

詳細は、DSP System Toolbox ドキュメンテーションの「Sample- and Frame-Based Concepts」を参照してください。

コマンド ライン情報

ブロック固有のパラメーターを参照してください。

特性

データ型

double | single | boolean | 整数 | 固定小数点 | 列挙型 | バス

サンプル時間

駆動ブロックから継承

多次元信号

あり

可変サイズの信号

あり

ゼロクロッシング検出

なし

コード生成

あり

参考

Inport

R2006a より前に導入

この情報は役に立ちましたか?