学步园

直方图



　　CvHistogram

　　多维直方图

     typedef struct CvHistogram

      {

            int header_size;

           CvHistType type;

           int flags; int c_dims;

           int dims[CV_HIST_MAX_DIM];

           int mdims[CV_HIST_MAX_DIM];

           float* thresh[CV_HIST_MAX_DIM];

           float* array;

           struct CvNode* root;

           CvSet* set;

           int* chdims[CV_HIST_MAX_DIM];

     } CvHistogram;

　　CreateHist

　　创建直方图

      CvHistogram* cvCreateHist( int dims, int* sizes, int type, float** ranges=NULL, int uniform=1
);

　　dims



　　直方图维数的数目


　　sizes


　　直方图维数尺寸的数组


　　type

　　直方图的表示格式:

       CV_HIST_ARRAY 意味着直方图数据表示为多维密集数组 CvMatND;

       CV_HIST_TREE 意味着直方图数据表示为多维稀疏数组CvSparseMat.

　　ranges


　　图中方块范围的数组. 它的内容取决于参数 uniform 的值。这个范围的用处是确定何时计算直方图或决定反向映射（backprojected ），每个方块对应于输入图像的哪个/哪组值。



　　uniform

　　归一化标识。

      如果不为0，则ranges[i]（0<=i<cDims，译者注：cDims为直方图的维数，对于灰度图为1，彩色图为3）是包含两个元素的范围数组，包括直方图第i维的上界和下界。在第i维上的整个区域
[lower,upper]被分割成 dims[i] 个相等的块（译者注：dims[i]表示直方图第i维的块数），这些块用来确定输入象素的第 i 个值（译者注：对于彩色图像，i确定R, G,或者B）的对应的块；

      如果为0，则ranges[i]是包含dims[i]+1个元素的范围数组，包括lower0, upper0, lower1, upper1 == lower2, ..., upperdims[i]-1,
其中lowerj 和upperj分别是直方图第i维上第 j 个方块的上下界（针对输入象素的第 i 个值）。任何情况下，输入值如果超出了一个直方块所指定的范围外，都不会被 cvCalcHist 计数，而且会被函数cvCalcBackProject 置零。

　　函数 cvCreateHist 创建一个指定尺寸的直方图，并且返回创建的直方图的指针。 如果数组的 ranges 是 0, 则直方块的范围必须由函数cvSetHistBinRanges 稍后指定。虽然
cvCalcHist 和 cvCalcBackProject 可以处理 8-比特图像而无需设置任何直方块的范围，但它们都被假设等分 0..255 之间的空间。

     
SetHistBinRanges

　　设置直方块的区间 void cvSetHistBinRanges( CvHistogram* hist, float** ranges, int uniform=1 );



　　hist 直方图. ranges


　　直方块范围数组的数组，见 cvCreateHist. uniform


　　归一化标识，见 cvCreateHist.

　　函数 cvSetHistBinRanges 是一个独立的函数，完成直方块的区间设置。更多详细的关于参数 ranges 和 uniform 的描述，请参考函数 cvCalcHist , 该函数也可以初始化区间。直方块的区间的设置必须在计算直方图之前，或
在计算直方图的反射图之前。

     
ReleaseHist

　　释放直方图结构 void cvReleaseHist( CvHistogram** hist );


　　hist


　　被释放的直方图结构的双指针.

　　函数 cvReleaseHist 释放直方图 (头和数据). 指向直方图的指针被函数所清空。如果 *hist 指针已经为 NULL, 则函数不做任何事情。

     ClearHist

　　清除直方图 void cvClearHist( CvHistogram* hist );


　　hist 直方图.

　　函数 cvClearHist 当直方图是稠密数组时将所有直方块设置为 0，当直方图是稀疏数组时，除去所有的直方块。

      MakeHistHeaderForArray

　　从数组中创建直方图

      CvHistogram* cvMakeHistHeaderForArray( int dims, int* sizes, CvHistogram* hist, float*
data, float** ranges=NULL, int uniform=1 );

　　dims


　　直方图维数.


　　sizes


　　直方图维数尺寸的数组


　　hist


　　为函数所初始化的直方图头


　　data


　　用来存储直方块的数组


　　ranges


　　直方块范围，见 cvCreateHist. uniform


　　归一化标识，见 cvCreateHist.

　　函数 cvMakeHistHeaderForArray 初始化直方图，其中头和直方块为用户所分配。以后不需要调用 cvReleaseHist 只有稠密直方图可以采用这种方法，函数返回
hist.

      QueryHistValue_1D

　　查询直方块的值

     #define cvQueryHistValue_1D( hist, idx0 ) cvGetReal1D( (hist)->bins, (idx0) )

     #define cvQueryHistValue_2D( hist, idx0, idx1 ) cvGetReal2D( (hist)->bins, (idx0), (idx1) )

     #define cvQueryHistValue_3D( hist, idx0, idx1, idx2 ) cvGetReal3D( (hist)->bins, (idx0), (idx1),
(idx2) )

     #define cvQueryHistValue_nD( hist, idx ) cvGetRealND( (hist)->bins, (idx) )

　　hist 直方图


　　idx0, idx1, idx2, idx3


　　直方块的下标索引


　　idx 下标数组

　　宏 cvQueryHistValue_*D 返回 1D, 2D, 3D 或 N-D 直方图的指定直方块的值。对稀疏直方图，如果方块在直方图中不存在，函数返回 0, 而且不创建新的直方块。

    
GetHistValue_1D