codebook算法（背景建模）的原理——该算法对光照非常敏感

测试结果：该算法对光照非常敏感，可能需要对输入图做些光照归一化处理！

导读

《Learning OpenCV》一书当中介绍的第二种背景建模方法是codebook。直接通过书本来理解codebook算法有点困难，可以按照下面的顺序来理解codebook算法，首先看看百度百科上对这个算法的基本原理的阐述，我认为百度百科上的描述已经比较直观，但当中有很多细节的东西还需要看具体的代码，所以可以通过细读下面转载的代码来理解codebook算法，理解代码的过程需要有点耐心，先看main函数，理解程序大致的流程，再仔细看看cvupdateCodeBook()、cvclearStaleEntries()、cvbackgroundDiff()这三个函数，看懂了代码之后就应该能够理解这个算法了 。下面阐述的基本原理部分来自于百度百科，已经阐述得比较直观。代码来自于网友的博文http://blog.csdn.net/zcube/article/details/7353941

基本原理

CodeBook算法的基本思想是得到每个像素的时间序列模型。这种模型能很好地处理时间起伏，缺点是需要消耗大量的内存。CodeBook算法为当前图像的每一个像素建立一个CodeBook(CB)结构,每个CodeBook结构又由多个CodeWord(CW)组成。

CB和CW的形式如下：

CB={CW1,CW2,…CWn,t}

CW={lHigh,lLow,max,min,t_last,stale}

其中n为一个CB中所包含的CW的数目，当n太小时，退化为简单背景，当n较大时可以对复杂背景进行建模;t为CB更新的次数。CW是一个6元组，其中IHigh和ILow作为更新时的学习上下界，max和min记录当前像素的最大值和最小值。上次更新的时间t_last和陈旧时间stale(记录该CW多久未被访问)用来删除很少使用的CodeWord。

假设当前训练图像I中某一像素为I(x,y)，该像素的CB的更新算法如下，另外记背景阈值的增长判定阈值为Bounds：

(1) CB的访问次数加1；

(2) 遍历CB中的每个CW，如果存在一个CW中的IHigh，ILow满足ILow≤I(x,y)≤IHigh，则转(4)；

(3) 创建一个新的码字CWnew加入到CB中, CWnew的max与min都赋值为I(x,y)，IHigh <- I(x,y) + Bounds，ILow <- I(x,y) – Bounds，并且转(6)；

(4) 更新该码字的t_last，若当前像素值I(x,y)大于该码字的max，则max <- I(x,y)，若I(x,y)小于该码字的min，则min <- I(x,y)；

(5) 更新该码字的学习上下界，以增加背景模型对于复杂背景的适应能力，具体做法是：若IHigh < I(x,y) + Bounds，则IHigh 增长1，若ILow > I(x,y) – Bounds，则ILow减少1；

(6) 更新CB中每个CW的stale。

使用已建立好的CB进行运动目标检测的方法很简单，记判断前景的范围上下界为minMod和maxMod，对于当前待检测图像上的某一像素I(x,y)，遍历它对应像素背景模型CB中的每一个码字CW，若存在一个CW，使得I(x,y) < max + maxMod并且I(x,y) > min – minMod，则I(x,y)被判断为背景，否则被判断为前景。

在实际使用CodeBook进行运动检测时，除了要隔一定的时间对CB进行更新的同时，需要对CB进行一个时间滤波，目的是去除很少被访问到的CW，其方法是访问每个CW的stale，若stale大于一个阈值（通常设置为总更新次数的一半），移除该CW。

综上所述，CodeBook算法检测运动目标的流程如下：

(1) 选择一帧到多帧使用更新算法建立CodeBook背景模型；

(2) 按上面所述方法检测前景（运动目标）；

(3) 间隔一定时间使用更新算法更新CodeBook模型，并对CodeBook进行时间滤波；

(4) 若检测继续，转(2)，否则结束。

参考代码

代码来自于网友的博文http://blog.csdn.net/zcube/article/details/7353941

 /************************************************************************/
 /*          A few more thoughts on codebook models
 In general, the codebook method works quite well across a wide number of conditions,
 and it is relatively quick to train and to run. It doesn’t deal well with varying patterns of
 light — such as morning, noon, and evening sunshine — or with someone turning lights
 on or off indoors. This type of global variability can be taken into account by using
 several different codebook models, one for each condition, and then allowing the condition
 to control which model is active.                                       */
 /************************************************************************/

 #include "stdafx.h"
 #include <cv.h>
 #include <highgui.h>
 #include <cxcore.h>

 #define CHANNELS 3
 // 设置处理的图像通道数,要求小于等于图像本身的通道数

 ///////////////////////////////////////////////////////////////////////////
 // 下面为码本码元的数据结构
 // 处理图像时每个像素对应一个码本,每个码本中可有若干个码元
 // 当涉及一个新领域,通常会遇到一些奇怪的名词,不要被这些名词吓坏,其实思路都是简单的
 typedef struct ce {
     uchar   learnHigh[CHANNELS];    // High side threshold for learning
     // 此码元各通道的阀值上限(学习界限)
     uchar   learnLow[CHANNELS];     // Low side threshold for learning
     // 此码元各通道的阀值下限
     // 学习过程中如果一个新像素各通道值x[i],均有 learnLow[i]<=x[i]<=learnHigh[i],则该像素可合并于此码元
     uchar   max[CHANNELS];          // High side of box boundary
     // 属于此码元的像素中各通道的最大值
     uchar   min[CHANNELS];          // Low side of box boundary
     // 属于此码元的像素中各通道的最小值
     int     t_last_update;          // This is book keeping to allow us to kill stale entries
     // 此码元最后一次更新的时间,每一帧为一个单位时间,用于计算stale
     int     stale;                  // max negative run (biggest period of inactivity)
     // 此码元最长不更新时间,用于删除规定时间不更新的码元,精简码本
 } code_element;                     // 码元的数据结构

 typedef struct code_book {
     code_element    **cb;
     // 码元的二维指针,理解为指向码元指针数组的指针,使得添加码元时不需要来回复制码元,只需要简单的指针赋值即可
     int             numEntries;
     // 此码本中码元的数目
     int             t;              // count every access
     // 此码本现在的时间,一帧为一个时间单位
 } codeBook;                         // 码本的数据结构


 ///////////////////////////////////////////////////////////////////////////////////
 // int updateCodeBook(uchar *p, codeBook &c, unsigned cbBounds)
 // Updates the codebook entry with a new data point
 //
 // p            Pointer to a YUV pixel
 // c            Codebook for this pixel
 // cbBounds     Learning bounds for codebook (Rule of thumb: 10)
 // numChannels  Number of color channels we're learning
 //
 // NOTES:
 //      cvBounds must be of size cvBounds[numChannels]
 //
 // RETURN
 //  codebook index
 int cvupdateCodeBook(uchar *p, codeBook &c, unsigned *cbBounds, int numChannels)
 {
     if(c.numEntries == 0) c.t = 0;
     // 码本中码元为零时初始化时间为0
     c.t += 1;   // Record learning event
     // 每调用一次加一,即每一帧图像加一

     //SET HIGH AND LOW BOUNDS
     int n;
     unsigned int high[3],low[3];
     for (n=0; n<numChannels; n++)
     {
         high[n] = *(p+n) + *(cbBounds+n);
         // *(p+n) 和 p[n] 结果等价,经试验*(p+n) 速度更快
         if(high[n] > 255) high[n] = 255;
         low[n] = *(p+n)-*(cbBounds+n);
         if(low[n] < 0) low[n] = 0;
         // 用p 所指像素通道数据,加减cbBonds中数值,作为此像素阀值的上下限
     }

     //SEE IF THIS FITS AN EXISTING CODEWORD
     int matchChannel;
     int i;
     for (i=0; i<c.numEntries; i++)
     {
         // 遍历此码本每个码元,测试p像素是否满足其中之一
         matchChannel = 0;
         for (n=0; n<numChannels; n++)
             //遍历每个通道
         {
             if((c.cb[i]->learnLow[n] <= *(p+n)) && (*(p+n) <= c.cb[i]->learnHigh[n])) //Found an entry for this channel
             // 如果p 像素通道数据在该码元阀值上下限之间
             {
                 matchChannel++;
             }
         }
         if (matchChannel == numChannels)        // If an entry was found over all channels
             // 如果p 像素各通道都满足上面条件
         {
             c.cb[i]->t_last_update = c.t;
             // 更新该码元时间为当前时间
             // adjust this codeword for the first channel
             for (n=0; n<numChannels; n++)
                 //调整该码元各通道最大最小值
             {
                 if (c.cb[i]->max[n] < *(p+n))
                     c.cb[i]->max[n] = *(p+n);
                 else if (c.cb[i]->min[n] > *(p+n))
                     c.cb[i]->min[n] = *(p+n);
             }
             break;
         }
     }

     // ENTER A NEW CODE WORD IF NEEDED
     if(i == c.numEntries)  // No existing code word found, make a new one
     // p 像素不满足此码本中任何一个码元,下面创建一个新码元
     {
         code_element **foo = new code_element* [c.numEntries+1];
         // 申请c.numEntries+1 个指向码元的指针
         for(int ii=0; ii<c.numEntries; ii++)
             // 将前c.numEntries 个指针指向已存在的每个码元
             foo[ii] = c.cb[ii];

         foo[c.numEntries] = new code_element;
         // 申请一个新的码元
         if(c.numEntries) delete [] c.cb;
         // 删除c.cb 指针数组
         c.cb = foo;
         // 把foo 头指针赋给c.cb
         for(n=0; n<numChannels; n++)
             // 更新新码元各通道数据
         {
             c.cb[c.numEntries]->learnHigh[n] = high[n];
             c.cb[c.numEntries]->learnLow[n] = low[n];
             c.cb[c.numEntries]->max[n] = *(p+n);
             c.cb[c.numEntries]->min[n] = *(p+n);
         }
         c.cb[c.numEntries]->t_last_update = c.t;
         c.cb[c.numEntries]->stale = 0;
         c.numEntries += 1;
     }

     // OVERHEAD TO TRACK POTENTIAL STALE ENTRIES
     for(int s=0; s<c.numEntries; s++)
     {
         // This garbage is to track which codebook entries are going stale
         int negRun = c.t - c.cb[s]->t_last_update;
         // 计算该码元的不更新时间
         if(c.cb[s]->stale < negRun)
             c.cb[s]->stale = negRun;
     }

     // SLOWLY ADJUST LEARNING BOUNDS
     for(n=0; n<numChannels; n++)
         // 如果像素通道数据在高低阀值范围内,但在码元阀值之外,则缓慢调整此码元学习界限
     {
         if(c.cb[i]->learnHigh[n] < high[n])
             c.cb[i]->learnHigh[n] += 1;
         if(c.cb[i]->learnLow[n] > low[n])
             c.cb[i]->learnLow[n] -= 1;
     }

     return(i);
 }

 ///////////////////////////////////////////////////////////////////////////////////
 // uchar cvbackgroundDiff(uchar *p, codeBook &c, int minMod, int maxMod)
 // Given a pixel and a code book, determine if the pixel is covered by the codebook
 //
 // p        pixel pointer (YUV interleaved)
 // c        codebook reference
 // numChannels  Number of channels we are testing
 // maxMod   Add this (possibly negative) number onto max level when code_element determining if new pixel is foreground
 // minMod   Subract this (possible negative) number from min level code_element when determining if pixel is foreground
 //
 // NOTES:
 // minMod and maxMod must have length numChannels, e.g. 3 channels => minMod[3], maxMod[3].
 //
 // Return
 // 0 => background, 255 => foreground
 uchar cvbackgroundDiff(uchar *p, codeBook &c, int numChannels, int *minMod, int *maxMod)
 {
     // 下面步骤和背景学习中查找码元如出一辙
     int matchChannel;
     //SEE IF THIS FITS AN EXISTING CODEWORD
     int i;
     for (i=0; i<c.numEntries; i++)
     {
         matchChannel = 0;
         for (int n=0; n<numChannels; n++)
         {
             if ((c.cb[i]->min[n] - minMod[n] <= *(p+n)) && (*(p+n) <= c.cb[i]->max[n] + maxMod[n]))
                 matchChannel++; //Found an entry for this channel
             else
                 break;
         }
         if (matchChannel == numChannels)
             break; //Found an entry that matched all channels
     }
     if(i == c.numEntries)
         // p像素各通道值满足码本中其中一个码元,则返回白色
         return(255);

     return(0);
 }


 //UTILITES/////////////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////////
 //int clearStaleEntries(codeBook &c)
 // After you've learned for some period of time, periodically call this to clear out stale codebook entries
 //
 //c     Codebook to clean up
 //
 // Return
 // number of entries cleared
 int cvclearStaleEntries(codeBook &c)
 {
     int staleThresh = c.t >> 1;           // 设定刷新时间
     int *keep = new int [c.numEntries]; // 申请一个标记数组
     int keepCnt = 0;                    // 记录不删除码元数目
     //SEE WHICH CODEBOOK ENTRIES ARE TOO STALE
     for (int i=0; i<c.numEntries; i++)
         // 遍历码本中每个码元
     {
         if (c.cb[i]->stale > staleThresh)
             // 如码元中的不更新时间大于设定的刷新时间,则标记为删除
             keep[i] = 0; //Mark for destruction
         else
         {
             keep[i] = 1; //Mark to keep
             keepCnt += 1;
         }
     }

     // KEEP ONLY THE GOOD
     c.t = 0;                        //Full reset on stale tracking
     // 码本时间清零
     code_element **foo = new code_element* [keepCnt];
     // 申请大小为keepCnt 的码元指针数组
     int k=0;
     for(int ii=0; ii<c.numEntries; ii++)
     {
         if(keep[ii])
         {
             foo[k] = c.cb[ii];
             foo[k]->stale = 0;       //We have to refresh these entries for next clearStale
             foo[k]->t_last_update = 0;
             k++;
         }
     }
     //CLEAN UP
     delete [] keep;
     delete [] c.cb;
     c.cb = foo;
     // 把foo 头指针地址赋给c.cb
     int numCleared = c.numEntries - keepCnt;
     // 被清理的码元个数
     c.numEntries = keepCnt;
     // 剩余的码元地址
     return(numCleared);
 }



 int main()
 {
     ///////////////////////////////////////
     // 需要使用的变量
     CvCapture*  capture;
     IplImage*   rawImage;
     IplImage*   yuvImage;
     IplImage*   ImaskCodeBook;
     codeBook*   cB;
     unsigned    cbBounds[CHANNELS];
     uchar*      pColor; //YUV pointer
     int         imageLen;
     int         nChannels = CHANNELS;
     int         minMod[CHANNELS];
     int         maxMod[CHANNELS];

     //////////////////////////////////////////////////////////////////////////
     // 初始化各变量
     cvNamedWindow("Raw");
     cvNamedWindow("CodeBook");

     capture = cvCreateFileCapture("tree.avi");
     if (!capture)
     {
         printf("Couldn't open the capture!");
         return -1;
     }

     rawImage = cvQueryFrame(capture);
     yuvImage = cvCreateImage(cvGetSize(rawImage), 8, 3);
     // 给yuvImage 分配一个和rawImage 尺寸相同,8位3通道图像
     ImaskCodeBook = cvCreateImage(cvGetSize(rawImage), IPL_DEPTH_8U, 1);
     // 为ImaskCodeBook 分配一个和rawImage 尺寸相同,8位单通道图像
     cvSet(ImaskCodeBook, cvScalar(255));
     // 设置单通道数组所有元素为255,即初始化为白色图像

     imageLen = rawImage->width * rawImage->height;
     cB = new codeBook[imageLen];
     // 得到与图像像素数目长度一样的一组码本,以便对每个像素进行处理

     for (int i=0; i<imageLen; i++)
         // 初始化每个码元数目为0
         cB[i].numEntries = 0;
     for (int i=0; i<nChannels; i++)
     {
         cbBounds[i] = 10;   // 用于确定码元各通道的阀值

         minMod[i]   = 20;   // 用于背景差分函数中
         maxMod[i]   = 20;   // 调整其值以达到最好的分割
     }


     //////////////////////////////////////////////////////////////////////////
     // 开始处理视频每一帧图像
     for (int i=0;;i++)
     {
         cvCvtColor(rawImage, yuvImage, CV_BGR2YCrCb);
         // 色彩空间转换,将rawImage 转换到YUV色彩空间,输出到yuvImage
         // 即使不转换效果依然很好
         // yuvImage = cvCloneImage(rawImage);

         if (i <= 30)
             // 30帧内进行背景学习
         {
             pColor = (uchar *)(yuvImage->imageData);
             // 指向yuvImage 图像的通道数据
             for (int c=0; c<imageLen; c++)
             {
                 cvupdateCodeBook(pColor, cB[c], cbBounds, nChannels);
                 // 对每个像素,调用此函数,捕捉背景中相关变化图像
                 pColor += 3;
                 // 3 通道图像, 指向下一个像素通道数据
             }
             if (i == 30)
                 // 到30 帧时调用下面函数,删除码本中陈旧的码元
             {
                 for (int c=0; c<imageLen; c++)
                     cvclearStaleEntries(cB[c]);
             }
         }
         else
         {
             uchar maskPixelCodeBook;
             pColor = (uchar *)((yuvImage)->imageData); //3 channel yuv image
             uchar *pMask = (uchar *)((ImaskCodeBook)->imageData); //1 channel image
             // 指向ImaskCodeBook 通道数据序列的首元素
             for(int c=0; c<imageLen; c++)
             {
                 maskPixelCodeBook = cvbackgroundDiff(pColor, cB[c], nChannels, minMod, maxMod);
                 // 我看到这儿时豁然开朗,开始理解了codeBook 呵呵
                 *pMask++ = maskPixelCodeBook;
                 pColor += 3;
                 // pColor 指向的是3通道图像
             }
         }
         if (!(rawImage = cvQueryFrame(capture)))
             break;
         cvShowImage("Raw", rawImage);
         cvShowImage("CodeBook", ImaskCodeBook);

         if (cvWaitKey(30) == 27)
             break;
         if (i == 56 || i == 63)
             cvWaitKey();
     }

     cvReleaseCapture(&capture);
     if (yuvImage)
         cvReleaseImage(&yuvImage);
     if(ImaskCodeBook)
         cvReleaseImage(&ImaskCodeBook);
     cvDestroyAllWindows();
     delete [] cB;

     return 0;
 }

转自：http://my.oschina.net/JiamingMai/blog/191893