1The VORONOI package adds a compute voronoi/atom command which
2calculates a Voronoi tesselation of the system.
3
4It uses the Voro++ library, available at http://math.lbl.gov/voro++/ to
5compute the tesselation locally on each processor.  Voro++ was
6developed by Chris H. Rycroft while at UC Berkeley / Lawrence Berkeley
7Laboratory.
8
9That library can be downloaded and built in lib/voronoi or elsewhere
10on your system, which must be done before building LAMMPS with this
11package.  Details of the download, build, and install process for
12Voro++ are given in the lib/voronoi/README file, and scripts are
13provided to help automate the process.  Also see the LAMMPS manual for
14general information on building LAMMPS with external libraries.  The
15settings in the Makefile.lammps file in lib/voronoi must be correct
16for LAMMPS to build correctly with this package installed.
17
18Once you have successfully built LAMMPS with this package and Voro++,
19you can test it using an input file from the examples dir:
20
21./lmp_serial < lammps/examples/voronoi/in.voronoi | grep '^TEST_'
22
23The output should conclude with 'TEST_DONE' and every line should
24report an error of 0%.
25
26== Credits and license ==
27
28This compute was written by Daniel Schwen (daniel@schwen.de) and is
29licensed under the GPLv2 license.
30
31Please contribute changes back to the community.
32