Skip to main content

A odule 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 Boost.Python.
-------------

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.

.. _Original work: http://math.lbl.gov/voro++/

Tess
======

`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.

.. _This repository: https://github.com/wackywendell/tess

Compilation
-----------
To make, run ``python setup.py build_ext`` in either the main directory or the ``src`` directory.

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

Use
---
After installation, use `import tess` to import the module.

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

.. _available here: http://nbviewer.ipython.org/github/wackywendell/tess/blob/master/examples/Examples.ipynb

Voro++ Copyright Notice
=======================
Voro++ Copyright (c) 2008, The Regents of the University of California, through
Lawrence Berkeley National Laboratory (subject to receipt of any required
approvals from the U.S. Dept. of Energy). All rights reserved.

If you have questions about your rights to use or distribute this software,
please contact Berkeley Lab's Technology Transfer Department at TTD@lbl.gov.

NOTICE. This software was developed under partial funding from the U.S.
Department of Energy. As such, the U.S. Government has been granted for itself
and others acting on its behalf a paid-up, nonexclusive, irrevocable, worldwide
license in the Software to reproduce, prepare derivative works, and perform
publicly and display publicly. Beginning five (5) years after the date
permission to assert copyright is obtained from the U.S. Department of Energy,
and subject to any subsequent five (5) year renewals, the U.S. Government is
granted for itself and others acting on its behalf a paid-up, nonexclusive,
irrevocable, worldwide license in the Software to reproduce, prepare derivative
works, distribute copies to the public, perform publicly and display publicly,
and to permit others to do so.


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.

Source Distribution

tess-0.1.tar.gz (121.6 kB view details)

Uploaded Source

Built Distribution

tess-0.1.linux-x86_64.tar.gz (524.1 kB view details)

Uploaded Source

File details

Details for the file tess-0.1.tar.gz.

File metadata

  • Download URL: tess-0.1.tar.gz
  • Upload date:
  • Size: 121.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for tess-0.1.tar.gz
Algorithm Hash digest
SHA256 b2eb81ec0f930a3aaf79ee71ec6f934c60975272cf76681dbb1519e22fd621b6
MD5 276c0b5addd94e068877ba393f3a37ac
BLAKE2b-256 2dae71f76c0125d2899634718508160339fc1c8d51ce0e5be3c00224bb058f70

See more details on using hashes here.

File details

Details for the file tess-0.1.linux-x86_64.tar.gz.

File metadata

File hashes

Hashes for tess-0.1.linux-x86_64.tar.gz
Algorithm Hash digest
SHA256 b0a4c0a73f7e86bf4094a614d5a865e50d9809335ada80e34a9e2ba86ac0d2b6
MD5 3c4555e0f6680231df64cf6b9974afc8
BLAKE2b-256 258e1be56b5d2785736ac45aa9fbc7b4b8e3d1d6ae68a14167607df9dbc55799

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page