Skip to content
This repository has been archived by the owner on Nov 1, 2021. It is now read-only.

danoan/BTools

Repository files navigation

Build Status Codacy Badge

BTools

BTools is a collection of applications originally developped for the publication [1]. In this work, we describe a flow driven by the minimization of the elastica energy. Its main applications are the shape-flow and *interactive-seg apps. The latter integrates all the necessary steps to execute a segmentation using the proposed digital flow.

[1] Antunes, D., Lachaud, J.O., Talbot H.: Digital curvature evolution model for image segmentation. In: Couprie, M., Cousty, J., Kenmochi, Y., Mustafa, N. (eds.) Discrete Geometry for Computer Imagery. pp 15-26. Springer International Publishing, Cham (2019).

Dependencies

libboost1.66.0-dev

opencv-3.3.0

eigen-3.36

DGtal1.1

jinja2.11

Build and Install

In order to build BTools, you are going to need cmake.

cd [BTOOLS_ROOT_FOLDER]
mkdir build
cd build
cmake ..
make install

There are plenty of configuration parameters, but usually, if all dependencies are installed in their standard locations, that should be enough. Otherwise, if errors occur, it is likely that a manual configuration should be done. In this scenario, ccmake is quite handy.

How to use

Build instructions can be found in INSTALL.txt

This source contains eight applications. For detailed description, type: [application] -?

We give output examples of the main applications: shape-flow and interactive-seg

shape-flow

Evolve the digital curvature flow for a given digital shape.

./shape-flow -Striangle -r15 -h0.1
./shape-flow -Sflower -r15 -h0.1

Triangle flow

Flower flow

interactive-seg

Load a image, select foreground/background seeds and then execute the boundary-correction algorithm.

./interactive-seg.sh -I images/coala.jpg output/coala

Coala seeds Coala segmentation