fimath のプロパティによって、fi オブジェクトでの固定小数点算術演算の実行ルールが決まります。推移性により、fimath のプロパティは fi オブジェクトのプロパティにもなります。これらのプロパティは個々の fi オブジェクトに対して設定できます。fimath オブジェクトのプロパティは常に書き込み可能です。

加算データ型のプロパティ

`CastBeforeSum` — 加算前に加算データ型にオペランドをキャスト
`1` `(true)` (既定値) | `0` `(false)`

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

1 または true - 加算前にキャストする
0 または false - 加算前にキャストしない

このプロパティは常に logical 値を返します。

メモ

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

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

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

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

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

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

データ型: single | double | half

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

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

メモ

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

`SumFractionLength` — 加算データ型の小数部の長さ (ビット単位)
`30` (既定値) | 整数

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

メモ

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

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

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

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

データ型: char

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

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

メモ

$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 つを変更すると、他のプロパティに影響を与えます。

データ型: single | double | half

`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 つを変更すると、他のプロパティに影響を与えます。

データ型: single | double | half

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

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

乗算データ型のプロパティ

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

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

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

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

データ型: single | double | half

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

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

メモ

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

`ProductFractionLength` — 乗算データ型の小数部の長さ (ビット単位)
`30` (既定値) | 整数

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

メモ

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

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

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

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

データ型: char

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

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

メモ

$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 つを変更すると、他のプロパティに影響を与えます。

データ型: single | double | half

`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 つを変更すると、他のプロパティに影響を与えます。

データ型: single | double | half

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

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

丸めとオーバーフローのプロパティ

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

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

Saturate — オーバーフロー時に固定小数点の範囲の最大値または最小値に飽和します。
Wrap — オーバーフローの場合、ラップします。

データ型: char

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

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

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

データ型: char

例

すべて折りたたむ

既定の 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

`fi` オブジェクトからの `fimath` オブジェクトの作成

ライブスクリプトを開く

この例では、既存の fi オブジェクトから fimath オブジェクトを作成する方法を示します。

既定のプロパティをもち、値が指定されていない fi オブジェクトを作成します。

a = fi

a = 

[]

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 15

a の fimath プロパティをクエリします。

a.fimath

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

a を入力として fimath オブジェクトを作成します。

F = fimath(a)

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

F は、a と同じ fimath プロパティをもちます。

拡張機能

すべて展開する

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

説明

作成

構文

説明

プロパティ

加算データ型のプロパティ

CastBeforeSum — 加算前に加算データ型にオペランドをキャスト 1 (true) (既定値) | 0 (false)

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

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

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

SumFractionLength — 加算データ型の小数部の長さ (ビット単位) 30 (既定値) | 整数

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

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

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

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

乗算データ型のプロパティ

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

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

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

ProductFractionLength — 乗算データ型の小数部の長さ (ビット単位) 30 (既定値) | 整数

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

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

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

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

丸めとオーバーフローのプロパティ

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

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

例

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

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

fi オブジェクトからの fimath オブジェクトの作成

拡張機能

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

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

バージョン履歴

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

参考

トピック

`CastBeforeSum` — 加算前に加算データ型にオペランドをキャスト
`1` `(true)` (既定値) | `0` `(false)`

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

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

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

`SumFractionLength` — 加算データ型の小数部の長さ (ビット単位)
`30` (既定値) | 整数

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

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

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

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

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

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

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

`ProductFractionLength` — 乗算データ型の小数部の長さ (ビット単位)
`30` (既定値) | 整数

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

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

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

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

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

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

`fi` オブジェクトからの `fimath` オブジェクトの作成

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

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

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