sfi

符号付き固定小数点数値オブジェクトの作成

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

構文

a = sfi

a = sfi(v)

a = sfi(v,w)

a = sfi(v,w,f)

a = sfi(v,w,slope,bias)

a = sfi(v,w,slopeadjustmentfactor,fixedexponent,bias)

説明

例

a = sfi は既定のコンストラクターで、値をもたない、語長が 16 ビット、小数部の長さが 15 ビットの符号付き fi オブジェクトを返します。

コンストラクター関数 sfi で作成された fi オブジェクトには、データプロパティ、fimath プロパティ、および numerictype プロパティが含まれます。これらのプロパティの詳細については、fi オブジェクトプロパティ、fimath オブジェクトプロパティ、およびnumerictype オブジェクトプロパティを参照してください。

コンストラクター関数 sfi で作成された fi オブジェクトには、ローカル fimath オブジェクトがありません。既定の fimath 設定を使用しない場合は、この fi オブジェクトに fimath オブジェクトを付加できます。詳細については、fimath オブジェクトの作成を参照してください。

例

a = sfi(v) は、値が v、語長が 16 ビット、小数部の長さが最高精度の符号付き固定小数点オブジェクトを返します。最高精度が得られるのは、所定の語長で値 v が保持されるように小数部の長さが自動的に設定されている場合です。

例

a = sfi(v,w) は、値が v、語長が w、小数部の長さが最高精度の符号付き固定小数点オブジェクトを返します。

例

a = sfi(v,w,f) は、値が v、語長が w、小数部の長さが f の符号付き固定小数点オブジェクトを返します。

a = sfi(v,w,slope,bias) は、値が v、語長が w、slope、および bias の符号付き固定小数点オブジェクトを返します。

a = sfi(v,w,slopeadjustmentfactor,fixedexponent,bias) は、値が v、語長が w、slopeadjustmentfactor、fixedexponent、および bias の符号付き固定小数点オブジェクトを返します。

例

すべて折りたたむ

符号付き `fi` オブジェクトを既定値で作成

既定のコンストラクターは、値をもたない、語長が 16 ビット、小数部の長さが 15 ビットの符号付き fi オブジェクトを返します。

a = sfi

a = 

[]

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

既定の語長と最高精度の小数部の長さをもつ符号付き `fi` オブジェクトの作成

既定の語長が 16 ビットで小数部の長さが最高精度の符号付き fi オブジェクトを作成します。

a = sfi(pi)

a =
 
    3.1416

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

最高精度の小数部の長さをもつ符号付き `fi` オブジェクトの作成

引数 f を省略すると、小数部の長さが可能な最高精度に自動的に設定されます。

a = sfi(pi,8)

a =
 
    3.1563

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 8
        FractionLength: 5

指定された語長と小数部の長さをもつ符号付き `fi` オブジェクトの作成

値 pi、語長 8 ビット、小数部の長さ 3 ビットの符号付き fi オブジェクトを作成します。

a = sfi(pi,8,3)

a =
 
    3.1250

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 8
        FractionLength: 3

既定の fimath プロパティが a に関連付けられています。fi オブジェクトにローカル fimath オブジェクトが存在しない場合、出力には fimath オブジェクトのプロパティが表示されません。fi オブジェクトに fimath オブジェクトがあるかどうかを判断するには、関数 isfimathlocal を使用します。

isfimathlocal(a)

ans =
     0

返された値が 0 の場合、fi オブジェクトにはローカル fimath オブジェクトが存在しないことを意味します。関数 isfimathlocal が 1 を返す場合、fi オブジェクトはローカル fimath オブジェクトをもちます。

値 v は配列も可能です。

a = sfi((magic(3)/10),16,12)

a = 

    0.8000    0.1001    0.6001
    0.3000    0.5000    0.7000
    0.3999    0.8999    0.2000

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

入力引数

すべて折りたたむ

`v` — 値
スカラー | ベクトル | 行列 | 多次元配列

符号付き fi オブジェクトの値。スカラー、ベクトル、行列または多次元配列として指定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fi

`w` — 語長
16 (既定値) | スカラー整数

符号付き fi オブジェクトの語長 (ビット単位)。スカラー整数として指定します。

`f` — 小数部の長さ
15 (既定値) | スカラー整数

符号付き fi オブジェクトの小数部の長さ (ビット単位)。スカラー整数として指定します。小数部の長さを指定しない場合、符号付き fi オブジェクトは、指定した値および語長のオーバーフローを回避しながら最高精度を提供する小数部の長さを自動的に使用します。

`slope` — 勾配
スカラー整数

スケーリングの勾配。スカラー整数として指定します。次の方程式は、勾配バイアスのスケーリングされた数値の実際値を表します。

$r e a l - w o r l d v a l u e = (s l o p e \times i n t e g e r) + b i a s$

`bias` — バイアス
スカラー

スケーリングのバイアス。スカラーとして指定します。次の方程式は、勾配バイアスのスケーリングされた数値の実際値を表します。

$r e a l - w o r l d v a l u e = (s l o p e \times i n t e g e r) + b i a s$

`slopeadjustmentfactor` — 勾配調整係数。
スカラー整数

勾配バイアスのスケーリングされた数値の勾配調整係数。次の方程式は、勾配、固定小数点の指数、勾配調整係数の間の関係を示します。

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

`fixedexponent` — 固定小数点の指数
スカラー整数

勾配バイアスのスケーリングされた数値の固定小数点の指数。次の方程式は、勾配、固定小数点の指数、勾配調整係数の間の関係を示します。

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

拡張機能

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

使用に関するメモと制限:

コード生成では、データ型に関連するすべてのプロパティは定数でなければなりません。

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

バージョン履歴

R2009b で導入

参考

sfi

構文

説明

例

符号付き fi オブジェクトを既定値で作成

既定の語長と最高精度の小数部の長さをもつ符号付き fi オブジェクトの作成

最高精度の小数部の長さをもつ符号付き fi オブジェクトの作成

指定された語長と小数部の長さをもつ符号付き fi オブジェクトの作成

入力引数

v — 値 スカラー | ベクトル | 行列 | 多次元配列

w — 語長 16 (既定値) | スカラー整数

f — 小数部の長さ 15 (既定値) | スカラー整数

slope — 勾配 スカラー整数

bias — バイアス スカラー

slopeadjustmentfactor — 勾配調整係数。 スカラー整数

fixedexponent — 固定小数点の指数 スカラー整数