lammps/lib/quip

QUIP library

Albert Bartok-Partay
apbartok at gmail dot com
2014

This library provides a plug-in for calling QUIP potentials from
LAMMPS. The QUIP package should be built separately, and then the
resulting libraries can be linked to the LAMMPS code. In case of some
potentials, such as BOP or GAP, third-party packages are needed, which
must be downloaded and compiled separately. NB: although GAP has to be
downloaded separately as it is licensed under a different license
agreement, it is compiled together with the rest of QUIP.

Building LAMMPS with QUIP support:

1) Building QUIP
1.1) Obtaining QUIP

The most current release of QUIP can be obtained from github: 

$ git clone https://github.com/libAtoms/QUIP.git QUIP

If GAP is needed, it may be downloaded from the `Software' section of
libatoms.org, after accepting the terms and conditions of the Academic
License Agreement. Extract the tarball under the /path/to/QUIP/src/ directory.

1.2) Building QUIP

There is a README file in the top-level QUIP directory, but here are
the main steps.

The arch directory contains a selection of machine- and
compiler-specific makefiles,
e.g. Makefile.linux_x86_64_gfortran. Decide which one is most
appropriate for your system, and edit if necessary. The configuring
step will use the makefile based on the QUIP_ARCH environment
variable, i.e. Makefile.${QUIP_ARCH}. The script will create a build
directory, build/${QUIP_ARCH}, and all the building will happen
there. First it will ask you some questions about where you keep
libraries and other stuff.

Please note: if you are building QUIP to link it to LAMMPS, the serial version
of QUIP must be compiled. For example, QUIP_ARCH may be:
darwin_x86_64_gfortran
linux_x86_64_gfortran
linux_x86_64_ifort_icc etc.

If you don't use something it is asking for, just leave it blank. NB
make sure to answer `y' to `Do you want to compile with GAP prediction
support ? [y/n]'. The answers will be stored in Makefile.inc in the
build/${QUIP_ARCH} directory, and you can edit them later (e.g. to
change optimisation or debug options). Note that the default state is
usually with rather heavy debugging on, including bounds checking,
which makes the code quite slow. The make command has to be executed
from the top-level directory. Making `libquip' ensures all the
necessary libraries will be built.

for example:

$ cd QUIP
$ export QUIP_ROOT=/path/to/QUIP
$ export QUIP_ARCH=linux_x86_64_gfortran
$ make config
$ make libquip

Optionally, do
$ make test
to run a test suite.

2) Building LAMMPS

LAMMPS is now shipped with the interface necessary to use QUIP potentials, but
it should be enabled first. Enter the LAMMPS directory:

$ cd LAMMPS
$ cd src
$ make yes-user-quip

2.2) Build LAMMPS according to the instructions on the LAMMPS website.

3) There are two example sets in examples/USER/quip:

- a set of input files to compute the energy of an 8-atom cubic
  diamond cell of silicon with the Stillinger-Weber potential. Use
  this to benchmark that the interface is working correctly.

- a set of input files to demonstrate how GAP potentials are specified
  in a LAMMPS input file to run a short MD. The GAP parameter file
  gap_example.xml is intended for TESTING purposes only. Potentials can be
  downloaded from http://www.libatoms.org or obtained from the authors of QUIP.