quantize method
Apply quantizer object to data
Syntax
y = quantize(q, x)
[y1,y2,...] = quantize(q,x1,x2,...)
Description
y = quantize(q, x) uses the quantizer object q to
quantize x. When x is a numeric
array, each element of x is quantized. When x is
a cell array, each numeric element of the cell array is quantized.
When x is a structure, each numeric field of x is
quantized. Quantize does not change nonnumeric elements or fields
of x, nor does it issue warnings for nonnumeric
values. The output y is a built-in double. When
the input x is a structure or cell array, the fields
of y are built-in doubles.
[y1,y2,...] = quantize(q,x1,x2,...) is
equivalent to y1 = quantize(q,x1), y2 = quantize(q,x2),...
The quantizer object states
max— Maximum value before quantizingmin— Minimum value before quantizingnoverflows— Number of overflowsnunderflows— Number of underflowsnoperations— Number of quantization operations
are updated during the call to quantize,
and running totals are kept until a call to resetlog is
made.
Examples
Custom Precision Floating-Point
The following example demonstrates using quantize to quantize data.
u=linspace(-15, 15, 1000);
q=quantizer([6 3], 'float');
range(q)ans = 1×2
-14 14
y=quantize(q, u);
Warning: 68 overflow(s) occurred in the fi quantize operation.
plot(u, y); title(tostring(q))
Fixed-Point
The following example demonstrates using quantize to quantize data.
u=linspace(-15, 15, 1000);
q=quantizer([6 2], 'wrap');
range(q)ans = 1×2
-8.0000 7.7500
y=quantize(q, u);
Warning: 468 overflow(s) occurred in the fi quantize operation.
plot(u, y); title(tostring(q))
See Also
assignmentquantizer | quantizer | set | unitquantize | unitquantizer