This directory contains build settings for the KIM API library which
is required to use the KIM package and its pair_style kim command in a
LAMMPS input script.
Information about the KIM project can be found at https://openkim.org.
The KIM project is lead by Ellad Tadmor and Ryan Elliott (U Minn) and
James Sethna (Cornell U). Ryan Elliott is the main developer for the
KIM API and he also maintains the code that implements the pair_style
kim command.
To download, build, and install the KIM API on your system, follow
these steps. You can use the install.py script to automate these steps.
**Note** The process described below will compile the kim-api using absolute
paths names. This means that if you move your lammps directory to a new
location after compilation the kim-api library will not be able to find some of
its components. It is best to recompile after moving the lammps directory.
The KIM API is available for download from "this site"_https://openkim.org,
namely https://openkim.org. The tarball you download is "kim-api-vX.Y.Z.tgz",
which can be unpacked in this directory or whereever you wish:
tar xvfz kim*tgz
Note that if you unpack and build KIM in this directory, when you
download a new LAMMPS tarball, the files you have added here will be
lost. So you likely want to build it somewhere else.
The kim-api-vX.Y.Z/docs/ directory has further documentation for the
KIM API. In order to compile and install the KIM API follow the
instructions found in the file kim-api-vX.Y.Z/INSTALL. (Don't forget
to download and compile any Model Drivers and Models that you want to
use.)
Once you have successfully compiled and installed the KIM API, you
need to make sure the utility kim-api-build-config is in your PATH so
that the LAMMPS build system can properly work with the KIM API.
The following are example commands that perform these steps:
# replace X.Y.Z as appropriate here and below
$ wget http://s3.openkim.org/kim-api/kim-api-vX.Y.Z.tgz
$ tar zxvf kim-api-vX.Y.Z.tgz
# get OpenKIM models, setup and compile
$ cd kim-api-vX.Y.Z
$ ./configure --prefix=??????
$ make add-EAM_Dynamo_Angelo_Moody_NiAlH__MO_418978237058_001
$ make
$ make install
# replace X with the KIM API major version number
$ make install-set-default-to-vX
# In order to permanently add the kim-api-build-config utility to your
# PATH variable, perform the following:
#
# For the bash shell:
$ printf "export PATH=${PATH}:${HOME}/local/bin\n" >> ${HOME}/.bashrc
$ source ${HOME}/.bashrc
#
# For the csh shell:
% printf "setenv PATH ${PATH}:${HOME}/local/bin\b" >> ${HOME}/.cshrc
% source ${HOME}/.cshrc
When these steps are complete you can build LAMMPS with the KIM
package installed:
$ cd lammps/src
$ make yes-kim
$ make g++ (or whatever target you wish)
Note that the Makefile.lammps file in this directory is required
to allow the LAMMPS build to find the necessary KIM files. You
should not normally need to edit this file.
