このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。
Outport
サブシステムの出力端子または外部出力を作成
- ライブラリ:
Simulink / Commonly Used Blocks
Simulink / Ports & Subsystems
Simulink / Sinks
HDL Coder / Commonly Used Blocks
HDL Coder / Ports & Subsystems
HDL Coder / Sinks
説明
Outport ブロックは信号をシステムからシステム外部の宛先にリンクします。あるサブシステムからモデルの別の部分に流れる信号を接続できます。モデルの階層構造の最上位レベルで外部出力を供給することもできます。
Simulink® は、以下のルールに従って Outport ブロック端子番号を割り当てます。
ルートレベル システム内またはサブシステム内の Outport ブロックに自動的に 1 から順番に番号を付けます。
Outport ブロックを追加する場合、使用可能な次の番号が割り当てられます。
Outport ブロックを削除する場合、Outport ブロックが順番どおり並び、どの番号も省略されることなく自動的に他の端子にも連番が付けられます。
サブシステム内の Outport ブロック
サブシステムの Outport ブロックは、サブシステムからの出力を表します。Subsystem ブロックの出力端子に接続されている信号は、そのサブシステムの対応する Outport ブロックから出力されます。出力端子に対応する Outport ブロックは、[端子番号] パラメーターが Subsystem ブロックの出力端子の相対位置に一致するブロックです。たとえば、[端子番号] パラメーターが 1 に等しい Outport ブロックは、その信号を Subsystem ブロックの一番上の出力端子に接続されているブロックに送信します。
Outport ブロックの端子番号に関して再度番号付けを行う場合、ブロックは別の出力端子に接続されるようになります。ブロックはサブシステム外部の同じブロックに引き続き信号を送信します。
ヒント
多くのバス要素で構成されるバスを含むモデルについては、In Bus Element ブロックと Out Bus Element ブロックを使用することを検討してください。これらのブロックは以下を行います。
ブロック線図における信号線の複雑さと煩雑さを低減する。
インターフェイスの段階的な変更を容易にする。
使用ポイントに近いバス要素へのアクセスを許可して、Bus Selector および Goto ブロック構成の使用を回避する。
In Bus Element ブロックはブロック タイプ Inport であり、Out Bus Element ブロックはブロック タイプ Outport です。
モデルの階層構造内の最上位 Outport ブロック
モデルの階層構造の最上位レベルにある Outport ブロックには 2 つの用途があります。このブロックは、ベース MATLAB® ワークスペースに外部出力を供給し、解析関数 linmod と trim によってシステムから出力を取得する手段を提供します。
ワークスペースに外部出力を供給するには、[コンフィギュレーション パラメーター] 、 [データのインポート/エクスポート] ペイン (MATLAB ワークスペースへのデータのエクスポートを参照) または sim
[t,x,y] = sim(...);
y を行列として書き込みます。各列には異なる Outport ブロックのデータが含まれます。列の順序は、Outport ブロックの端子番号の順序と一致します。
2 番目の (状態) 引数の後ろに 1 つを超える変数名を指定した場合、各 Outport ブロックからのデータは異なる変数に書き込まれます。たとえば、システムが 2 つの Outport ブロック (Outport ブロック 1 からのデータを speed に保存するブロックと Outport ブロック 2 からのデータを dist に保存するブロック) をもっている場合、このコマンドを指定します。
[t,x,speed,dist] = sim(...);
ルートレベルの Outport へのバスの接続
モデル内のルートレベルの Outport ブロックは、バスのすべての要素が同じデータ型をもつ場合に限り、バーチャル バスを受け取ることができます。Outport ブロックは、バスを自動的にバスと同じ要素数をもつベクトルにまとめ、そのベクトルを出力として提供します。
混在する型を含むバスをモデルのルートレベルの Outport ブロックが受け取るようにする場合、Outport ブロックの [データ型] を Bus: <object name> に設定します。バスがバーチャルである場合、バーチャルおよび非バーチャル バスの変換で説明しているように、非バーチャルに変換されます。
ルートレベルの Outport ブロックと Simulink.Signal オブジェクトの関連付け
ルートレベルの Outport ブロックを Simulink.Signal オブジェクトに関連付けるには、モデル データ エディターを使用します。信号の場合を参照してください。
端子
入力
パラメーター
メイン
端子番号 — 親ブロックの端子の位置
1 (既定値) | 実数の整数
ブロックに対応する端子が親 Subsystem または Model ブロックに現れる順序を指定します。
別の端子を作成するブロックを追加する場合、端子番号は次に利用可能な番号になります。
ある端子に関連付けられているすべてのブロックを削除すると、その端子が削除されます。どの番号も省略されることなく連番になるように、その他の端子の番号を付け直します。
端子の数を超える端子番号を指定すると、その番号の端子と、その番号まで連番になる他の端子が作成されます。
プログラムでの使用
ブロック パラメーター: Port |
| 型: 文字ベクトル |
| 値: 実数の整数 |
既定の設定: '1' |
信号名 — 信号名
' ' (既定値) | 文字ベクトル
生成されたコード内の対応する信号データの名前を指定します。このパラメーターを使用して、ストレージ クラスをルートレベルの Outport ブロックに適用する際の信号データの名前を指定します。
プログラムでの使用
ブロック パラメーター: SignalName |
| 型: 文字ベクトル |
| 値: 文字ベクトル |
既定の設定: ' ' |
アイコン表示 — アイコン表示
端子番号 (既定値) | 信号名 | 端子番号と信号名
ブロック アイコンに表示される情報を指定します。
プログラムでの使用
ブロック パラメーター: IconDisplay
|
| 型: 文字ベクトル |
値: 'Signal name' | 'Port number' | 'Port number and signal name' |
既定の設定: 'Port number'
|
ソース非接続時に出力を指定 — 未接続の出力値を指定
off (既定値) | on
ソースが接続されていないときの定数出力値を指定します。
依存関係
Variant Subsystem ブロック内の未接続の Outport ブロックで使用できます。
プログラムでの使用
ブロック パラメーター: OutputWhenUnconnected
|
| 型: 文字ベクトル |
値: 'on' | 'off' |
既定の設定: 'off'
|
定数値 — ブロックが未接続の場合の出力値
0 (既定値) | スカラー | ベクトル
ソースが接続されていないときの定数出力値を指定します。
依存関係
[ソース非接続時に出力を指定] が選択されている未接続の Outport ブロックについての Variant Subsystem ブロックで使用できます。
プログラムでの使用
ブロック パラメーター: OutputWhenUnconnectedValue |
| 型: 文字ベクトル |
値: scalar | vector |
既定の設定: '0' |
ベクトル パラメーターを 1 次元として解釈 — ベクトルを 1 次元として処理
on (既定値) | off
[定数値] パラメーターが N 要素の行または列ベクトルの場合、長さ N のベクトルを出力で作成するにはこのチェック ボックスをオンにします。
依存関係
[ソース非接続時に出力を指定] パラメーターを選択した場合、未接続の Outport ブロックの Variant Subsystem ブロックで使用できます。
プログラムでの使用
ブロック パラメーター: VectorParamsAs1DForOutWhenUnconnected
|
| 型: 文字ベクトル |
値: 'on' | 'off' |
既定の設定: 'on'
|
出力端子がバーチャルであることを確認 — 出力端子がバーチャルであることを確認
off (既定値) | on
Simulink が出力端子で信号バッファーを使用することを指定するには、このチェック ボックスをオフにします。このバッファーは、Outport ブロック信号の一貫した初期化を必ず行います。
このチェック ボックスをオンにした場合、Simulink は信号バッファーを削除しようとします。
信号バッファーが必要ではない場合、Simulink はバッファーを削除します。
データの一貫性および適切な実行を行うために信号バッファーが必要である場合、Simulink はバッファーを削除できなかったことを示すエラーを表示します。
Assignment ブロックを介して部分的な書き込みを許可します。
条件付きの書き込みと部分的な書き込みの例については、出力端子がバーチャルであることを確認を参照してください。
依存関係
このパラメーターは、次のブロックに適用されます。
Conditional subsystem
Assignment
Merge
ルート Outport ブロックをもつモデル
プログラムでの使用
ブロック パラメーター: EnsureOutportIsVirtual
|
| 型: 文字ベクトル |
値: 'on' | 'off' |
既定の設定: 'off'
|
初期出力の値のソース — 初期出力の値のソース
[ダイアログ] (既定値) | [入力信号]
ブロックの初期出力値のソースを選択します。初期出力値が [初期出力] パラメーターの値であることを指定するには、[ダイアログ] を選択します。初期出力値が入力信号から継承されることを指定するには、[入力信号] を選択します。条件付きサブシステムの初期出力値を参照してください。
ヒント
クラシック初期化モードを使用している場合、
[入力信号]を選択するとエラーが発生します。初期出力値を入力信号から継承するには、このパラメーターを[ダイアログ]に設定して [初期出力] の値に[](空行列) を指定します。詳細については、条件付きサブシステムの初期出力値を参照してください。
依存関係
条件付きサブシステム内の Outport ブロックで使用できます。
[ダイアログ] を選択すると次のパラメーターが表示されます。
ディセーブル時の出力
初期出力
プログラムでの使用
ブロック パラメーター: SourceOfInitialOutputValue
|
| 型: 文字ベクトル |
値: 'Dialog' | 'Input signal' |
既定の設定: 'Dialog'
|
ディセーブル時の出力 — ディセーブル時の出力
保持 (既定値) | リセット
サブシステムがディセーブルになったときのブロック出力に何が起こるのかを指定します。サブシステムがディセーブルになる場合に出力が保持されることを示すには、[保持] を選択します。サブシステムがディセーブルになる場合に出力が [初期出力] で指定された値にリセットされることを示すには、[リセット] を選択します。
依存関係
有効化と無効化の有効なセマンティクスのある条件付きサブシステム内の Outport ブロックに対して [初期出力の値のソース] パラメーターの値として [ダイアログ] を選択する場合に使用できます。たとえば、Enabled Subsystem ブロック内の Outport ブロックでパラメーターは使用可能であり、Triggered Subsystem ブロック内の Outport ブロックでは使用できません。
Outport ブロックが Function-Call Subsystem ブロック内にある場合、このパラメーターは、Function-Call Subsystem ブロックが Stateflow® チャート内の状態に接続されている場合にのみ意味をもちます。詳細については、Function-Call Subsystem のステートへのバインド (Stateflow)を参照してください。
条件付きサブシステムの出力を Merge ブロックに接続するときは、このパラメーターを 保持 に設定します。[リセット] に設定するとエラーが返されます。
プログラムでの使用
ブロック パラメーター: OutputWhenDisabled
|
| 型: 文字ベクトル |
値: 'held' | 'reset' |
既定の設定: 'held'
|
初期出力 — 条件付き実行サブシステムの初期出力
[] (既定値) | スカラー | 構造体
条件付き実行サブシステムの場合は、そのサブシステムを実行する前とそのサブシステムが実行不能になっている間にブロック出力を指定します。初期出力値を入力信号から継承するには [] を指定します。詳細については、条件付きサブシステムの初期出力値を参照してください。
初期条件構造体の指定方法の詳細は、バス要素の初期条件の指定を参照してください。
ヒント
条件付きサブシステムが Merge ブロックを駆動する場合は、Outport ブロックの初期条件 (IC) を指定する必要はありません。詳細については、指定不足の初期化の検出を参照してください。
依存関係
条件付きサブシステム内の Outport ブロックに対して [初期出力の値のソース] が [ダイアログ] に設定されている場合に使用できます。
制限
このブロックでは、
infまたはNaNの初期出力が許可されません。入力がバーチャル バスのとき、[初期出力] の値
[]はdouble(0)として扱われます。入力に非バーチャル バスが含まれている場合、[初期出力] では非ゼロのスカラー値がサポートされません。
プログラムでの使用
ブロック パラメーター: InitialOutput
|
| 型: 文字ベクトル |
値: '[]' | スカラー | 構造体 |
既定の設定: '[]' |
信号属性
[データ型アシスタントを表示] ボタン 
をクリックして、データ型の属性の設定に役立つ [データ型アシスタント] を表示します。詳細については、データ型アシスタントを利用したデータ型の指定を参照してください。
最小値 — 出力の最小値
[] (既定値) | スカラー
Simulink がチェックする出力範囲の下限値。
この数値は有限の実数で double のスカラー値でなければなりません。
メモ
このブロックのデータ型としてバス オブジェクトを指定した場合、ブロックのバス データの最小値を設定しないでください。Simulink によりこの設定は無視されます。代わりに、データ型として指定したバス オブジェクトのバス要素の最小値を設定してください。バス要素の [最小値] プロパティの詳細については、Simulink.BusElement を参照してください。
Simulink ソフトウェアは、以下を行う際にこの値を使用します。
シミュレーション範囲のチェック (信号範囲の指定を参照)
固定小数点データ型の自動スケーリング
モデルから生成するコードの最適化。この最適化により、アルゴリズム コードが削除され、SIL やエクスターナル モードなどの一部のシミュレーション モードの結果に影響を与えることがあります。詳細については、指定した最小値と最大値を使用した最適化 (Embedded Coder)を参照してください。
プログラムでの使用
ブロック パラメーター: OutMin |
| 型: 文字ベクトル |
値: '[ ]'| スカラー |
既定の設定: '[ ]' |
最大値 — 出力の最大値
[] (既定値) | スカラー
Simulink がチェックする出力範囲の上限値。
この数値は有限の実数で double のスカラー値でなければなりません。
メモ
このブロックのデータ型としてバス オブジェクトを指定した場合、ブロックのバス データの最大値を設定しないでください。Simulink によりこの設定は無視されます。代わりに、データ型として指定したバス オブジェクトのバス要素の最大値を設定します。バス要素の [最大値] プロパティの詳細については、Simulink.BusElement を参照してください。
Simulink ソフトウェアは、以下を行う際にこの値を使用します。
シミュレーション範囲のチェック (信号範囲の指定を参照)
固定小数点データ型の自動スケーリング
モデルから生成するコードの最適化。この最適化により、アルゴリズム コードが削除され、SIL やエクスターナル モードなどの一部のシミュレーション モードの結果に影響を与えることがあります。詳細については、指定した最小値と最大値を使用した最適化 (Embedded Coder)を参照してください。
プログラムでの使用
ブロック パラメーター: OutMax |
| 型: 文字ベクトル |
値: '[ ]'| スカラー |
既定の設定: '[ ]' |
データ型 — 出力データ型
Inherit: auto (既定値) | double | single | half | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | [fixdt(1,16)] | fixdt(1,16,0) | fixdt(1,16,2^0,0) | string | Enum:<class name> | Bus:<object name> | <data type expression>
外部入力の出力データ型を指定します。型は継承されるか、直接指定されるか、Simulink.NumericType などのデータ型オブジェクトとして表現されます。
ヒント
データ型式として Simulink.Bus オブジェクトの名前を入力することはできません。Bus オブジェクトを使用してブロックの [データ型] を指定するには、[Bus: <object name>] オプションを選択して <object name> を Bus オブジェクトの名前で置き換えます。
プログラムでの使用
ブロック パラメーター: OutDataTypeStr |
| 型: 文字ベクトル |
値: 'Inherit: auto' | 'double' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'boolean' | 'fixdt(1,16)' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'string' | 'Enum: <class name>' | 'Bus: <object name>' | '<data type expression>' |
既定の設定: 'Inherit: auto' |
固定小数点ツールによる変更に対して出力データ型の設定をロックする — 固定小数点ツールがデータ型をオーバーライドするのを防止
off (既定値) | on
固定小数点ツールや固定小数点アドバイザーによる変更を避けるために、このブロックの出力データ型の設定をロックします。詳細については、[出力データ型の設定をロックする] の使用 (Fixed-Point Designer)を参照してください。
プログラムでの使用
ブロック パラメーター: LockScale |
| 型: 文字ベクトル |
値: 'off' | 'on' |
既定の設定: 'off' |
親モデル内の非バーチャル バスとして出力 — 親モデル内の非バーチャル バスとして出力
off (既定値) | on
親モデル内で非バーチャルになる出力端子のバスを指定します。親モデルに現れるバスが非バーチャルであるようにする場合、このパラメーターを選択します。[親モデル内の非バーチャル バスとして出力] の設定にかかわらず、端子への入力であるバスは、バーチャルまたは非バーチャルになることができます。
親モデルに現れるバスがバーチャルであるようにする場合、このパラメーターの選択を解除します。
ヒント
非バーチャル バスでは、すべての信号が、関連するバス オブジェクトの要素が継承されたサンプル時間を指定する場合でも、同じサンプル時間をもたなければなりません。この要件を満たさない非バーチャル バスになる演算は、エラーになります。詳細については、非バーチャル バスのサンプル時間の変更を参照してください。
バーチャル バスでマルチレート信号を使用するには、ルートレベルの Outport ブロックで、[サンプル時間] パラメーターを [継承] (
-1) に設定します。モデル参照階層の最上位モデルでは、コードの生成によって、このブロックのバス出力を表す C 構造体が作成されます。
参照モデルでは、このオプションを選択して C 構造体を作成します。それ以外の場合は、コード生成によって、バスの各リーフ要素の引数が作成されます。
依存関係
[データ型] が [Bus: <object name>] に設定されている場合に使用できます。
プログラムでの使用
ブロック パラメーター: BusOutputAsStruct |
| 型: 文字ベクトル |
値: 'off' | 'on' |
既定の設定: 'off' |
単位 (m、m/s^2、N*m など) — ブロックに対する入力信号の物理単位
inherit (既定値) | <Enter unit>
ブロックに対する入力信号の物理単位を指定します。単位を指定するには、テキスト ボックスに入力します。入力中、パラメーターには一致する可能性のある単位が表示されます。サポートされる単位のリストについては、「Allowed Units」を参照してください。
単位系を制約するには、パラメーターの右側にあるリンクをクリックします。
Unit System Configuration ブロックがコンポーネントに存在する場合は、そのダイアログ ボックスが表示されます。そのダイアログ ボックスを使用して、コンポーネントに対して許可される単位系と許可されない単位系を指定します。
Unit System Configuration ブロックがコンポーネントに存在しない場合は、モデルの [コンフィギュレーション パラメーター] ダイアログ ボックスが表示されます。そのダイアログ ボックスを使用して、モデルに対して許可される単位系と許可されない単位系を指定します。
プログラムでの使用
ブロック パラメーター: Unit
|
| 型: 文字ベクトル |
値: 'inherit' | '<Enter unit>'
|
既定の設定: 'inherit'
|
端子の次元 (継承は -1) — 端子の次元
-1 (既定値) | 整数 | [整数, 整数]
この Outport ブロックに接続するために信号に必要な次元を指定します。
| 任意の次元の信号をこの端子に接続できます。 |
| この端子に接続される信号は、サイズ |
| この端子に接続される信号は、 |
プログラムでの使用
ブロック パラメーター: PortDimensions |
| 型: 文字ベクトル |
値: '-1' | 整数 | [整数, 整数] |
既定の設定: '-1' |
可変サイズの信号 — 可変サイズの信号を許可
継承 (既定値) | いいえ | あり
この端子の出力で許可される信号のタイプを指定します。可変サイズの信号と固定サイズの信号を許可するには、[継承] を選択します。可変サイズの信号のみを許可するには、[あり] を選択します。固定サイズの信号のみを許可するには、[なし] を選択します。
依存関係
この端子の信号が可変サイズの信号である場合、[端子の次元] パラメーターにより信号の最大次元が指定されます。
コマンド ライン情報
パラメーター: VarSizeSig
|
| 型: 文字ベクトル |
値: 'Inherit' | 'No' | 'Yes'
|
既定の設定: 'Inherit'
|
サンプル時間 (継承は -1) — サンプル時間の指定
-1 (既定値) | スカラー
サンプル時間の離散間隔を指定します。あるいは、連続または継承などの他の適切なサンプル時間を指定します。
既定の設定では、ブロックはモデル内の前後関係に基づいてサンプル時間を継承します。他のサンプル時間を設定するには、サンプル時間のタイプの表に基づいて有効なサンプル時間を入力します。
プログラムでの使用
ブロック パラメーター: SampleTime |
| 型: 文字ベクトル |
| 値: スカラー |
既定の設定: '-1' |
信号タイプ — 出力信号タイプ
自動 (既定値) | 実数 | 複素数
信号出力の数値型を指定します。その入力に接続している信号の数値型を選択するには、[自動] を選択します。それ以外の場合は、実数または複素信号型を選択します。
プログラムでの使用
ブロック パラメーター: SignalType |
| 型: 文字ベクトル |
値: 'auto' | 'real' | 'complex' |
既定の設定: 'auto' |
ブロックの特性
データ型 |
|
直接フィードスルー |
|
多次元信号 |
|
可変サイズの信号 |
|
ゼロクロッシング検出 |
|
拡張機能
参考
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
