.TH AVQRATE 1 "QCCPACK" "".SH NAMEavqrate \- calculates rate for AVQ programs.SH SYNOPSIS.B avqrate.RB "[\|" \-vo "\|]".RB "[\|" \-noent "\|]".I codebook\_coder.I channelfile.I sideinfofile.SH OPTIONS.TP.B \-voOutput only the value of the rate (terse output)..TP.B \-noentDisable entropy-coding estimate in side information..SH DESCRIPTION.LP.B avqratereads a channel,.I channelfile(CHN format), and side information,.I sideinfofile(SID format), both produced by one of the following AVQ programs:.BR gtrencode "(1), " paulencode "(1), or " gyencode (1).It estimates the bit rate, in terms of number of bits peroriginal source symbol, achieved by the algorithm.The calculation of the bit rate varies for each algorithm as described below..B avqratedetermines which specific calculation to use based on the.I program\_name field specified in the header of.IR sideinfofile ..I codebook\_codergives the scalar quantizer used to produce the side information..SH THE GTR AND PAUL ALGORITHMSThe bit rate is estimated as:.LP.I "    R"=.RI ( Nc+.IR Ns )/ N / dim.LPwhere.I Nis the total number of original source vectors,.I dimis the vector dimension,.I Ncis the number of bits used in the VQ channel, and.I Nsis the total number of bits of side information..I Nc is estimated from the first-order entropy of the VQ channel as.I Nc= .IR Hc *( N " - " Nr ),where .I Hcis the first-order entropy of the channel and.I Nris the number of times the codebook was updated duringencoding..LPUnless.B \-noentis specified,.I Nsis estimated as the first-order entropy of theupdate flags used by the algorithm plus the first-orderentropy of the components of the update vectors.If .B \-noentis specified, entropy estimation of side informationis disabled; that is, each update flag counted as one bit and a fixed-length block code is assumed for the update-vector components..LP.B avqrateprints.IR R , .IR Nc / N / dim ,and.IR Ns / N / dimto stdout,unless option.B \-vois given, in which case only.I Ris output..SH THE GERSHO-YANO ALGORITHMThe bit rate is estimated as.LP.I "    R"=.RI ( Rc+.IR Rs )/ dim.LPwhere .I dimis the vector dimension,.I Rcis the rate of the VQ channel, and.I Rs is the rate of side information..I Rcis simply the first-order entropy of the VQ channel..I Rsis calculated as.I Rs=  .I Ns/.IR N ,where.I Nsis the number of bits of side information and.I Nis the total number of original source vectors..LPUnless.B \-noentis specified,.I Nsis estimated as the first-order entropy of theupdate addresses used by the algorithm plus the first-orderentropy of the components of the update vectors.If .B \-noentis specified, entropy estimation of side informationis disabled; that is, a fixed-length block code is assumed for the both the update addresses and the update-vector components..LP.B avqrateprints.IR R , .IR Rc / dim ,and.IR Rs / dimto stdout,unless option.B \-vois given, in which case only.I Ris output..SH "SEE ALSO".BR gtrencode (1),.BR gtrdecode (1),.BR paulencode (1),.BR pauldecode (1),.BR gyencode (1),.BR gydecode (1),.BR QccPackAVQ (3),.BR QccPack (3).SH AUTHORCopyright (C) 1997-2009  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.