Download

The current version of the code is available for download here:

Older versions and additional examples are also available.

Installation

The package contains the C++ source code, example files, miscellaneous utilities, and documentation. On Linux, Mac OS, and Windows (using Cygwin), the compilation and installation can be carried out using GNU Make.

To begin, the user should review the file “config.mk” in the top level directory, to make sure that the compilation and installation settings are appropriate for their system. Typing “make” will then compile the static library, command-line utility, and examples.

Following successful compilation, the library, command-line utility, and documentation can be installed by typing “sudo make install”. By default, the program files are installed into /usr/local, and it may be necessary to add these directories to the appropriate environment variables in order to use library. The code can later be uninstalled using “sudo make uninstall”.

On Windows without a terminal environment like Cygwin, it is possible to import and compile the library in many standard C++ development environments. Users have reported success in building the library with Microsoft Visual C++ Express and Code::Blocks.

Related programs

No external dependencies are required to compile and run the code, but several programs may be useful for analyzing the output:

Development version from Subversion repository

Voro++ is hosted on as a project on code@LBL. Anonymous access of the source code via Subversion is possible with the command

svn checkout --username anonsvn https://code.lbl.gov/svn/voro/trunk

When prompted for a password, type "anonsvn".

Contact

If you find this software useful, please contact me, as hearing back from people greatly helps in the development of the library. I am very interested to hear of additional features that people would find useful that the library currently does not support.

References

If you plan to publish an academic paper using this software, please consider citing one of the following publications:

Licensing

This project is free, open-source software, released through the Lawrence Berkeley Laboratory and the US Department of Energy. It is distributed under a modified BSD license, that makes it free for any purpose. The full text of the license is distributed with the code. Any questions about licensing should be directed to the LBL Tech Transfer department.

Acknowledgments

I am very grateful to the following people:

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