quantizer
quantizer オブジェクトの作成
説明
quantizer オブジェクトは、量子化に使用するデータ型プロパティを記述します。quantizer オブジェクトを作成した後、quantize を使用して倍精度データを量子化します。quantizer オブジェクトを使用して、任意の語長と指数部の長さをもつカスタムの浮動小数点データ型をシミュレートできます。
作成
構文
説明
q = quantizer(Name,Value)
q = quantizer(Value1,Value2)quantizer はリストの後のプロパティ値を設定します。
q = quantizer(s)s に格納された値で設定します。
q = quantizer(pn,pv)pn で指定された名前のプロパティを cell 配列 pv の対応する値に設定します。
quantizer オブジェクトを作成するときは、名前と値の string の引数、構造体、および名前と値の cell 配列の引数を組み合わせて使用してプロパティ値を設定できます。
プロパティ
オブジェクト関数
quantize | quantizer オブジェクトを使用した数値データの量子化 |
unitquantize | eps が +1 以内の数値を除く quantizer オブジェクトを使用した数値データの量子化 |
wordlength | quantizer オブジェクトの語長 |
例
quantizer オブジェクトを既定のプロパティ値で作成します。
q = quantizer
q =
DataMode = fixed
RoundMode = floor
OverflowMode = saturate
Format = [16 15]
quantizer オブジェクトをコピーするには、代入を使用します。
q = quantizer; r = q; isequal(q,r)
ans = logical
1
プロパティの名前と値の引数を使用して quantizer オブジェクトのプロパティを設定します。
q = quantizer('Mode','fixed','RoundMode','ceil',... 'OverflowMode','saturate','Format',[5 4])
q =
DataMode = fixed
RoundMode = ceil
OverflowMode = saturate
Format = [5 4]
コマンドでプロパティ値のみをリストして quantizer オブジェクトのプロパティを設定します。
q = quantizer('fixed','ceil','saturate',[5 4])
q =
DataMode = fixed
RoundMode = ceil
OverflowMode = saturate
Format = [5 4]
構造体を使用して quantizer オブジェクトのプロパティを設定します。
struct.DataMode = 'fixed'; struct.RoundMode = 'ceil'; struct.OverflowMode = 'saturate'; struct.Format = [5 4]; q = quantizer(struct)
q =
DataMode = fixed
RoundMode = ceil
OverflowMode = saturate
Format = [5 4]
プロパティ名とプロパティ値の cell 配列を使用して quantizer オブジェクトのプロパティを設定します。
pn = {'Mode','RoundMode','Overflowmode','Format'};
pv = {'fixed','ceil','saturate',[5 4]};
q = quantizer(pn,pv)q =
DataMode = fixed
RoundMode = ceil
OverflowMode = saturate
Format = [5 4]
quantize を使用してデータを量子化し、量子化が quantizer オブジェクトの状態にどのように影響するかを確認し、reset を使用して quantizer オブジェクトの状態を既定値にリセットします。
サンプル データ セットを作成し、そのデータ セットを量子化するときに使用する量子化パラメーターを quantizer オブジェクトを作成して指定します。
format long g rng(0,'twister'); x = rng(100); q = quantizer([16,14])
q =
DataMode = fixed
RoundMode = floor
OverflowMode = saturate
Format = [16 14]max と noverflows の値を取得します。
q.max q.noverflows
ans =
-1.79769313486232e+308
ans =
0max が -realmax と等しいことに注意してください。これは、量子化器 q がリセット状態であることを示しています。
関数 quantize を使用して、quantizer オブジェクトの指定に従ってデータ セットを量子化します。
y = quantize(q,x);
Warning: 625 overflow(s) occurred in the fi quantize operation.
max と noverflows の値を確認します。
q.max q.noverflows
ans =
1.99993896484375
ans =
625記録された最大値が量子化後に取得された値であることに注意してください。つまり、q.max == max(y) です。
quantizer の状態をリセットして確認します。
reset(q) q.maxlog q.noverflows
ans =
-1.79769313486232e+308
ans =
0この例では、quantizer オブジェクトで指定されるプロパティを使用してデータを量子化する方法を示します。
まず、いくつかの量子化するデータを作成します。
x = linspace(-15,15,1000);
カスタム精度の浮動小数点に量子化
語長が 6 ビットで指数部の長さが 4 ビットのカスタム精度の浮動小数点データ モードを指定する quantizer オブジェクトを作成します。
q = quantizer('DataMode','float','Format',[6 4])
q =
DataMode = float
RoundMode = floor
Format = [6 4]
RoundMode プロパティには、既定の設定の 'Floor' が使用されます。
関数 quantize を使用して、quantizer オブジェクトで指定されるプロパティを使って x のデータを量子化します。
y = quantize(q,x);
x に対して y をプロットし、このデータに対する指定された量子化プロパティの影響を可視化します。
plot(x,x,x,y); title(tostring(q)); legend('Input Data','Quantized Data','Location','northwest');
![Figure contains an axes object. The axes object with title quantizer('float', 'floor', [6 4]) contains 2 objects of type line. These objects represent Input Data, Quantized Data.](../../examples/fixedpoint/win64/QuantizeDataUsingTheQuantizerObjectExample_01.png)
quantizer オブジェクトの読み取り専用のプロパティを使用して追加の情報にアクセスできます。
q.noverflows
ans = 0
q.nunderflows
ans = 0
この例では、量子化操作で発生したオーバーフローが 0 回、アンダーフローが 0 回でした。
固定小数点に量子化
語長が 6 ビットで小数部の長さが 1 ビット、オーバーフロー時にラップする符号付き固定小数点データ モードを指定する quantizer オブジェクトを作成します。
q = quantizer([6 1],'wrap')q =
DataMode = fixed
RoundMode = floor
OverflowMode = wrap
Format = [6 1]
quantizer は、既定の DataMode プロパティ 'fixed' と既定の RoundMode プロパティ 'Floor' を使用します。
関数 quantize を使用して、quantizer オブジェクトで指定されるプロパティを使って x のデータを量子化します。
y = quantize(q,x);
x に対して y をプロットし、このデータに対する指定された量子化プロパティの影響を可視化します。
plot(x,x,x,y); title(tostring(q)); legend('Input Data','Quantized Data','Location','northwest');
![Figure contains an axes object. The axes object with title quantizer('fixed', 'floor', 'wrap', [6 1]) contains 2 objects of type line. These objects represent Input Data, Quantized Data.](../../examples/fixedpoint/win64/QuantizeDataUsingTheQuantizerObjectExample_02.png)
quantizer オブジェクトの読み取り専用のプロパティを使用して追加の情報にアクセスできます。
q.noverflows
ans = 0
q.nunderflows
ans = 17
この例では、量子化操作で発生したオーバーフローが 0 回、アンダーフローが 17 回でした。
