NumericTypeScope

固定小数点データ型を判別

構文

H = NumericTypeScope show(H) step(H, data) release(H) reset(H)

説明

NumericTypeScope は、データのダイナミックレンジについての情報を提供するオブジェクトです。このスコープはデータのダイナミックレンジを log2 ヒストグラムの形式で視覚的に表現したものです。このヒストグラムでは、ビットの重みが X 軸、出現割合が Y 軸に沿って表示されます。ヒストグラムの各ビンはバイナリワードのビットに対応しています。たとえば、2⁰ はバイナリワードの最初の整数ビットに対応し、2^-1 はバイナリワードの最初の小数ビットに対応します。

このスコープは、指定された基準を満たす numerictype オブジェクトの形式のデータ型を示唆します。ダイアログのパネルのビット割り当ての節を参照してください。

H = NumericTypeScope は、MATLAB^® でデータのダイナミックレンジを確認するために使用できる NumericTypeScope オブジェクトを返します。H の作成後に NumericTypeScope ウィンドウを表示するには、show メソッドを使用します。

show(H) は NumericTypeScope オブジェクト H を開いて表示します。スコープウィンドウを閉じても、オブジェクトはワークスペースから削除されません。スコープオブジェクトがワークスペースに残っていれば、show メソッドを使用して開いて再度表示することができます。

step(H, data) はデータを処理し、ダイナミックレンジを可視化できるようにします。H オブジェクトは以前に step が一度呼び出されてから次回呼び出される間に収集された変数に関する情報を保持します。

release(H) はシステムリソース (メモリ、ファイルハンドル、ハードウェア接続など) を解放し、すべてのプロパティと入力特性の変更を可能にします。

reset(H) は保存された情報をすべて NumericTypeScope オブジェクト H から消去します。オブジェクトをリセットすると、スコープウィンドウに表示されている情報が消去されます。

範囲外または精度の低い値の特定

NumericTypeScope を使用すると、現在のデータ型に基づいて範囲外または精度の低い値を特定しやすくなります。そのような値を特定するために NumericTypeScope を作成するには、fi オブジェクトである入力変数を指定し、次のいずれかの条件が真であることを確認します。

fi オブジェクトの DataTypeMode が Scaled doubles: binary point scaling に設定されている。
Fixed-Point Designer™ fipref オブジェクトの DataTypeOverride プロパティが ScaledDoubles に設定されている。

この情報を入手できる場合、スコープはデータ型の範囲外にある値、精度が低い値および範囲内にある値について、ヒストグラムバーを次のように色分けして示します。

青 - ヒストグラムビンに現在のデータ型の範囲内にある値が格納されます。
赤 - ヒストグラムビンに現在のデータ型の範囲外にある値が格納されます。
黄 - ヒストグラムビンに現在のデータ型で精度の低い値が格納されます。

スコープの色分けの例は、垂直方向の単位の図を参照してください。

ダイアログのパネルの凡例も参照してください。

NumericTypeScope を使用してデータ型を選択する方法の詳細は、例の節を参照してください。

[NumericTypeScope] ウィンドウ

NumericTypeScope はウィンドウの上部に既定のツールバーを表示し、右側にダイアログパネルを表示した状態で開きます。

[構成] ダイアログボックス

NumericTypeScope 設定を使用すると、スコープウィンドウの動作と外観を制御することができます。

[構成] ダイアログボックスを開くには、[ファイル] 、 [構成] を選択するか、スコープをアクティブなウィンドウにして N キーを押します。

[構成] ダイアログボックスには一連のペインがあり、各ペインには設定オプションの一覧表が表示されます。各ペインでオプションを設定する方法については、各ペインに関するリファレンスの節を参照してください。このダイアログボックスには 1 つの [コア] ペインと、スコープユーザーインターフェイスの一般的な UI を設定するためのオプションが 1 つあるだけです。

後で使用するためにコンフィギュレーション設定を保存するには、[ファイル] 、 [構成] 、 [名前を付けて保存] をクリックします。保存した設定は NumericTypeScope オブジェクトの既定の設定になります。

注意

独自の設定を matlab/toolbox/fixedpoint/fixedpoint フォルダーに保存する前に、既定の設定のバックアップコピーを別の場所に保存してください。既定の設定のバックアップコピーを別の場所に保存しておかないと、後で復元できなくなります。

後で使用するために設定を保存するには、ファイル名を NumericTypeScopeComponent.cfg として matlab/toolbox/fixedpoint/fixedpoint フォルダーに保存します。設定はいつでも再保存できますが、指定のファイル名で指定のフォルダーに保存しなければならないことを忘れないでください。

[コア] ペイン

[構成] ダイアログボックスの [コア] ペインは、スコープの一般的な設定を制御します。

[一般的な UI] をクリックしたまま [オプション] をクリックすると、[一般的な UI オプション] ダイアログボックスを開きます。

タイトルバーに絶対ソースパスを表示 - スコープのタイトルバーにファイル名と変数名を表示するには、このチェックボックスをオンにします。スコープがファイルからのものでないか、このチェックボックスをオフにすると、スコープはタイトルバーに変数名のみを表示します。
[メッセージログを開く] - [メッセージログ] ウィンドウをいつ開くのかを制御します。[メッセージログ] ウィンドウを使用すると、スコープに関する問題のデバッグが容易になります。次のどの条件によって [メッセージログ] ウィンドウを開くかを選択します。
- 新規メッセージ用
- 警告/エラーメッセージ用
- エラーメッセージ専用
- 手動
このオプションの既定値は [警告/エラーメッセージ用] です。
[ヘルプ] 、 [メッセージログ] を選択するか、Ctrl+M を押して、メッセージログをいつでも開くことができます。[メッセージログ] ダイアログボックスでは、読み込まれた構成と登録済み拡張機能のシステムレベルの記録が提供されます。[メッセージログ] ダイアログボックスには各メッセージの概要と詳細が表示され、メッセージ表示をタイプまたはカテゴリ別にフィルター処理することができます。
- [タイプ] - [メッセージログ] ダイアログボックスに表示するメッセージのタイプを選択します。選択できるのは [すべて]、[情報]、[警告] または [失敗] です。[タイプ] の既定値は [すべて] です。
- [カテゴリ] - [メッセージログ] ダイアログボックスに表示するメッセージのカテゴリを選択します。選択できるのは [すべて]、[構成] または [拡張子] です。スコープでは [構成] メッセージを使用して新しいコンフィギュレーションファイルがいつ読み込まれるのかを示し、[拡張子] メッセージを使用してコンポーネントがいつ登録されるのかを示します。[カテゴリ] の既定値は [すべて] です。

ダイアログのパネル

ビット割り当て
凡例
結果のタイプ
入力データ

ビット割り当て

スコープの [ビット割り当て] ダイアログパネルには、次の図のようにデータ型の基準を指定するためのオプションがいくつかあります。

このパネルを使用して、既知の語長と、範囲外での目的の最大出現数を指定することができます。また、範囲外での目的の出現数と、推奨されたデータ型で表現される最小値を指定することもできます。ストリーミングデータの場合、指定の基準を引き続き満たすために、推奨された数値型オブジェクトが時間の経過に従って調整されます。

スコープではヒストグラムプロットと対話することもできます。[ビット割り当て] ダイアログパネルの [グラフィカルコントロール] チェックボックスをオンにすると、2 進小数点の両側にあるカーソルが有効になります。これらのカーソルを対話的に操作し、推奨された数値型が入力データに及ぼす影響を確認することができます。たとえば、範囲外の値の数や、精度が低い値の数を確認することができます。また、データ型で表現できる最大値と最小値を確認することもできます。

凡例

スコープの [凡例] パネルには、スコープで値を示すために使用される色が説明されています。これらの色はスコープで表示されるときの範囲外の値、範囲内の値、精度の低い値を表します。

結果のタイプ

[結果のタイプ] パネルには、スコープ設定で定義された固定小数点データ型が示されます。[ビット割り当て] パネルまたはカーソルを使用して視覚的表示を操作することで、データ型の値を変更することができます。

[データの詳細] セクションには、このパネルの一番上の numerictype オブジェクトについて、範囲外の値または精度の低い値の割合が表示されます。[SQNR] (信号量子化ノイズ比) は信号によって異なります。このパラメーターに値が指定されていない場合、データ不足のため SQNR を計算できません。スコープ情報または numerictype が変わると、SQNR はリセットされます。

[データのタイプ] セクションには、固定小数点データ型の詳細が表示されます。

入力データ

[入力データ] パネルには、NumericScopeType オブジェクトで現在表示されている値についての統計情報が表示されます。

垂直方向の単位

範囲外または精度の低い値を割合または実際の個数として表示するには、[垂直方向の範囲] オプションを使用します。たとえば、次の図は範囲外または精度の低い値を合計値に対する割合として示したものです。

次の例では、範囲外または精度の低い値が実際の個数として表示されます。

すべての Numeric Type Scope ウィンドウを前面へ移動

NumericScopeType GUI には [表示] 、 [すべての Numeric Type Scope ウィンドウを前面へ移動] メニューオプションがあり、NumericTypeScope ウィンドウを簡単に管理することができます。このオプションを選択するか、Ctrl + F キーを押すと、NumericTypeScope ウィンドウがすべて表示されます。NumericTypeScope ウィンドウが現在開いていない場合、このメニューオプションをクリックするとウィンドウが開いて表示されます。

ツールバー (Mac 専用)

ツールバーを有効にするには、[表示] 、 [ツールバー] をクリックします。このツールを有効にすると、スコープを GUI にドッキングしたりドッキング解除したりすることができます。

このツールバー機能は Mac 専用です。Windows^® または UNIX^® バージョンで [ツールバー] をクリックしても、空のツールバーが表示されるだけです。これらのバージョンでは、右上にある GUI にドッキングアイコンが表示されます。

メソッド

release

このメソッドを使用して、システムリソース (メモリ、ファイルハンドルまたはハードウェア接続など) を解放し、すべてのプロパティと入力特性を変更できるようにします。

例:

>>release(H)

reset

オブジェクト H に格納された情報を消去するには、このメソッドを使用します。これにより、H を再利用して別の変数のデータを処理できます。

例:

>>reset(H)

show

スコープウィンドウを開いて表示するには、このメソッドを使用します。

例:

>>show(H)

step

データを処理してダイナミックレンジをスコープウィンドウに表示するには、このメソッドを使用します。

例:

>>step(H, data)

例

すべて折りたたむ

fi オブジェクトのダイナミックレンジの表示

スクリプトを開く

fi オブジェクトの DataTypeOverride を「スケーリングされた double」に設定し、そのダイナミックレンジを表示します。

fp = fipref;
initialDTOSetting = fp.DataTypeOverride;
fp.DataTypeOverride = 'ScaledDoubles';
a = fi(magic(10),1,8,2);
b = fi([a; 2.^(-5:4)],1,8,3);
h = NumericTypeScope;
step(h,b);
fp.DataTypeOverride = initialDTOSetting;

log2 ヒストグラム表示には、変数の値のうち範囲外の値と精度の低い値の両方が表示されています。この場合、b のデータ型は numerictype(1,8,3) です。numerictype(1,8,3) のデータ型では 5 つの整数ビット (符号付きビットも含む) と 3 個の小数部ビットを使用できます。したがって、このデータ型は -2^4 から 2^4- 2^-3 まで (-16 ～ 15.8750) の範囲値のみを表現できます。このデータ型に範囲と精度を指定すると、2^4 を超える値は範囲外となり、2^–3 未満の値はデータ型の精度を下回ることになります。NumericTypeScope の表示を調べると、ビット 5、6 および 7 を必要とする値は範囲外であり、小数部のビット 4 と 5 を必要とする値は精度が低いことがわかります。この情報が手元にあるので、変数 b のデータ型を numerictype(0,13,5) に変えることにより、範囲外の値と精度の低い値を回避することができます。

fi オブジェクトの数値型の決定

スクリプトを開く

ダイナミックレンジを確認し、DataTypeMode が「スケーリングされた double: 2 進小数点スケーリング」である fi オブジェクトに適した数値型を決定します。

DataTypeMode が「スケーリングされた double: 2 進小数点スケーリング」の numerictype オブジェクトを作成します。その後、この numerictype オブジェクトを使用して fi オブジェクトを構築できます。DataTypeMode を「スケーリングされた double: 2 進小数点スケーリング」に設定したので、NumericTypeScope はデータ内のオーバーフローを特定できるようになります。

T = numerictype;
T.DataTypeMode = 'Scaled double: binary point scaling';
T.WordLength = 8;
T.FractionLength = 6;
a = fi(sin(0:100)*3.5, T);
b = fi(cos(0:100)*1.75,T);
acc = fi(0,T);
h = NumericTypeScope;
for i = 1:length(a)
    acc(:) = a(i)*0.7+b(i);
    step(h,acc)
end

このダイナミックレンジ解析では、5 ビットのアキュムレータ内のデータの全範囲を表現できることが示されました。5 ビットの内訳は 2 進小数点の左側 2 ビットが整数ビットで右側 3 ビットが小数ビットです。このデータ型により、numerictype オブジェクト T の WordLength および FractionLength プロパティを変更することで、すべての値を表すことができることを確認できます。その後、T を使用してアキュムレータを再定義します。

この新しいデータ型に基づくダイナミックレンジ解析を確認するには、NumericTypeScope オブジェクト h をリセットし、次のループを再実行します。

T.WordLength = 5;
T.FractionLength = 2;
acc = fi(0,T);
release(h)
reset(h)
for i = 1:length(a)
    acc(:) = a(i)*0.7 + b(i);
    step(h,acc)
end

バージョン履歴

R2010a で導入

参考

hist | log2