Pure python binding of delaunator
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
logs
pydelaunator
.gitignore
LICENSE
MANIFEST.in
Makefile
README.mkd
requirements.txt
setup.py

README.mkd

PyDelaunator

Test of implementation of a quad-edge data structure using python.

This little project is here to study quad-edge structure for further developments of Delaunator, which waits since a long time.

There is a small GUI (done with the awesome pyglet module) that allow one to play with the triangulation.

Installation/requirements

Installation in one command, including dependancies:

pip install pydelaunator

Usage

The package run the GUI if launched directly:

python -m pydelaunator

Use --help for options.

The higher-level API is the Placer object. See tests for other usage examples.

Notes

Goals

This work is mainly here to prototype a better API and detect where and why are bugs in Delaunator.

Efficiency is not a primarily goal, altough, since interfacing python with other languages is a fun exercise, i probably will try some optimizations related to C. Similarly, some algorithms ideas could be easily tested here.

Therefore, PyDelaunator is also a playground for further researchs.

Computational geometry

Codes used there are mainly constitued from online ressources (SO, wikipedia). They are not toroughly tested, but as far as the triangulation works.

Implementating them in C could probably speed them up a little, since in python arithmetic codes tends to be costly.

Duality Vertex/data

Maybe not the most optimized, but a mapping object/vertex with a dict is certainly the less invasive for end-user, as implemented in the Placer object.

Other ways to go:

  • client objects inheriting from Vertex
  • client objects keeping a reference to their vertex

These two ways are probably far more efficient in case of big data. However, if current API allow these, Placer object continue to track objects using the dict mapping. Modification of the Placer is needed, or an alternative implementation.