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).
- Related DGtalTools-contrib: https://github.com/DGtal-team/DGtalTools-contrib
- Release 2.1
- Release 2.0
- Release 1.4
- Release 1.3
- Release 1.2
- Release 1.1
- Release 1.0
- Release 0.9.4.1
- Release 0.9.4
- Release 0.9.3
- Release 0.9.2
- Release 0.9.1
- Release 0.9
- Release 0.8
- Continuous Integration (Linux/MacOS/Windows)
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)
- 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.
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
-

vol2heighfield heightfield2vol imgAddNoise vol2slice

mesh2heightfield heightfield2shading vol2sdp -

Illustration of curvatureScaleSpaceBCC
Illustration of generic3dNormalEstimators on VCM estimator applied on smooth and noisy shapes. 2dLocalEstimators 


3dCurveTangentEstimator vol2normalField lengthEstimators -
grid size = 1 grid size= 0.1 grid size = 0.01 shapeGenerator -




3dCurvatureViewer 3dCurveViewer 3dImageViewer 3dVolViewer 

displayContours meshViewer 3dSDPViewer volScope
3dHeightMapViewer 3dCompSurfelData 3dImplicitSurfaceExtractorByThickening









