gradientHist

PURPOSE ^

Compute oriented gradient histograms.

SYNOPSIS ^

function H = gradientHist( M, O, varargin )

DESCRIPTION ^

 Compute oriented gradient histograms.

 For each binSize x binSize region in an image I, computes a histogram of
 gradients, with each gradient quantized by its angle and weighed by its
 magnitude. If I has dimensions [hxw], the size of the computed feature
 vector H is floor([h/binSize w/binSize nOrients]).

 This function implements the gradient histogram features described in:
   P. Dollár, Z. Tu, P. Perona and S. Belongie
   "Integral Channel Features", BMVC 2009.
 These features in turn generalize the HOG features introduced in:
   N. Dalal and B. Triggs, "Histograms of Oriented
   Gradients for Human Detection," CVPR 2005.
 Setting parameters appropriately gives almost identical features to the
 original HOG or updated FHOG features, see hog.m and fhog.m for details.

 The input to the function are the gradient magnitude M and orientation O
 at each image location. See gradientMag.m for computing M and O from I.

 The first step in computing the gradient histogram is simply quantizing
 the magnitude M into nOrients [hxw] orientation channels according to the
 gradient orientation. The magnitude at each location is placed into the
 two nearest orientation bins using linear interpolation if softBin >= 0
 or simply to the nearest orientation bin if softBin < 0. Next, spatial
 binning is performed by summing the pixels in each binSize x binSize
 region of each [hxw] orientation channel. If "softBin" is odd each pixel
 can contribute to multiple spatial bins (using bilinear interpolation),
 otherwise each pixel contributes to a single spatial bin. The result of
 these steps is a floor([h/binSize w/binSize nOrients]) feature map
 representing the gradient histograms in each image region.

 Parameter settings of particular interest:
  binSize=1: simply quantize the gradient magnitude into nOrients channels
  softBin=1, useHog=1, clip=.2: original HOG features (see hog.m)
  softBin=-1; useHog=2, clip=.2: FHOG features (see fhog.m)
  softBin=0, useHog=0: channels used in Dollar's BMVC09 paper

 This code requires SSE2 to compile and run (most modern Intel and AMD
 processors support SSE2). Please see: http://en.wikipedia.org/wiki/SSE2.

 USAGE
  H = gradientHist( M, O, [binSize,nOrients,softBin,useHog,clipHog,full] )

 INPUTS
  M        - [hxw] gradient magnitude at each location (see gradientMag.m)
  O        - [hxw] gradient orientation in range defined by param flag
  binSize  - [8] spatial bin size
  nOrients - [9] number of orientation bins
  softBin  - [1] set soft binning (odd: spatial=soft, >=0: orient=soft)
  useHog   - [0] 1: compute HOG (see hog.m), 2: compute FHOG (see fhog.m)
  clipHog  - [.2] value at which to clip hog histogram bins
  full     - [false] if true expects angles in [0,2*pi) else in [0,pi)

 OUTPUTS
  H        - [w/binSize x h/binSize x nOrients] gradient histograms

 EXAMPLE
  I=rgbConvert(imread('peppers.png'),'gray'); [M,O]=gradientMag(I);
  H1=gradientHist(M,O,2,6,0); figure(1); montage2(H1);
  H2=gradientHist(M,O,2,6,1); figure(2); montage2(H2);

 See also gradientMag, gradient2, hog, fhog

 Piotr's Computer Vision Matlab Toolbox      Version 3.23
 Copyright 2014 Piotr Dollar & Ron Appel.  [pdollar-at-gmail.com]
 Licensed under the Simplified BSD License [see external/bsd.txt]

Generated by m2html © 2003