The Hungarian-BP code in Paper "Pairwise Matching Through Max-Weight Bipartite Belief Propagation"
Matlab
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
HBPMex @ b87c7f7
.gitmodules
BaBMatchingSolver.m matlab code added thus we get the whole Hungarian-BP code Apr 16, 2016
HungarianBP.m
README.md readme updated Aug 4, 2016
carAsgSrc.m
compiling.m demo for chinese character added May 23, 2016
conKnlGphPQDChar.m demo for chinese character added May 23, 2016
demoCar.m
demoCharater.m
demoMotor.m matlab code added thus we get the whole Hungarian-BP code Apr 16, 2016
gmLSM.m code updated Apr 17, 2016
motorAsgFeat.m
motorAsgSrc.m
newGphChar.m

README.md

HungarianBP: Pairwise Matching through Max-Weight Bipartite Belief Propagation

Introduction

This repository contains the source code of the algorithm described in a CVPR 2016 paper Pairwise Matching through Max-Weight Bipartite Belief Propagation. More details are provided on the [project page] (https://zzhang.org/featurematching.html). This packages has been tested using Matlab R2015b on CentOS 7.0 (a distrubition of Linux) x64.

Citing HungarianBP

If you find HungarianBP useful in your research, please consider citing:

@inproceedings{Zhang:2016:CVPR,
    author = {Zhang, Zhen and Shi, Qinfeng and McAuley, Julian and Wei, Wei and Zhang, Yanning and Hengel, Anton},
    booktitle = {CVPR},
    title = {Pairwise Matching through {Max-Weight} Bipartite Belief Propagation},
    year = {2016}, 
}

Usage

  1. Prerequisites

  2. [Boost] (http://www.boost.org/): Install the boost library via apt-get, yum, or compiling from scratch.

  3. [Matlab] (http://www.mathworks.com/): Install Matlab.

  4. Configuring HungarianBP

  5. Downloading HungarianBP via

        git clone https://github.com/zzhang1987/HungarianBP
    
  6. Fetching the mex code via

    	cd HungarianBP 
        git submodule init
    	git submodule update --remote	
    
  7. Run compiling.m.

    	matlab
    	#inside matlab 
    		cd HungarianBP
    		compiling
    
  8. Run demoCar.m and demoMotor.m to reproduce the results on the [Cars and Motorbikes Dataset] (https://sites.google.com/site/graphmatchingmethods/). Run demoCharater.m to reproduce the results on the [Chinese Character dataset] (http://www.escience.cn/system/file?fileId=62549).

Remarks

Precompiled mex files for linux x64 are included. For other platforms, you can use any compilier that supports matlab and c++11 to compile the mex files.

Feedback

If you have any issues (question, feedback) or find bugs in the code, please contact zhangzhen@mail.nwpu.edu.cn.