gtrdecode.1

QccPack implementation in C

.TH GTRDECODE 1 "QCCPACK" ""
.SH NAME
gtrdecode \- generalized-threshold-replenishment (GTR) decoder
.SH SYNOPSIS
.B gtrdecode
.RB "[\|" \-ic
.IR initial\_codebook "\|]"
.I channelfile
.I sideinfofile
.I codebook\_coder
.I datfile
.SH OPTIONS
.TP
.BI \-ic " initial\_codebook"
.SH DESCRIPTION
.LP
.B gtrdecode
decodes a channel,
.I channelfile
(CHN format), and side information,
.I sideinfofile
(SID format), both produced by
.BR gtrencode ,
and writes the resulting output data to
.IR datfile .
That is, 
.B gtrdecode
performs VQ-index lookup of the indices in
.I channelfile
while updating the VQ codebook as dictated by
.IR sideinfofile .
.B gtrdecode
starts decoding using the initial codebook specified
by
.I initial\_codebook
(which should be the same initial codebook originally used by
.BR gtrencode ), 
if given.
In the absense of the 
.B \-ic
switch, 
.B gtrdecode
starts with an empty codebook, and online initialization is used
until the codebook size reaches
.IR max\_codebook\_size ,
given by the corresponding value in the header of
.IR sideinfofile .
.I codebook\_coder
(SQ format) gives the scalar quantizer used to decode the
side information.
.SH "SEE ALSO"
.BR gtrencode (1),
.BR gtrrate (1),
.BR QccPackAVQ (3),
.BR QccPack (3)

J. E. Fowler and S. C. Ahalt, "Adaptive Vector Quantization Using Generalized
Threshold Replenishment," in 
.I "Proceedings of the IEEE Data Compression Conference" 
(J. A. Storer and M. Cohn, eds.),
(Snowbird, UT), pp. 317-326, IEEE Computer Society Press, March 1997-2005.

.SH AUTHOR
Copyright (C) 1997-2005  James E. Fowler
.\"  The programs herein are free software; you can redistribute them and/or
.\"  modify them under the terms of the GNU General Public License
.\"  as published by the Free Software Foundation; either version 2
.\"  of the License, or (at your option) any later version.
.\"  
.\"  These programs are distributed in the hope that they will be useful,
.\"  but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"  GNU General Public License for more details.
.\"  
.\"  You should have received a copy of the GNU General Public License
.\"  along with these programs; if not, write to the Free Software
.\"  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.