============
Introduction
============
    This page contains software and instructions for factorized graph matching (FGM) [1] [2].
    In addition, we include the following well-known methods as baselines:

	  spectral matching (SM) [3],
      spectral matching with affine constraints (SMAC) [4],
      graduated assignment (GA) [5],
	  probabilistic matching (PM) [6],
	  integer projected fixed point method (IPFP) [7],
      re-weighted random walk matching (RRWM) [8].

    The implementations of the above methods are taken from the authors' websites.


============
Installation
============
    1. unzip "fgm.zip" to your folder;
    2. Run "make" to compile all C++ files;
    3. Run "addPath" to add sub-directories into the path of Matlab.
    4. Run "demoXXX" or "testXXX".


============
Instructions
============
    The package of "fgm.zip" contains the following files and folders:

    ./data: This folder contains the CMU House Image dataset.

    ./save: This folder contains the experimental results reported in the paper.

    ./src: This folder contains the main implmentation of FGM as well as other baselines.

    ./lib: This folder contains some necessary library functions.

    ./make.m: Matlab makefile for C++ code.

    ./addPath.m: Adds the sub-directories into the path of Matlab.

    ./demoToy.m: A demo comparison of different graph matching methods on the synthetic dataset.

    ./demoHouse.m: A demo comparison of different graph matching methods on the on CMU House dataset.
  
    ./testToy.m: Testing the performance of different graph matching methods on the synthetic dataset.
                 This is a similar function used for reporting (Fig. 4) the first experiment (Sec 5.1) in the CVPR 2012 paper

    ./testHouse.m Testing the performance of different graph matching methods on CMU House Image dataset.
			      This is the same function used for reporting (Fig. 4) the first experiment (Sec 5.1) in the CVPR 2013 paper.


========
C++ Code
========
    In order to achieve efficiency, we provide several C++ codes under
    "src/asg/fgm/matrix" for performing matrix products between
    binary matrices. For instance, the function "multiGXH.cpp" is used
    to more efficiently compute the matrix product, "G^T * X * H", where G and H
    are two binary matrices.


==========
References
==========
    [1] F. Zhou and F. De la Torre, "Deformable Graph Matching," in IEEE
    Conference on Computer Vision and Pattern Recognition (CVPR), 2013.
    
    [2] F. Zhou and F. De la Torre, "Factorized Graph Matching," in IEEE
    Conference on Computer Vision and Pattern Recognition (CVPR), 2012.
    
    [3] M. Leordeanu and M. Hebert, "A spectral technique for
    correspondence problems using pairwise constraints," in International
    Conference on Computer Vision (ICCV), 2005.
    
    [4] T. Cour, P. Srinivasan and J. Shi, "Balanced Graph Matching", in
    Advances in Neural Information Processing Systems (NIPS), 2006
    
    [5] S. Gold and A. Rangarajan, "A Graduated Assignment Algorithm for
    Graph Matching", IEEE Transactions on Pattern Analysis and Machine
    Intelligence (PAMI), 1996
    
    [6] R. Zass and A. Shashua, "Probabilistic Graph and Hypergraph
    Matching", in IEEE Conference on Computer Vision and Pattern
    Recognition (CVPR), 2008
    
    [7] M. Leordeanu, M. Hebert and R. Sukthankar, "An Integer Projected
    Fixed Point Method for Graph Matching and MAP Inference", in Advances
    in Neural Information Processing Systems (NIPS), 2009
    
    [8] M. Cho, J. Lee and K. Lee, "Reweighted Random Walks for Graph
	Matching", in European Conference on Computer Vision (ECCV), 2010









Copyright
    This software is free for use in research projects. If you
    publish results obtained using this software, please use this
    citation.
@inproceedings{ZhouD12b,
   author   = {Feng Zhou and Fernando {De la Torre}},
   title    = {Factorized Graph Matching},
   booktitle    = {IEEE Conference on Computer Vision and Pattern Recognition (CVPR)},
   year     = {2012},
}
If you have any question, please feel free to contact Feng Zhou (zhfe99@gmail.com).