Chris@1: /********************************************************************
Chris@1:  *                                                                  *
Chris@1:  * THIS FILE IS PART OF THE OggVorbis SOFTWARE CODEC SOURCE CODE.   *
Chris@1:  * USE, DISTRIBUTION AND REPRODUCTION OF THIS LIBRARY SOURCE IS     *
Chris@1:  * GOVERNED BY A BSD-STYLE SOURCE LICENSE INCLUDED WITH THIS SOURCE *
Chris@1:  * IN 'COPYING'. PLEASE READ THESE TERMS BEFORE DISTRIBUTING.       *
Chris@1:  *                                                                  *
Chris@1:  * THE OggVorbis SOURCE CODE IS (C) COPYRIGHT 1994-2001             *
Chris@1:  * by the Xiph.Org Foundation http://www.xiph.org/                  *
Chris@1:  *                                                                  *
Chris@1:  ********************************************************************
Chris@1: 
Chris@1:  function: function calls to collect codebook metrics
Chris@1:  last mod: $Id: metrics.c 16037 2009-05-26 21:10:58Z xiphmont $
Chris@1: 
Chris@1:  ********************************************************************/
Chris@1: 
Chris@1: 
Chris@1: #include <stdlib.h>
Chris@1: #include <unistd.h>
Chris@1: #include <math.h>
Chris@1: #include "bookutil.h"
Chris@1: 
Chris@1: /* collect the following metrics:
Chris@1: 
Chris@1:    mean and mean squared amplitude
Chris@1:    mean and mean squared error 
Chris@1:    mean and mean squared error (per sample) by entry
Chris@1:    worst case fit by entry
Chris@1:    entry cell size
Chris@1:    hits by entry
Chris@1:    total bits
Chris@1:    total samples
Chris@1:    (average bits per sample)*/
Chris@1:    
Chris@1: 
Chris@1: /* set up metrics */
Chris@1: 
Chris@1: float meanamplitude_acc=0.f;
Chris@1: float meanamplitudesq_acc=0.f;
Chris@1: float meanerror_acc=0.f;
Chris@1: float meanerrorsq_acc=0.f;
Chris@1: 
Chris@1: float **histogram=NULL;
Chris@1: float **histogram_error=NULL;
Chris@1: float **histogram_errorsq=NULL;
Chris@1: float **histogram_hi=NULL;
Chris@1: float **histogram_lo=NULL;
Chris@1: float bits=0.f;
Chris@1: float count=0.f;
Chris@1: 
Chris@1: static float *_now(codebook *c, int i){
Chris@1:   return c->valuelist+i*c->c->dim;
Chris@1: }
Chris@1: 
Chris@1: int books=0;
Chris@1: 
Chris@1: void process_preprocess(codebook **bs,char *basename){
Chris@1:   int i;
Chris@1:   while(bs[books])books++;
Chris@1:   
Chris@1:   if(books){
Chris@1:     histogram=_ogg_calloc(books,sizeof(float *));
Chris@1:     histogram_error=_ogg_calloc(books,sizeof(float *));
Chris@1:     histogram_errorsq=_ogg_calloc(books,sizeof(float *));
Chris@1:     histogram_hi=_ogg_calloc(books,sizeof(float *));
Chris@1:     histogram_lo=_ogg_calloc(books,sizeof(float *));
Chris@1:   }else{
Chris@1:     fprintf(stderr,"Specify at least one codebook\n");
Chris@1:     exit(1);
Chris@1:   }
Chris@1: 
Chris@1:   for(i=0;i<books;i++){
Chris@1:     codebook *b=bs[i];
Chris@1:     histogram[i]=_ogg_calloc(b->entries,sizeof(float));
Chris@1:     histogram_error[i]=_ogg_calloc(b->entries*b->dim,sizeof(float));
Chris@1:     histogram_errorsq[i]=_ogg_calloc(b->entries*b->dim,sizeof(float));
Chris@1:     histogram_hi[i]=_ogg_calloc(b->entries*b->dim,sizeof(float));
Chris@1:     histogram_lo[i]=_ogg_calloc(b->entries*b->dim,sizeof(float));
Chris@1:   }
Chris@1: }
Chris@1: 
Chris@1: static float _dist(int el,float *a, float *b){
Chris@1:   int i;
Chris@1:   float acc=0.f;
Chris@1:   for(i=0;i<el;i++){
Chris@1:     float val=(a[i]-b[i]);
Chris@1:     acc+=val*val;
Chris@1:   }
Chris@1:   return acc;
Chris@1: }
Chris@1: 
Chris@1: void cell_spacing(codebook *c){
Chris@1:   int j,k;
Chris@1:   float min=-1.f,max=-1.f,mean=0.f,meansq=0.f;
Chris@1:   long total=0;
Chris@1: 
Chris@1:   /* minimum, maximum, mean, ms cell spacing */
Chris@1:   for(j=0;j<c->c->entries;j++){
Chris@1:     if(c->c->lengthlist[j]>0){
Chris@1:       float localmin=-1.;
Chris@1:       for(k=0;k<c->c->entries;k++){
Chris@1:         if(c->c->lengthlist[k]>0){
Chris@1:           float this=_dist(c->c->dim,_now(c,j),_now(c,k));
Chris@1:           if(j!=k &&
Chris@1:              (localmin==-1 || this<localmin))
Chris@1:             localmin=this;
Chris@1:         }
Chris@1:       }
Chris@1:       
Chris@1:       if(min==-1 || localmin<min)min=localmin;
Chris@1:       if(max==-1 || localmin>max)max=localmin;
Chris@1:       mean+=sqrt(localmin);
Chris@1:       meansq+=localmin;
Chris@1:       total++;
Chris@1:     }
Chris@1:   }
Chris@1:   
Chris@1:   fprintf(stderr,"\tminimum cell spacing (closest side): %g\n",sqrt(min));
Chris@1:   fprintf(stderr,"\tmaximum cell spacing (closest side): %g\n",sqrt(max));
Chris@1:   fprintf(stderr,"\tmean closest side spacing: %g\n",mean/total);
Chris@1:   fprintf(stderr,"\tmean sq closest side spacing: %g\n",sqrt(meansq/total));
Chris@1: }
Chris@1: 
Chris@1: void process_postprocess(codebook **bs,char *basename){
Chris@1:   int i,k,book;
Chris@1:   char *buffer=alloca(strlen(basename)+80);
Chris@1: 
Chris@1:   fprintf(stderr,"Done.  Processed %ld data points:\n\n",
Chris@1:           (long)count);
Chris@1: 
Chris@1:   fprintf(stderr,"Global statistics:******************\n\n");
Chris@1: 
Chris@1:   fprintf(stderr,"\ttotal samples: %ld\n",(long)count);
Chris@1:   fprintf(stderr,"\ttotal bits required to code: %ld\n",(long)bits);
Chris@1:   fprintf(stderr,"\taverage bits per sample: %g\n\n",bits/count);
Chris@1: 
Chris@1:   fprintf(stderr,"\tmean sample amplitude: %g\n",
Chris@1:           meanamplitude_acc/count);
Chris@1:   fprintf(stderr,"\tmean squared sample amplitude: %g\n\n",
Chris@1:           sqrt(meanamplitudesq_acc/count));
Chris@1: 
Chris@1:   fprintf(stderr,"\tmean code error: %g\n",
Chris@1:           meanerror_acc/count);
Chris@1:   fprintf(stderr,"\tmean squared code error: %g\n\n",
Chris@1:           sqrt(meanerrorsq_acc/count));
Chris@1: 
Chris@1:   for(book=0;book<books;book++){
Chris@1:     FILE *out;
Chris@1:     codebook *b=bs[book];
Chris@1:     int n=b->c->entries;
Chris@1:     int dim=b->c->dim;
Chris@1: 
Chris@1:     fprintf(stderr,"Book %d statistics:------------------\n",book);
Chris@1: 
Chris@1:     cell_spacing(b);
Chris@1: 
Chris@1:     sprintf(buffer,"%s-%d-mse.m",basename,book);
Chris@1:     out=fopen(buffer,"w");
Chris@1:     if(!out){
Chris@1:       fprintf(stderr,"Could not open file %s for writing\n",buffer);
Chris@1:       exit(1);
Chris@1:     }
Chris@1:     
Chris@1:     for(i=0;i<n;i++){
Chris@1:       for(k=0;k<dim;k++){
Chris@1:         fprintf(out,"%d, %g, %g\n",
Chris@1:                 i*dim+k,(b->valuelist+i*dim)[k],
Chris@1:                 sqrt((histogram_errorsq[book]+i*dim)[k]/histogram[book][i]));
Chris@1:       }
Chris@1:     }
Chris@1:     fclose(out);
Chris@1:       
Chris@1:     sprintf(buffer,"%s-%d-me.m",basename,book);
Chris@1:     out=fopen(buffer,"w");
Chris@1:     if(!out){
Chris@1:       fprintf(stderr,"Could not open file %s for writing\n",buffer);
Chris@1:       exit(1);
Chris@1:     }
Chris@1:     
Chris@1:     for(i=0;i<n;i++){
Chris@1:       for(k=0;k<dim;k++){
Chris@1:         fprintf(out,"%d, %g, %g\n",
Chris@1:                 i*dim+k,(b->valuelist+i*dim)[k],
Chris@1:                 (histogram_error[book]+i*dim)[k]/histogram[book][i]);
Chris@1:       }
Chris@1:     }
Chris@1:     fclose(out);
Chris@1: 
Chris@1:     sprintf(buffer,"%s-%d-worst.m",basename,book);
Chris@1:     out=fopen(buffer,"w");
Chris@1:     if(!out){
Chris@1:       fprintf(stderr,"Could not open file %s for writing\n",buffer);
Chris@1:       exit(1);
Chris@1:     }
Chris@1:     
Chris@1:     for(i=0;i<n;i++){
Chris@1:       for(k=0;k<dim;k++){
Chris@1:         fprintf(out,"%d, %g, %g, %g\n",
Chris@1:                 i*dim+k,(b->valuelist+i*dim)[k],
Chris@1:                 (b->valuelist+i*dim)[k]+(histogram_lo[book]+i*dim)[k],
Chris@1:                 (b->valuelist+i*dim)[k]+(histogram_hi[book]+i*dim)[k]);
Chris@1:       }
Chris@1:     }
Chris@1:     fclose(out);
Chris@1:   }
Chris@1: }
Chris@1: 
Chris@1: float process_one(codebook *b,int book,float *a,int dim,int step,int addmul,
Chris@1:                    float base){
Chris@1:   int j,entry;
Chris@1:   float amplitude=0.f;
Chris@1: 
Chris@1:   if(book==0){
Chris@1:     float last=base;
Chris@1:     for(j=0;j<dim;j++){
Chris@1:       amplitude=a[j*step]-(b->c->q_sequencep?last:0);
Chris@1:       meanamplitude_acc+=fabs(amplitude);
Chris@1:       meanamplitudesq_acc+=amplitude*amplitude;
Chris@1:       count++;
Chris@1:       last=a[j*step];
Chris@1:     }
Chris@1:   }
Chris@1: 
Chris@1:   if(b->c->q_sequencep){
Chris@1:     float temp;
Chris@1:     for(j=0;j<dim;j++){
Chris@1:       temp=a[j*step];
Chris@1:       a[j*step]-=base;
Chris@1:     }
Chris@1:     base=temp;
Chris@1:   }
Chris@1: 
Chris@1:   entry=vorbis_book_besterror(b,a,step,addmul);
Chris@1: 
Chris@1:   if(entry==-1){
Chris@1:     fprintf(stderr,"Internal error: _best returned -1.\n");
Chris@1:     exit(1);
Chris@1:   }
Chris@1:   
Chris@1:   histogram[book][entry]++;  
Chris@1:   bits+=vorbis_book_codelen(b,entry);
Chris@1:           
Chris@1:   for(j=0;j<dim;j++){
Chris@1:     float error=a[j*step];
Chris@1: 
Chris@1:     if(book==books-1){
Chris@1:       meanerror_acc+=fabs(error);
Chris@1:       meanerrorsq_acc+=error*error;
Chris@1:     }
Chris@1:     histogram_errorsq[book][entry*dim+j]+=error*error;
Chris@1:     histogram_error[book][entry*dim+j]+=fabs(error);
Chris@1:     if(histogram[book][entry]==0 || histogram_hi[book][entry*dim+j]<error)
Chris@1:       histogram_hi[book][entry*dim+j]=error;
Chris@1:     if(histogram[book][entry]==0 || histogram_lo[book][entry*dim+j]>error)
Chris@1:       histogram_lo[book][entry*dim+j]=error;
Chris@1:   }
Chris@1:   return base;
Chris@1: }
Chris@1: 
Chris@1: 
Chris@1: void process_vector(codebook **bs,int *addmul,int inter,float *a,int n){
Chris@1:   int bi;
Chris@1:   int i;
Chris@1: 
Chris@1:   for(bi=0;bi<books;bi++){
Chris@1:     codebook *b=bs[bi];
Chris@1:     int dim=b->dim;
Chris@1:     float base=0.f;
Chris@1: 
Chris@1:     if(inter){
Chris@1:       for(i=0;i<n/dim;i++)
Chris@1:         base=process_one(b,bi,a+i,dim,n/dim,addmul[bi],base);
Chris@1:     }else{
Chris@1:       for(i=0;i<=n-dim;i+=dim)
Chris@1:         base=process_one(b,bi,a+i,dim,1,addmul[bi],base);
Chris@1:     }
Chris@1:   }
Chris@1:   
Chris@1:   if((long)(count)%100)spinnit("working.... samples: ",count);
Chris@1: }
Chris@1: 
Chris@1: void process_usage(void){
Chris@1:   fprintf(stderr,
Chris@1:           "usage: vqmetrics [-i] +|*<codebook>.vqh [ +|*<codebook.vqh> ]... \n"
Chris@1:           "                 datafile.vqd [datafile.vqd]...\n\n"
Chris@1:           "       data can be taken on stdin.  -i indicates interleaved coding.\n"
Chris@1:           "       Output goes to output files:\n"
Chris@1:           "       basename-me.m:       gnuplot: mean error by entry value\n"
Chris@1:           "       basename-mse.m:      gnuplot: mean square error by entry value\n"
Chris@1:           "       basename-worst.m:    gnuplot: worst error by entry value\n"
Chris@1:           "       basename-distance.m: gnuplot file showing distance probability\n"
Chris@1:           "\n");
Chris@1: 
Chris@1: }