fimath

固定小数点の算術設定を指定

ページ内をすべて折りたたむ

構文

F = fimath

F = fimath(Name,Value)

説明

F = fimath は fimath オブジェクトを fimath の既定のプロパティ設定で作成します。

例

F = fimath(Name,Value) は 1 つ以上の名前と値のペアの引数を使用して fimath オブジェクトのプロパティを指定します。コンストラクターで指定されないプロパティについては、いずれも既定値が使用されます。

例

すべて折りたたむ

既定の fimath オブジェクトの作成

ライブスクリプトを開く

この例では、既定のプロパティ設定で fimath オブジェクトを作成する方法を示します。

F = fimath

F = 
        RoundingMethod: Nearest
        OverflowAction: Saturate
           ProductMode: FullPrecision
               SumMode: FullPrecision

fimath オブジェクトのプロパティの設定

ライブスクリプトを開く

fimath オブジェクトのプロパティは、名前と値のペアを使用したオブジェクトの作成時に設定します。たとえば、オーバーフローアクションを飽和に、丸め手法を最も近い偶数方向の丸めに設定します。

F = fimath('OverflowAction','Saturate','RoundingMethod','Convergent')

F = 
        RoundingMethod: Convergent
        OverflowAction: Saturate
           ProductMode: FullPrecision
               SumMode: FullPrecision

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: F = fimath('OverflowAction','Saturate','RoundingMethod','Floor')

`CastBeforeSum` — 両方のオペランドが加算前に加算データ型にキャストされるかどうか
`true` または `1` (既定値) | `false` または `0`

両方のオペランドが加算前に加算データ型にキャストされるかどうか。数値または logical の 1 (true) または 0 (false) として指定します。

メモ

SumMode が FullPrecision に設定されていると、このプロパティは非表示になります。

例: F = fimath('CastBeforeSum',true)

`MaxProductWordLength` — 乗算データ型の最大許容語長
`65535` (既定値) | 正の整数

乗算データ型の最大許容語長。正の整数として指定します。

例: F = fimath('MaxProductWordLength',16)

`MaxSumWordLength` — 加算データ型の最大許容語長
65535 (既定値) | 正の整数

加算データ型の最大許容語長。正の整数として指定します。

例: F = fimath('MaxSumWordLength',16)

`OverflowAction` — オーバーフロー時のアクション
`'Saturate'` (既定値) | `'Wrap'`

オーバーフロー時のアクション。次の値のいずれかとして指定します。

'Saturate' – オーバーフロー時に固定小数点の範囲の最大値または最小値に飽和します。
'Wrap' — オーバーフロー時にラップします。このモードは、2 の補数オーバーフローとも呼ばれます。

例: F = fimath('OverflowAction','Wrap')

データ型: char

`ProductBias` — 乗算データ型のバイアス
`0` (既定値) | 浮動小数点数

乗算データ型のバイアス。浮動小数点数として指定します。

例: F = fimath('ProductBias',1)

`ProductFixedExponent` — 乗算データ型の固定小数点の指数
`-30` (既定値) | 非ゼロの整数

乗算データ型の固定小数点の指数。非ゼロの整数として指定します。

メモ

ProductFractionLength は、ProductFixedExponent の負の値です。1 つのプロパティを変更すると、他のプロパティも変更されます。

例: F = fimath('ProductFixedExponent',-20)

`ProductFractionLength` — 乗算データ型の小数部の長さ
`30` (既定値) | 非ゼロの整数

乗算データ型の小数部の長さ (ビット単位)。非ゼロの整数として指定します。

メモ

ProductFractionLength は、ProductFixedExponent の負の値です。1 つのプロパティを変更すると、他のプロパティも変更されます。

例: F = fimath('ProductFractionLength',20)

`ProductMode` — 乗算データ型の決定方法
`'FullPrecision'` (既定値) | `'KeepLSB'` | `'KeepMSB'` | `'SpecifyPrecision'`

乗算データ型の決定方法。次の値のいずれかとして指定します。

'FullPrecision' – 結果の完全精度を維持します。
'KeepLSB' – 最下位ビットを維持します。乗算の語長を指定します。小数部の長さは積の最下位ビットを維持するように設定されます。
'KeepMSB' – 最上位ビットを維持します。乗算の語長を指定します。小数部の長さは積の最上位ビットを維持するように設定されます。
'SpecifyPrecision' – 語長と小数部の長さまたは乗算の傾きとバイアスを指定します。

例: F = fimath('ProductMode','KeepLSB')

データ型: char

`ProductSlope` — 乗算データ型の傾き
`9.3132e-10` (既定値) | 有限の正の浮動小数点数

乗算データ型の傾き。有限の正の浮動小数点数として指定します。

メモ

$P r o d u c t S l o p e = P r o d u c t S l o p e A d j u s t m e n t F a c t o r \times 2^{P r o d u c t F i x e d E x p o n e n t}$

これらのプロパティの 1 つを変更すると、他のプロパティに影響を与えます。

例: F = fimath('ProductSlope',9.3132e-10)

`ProductSlopeAdjustmentFactor` — 乗算データ型の傾き調整係数
`1` (既定値) | 1 以上 2 未満の浮動小数点数

乗算データ型の傾き調整係数。1 以上 2 未満の浮動小数点数として指定します。

メモ

$P r o d u c t S l o p e = P r o d u c t S l o p e A d j u s t m e n t F a c t o r \times 2^{P r o d u c t F i x e d E x p o n e n t}$

これらのプロパティの 1 つを変更すると、他のプロパティに影響を与えます。

例: F = fimath('ProductSlopeAdjustmentFactor',1)

`ProductWordLength` — 乗算データ型の語長
`32` (既定値) | 正の整数

乗算データ型の語長 (ビット単位)。正の整数として指定します。

例: F = fimath('ProductWordLength',64)

`RoundingMethod` — 使用する丸め手法です。
`'Nearest'` (既定値) | `'Ceiling'` | `'Convergent'` | `'Zero'` | `'Floor'` | `'Round'`

使用する丸め手法。次の値のいずれかとして指定します。

'Nearest' – 最も近い整数方向に丸めます。等距離の場合は、正の無限大方向に丸めます。
'Ceiling' – 正の無限大方向に丸めます。
'Convergent' – 最も近い整数方向に丸めます。等距離の場合は、最も近い偶数の格納整数に丸めます (最小バイアス)。
'Zero' – ゼロ方向に丸めます。
'Floor' – 負の無限大方向に丸めます。
'Round' – 最も近い整数方向に丸めます。等距離の場合、負数に対しては負の無限大方向に丸め、正数に対しては正の無限大方向に丸めます。

例: F = fimath('RoundingMethod','Convergent')

データ型: char

`SumBias` — 加算データ型のバイアス
`0` (既定値) | 浮動小数点数

加算データ型のバイアス。浮動小数点数として指定します。

例: F = fimath('SumBias',0)

`SumFixedExponent` — 加算データ型の固定小数点の指数
`-30` (既定値) | 非ゼロの整数

加算データ型の固定小数点の指数。非ゼロの整数として指定します。

メモ

SumFractionLength は、SumFixedExponent の負の値です。1 つのプロパティを変更すると、他のプロパティも変更されます。

例: F = fimath('SumFixedExponent',-20)

`SumFractionLength` — 加算データ型の小数部の長さ
`30` (既定値) | 非ゼロの整数

加算データ型の小数部の長さ (ビット単位)。非ゼロの整数として指定します。

メモ

SumFractionLength は、SumFixedExponent の負の値です。1 つのプロパティを変更すると、他のプロパティも変更されます。

例: F = fimath('SumFractionLength',20)

`SumMode` — 加算データ型の決定方法
`'FullPrecision'` (既定値) | `'KeepLSB'` | `'KeepMSB'` | `'SpecifyPrecision'`

加算データ型の決定方法。次の値のいずれかとして指定します。

'FullPrecision' – 結果の完全精度を維持します。
'KeepLSB' – 最下位ビットを維持します。加算データ型の語長を指定します。小数部の長さは合計の最下位ビットを維持するように設定されます。
'KeepMSB' – 最上位ビットを維持します。加算データ型の語長を指定します。小数部の長さは合計の最上位ビットを維持するように設定され、必要以上の小数部ビットはありません。
'SpecifyPrecision' – 加算データ型の語長と小数部の長さまたは傾きとバイアスを指定します。

例: F = fimath('SumMode','KeepLSB')

データ型: char

`SumSlope` — 加算データ型の傾き
`9.3132e-10` (既定値) | 浮動小数点数

加算データ型の傾き。浮動小数点数として指定します。

メモ

$S u m S l o p e = S u m S l o p e A d j u s t m e n t F a c t o r \times 2^{S u m F i x e d E x p o n e n t}$

これらのプロパティの 1 つを変更すると、他のプロパティに影響を与えます。

例: F = fimath('SumSlope',9.3132e-10)

`SumSlopeAdjustmentFactor` — 加算データ型の傾き調整係数
`1` (既定値) | 1 以上 2 未満の浮動小数点数

加算データ型の傾き調整係数。1 以上 2 未満の浮動小数点数として指定します。

メモ

$S u m S l o p e = S u m S l o p e A d j u s t m e n t F a c t o r \times 2^{S u m F i x e d E x p o n e n t}$

これらのプロパティの 1 つを変更すると、他のプロパティに影響を与えます。

例: F = fimath('SumSlopeAdjustmentFactor',1)

`SumWordLength` — 加算データ型の語長
`32` (既定値) | 正の整数

加算データ型の語長 (ビット単位)。正の整数として指定します。

例: F = fimath('SumWordLength',64)

拡張機能

すべて展開する

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

使用上の注意および制限:

Simulink^® から MATLAB^® Function ブロックに読み込まれる固定小数点信号は、fimath オブジェクトに割り当てられます。このオブジェクトは、モデルエクスプローラーの MATLAB Function ブロックのダイアログで定義します。
生成されるコードで fimath オブジェクトを作成するのに使用します。
fimath オブジェクトの ProductMode プロパティが FullPrecision 以外の値に設定されている場合、ProductWordLength および ProductFractionLength プロパティは定数でなければなりません。
fimath オブジェクトの SumMode プロパティが FullPrecision 以外の値に設定されている場合、SumWordLength および SumFractionLength プロパティは定数でなければなりません。

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

バージョン履歴

R2006a より前に導入

すべて展開する

R2021a: `fi`、`fimath`、`numerictype` オブジェクトのあいまいなプロパティ名はサポートされない

以前のリリースでは、fi、fimath、numerictype オブジェクトのあいまいなプロパティに対して警告が表示されていました。R2021a では、あいまいなプロパティ名のサポートは削除されています。代わりに正確なプロパティ名を使用してください。

参考

fimath

構文

説明

例

既定の fimath オブジェクトの作成

fimath オブジェクトのプロパティの設定

名前と値の引数

CastBeforeSum — 両方のオペランドが加算前に加算データ型にキャストされるかどうか true または 1 (既定値) | false または 0

MaxProductWordLength — 乗算データ型の最大許容語長 65535 (既定値) | 正の整数

MaxSumWordLength — 加算データ型の最大許容語長 65535 (既定値) | 正の整数

OverflowAction — オーバーフロー時のアクション 'Saturate' (既定値) | 'Wrap'

ProductBias — 乗算データ型のバイアス 0 (既定値) | 浮動小数点数

ProductFixedExponent — 乗算データ型の固定小数点の指数 -30 (既定値) | 非ゼロの整数

ProductFractionLength — 乗算データ型の小数部の長さ 30 (既定値) | 非ゼロの整数

ProductMode — 乗算データ型の決定方法 'FullPrecision' (既定値) | 'KeepLSB' | 'KeepMSB' | 'SpecifyPrecision'

ProductSlope — 乗算データ型の傾き 9.3132e-10 (既定値) | 有限の正の浮動小数点数

ProductSlopeAdjustmentFactor — 乗算データ型の傾き調整係数 1 (既定値) | 1 以上 2 未満の浮動小数点数

ProductWordLength — 乗算データ型の語長 32 (既定値) | 正の整数

RoundingMethod — 使用する丸め手法です。 'Nearest' (既定値) | 'Ceiling' | 'Convergent' | 'Zero' | 'Floor' | 'Round'

SumBias — 加算データ型のバイアス 0 (既定値) | 浮動小数点数

SumFixedExponent — 加算データ型の固定小数点の指数 -30 (既定値) | 非ゼロの整数

SumFractionLength — 加算データ型の小数部の長さ 30 (既定値) | 非ゼロの整数

SumMode — 加算データ型の決定方法 'FullPrecision' (既定値) | 'KeepLSB' | 'KeepMSB' | 'SpecifyPrecision'

SumSlope — 加算データ型の傾き 9.3132e-10 (既定値) | 浮動小数点数

SumSlopeAdjustmentFactor — 加算データ型の傾き調整係数 1 (既定値) | 1 以上 2 未満の浮動小数点数

SumWordLength — 加算データ型の語長 32 (既定値) | 正の整数

拡張機能

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

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

バージョン履歴

R2021a: fi、fimath、numerictype オブジェクトのあいまいなプロパティ名はサポートされない

参考

トピック

`CastBeforeSum` — 両方のオペランドが加算前に加算データ型にキャストされるかどうか
`true` または `1` (既定値) | `false` または `0`

`MaxProductWordLength` — 乗算データ型の最大許容語長
`65535` (既定値) | 正の整数

`MaxSumWordLength` — 加算データ型の最大許容語長
65535 (既定値) | 正の整数

`OverflowAction` — オーバーフロー時のアクション
`'Saturate'` (既定値) | `'Wrap'`

`ProductBias` — 乗算データ型のバイアス
`0` (既定値) | 浮動小数点数

`ProductFixedExponent` — 乗算データ型の固定小数点の指数
`-30` (既定値) | 非ゼロの整数

`ProductFractionLength` — 乗算データ型の小数部の長さ
`30` (既定値) | 非ゼロの整数

`ProductMode` — 乗算データ型の決定方法
`'FullPrecision'` (既定値) | `'KeepLSB'` | `'KeepMSB'` | `'SpecifyPrecision'`

`ProductSlope` — 乗算データ型の傾き
`9.3132e-10` (既定値) | 有限の正の浮動小数点数

`ProductSlopeAdjustmentFactor` — 乗算データ型の傾き調整係数
`1` (既定値) | 1 以上 2 未満の浮動小数点数

`ProductWordLength` — 乗算データ型の語長
`32` (既定値) | 正の整数

`RoundingMethod` — 使用する丸め手法です。
`'Nearest'` (既定値) | `'Ceiling'` | `'Convergent'` | `'Zero'` | `'Floor'` | `'Round'`

`SumBias` — 加算データ型のバイアス
`0` (既定値) | 浮動小数点数

`SumFixedExponent` — 加算データ型の固定小数点の指数
`-30` (既定値) | 非ゼロの整数

`SumFractionLength` — 加算データ型の小数部の長さ
`30` (既定値) | 非ゼロの整数

`SumMode` — 加算データ型の決定方法
`'FullPrecision'` (既定値) | `'KeepLSB'` | `'KeepMSB'` | `'SpecifyPrecision'`

`SumSlope` — 加算データ型の傾き
`9.3132e-10` (既定値) | 浮動小数点数

`SumSlopeAdjustmentFactor` — 加算データ型の傾き調整係数
`1` (既定値) | 1 以上 2 未満の浮動小数点数

`SumWordLength` — 加算データ型の語長
`32` (既定値) | 正の整数

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

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

R2021a: `fi`、`fimath`、`numerictype` オブジェクトのあいまいなプロパティ名はサポートされない