# histcImWin

## PURPOSE

Calculates local histograms at every point in an image I.

## SYNOPSIS

function H = histcImWin( I, edges, wtMask, shape )

## DESCRIPTION

     Calculates local histograms at every point in an image I.

     H(i,j,...,k,:) will contain the histogram at location (i,j,...,k), as
     calculated by weighing values in I by placing wtMask at that
     location.  For example, if wtMask is ones(windowSize) then the
     histogram at every location will simply be a histogram of the pixels
     within that window.  See histc2 for more information about histgorams.
     See convnFast for information on shape flags.

     USAGE
      H = histcImWin( I, edges, wtMask, [shape] )

     INPUTS
      I           - image (possibly multidimensional) [see above]
      edges       - quantization bounds, see histc2
      wtMask      - numeric array of weights, or cell array of sep kernels
      shape       - ['full'], 'valid', 'same', or 'smooth'

     OUTPUTS
      H           - [size(I)xnBins] array of size(I) histograms

     EXAMPLE
      load trees; L=conv2(X,filterDog2d(10,4,1,0),'valid'); figure(1); im(L);
      f1=filterGauss(25,[],25);  f2=ones(1,15);
      H1 = histcImWin(L, 15, {f1,f1'}, 'same');  figure(2); montage2(H1);
      H2 = histcImWin(L, 15, {f2,f2'}, 'same');  figure(3); montage2(H2);

     See also ASSIGNTOBINS, HISTC2, CONVNFAST, HISTCIMLOC

     Piotr's Image&Video Toolbox      Version 2.0
     Copyright 2008 Piotr Dollar.  [pdollar-at-caltech.edu]
     Please email me if you find bugs, or have suggestions or questions!
     Licensed under the Lesser GPL [see external/lgpl.txt]

## CROSS-REFERENCE INFORMATION

This function calls:

- assignToBins Quantizes A according to values in edges.
- convnFast Fast convolution, replacement for both conv2 and convn.

This function is called by: