Skip to content

About

Tools associated with DGtal Library

Resources

Contributing

Stars

50 stars

Watchers

19 watching

Forks

Repository files navigation

DGtalTools

DGtalTools is a separate github project containing tools constructed using DGtal library. The main goal of this part is to gather simple and useful tools exploiting the structures and algorithms defined in DGtal. The resulting tools could be useful to:

  • Share and apply DGtal algorithms to various data from different domains.

  • Construct demonstration tools like online demonstrations (as for instance the one of the Image Processing Online (http://www.ipol.im)

  • Simplify comparisons of different algorithms with an single framework.

  • Provide useful tools of digital image related algorithms (extraction of connected components, digital contour/surface extraction, simple visualization tools ... etc).

The source code of the tools can also be used to non DGtal familiar user to show how to include the DGtal library framework directly in their own source code (in complement of DGtal tutorial https://dgtal-team.github.io/doc-nightly/packageTutorials.html).

More Information

  • Related DGtalTools-contrib: https://github.com/DGtal-team/DGtalTools-contrib
  • Release 2.1 DOI
  • Release 2.0 DOI
  • Release 1.4 DOI
  • Release 1.3 DOI
  • Release 1.2 DOI
  • Release 1.1 DOI
  • Release 1.0 DOI
  • Release 0.9.4.1 DOI
  • Release 0.9.4 DOI
  • Release 0.9.3 DOI
  • Release 0.9.2 DOI
  • Release 0.9.1 DOI
  • Release 0.9 DOI
  • Release 0.8 DOI
  • Continuous Integration (Linux/MacOS/Windows) Build status

Documentation

The description and documentation of the tools are available here.

Actually the DGTal project is organized as follows:

  • Converters: utilities to convert various simple file formats (for instance vol2raw, dicom2vol, mesh2heightfield ...)

  • Estimators: different geometric estimators (like tangent, curvature 2D/3D...)

  • Generators: utilities to generate various contours/shapes

  • Visualization: various tools to visualize digital data (set of voxels, vol file, heightmap ... )

  • Volumetric: tools to manipulate volumetric files (marching cube, sub sampling, thinning)

  • ImageProcessing: tools to process images (image restoration, image inpainting)

How to build the tools

  • use cmake tool to generate a build script (MakeFile, VS project,..) from the CMakeLists.txt
  • DGtal must be installed in your system. Concerning DGtal dependencies, all the dependencies used to compile your DGtal library must be present to build the DGtalTools.

Docker

A Dockerfile is included in the repository to allow users to build a Docker image with DGtalTools installed. The image is based on the DGtal Docker image and includes the DGtalTools project and its dependencies.

To build the Docker image, Docker should be installed in the system (see Docker installation). Download the Dockerfile inside the DGtalTools repository and, in the directory containing the Dockerfile, execute:

docker build -t dgtaltools:latest .

Alternatively, users who do not wish to build the image themselves can directly download the prebuilt image from Docker Hub:

docker pull ker69/dgtaltools:latest

To run an interactive terminal inside the Docker container and access local data:

docker run -it --rm \
    -v $(pwd)/samples:/data \
    dgtaltools:latest bash

For example, to run a tools:

vol2obj /data/lobster.vol -m 50 -M 200 res.obj

If you want to use the tools in other image simply do in your Dockerfile:

FROM docker.io/ker69/dgtaltools:latest

Galleries

About

Tools associated with DGtal Library

Resources

Contributing

Stars

50 stars

Watchers

19 watching

Forks

Releases

Packages

Used by

Contributors

Languages