README

First:

cd grouping/source
mkdir build && cd build && cmake ../ && make && mv *.so ../../lib
cd ../..
export LD_LIBRARY_PATH=$(pwd)/lib:/usr/lib

To run, go to the grouping folder and open up octave (or Matlab, but I have not tried on matlab yet). The run:

addpath(genpath('./'))
compile
example

As of the mail of June 2012, I am allowed to relicense gPb as BSD and integrate it in OpenCV

gPb licensing / OpenCV integration
From:	Michael Maire <mmaire@caltech.edu>
To:	Vincent Rabaud <vrabaud@willowgarage.com>
CC:	Jitendra Malik <malik@eecs.berkeley.edu>, Charless Fowlkes <fowlkes@ics.uci.edu>, Pablo Arbelaez <arbelaez@eecs.berkeley.edu>, David Martin <david.r.martin@gmail.com>
Date:	Monday 12:54:37 PM
Hi Vincent,

The current gPb-UCM code consists of some components distributed under
the GPL and some components distributed under the AGPL:
http://www.gnu.org/copyleft/gpl.html
http://www.gnu.org/licenses/agpl.html

We would like to make the following licensing arrangements to allow
integration into OpenCV:

(1) We give you, the OpenCV team, and Willow Garage permission to take 
    our current gPb-UCM code, use whatever parts of it (or all of it) 
    that you like, and distribute the result as part of OpenCV under
    the BSD license ( http://opensource.org/licenses/bsd-license.php ).

(2) OpenCV (and the gPb-UCM implementation within it) are distributed 
    under the BSD license.

(3) We will continue to distribute our own gPb-UCM code under the 
    current GPL/AGPL.

Essentially, we are taking a snapshot of the code and releasing it to
you under the BSD license.

Point (3) above is made to indicate that we intend to release our own
future enhancements under the GPL/AGPL and not under the BSD license.
You would need to negotiate separately for permission to include such
work in OpenCV.

Also note that we are not changing the license on any of our own code
which uses gPb in a larger project.  For example, I have written code
that combines gPb with object detection and released the result under
the AGPL.  At this time, I am NOT releasing this additional code with a
BSD license.

What we are granting you permission to distribute under the BSD license
is our code for the implementation of gPb-UCM corresponding to the work
described in this paper:

Contour Detection and Hierarchical Image Segmentation
P. Arbelaez, M. Maire, C. Fowlkes and J. Malik.
IEEE TPAMI, Vol. 33, No. 5, pp. 898-916, May 2011
http://www.eecs.berkeley.edu/Research/Projects/CS/vision/grouping/papers/amfm_pami2010.pdf

The code will be that found here, with a few pending improvements by
Pablo:
http://www.eecs.berkeley.edu/Research/Projects/CS/vision/grouping/BSR/BSR_source.tgz

All contributors to this code are cc'd to this email and all have agreed
to the licensing arrangement outlined above.  If anyone has additional
questions, please email me.

Turning to practical matters, Pablo and I will coordinate with Vincent
on the technical details of integrating gPb into OpenCV.  If anyone else
would also like to be a part of this process, please let me know.
Otherwise, we will leave you out of the technical discussion unless your
advice is specifically required.

Best,
Michael