
Matlab classes for Hierarchical Models of Scenes, Objects, & Parts
******************************************************************

Variants of these Matlab classes were used to run the experiments 
reported in the following journal publication:
  Describing Visual Scenes Using Transformed Objects and Parts
  E. B. Sudderth, A. Torralba, W. T. Freeman, and A. S. Willsky
  Int. J. Comp. Vision, vol. 77, pp. 291-330, 2008.

The classes in this directory are used for learning nonparametric, Dirichlet 
process models with potentially infinite numbers of objects and parts:
@tdpmix:  Transformed Dirichlet process (TDP) mixture models (IJCV Sec. 7).
          Also supports hierarchical DP mixtures, and standard DP mixtures.
@tdpscenepart:  TDP model for scenes with unknown sets of objects, each of
                which has an unknown set of internal parts.  IJCV Sec. 8, 9.

For demonstrations of MCMC learning on toy data, see the test_*.m scripts.
To adapt these scripts to your own data, replace the call to sampledata.m with 
appropriate calls to insertdata.m.

For examples of how to use these models with realistic image features,
see the "scripts" directory.

