主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

获得

入力に定数を乗算

  • ライブラリ:
  • 金宝appSimulink /常用模块

    金宝appSimulink /数学运算

    HDL编码器/常用模块

    HDL编码器/ HDL浮点运算

    HDL编码器/数学运算

  • 获得块

説明

获得ブロックは,入力に定数値(ゲイン)を乗算します。入力とゲインには、スカラー、ベクトル、または行列を指定できます。

ゲインの値は[ゲイン]パラメーターで指定します。[乗算]パラメーターによって,要素ごとの乗算または行列乗算を指定することができます。行列乗算の場合,このパラメーターによって乗算の順序も指定できます。

ゲインは、双から,ブロックのパラメーター属性のデータ型アシスタントで指定されたデータ型に,最近傍の丸めと飽和を使用して変換されます。次に,入力とゲインが乗算され,結果は,指定された丸めとオーバーフローモードを使用して出力データ型に変換されます。

端子

入力

すべて展開する

获得ブロックは,実数値または複素数値のスカラー,ベクトル,または行列の入力を受け入れます。获得ブロックは,固定小数点データ型をサポートします。获得ブロックの入力が実数であり、ゲインが複素数の場合、出力は複素数です。

データ型:一半|||int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点

出力

すべて展開する

获得ブロックは,定数のゲイン値で乗算された入力を出力します。获得ブロックへの入力が実数であり、ゲインが複素数の場合、出力は複素数です。

データ型:一半|||int8|int16|int32|int64|uint8|uint16|uint32|uint64|布尔|不动点

パラメーター

すべて展開する

メイン

入力に乗算する値を指定します。ゲインは実数値または複素数値のスカラー、ベクトル、または行列のいずれかになります。

プログラムでの使用

ブロックパラメーター:获得
型:文字ベクトル
値:'1' |实值或复数标量、向量或矩阵
既定の設定:' 1 '

次のいずれかの乗算モードを指定します。

  • 要素単位(k . * u)——入力の各要素にゲインの各要素を乗算します。必要に応じてブロックは拡張を行い,入力とゲインを同じ次元にします。

  • 行列(K * u)——入力とゲインは,入力を2番目のオペランドとして行列乗算されます。

  • 行列(u * K)——入力とゲインは,入力を1番目のオペランドとして行列乗算されます。

  • 行列(K * u) (uはベクトル)——入力とゲインは,入力を2番目のオペランドとして行列乗算されます。このモードは[行列(K * u)]と同じですが,次元の決め方が異なります。

    Km×n的の行列であるとします。矩阵(K * u) (u向量)は,入力を長さnのベクトルに設定し,出力を長さのベクトルに設定します。それに対して,(行列(K * u)]は伝播を使用して入力と出力の次元を決定します。m行n列ゲイン行列の場合,入力はn行问列行列に伝播でき,出力はm行问列行列になります。

プログラムでの使用

パラメーター:乘法
型:文字ベクトル
値:“Element-wise (K . * u)”|“矩阵(K * u)”|“矩阵(u * K)”|“矩阵(K * u) (u向量)”
既定の設定:“Element-wise (k . * u)”

サンプル時間を1以外の値で指定します。詳細については,サンプル時間の指定を参照してください。

依存関係

このパラメーターは,明示的に-1以外の値に設定されていない限り表示されません。詳細は,サンプル時間が推奨されないブロックを参照してください。

プログラムでの使用

ブロックパラメーター:SampleTime
型:文字ベクトル
値:スカラーまたはベクトル
既定の設定:' 1 '

信号的属性

金宝app®がチェックする出力範囲の下限値。

金宝app仿真软件は,最小値を使って以下を行います。

メモ

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

プログラムでの使用

ブロックパラメーターOutMin
:文字ベクトル
“[]”|スカラー
既定の設定:“[]”

金宝app仿真软件がチェックする出力範囲の上限値。

金宝app仿真软件は,最大値を使って以下を行います。

メモ

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

プログラムでの使用

ブロックパラメーターOutMax
:文字ベクトル
“[]”|スカラー
既定の設定:“[]”

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

継承オプションを選択すると,ブロックは次の動作を示します。

  • 継承:内部ルールによる継承——金宝appSimulink仿真は組み込みターゲットハードウェアのプロパティを考慮しつつ,数値の精度,パフォーマンス,および生成コードのサイズのバランスが取れるように,データ型を選択します。組み込みターゲットハードウェアの設定を変更すると,内部ルールにより選択されるデータ型が変更される可能性があります。たとえば,ブロックがint8型の入力にint16のゲインを乗算し,ターゲットハードウェアタイプとして(ASIC / FPGA)が指定されている場合,出力データ型はsfix24です。ターゲットハードウェアとして[未指明(假定32位通用)](汎用32ビットマイクロプロセッサ)が指定された場合,出力データ型はint32です。ターゲットマイクロプロセッサによって指定される語長では出力範囲に対応できない場合,仿金宝app真软件は診断ビューアーにエラーを表示します。

  • 継承:MSBを保持——金宝app模型は,演算の全範囲を維持するデータ型を選択した後,組み込みターゲットハードウェアに適したサイズに出力精度を低下させます。

    ヒント

    生成コードの効率を向上させるには,(整数オーバーフローで飽和)パラメーターをオフにします。

    このルールでは,オーバーフローは決して発生しません。

  • 継承:スケーリングの一致——金宝appSimulink仿真はスケーリングが入力型のスケーリングと一致するデータ型を選択します。型の全範囲が組み込みターゲット ハードウェアに適合しない場合は、その範囲を小さくして組み込みターゲット ハードウェアに適切な型が生成されます。このルールでは、オーバーフローが発生することがあります。

    コードの効率と数値の精度が,ソフトウェアにより同時に最適化されるとは限りません。これらの内部ルールが,数値精度またはパフォーマンスに対する特定の要求を満たさない場合は,以下のいずれかを行ってください。

    • 出力データ型を明示的に指定する。

    • 単に継承:入力と同じを選択します。

    • fixdt(1, 32岁,16)のように既定のデータ型を明示的に指定し,固定小数点ツールを使用してモデルにデータ型を推奨する。詳細については,fxptdlg(定点设计师)を参照してください。

    • 独自の継承ルールを指定するには,[継承:逆伝播による継承)を使用し,数据类型传播ブロックを使用します。このブロックの使い方の例については,信号属性ライブラリの数据类型传播示例ブロックを参照してください。

  • 継承:逆伝播による継承——駆動ブロックのデータ型を使用します。

  • 継承:入力と同じ——入力信号のデータ型を使用します。

依存関係

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

プログラムでの使用

ブロックパラメーターOutDataTypeStr
:文字ベクトル
“继承:通过内部规则继承”|“继承:保持最高有效位”|“继承:匹配扩展”|“继承:与输入相同”|“继承:通过反向传播继承”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”|“int32”|“uint32”|“int64”|“uint64”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|“< >数据类型表达”
既定の設定:“继承:通过内部规则继承”

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

プログラムでの使用

ブロックパラメーター:LockScale
型:文字ベクトル
値:”从“|”“
既定の設定:“关闭”

固定小数点演算の丸めモードを指定します。詳細については,丸め(定点设计师)を参照してください。

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

プログラムでの使用

ブロックパラメーター:RndMeth
型:文字ベクトル
値:'天花板' | '收敛' | '地板' | '最近' | 'Round' | '最简单' | '零'
既定の設定:“地板”

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

動作 根拠 オーバーフローの影響

このチェックボックスをオンにする()。

モデルでオーバーフローが発生する可能性があるので,生成コードに飽和保護を明示的に組み込むことをお勧めします。

オーバーフローは,データ型が表現できる最小値または最大値のいずれかに飽和します。

int8(符号付き8ビット整数)データ型が表すことができる最大値は127です。この最大値を超えるブロックの演算結果により8ビット整数のオーバーフローが発生します。チェックボックスがオンになっていると,ブロック出力は127で飽和します。同様に,ブロック出力は最小出力値である-128で飽和します。

このチェックボックスをオンにしない()。

生成コードの効率を最適化することをお勧めします。

ブロックが範囲外の信号を処理する方法を指定しすぎないようにすることをお勧めします。詳細については,信号範囲のエラーのトラブルシューティングを参照してください。

オーバーフローは,データ型によって表現される適切な値にラップされます。

int8(符号付き8ビット整数)データ型が表すことができる最大値は127です。この最大値を超えるブロックの演算結果により8ビット整数のオーバーフローが発生します。チェックボックスをオフにすると,オーバーフローを引き起こした値はint8として解釈され,意図しない結果が引き起こされる可能性があります。たとえば,int8として表されるブロック結果130(バイナリで1000 0010)は-126です。

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

プログラムでの使用

ブロックパラメーター:SaturateOnIntegerOverflow
型:文字ベクトル
値:”从“|”“
既定の設定:“关闭”

パラメーター属性

ゲインの最小値を指定します。既定値は[](指定なし)です。金宝app仿真软件は,以下を行う際にこの値を使用します。

プログラムでの使用

ブロックパラメーターParamMin
:文字ベクトル
:スカラー
既定の設定:“[]”

ゲインの最大値を指定します。既定値は[](指定なし)です。金宝app仿真软件は,以下を行う際にこの値を使用します。

プログラムでの使用

ブロックパラメーターParamMax
:文字ベクトル
:スカラー
既定の設定:“[]”

获得パラメーターのデータ型を指定します。

プログラムでの使用

ブロックパラメーターParamDataTypeStr
:文字ベクトル
继承:通过内部规则继承|“继承:与输入相同”|“继承:通过反向传播继承”|“单一”|“一半”|“int8”|“uint8”|“int16”|“uint16”“int32”|“uint32”|“int64”|“uint64”|“fixdt(16)”|“fixdt(0) 1, 16日”|“fixdt(1, 16日2 ^ 0,0)”|“< >数据类型表达”
既定の設定:“继承:通过内部规则继承”

ブロックの特性

データ型

布尔||不动点|一半|整数|

直接フィードスルー

はい

多次元信号

はい

可変サイズの信号

はい

ゼロクロッシング検出

いいえ

拡張機能

C / c++コード生成
金宝app仿真软件®编码器™を使用してCおよびc++コードを生成します。

PLCコード生成
金宝app仿真软件®PLC编码器™を使用して構造化テキストコードを生成します。

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

R2006aより前に導入