Environment variables

By default, Voro++ installs into the /usr/local directory, which is the standard location for user-installed software. If this is the first time you have installed software into this directory, it may be necessary to adjust your PATH environment variable to tell your shell to look for the Voro++ program here. To check, type

echo $PATH

after which you should see a line such as


containing all the places the shell looks for programs, each separated by a colon. If /usr/local/bin is in this string, then nothing must be done. Otherwise, it is necessary to add a line to your configuration file to append this directory to this variable.

The syntax for adding the PATH variable depends on what shell you using. To determine your shell, type “echo $SHELL”. If you are using csh or tcsh, then you must add the line

set PATH = ($PATH /usr/local/bin)

to the start-up file “.cshrc” in your home directory, using a text editor such as vim, emacs, or nano. If you are using the bash shell, add the line

export PATH=$PATH:/usr/local/bin

to the start-up file “.bashrc”. For the Z shell, the above command can be added to the “.zshenv” start-up file. Many web pages describe the modification of shell environment variables in more detail.

Manual pages

Voro++ contains a man page which is installed into /usr/local/man by default. If you wish to access this page, you may have to repeat the instructions above to add /usr/local/man to the MANPATH environment variable.

Library files

The Voro++ header files are installed into /usr/local/include/voro++. When compiling a program that references them, the compilation flag “-I/usr/local/include/voro++” must be used to tell the compiler to look in this location. The pre-compiled library is installed into /usr/local/lib. To link to the library, it is necessary to use the compile flag “-L/usr/local/lib” to tell the compiler to look in this directory, and then append the flag “-lvoro++” to tell the compiler to use the Voro++ library.