Skip to main content

A module for calculating and analyzing Voronoi tesselations

Project description

Tess, a 3D cell-based Voronoi library based on voro++

Original work by Chris H. Rycroft (UC Berkeley / Lawrence Berkeley Laboratory). This repository includes Python bindings, using Cython.

Voro++ is a software library for carrying out three-dimensional computations of the Voronoi tessellation. A distinguishing feature of the Voro++ library is that it carries out cell-based calculations, computing the Voronoi cell for each particle individually, rather than computing the Voronoi tessellation as a global network of vertices and edges. It is particularly well-suited for applications that rely on cell-based statistics, where features of Voronoi cells (eg. volume, centroid, number of faces) can be used to analyze a system of particles.

Voro++ comprises of several C++ classes that can be built as a static library and linked to. A command-line utility is also provided that can analyze text files of particle configurations and use most of the features of the code. Numerous examples are provided to demonstrate the library’s features and all of these are discussed in detail on the library website.


This repository is a python wrapper around the voro++ library. It is currently not as powerful as the full C++ library, but contains a number of functions.


To make, run python build_ext in either the main directory or the src directory.

To install, run python install --user to install to your home directory (recommended), or sudo python install to install to the main setup directory.


After installation, use import tess to import the module.

Examples of use are available here, with the notebook being rendered from examples/Examples.ipynb.

Voro++ Acknowledgments

This work (voro++) was supported by the Director, Office of Science, Computational and Technology Research, U.S. Department of Energy under Contract No. DE-AC02-05CH11231.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tess, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size tess-0.1.2.linux-x86_64.tar.gz (524.1 kB) File type Dumb Binary Python version 3.4 Upload date Hashes View
Filename, size tess-0.1.2.tar.gz (121.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page