DGtal python binding

Package managers:

Pablo Hernandez-Cerdan, David Coeurjolly

Since

1.2

Package Overview

Since release 1.2, DGtal has a partial python binding using pybind11. To install the python package, just use:

pip install dgtal

Then, you can import the module in python:

import dgtal
....

At this point, only a partial support is available (some base, kernel, image, topology classes). For a complete review of the available tools, have a look to this Pull-Request.

Just a quick example (Euler characteristics and simple point detection on random sets):

import dgtal
import random
 
Point  = dgtal.kernel.Point3D
Domain = dgtal.kernel.DomainZ3i
Set    = dgtal._dgtal.kernel.DigitalSetZ3i
 
dom    = Domain( Point(0,0,0), Point(10,10,10))
mySet  = Set(dom)
 
# Random set
for i in range(50*50):
  mySet.insert(Point(random.randint(0,10),random.randint(0,10),random.randint(0,10)))
 
# Digital Object (with topology)
Object = dgtal.topology.Object26_6
Topo   = Object.TDigitalTopology
FAdj   = Topo.TForegroundAdjacency
BAdj   = Topo.TBackgroundAdjacency
fadj   = FAdj()
badj   = BAdj()
topo   = Topo(fadj, badj)
obj    = Object(topo,mySet)
 
#Counting the simple points
cptSimple=0
for p in mySet:
    if obj.isSimple(p):
        cptSimple += 1
print("Number of simple points: "+str(cptSimple)+ " / " + str(mySet.size()))
 
# Cubical Complex
kspace   = dgtal.topology.KSpace3D()
ccomplex = dgtal.topology.CubicalComplex3D(kspace)
ccomplex.construct(mySet)
 
print("Euler characteristic: "+str(ccomplex.euler()))