fixdt

固定小数点または浮動小数点データ型を記述した Simulink.NumericType オブジェクトの作成

構文

a = fixdt(Signed,WordLength)

a = fixdt(Signed,WordLength,FractionLength)

a = fixdt(Signed,WordLength,TotalSlope,Bias)

a = fixdt(Signed,WordLength,SlopeAdjustmentFactor,FixedExponent,Bias)

a = fixdt(DataTypeNameString)

a = fixdt(___,'DataTypeOverride','Off')

[a,IsScaledDouble] = fixdt(___)

説明

a = fixdt(Signed,WordLength) は、指定された符号属性と語長をもち、スケーリングか未指定の固定小数点データ型を記述する Simulink.NumericType オブジェクトを返します。

a = fixdt(Signed,WordLength,FractionLength) は、2 進小数点スケーリングが行われる固定小数点データ型を記述する Simulink.NumericType オブジェクトを返します。

a = fixdt(Signed,WordLength,TotalSlope,Bias) は、傾きとバイアス スケーリングが行われる固定小数点データ型を記述する Simulink.NumericType オブジェクトを返します。

a = fixdt(Signed,WordLength,SlopeAdjustmentFactor,FixedExponent,Bias) は、傾きとバイアス スケーリングが行われる固定小数点データ型を記述する Simulink.NumericType オブジェクトを返します。

a = fixdt(DataTypeNameString) は、データ型の名前で指定される整数データ型、固定小数点データ型、または浮動小数点データ型を記述する Simulink.NumericType オブジェクトを返します。

a = fixdt(___,'DataTypeOverride','Off') は、DataTypeOverride パラメーターが Off に設定された Simulink.NumericType オブジェクトを返します。このプロパティの既定値は Inherit です。DataTypeOverride パラメーターは、他の入力パラメーターの任意の組み合わせの後に指定できます。

[a,IsScaledDouble] = fixdt(___) は、固定小数点データ型または浮動小数点データ型と、指定されるデータ型がスケーリングされた double データ型かどうかを示すフラグを記述する Simulink.NumericType オブジェクトを返します。

例

スケーリングが未指定の Simulink.NumericType オブジェクトの作成

16 ビットの語長でスケーリングが未指定の符号付き Simulink.NumericType オブジェクトを作成します。

a = fixdt(1,16)

a = 
  NumericType with properties:

    DataTypeMode: 'Fixed-point: unspecified scaling'
      Signedness: 'Signed'
      WordLength: 16
         IsAlias: 0
       DataScope: 'Auto'
      HeaderFile: ''
     Description: ''

2 進小数点スケーリングの Simulink.NumericType オブジェクトの作成

語長が 16 ビットで小数部の長さが 2 ビットの符号付き固定小数点データ型を記述する Simulink.NumericType オブジェクトを作成します。

a = fixdt(1,16,2)

a = 
  NumericType with properties:

      DataTypeMode: 'Fixed-point: binary point scaling'
        Signedness: 'Signed'
        WordLength: 16
    FractionLength: 2
           IsAlias: 0
         DataScope: 'Auto'
        HeaderFile: ''
       Description: ''

傾きとバイアスのスケーリングによる Simulink.NumericType オブジェクトの作成

傾きバイアスのスケーリングされた数値の実際値は以下で表されます。

$$\mathrm{real}\mathrm{world}\mathrm{value}=\left(\mathrm{slope}\times \mathrm{integer}\right)+\mathrm{bias}$$

語長が 16 ビット、傾きが 2^-2、バイアスが 4 の符号付き固定小数点データ型を記述する Simulink.NumericType オブジェクトを作成します。

a = fixdt(1,16,2^-2,4)

a = 
  NumericType with properties:

    DataTypeMode: 'Fixed-point: slope and bias scaling'
      Signedness: 'Signed'
      WordLength: 16
           Slope: 0.2500
            Bias: 4
         IsAlias: 0
       DataScope: 'Auto'
      HeaderFile: ''
     Description: ''

あるいは、傾きは次のように表すことができます。

$$\mathrm{slope}=\mathrm{slopeadjustmentfactor}\times 2^{\mathrm{fixedexponent}}$$

a = fixdt(1,16,1,-2,4)

a = 
  NumericType with properties:

    DataTypeMode: 'Fixed-point: slope and bias scaling'
      Signedness: 'Signed'
      WordLength: 16
           Slope: 0.2500
            Bias: 4
         IsAlias: 0
       DataScope: 'Auto'
      HeaderFile: ''
     Description: ''

Simulink.NumericType オブジェクト a の DataTypeMode プロパティは、slope and bias scaling です。

データ型名を使用した Simulink.NumericType オブジェクトの作成

データ型名を使用して、8 ビット符号なし固定小数点データ型を記述する Simulink.NumericType オブジェクトを作成し、オブジェクトがスケーリングされた double データ型であるかどうかを示すフラグを返します。

[a,IsScaledDouble] = fixdt('ufix8')

a = 
  NumericType with properties:

      DataTypeMode: 'Fixed-point: binary point scaling'
        Signedness: 'Unsigned'
        WordLength: 8
    FractionLength: 0
           IsAlias: 0
         DataScope: 'Auto'
        HeaderFile: ''
       Description: ''

IsScaledDouble = logical
   0

IsScaledDouble の出力は 0 を返します。これは、a のデータ型がスケーリングされた double データ型ではないことを示しています。

DataTypeOverride が Off に設定された Simulink.NumericType オブジェクトの作成

DataTypeOverride プロパティが Off に設定された Simulink.NumericType オブジェクトを作成します。

a = fixdt(0,8,2,'DataTypeOverride','Off')

a = 
  NumericType with properties:

        DataTypeMode: 'Fixed-point: binary point scaling'
          Signedness: 'Unsigned'
          WordLength: 8
      FractionLength: 2
    DataTypeOverride: 'Off'
             IsAlias: 0
           DataScope: 'Auto'
          HeaderFile: ''
         Description: ''

入力引数

Signed — 符号属性

true または 1 | false または 0

Simulink.NumericType オブジェクトの符号属性。数値または logical 1 (true) または 0 (false) として指定します。1 または true の値は符号付きデータ型を示します。0 または false の値は、符号なしデータ型を示します。

データ型: logical

WordLength — 語長

正のスカラー

Simulink.NumericType オブジェクトの語長 (ビット単位)。正のスカラーとして指定します。

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

FractionLength — 小数部の長さ

0 (既定値) | スカラー

Simulink.NumericType オブジェクトの小数部の長さ (ビット単位)。スカラーとして指定します。

FractionLength は WordLength より大きくなってもかまいません。詳細については、2 進小数点の解釈 (Fixed-Point Designer)を参照してください。

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

TotalSlope — スケーリングの傾き

1 (既定値) | スカラー

スケーリングの傾き。スカラーとして指定します。

次の方程式は、傾きバイアスのスケーリングされた数値の実際値を表します。

$$realworldvalue=(slope\times integer)+bias$$

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

Bias — スケーリングのバイアス

0 (既定値) | スカラー

スケーリングのバイアス。スカラーとして指定します。

次の方程式は、傾きバイアスのスケーリングされた数値の実際値を表します。

$$realworldvalue=(slope\times integer)+bias$$

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

SlopeAdjustmentFactor — 傾きの傾き調整係数とバイアスのスケーリングされた数値

1 (既定値) | 正のスカラー

傾きバイアスのスケーリングされた数値の傾き調整係数。正のスカラーとして指定します。

傾き調整係数は 1 以上かつ 2 未満でなければなりません。この範囲外の SlopeAdjustmentFactor を入力すると、fixdt は自動的に SlopeAdjustmentFactor および FixedExponent の値にスケーリングの正規化を適用して、修正後の傾き調整係数が 1 以上かつ 2 未満になるようにし、傾きの値を維持します。

次の方程式は、傾き、固定小数点の指数、傾き調整係数の間の関係を示します。

$$slope=slopeadjustmentfactor\times 2^{fixedexponent}$$

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

FixedExponent — 傾きとバイアスのスケーリングされた数値の固定小数点の指数。

0 (既定値) | スカラー

傾きバイアスのスケーリングされた数値の固定小数点の指数。スカラーとして指定します。

次の方程式は、傾き、固定小数点の指数、傾き調整係数の間の関係を示します。

$$slope=slopeadjustmentfactor\times 2^{fixedexponent}$$

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

DataTypeNameString — データ型名

文字ベクトル

データ型名。文字ベクトルとして指定します。

データ型名は、Simulink^® の組み込みデータ型名または Fixed-Point Designer™ 製品で規定されている固定小数点の命名法に適合する固定小数点データ型名のいずれかになります。詳細については、固定小数点データ型とスケーリングの表記法 (Fixed-Point Designer)を参照してください。

データ型: char

出力引数

a — データ型

Simulink.NumericType オブジェクト

データ型。Simulink.NumericType オブジェクトとして返されます。

IsScaledDouble — スケーリングされた double フラグ

logical

スケーリングされた double フラグ。指定されたデータ型名がスケーリングされた double データ型の名前であるかどうかを示す logical として返されます。

拡張機能

C/C++ コード生成

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

関数 fixdt については、コードは embedded.numerictype オブジェクトから生成されます。Simulink.NumericType オブジェクトはコード生成でサポートされていません。

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

バージョン履歴

R2006a より前に導入

参考

トピック

• 固定小数点データ型とスケーリングの表記法 (Fixed-Point Designer)