% -*- texinfo -*-
% @deftypefn {Function File} {@var{qidx} = } quantiz (@var{x}, @var{table})
% @deftypefnx {Function File} {[@var{qidx}, @var{q}] = } quantiz (@var{x}, @var{table}, @var{codes})
% @deftypefnx {Function File} {[ @var{qidx}, @var{q}, @var{d}] = } quantiz (@var{...})
%
% Quantization of an arbitrary signal relative to a paritioning.
%
% @table @code
% @item qidx = quantiz(x, table)
% Determine position of x in strictly monotonic table. The first
% interval, using index 0, corresponds to x <= table(1).
% Subsequent intervals are table(i-1) < x <= table(i).
%
% @item [qidx, q] = quantiz(x, table, codes)
% Associate each interval of the table with a code. Use codes(1)
% for x <= table(1) and codes(n+1) for table(n) < x <= table(n+1).
%
% @item [qidx, q, d] = quantiz(...)
% Compute distortion as mean squared distance of x from the
% corresponding quantization values.
% @end table
% @end deftypefn