MinMax

最小入力値または最大入力値を出力

• 

×

ライブラリ:
Simulink / Math Operations
HDL Coder / Math Operations

説明

MinMax ブロックは、入力の最小要素または最大要素を出力します。ブロックが最小値と最大値のどちらを出力するかを、"関数" パラメーターを設定して選択します。

MinMax ブロックは、各入力値が NaN である場合を除き、NaN である入力値を無視します。すべての入力値が NaN の場合、出力は、スカラーまたは各出力ベクトル要素の値としての NaN です。

例

入力の最大値の検出

この例では、MinMax ブロックを使用して 2 つの正弦波の最大値を出力する方法を示します。

完全なシミュレーションを実行した後に、[スコープ] に結果を表示できます。最初は、最大値 (オレンジの線) は SineWave2 を追跡しています。SineWave2 値が負に変わると、最大値は SineWave1 の追跡を開始します。SineWave2 値が正に戻ると、最大値は SineWave2 の追跡を再開します。

拡張例

フォールトトレラント燃料制御システムのモデル化

この例では、Stateflow® を Simulink® と組み合わせてハイブリッド システムをモデル化する方法を示します。このタイプのモデル化は、離散イベントに基づいて多数の可能な動作モードをもつシステムに対して特に便利です。従来の信号の流れが Simulink で処理されるのに対して、制御設定の変更は Stateflow で実装されます。この例で説明するモデルでは、ガソリン エンジンの燃料制御システムを表します。このシステムは、個々のセンサーの故障が検出され、制御システムが連続稼働用に動的に再設定されるという点で堅牢です。

モデルを開く

端子

入力

Port_1 — 入力信号

スカラー | ベクトル | 行列

ブロックが最小値または最大値を出力する元の入力信号を提供します。

• このブロックが単一の入力端子をもっている場合、入力はスカラーまたはベクトルでなければなりません。このブロックは、入力ベクトルの最小要素または最大要素に等しいスカラーを出力します。

• このブロックが複数の入力端子をもっている場合、非スカラー入力はいずれも同じ次元をもたなければなりません。このブロックは、非スカラー入力と同じ次元を有するようにスカラー入力を拡張します。このブロックは、入力と同じ次元をもっている信号を出力します。各出力要素は、対応する入力要素の最小値または最大値に等しくなります。

依存関係

行列入力をサポートするには、[入力端子の数] パラメーターを 1 より大きい整数に設定しなければなりません。すべての非スカラー入力は同じ次元をもつ必要があります。

データ型: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point

Port_N — N 番目の入力信号

スカラー | ベクトル | 行列

ブロックが最小値または最大値を出力する元の入力信号を提供します。

このブロックが複数の入力端子をもっている場合、非スカラー入力はいずれも同じ次元をもたなければなりません。このブロックは、非スカラー入力と同じ次元を有するようにスカラー入力を拡張します。このブロックは、入力と同じ次元をもっている信号を出力します。各出力要素は、対応する入力要素の最小値または最大値に等しくなります。

依存関係

1 つより多い入力信号を使用するには、[入力端子の数] を 1 より大きい整数に設定します。

データ型: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point

出力

Port_1 — 入力の最小値または最大値

スカラー | ベクトル | 行列

ブロックが 1 つの入力をもつ場合、出力はスカラー値で、入力要素の最小または最大と等しくなります。ブロックが複数の入力をもつ場合、出力は入力と同じ次元をもつ信号です。各出力要素は、対応する入力要素の最小値または最大値に等しくなります。ブロック入力に異なる入力データ型がある場合、出力のサイズは入力と同じですが、精度が低くなることがあります。たとえば、入力の 1 つが int8 で 1 つが uint8 である場合、出力データ型も 8 ビットの sfix8_E1 ですが、精度が低くなります。

データ型: half | single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point

パラメーター

メイン

関数 — 最小または最大の指定

最小値 (既定値) | 最大値

関数 min または関数 max を入力に適用するかどうかを指定します。

プログラムでの使用

ブロック パラメーター: Function

型: 文字ベクトル

値: 'min' | 'max'

既定の設定: 'min'

入力端子の数 — 入力端子の数を指定

1 (既定値) | positive integer

このブロックへの入力の数を指定します。

プログラムでの使用

ブロック パラメーター: Inputs

型: 文字ベクトル

値: positive integer

既定の設定: '1'

適用範囲 — 指定した次元に沿って関数を適用する方法

すべての次元 (既定値) | 指定した次元

指定した次元に沿って関数を適用する方法を指定します。

• すべての次元 — すべての次元のすべての入力値について関数を適用します。

• 指定した次元 — 指定した次元のすべての入力値について関数を適用します。

たとえば、次のモデルでは、[関数] を [最大値] に設定し、[適用範囲] を [すべての次元] に設定しています。ブロックは、すべての次元の最も大きい入力値を返します。

依存関係

このパラメーターを有効にするには、[入力端子の数] が 1 でなければなりません。

プログラムでの使用

ブロック パラメーター: CollapseMode

型: 文字ベクトル

値: 'All dimensions' | 'Specified dimension'

既定の設定: 'All dimensions'

次元 — 関数を適用する次元を指定

1 (既定値) | 正の整数 | ... | N

関数を適用する次元を正の整数として指定します。たとえば、2 次元行列では、1 の場合は各列に関数が適用され、2 の場合は各行に関数が適用されます。

たとえば、次のモデルでは、[関数] を [最大値] に設定し、[適用範囲] を [指定した次元] に設定し、[次元] を 2 に設定しています。ブロックは、各行の最も大きい入力値を返します。

依存関係

このパラメーターを有効にするには、[適用範囲] を [指定した次元] に設定します。

プログラムでの使用

ブロック パラメーター: CollapseDim

型: 文字ベクトル

値: 正の整数

既定の設定: '1'

ゼロクロッシング検出を有効にする — ゼロクロッシング検出を有効にする

on (既定値) | off

ゼロクロッシング検出を有効にする場合は選択します。詳細については、ゼロクロッシング検出を参照してください。

プログラムでの使用

ブロック パラメーター: ZeroCross

型: 文字ベクトル | string

値: 'off' | 'on'

既定の設定: 'on'

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

-1 (既定値) | スカラー | ベクトル

サンプルの時間間隔を指定します。サンプル時間を継承するには、このパラメーターを -1 に設定します。詳細については、サンプル時間の指定を参照してください。

依存関係

このパラメーターは、-1 以外の値に設定した場合にのみ表示されます。詳細は、サンプル時間が推奨されないブロックを参照してください。

プログラムでの使用

ブロック パラメーター: SampleTime

型: string スカラーまたは文字ベクトル

既定の設定: "-1"

信号属性

すべての入力が同じデータ型をもつ — 入力は同じデータ型でなければならない

off (既定値) | on

このチェック ボックスをオンにした場合、すべての入力が同じデータ型でなければなりません。

プログラムでの使用

ブロック パラメーター: InputSameDT

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

出力の最小値 — 範囲チェックの最小出力値

[] (既定値) | スカラー

Simulink^® がチェックする出力範囲の下限値。

Simulink は、最小値を使って以下を行います。

• 一部のブロックに対するパラメーター範囲のチェック (ブロック パラメーターの最小値と最大値の指定を参照)

• シミュレーション範囲のチェック (信号範囲の指定およびシミュレーション範囲のチェックの有効化を参照)

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

• モデルから生成するコードの最適化。この最適化により、アルゴリズム コードが削除され、SIL やエクスターナル モードなどの一部のシミュレーション モードの結果に影響を与えることがあります。詳細については、Optimize using the specified minimum and maximum values (Embedded Coder)を参照してください。

メモ

[出力の最小値] により、実際の出力信号が飽和する (またはクリップされる) ことはありません。代わりに、Saturation ブロックを使用してください。

プログラムでの使用

ブロック パラメーター: OutMin

型: 文字ベクトル

値: '[ ]'| スカラー

既定の設定: '[ ]'

出力の最大値 — 範囲チェックの最大出力値

[] (既定値) | スカラー

Simulink がチェックする出力範囲の上限値。

Simulink は、最大値を使って以下を行います。

• 一部のブロックに対するパラメーター範囲のチェック (ブロック パラメーターの最小値と最大値の指定を参照)

• シミュレーション範囲のチェック (信号範囲の指定およびシミュレーション範囲のチェックの有効化を参照)

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

• モデルから生成するコードの最適化。この最適化により、アルゴリズム コードが削除され、SIL やエクスターナル モードなどの一部のシミュレーション モードの結果に影響を与えることがあります。詳細については、Optimize using the specified minimum and maximum values (Embedded Coder)を参照してください。

メモ

[出力の最大値] により、実際の出力信号が飽和する (またはクリップされる) ことはありません。代わりに、Saturation ブロックを使用してください。

プログラムでの使用

ブロック パラメーター: OutMax

型: 文字ベクトル

値: '[ ]'| スカラー

既定の設定: '[ ]'

出力データ型 — 出力データ型を指定

継承: 内部ルールによる継承 (既定値) | 継承: 逆伝播による継承 | 継承: 1 番目の入力と同じ | double | single | half | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | fixdt(1,16,0) | fixdt(1,16,2^0,0) | <data type expression>

出力のデータ型を選択します。型は継承されるか、直接指定されるか、Simulink.NumericType などのデータ型オブジェクトとして表現されます。

データ属性の設定には [データ型アシスタント] が役立ちます。[データ型アシスタント] を使用するには、 をクリックします。詳細については、データ型アシスタントを利用したデータ型の指定を参照してください。

依存関係

入力が単精度より小さい浮動小数点データ型の場合、[継承: 内部ルールによる継承] 出力データ型は単精度より小さい浮動小数点の出力型を継承するコンフィギュレーション パラメーターの設定によって変わります。データ型の符合化に必要なビット数が単精度データ型の符合化に必要な 32 ビットより少ない場合、データ型は単精度より小さくなります。たとえば、half と int16 は単精度より小さくなります。

プログラムでの使用

ブロック パラメーター: OutDataTypeStr

型: 文字ベクトル

値: 'Inherit: Inherit via internal rule' | 'Inherit: Inherit via back propagation' | 'Inherit: Same as first input' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | '<data type expression>'

既定の設定: 'Inherit: Inherit via internal rule'

固定小数点ツールによる変更に対して出力データ型の設定をロックする — 固定小数点ツールが出力データ型をオーバーライドするのを防止するオプション

off (既定値) | on

固定小数点ツールが、ブロックに指定した [出力] データ型をオーバーライドしないようにするには、このパラメーターを選択します。詳細については、[出力データ型の設定をロックする] の使用 (Fixed-Point Designer)を参照してください。

プログラムでの使用

ブロック パラメーター: LockScale

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

整数丸めモード — 固定小数点演算の丸めモード

負方向 (既定値) | 正方向 | 最も近い偶数方向 | 最も近い正の整数方向 | 最も近い整数方向 | 最も簡潔 | ゼロ方向

固定小数点演算の丸めモードを指定します。詳細については、丸め (Fixed-Point Designer)を参照してください。

ブロック パラメーターは常に最近傍の表現可能な値に丸められます。ブロックパラメーターの丸めを直接制御するには、MATLAB^® の丸め関数を使用する式をマスク フィールドに入力します。

プログラムでの使用

ブロック パラメーター: RndMeth

型: 文字ベクトル

値: 'Ceiling' | 'Convergent' | 'Floor' | 'Nearest' | 'Round' | 'Simplest' | 'Zero'

既定の設定: 'Floor'

整数オーバーフローで飽和 — オーバーフロー アクションの方法

off (既定値) | on

オーバーフローで飽和するかラップするかを指定します。

動作	根拠	オーバーフローの影響	例
このチェック ボックスをオンにする (on)。	モデルでオーバーフローが発生する可能性があるので、生成コードに飽和保護を明示的に組み込むことをお勧めします。	オーバーフローは、データ型が表現できる最小値または最大値のいずれかに飽和します。	int8 (符号付き、8 ビット整数) データ型が表すことができる最大値は 127 です。この最大値を超えるブロックの演算結果により 8 ビット整数のオーバーフローが発生します。チェック ボックスがオンになっていると、ブロック出力は 127 で飽和します。同様に、ブロック出力は最小出力値である -128 で飽和します。
このチェック ボックスをオンにしない (off)。	生成コードの効率を最適化することをお勧めします。 ブロックが範囲外の信号を処理する方法を指定しすぎないようにすることをお勧めします。詳細については、信号範囲のエラーのトラブルシューティングを参照してください。	オーバーフローは、データ型によって表現される適切な値にラップされます。	int8 (符号付き、8 ビット整数) データ型が表すことができる最大値は 127 です。この最大値を超えるブロックの演算結果により 8 ビット整数のオーバーフローが発生します。チェック ボックスをオフにすると、オーバーフローを引き起こした値は int8 として解釈され、意図しない結果が引き起こされる可能性があります。たとえば、int8 として表されるブロック結果 130 (バイナリで 1000 0010) は -126 です。

このチェック ボックスをオンにすると、飽和は出力や結果だけでなく、このブロックの内部演算すべてに適用されます。通常、オーバーフローが可能ではない場合は、コード生成プロセスで検出されます。この場合、コード ジェネレーターでは飽和コードは生成されません。

プログラムでの使用

ブロック パラメーター: SaturateOnIntegerOverflow

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

ブロックの特性

データ型	Boolean | double | fixed point | half | integer | single
直達	はい
多次元信号	はい
可変サイズの信号	はい
ゼロクロッシング検出	はい

拡張機能

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

HDL Coder™ には、HDL の実装および合成されたロジックに影響する追加のコンフィギュレーション オプションがあります。

HDL アーキテクチャ

このブロックには、生成されたコードで追加のレイテンシを導入するマルチサイクル実装があります。追加されたレイテンシを確認するには、生成されたモデルまたは検証モデルを表示します。生成されたモデルと検証モデル (HDL Coder)を参照してください。

アーキテクチャ	追加のレイテンシのサイクル	説明
既定の設定 ツリー	0	比較演算子のツリー構造を生成します。

HDL ブロック プロパティ

一般
ConstrainedOutputPipeline	既存の遅延を設計内で移動することによって出力に配置するレジスタの数。分散型パイプラインではこれらのレジスタは再分散されません。既定の設定は 0 です。詳細については、ConstrainedOutputPipeline (HDL Coder)を参照してください。
InputPipeline	生成されたコードに挿入する入力パイプライン ステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は 0 です。詳細については、InputPipeline (HDL Coder)を参照してください。
OutputPipeline	生成されたコードに挿入する出力パイプライン ステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は 0 です。詳細については、OutputPipeline (HDL Coder)を参照してください。
InstantiateStages	各カスケードの段階向けに VHDL® entity または Verilog® module を生成します。既定の設定は [オフ] です。InstantiateStages (HDL Coder)も参照してください。
SerialPartition	カスケード シリアル実装のパーティションを、各パーティションの長さのベクトルとして指定します。既定の設定では最小限の数の段階を使用します。SerialPartition (HDL Coder)も参照してください。

メモ

MinMax ブロックに対して [LatencyStrategy] 設定を有効にするには、[Tree] を [HDL Architecture] として指定しなければなりません。

ネイティブ浮動小数点
LatencyStrategy	浮動小数点演算子について、設計内のブロックを inherit、Max、Min、または Zero にマッピングするかどうかを指定します。既定の設定は [inherit] です。LatencyStrategy (HDL Coder)も参照してください。

PLC コード生成
Simulink® PLC Coder™ を使用して構造化テキスト コードを生成します。

固定小数点の変換
Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

バージョン履歴

R2006a より前に導入

R2024a: MinMax ブロックで次元の指定をサポート

MinMax ブロックで、次の新しいパラメーターを使用することで、指定した次元について最小値と最大値を見つけることができます。

• 適用範囲 — すべての次元または指定した次元について関数を適用します。

• 次元 — 関数を適用する次元。

参考

MinMax Running Resettable