/**MAN





























































Sun Release 4.1         Last change: UCL                        1






TREEVQ(1)                USER COMMANDS                  TREEVQ(1)



NAME
     treevq - build/use a binary tree codebook for vector quanti-
     sation

SYNOPSIS
     treevq  (-i  item|-a  item)  (-c  cbitem)  (-f  cbfile)  (-n
     numcode) (-u) file

DESCRIPTION
     treevq is a program to either build  or  use  a  binary-tree
     format vector quantisation codebook.  In encoding mode (when
     -c and -f options not used) the input  item(s)  are  divided
     into  2  clusters,  then each cluster may then be split into
     two further clusters, etc, until  the  number  of  requested
     codes is met or exceeded.  The cluster centroids used in the
     derivation of the final clusters,  and  the  final  clusters
     themselves  are  then  saved  back to the file.  In decoding
     mode (where -c or -f is used) a built codebook  is  used  to
     encode  a  single  new  input  item,  the result saved as an
     artificial coefficient item consisting of the codebook  vec-
     tors,  but  with the 'flag' field in each coefficient record
     set to the mapped codebook index.  For decoding,  the  code-
     book may be stored in a separate file.  For encoding, a uni-
     form (balanced binary tree) may  be  enforced  with  the  -u
     switch.

OPTIONS
     -I         Identify program name and version number.

     -iitem     Select input coefficient  item  for  building  or
                encoding.

     -aitem     Select all coefficient  items  in  the  file  for
                building.

     -ccbitem   Select input  codebook  coefficient  item.   Also
                selects encoding operation.  Default: building.

     -fcbfile   Select input codebook filename.   Default:  input
                file.

     -nnumcode  Specify minimum # codes  in  codebook.   Default:
                64.   For  -u  switch,  the  number of codes will
                always be a power of two.

     -u         Specify  a  uniform  binary  tree.   This   gives
                slightly  worse  distortion  for a given codebook
                size, but gives the best average encoding speed.

INPUT ITEMS
     COEFF
          Input vectors for building or encoding.



Sun Release 4.1         Last change: UCL                        1






TREEVQ(1)                USER COMMANDS                  TREEVQ(1)



OUTPUT ITEMS
     COEFF
          (Building)Codebook.

     COEFF
          (Encoding)Encoded utterance.

HISTORY
     input=
          Input items for codebook.

     size=
          Number of codes

     uniform
          Uniform binary tree.

VERSION/AUTHOR
     1.0  Mark Huckvale

SEE ALSO
     <associated programs>

BUGS
     */

SOURCE
     /users/mark/sfs/man/../contrib/asr/treevq.c



























Sun Release 4.1         Last change: UCL                        2



