Building CIS

Unfortunately, the code from CIS cannot be shipped with this library due to the restrictive license. Therefore, only a command line tool in cis_cli is provided.

Installation instructions:

Go to http://www.csd.uwo.ca/faculty/olga/ and download the code.

Extract the archive into lib_cis in order to obtain the following directory structure (where the CMakeLists.txt files are provided by this library):

lib_cis
|- vlib
    |- include
    |- utils
    |- CMakeLists.txt (provided by this library, not included in the download described above)
|- README.txt (original README)
|- README.md (this README)
|- maxflow.cpp
|- ...
|- superpixels.h (provided by this library, not included in the download described above)
|- CMakeLists.txt (provided by this library, not included in the download described above)

Comment out the main function in superpixels.cpp.

Change the declaration of loadEdges in superpixels.cpp to

void loadEdges(vector<Value> &weights,int num_pixels,int width,int height,
               Value lambda, vlib::image<unsigned char> *edges)

or use -fpermissive (default) (adapt CMakeLists.txt accordingly).

In loadEdges comment out the following line:

image<uchar> *edges = loadPGM(name);

Adapt computeWeights to accept an additional parameter named sigma, thereby commenting the following line out:

float sigma = 2.0f;

Depending on the operating system, some changes in energy.h are required: Change occurrences of

add_tweights(y, 0, C);
add_edge(x, y, B+C, 0);

to

this->add_tweights(y, 0, C);
this->add_edge(x, y, B+C, 0);

Now use -DBUILD_CIS=On to run CMake (as described in Building.