Topological Watershed

Topological watershed: programs

We provide C source code for computing topological watersheds, both for 2D and 3D grayscale images.

Installation

A version of Linux is needed for an easy installation. To install the programs, download the archive TW_programs.tgz to your working directory, then open a terminal and type :

    tar zxvf TW_programs.tgz
    cd TW_programs
    make

The executables are created in the subdirectory "bin".

File format

We use a standard file format for 2D images, called pgm. The format description can be found here. For 3D images, we use a "natural" extension of the pgm format. In addition to the "width" and "height" fields in the file header, a "depth" field (in ASCII decimal) indicates the number of planes of the 3D volume. The data is stored as a succession of 2D planes. Both raw data and ASCII data are supported.

For conversion from and to raw file format, we provide the programs raw2pgm and pgm2raw.

Test

To test the programs, you may use the images provided in the directory "test".

DOCUMENTATION

A quite minimal documentation is provided. The html version can be found in "doc/html/index.html", and the pdf version in "doc/latex/refman.pdf".

Site info

© 2006-2007 A2SI Lab.