diff --git a/examples/README b/examples/README
index 0fa54573c..5f614b968 100644
--- a/examples/README
+++ b/examples/README
@@ -1,87 +1,88 @@
LAMMPS example problems
Each of these sub-directories contains a sample problem you can run
with LAMMPS. Most are 2d models so that they run quickly, requiring a
few seconds to a few minutes to run on a desktop machine. Each
problem has an input script (in.*) and produces a log file (log.*) and
(optionally) a dump file (dump.*) or image files (image.*) when it
runs. Some use a data file (data.*) of initial coordinates as
additional input.
A few sample log file outputs on different machines and different
numbers of processors are included in the directories to compare your
answers to. E.g. a log file like log.crack.date.foo.P means it ran on
P processors of machine "foo" with the dated version of LAMMPS. Note
that these problems should get statistically similar answers when run
on different machines or different numbers of processors, but not
identical answers to those in the log of dump files included here.
See the Errors section of the LAMMPS documentation for more
discussion.
These are the sample problems and their output in the various
sub-directories:
colloid: big colloid particles in a small particle solvent, 2d system
comb: models using the COMB potential
crack: crack propagation in a 2d solid
dipole: point dipolar particles, 2d system
dreiding: methanol via Dreiding FF
eim: NaCl using the EIM potential
ellipse: ellipsoidal particles in spherical solvent, 2d system
flow: Couette and Poiseuille flow in a 2d channel
friction: frictional contact of spherical asperities between 2d surfaces
gpu: use of the GPU package for GPU acceleration
hugoniostat: Hugoniostat shock dynamics
indent: spherical indenter into a 2d solid
+kim: use of potentials in Knowledge Base for Interatomic Models (KIM)
meam: MEAM test for SiC and shear (same as shear examples)
melt: rapid melt of 3d LJ system
micelle: self-assembly of small lipid-like molecules into 2d bilayers
min: energy minimization of 2d LJ melt
msst: MSST shock dynamics
neb: nudged elastic band (NEB) calculation for barrier finding
nemd: non-equilibrium MD of 2d sheared system
obstacle: flow around two voids in a 2d channel
peptide: dynamics of a small solvated peptide chain (5-mer)
peri: Peridynamic model of cylinder impacted by indenter
pour: pouring of granular particles into a 3d box, then chute flow
prd: parallel replica dynamics of vacancy diffusion in bulk Si
reax: RDX and TATB models using the ReaxFF
rigid: rigid bodies modeled as independent or coupled
shear: sideways shear applied to 2d solid, with and without a void
srd: stochastic rotation dynamics (SRD) particles as solvent
tad: temperature-accelerated dynamics of vacancy diffusion in bulk Si
Here is how you might run and visualize one of the sample problems:
cd indent
cp ../../src/lmp_linux . # copy LAMMPS executable to this dir
lmp_linux < in.indent # run the problem
If you uncomment the dump atom (or dump custom or dump cfg) line(s) in
the input script a dump.* file will be produced by the run. These can
be animated using tools like VMD or AtomEye, or the xmovie tool
described in the "Additional Tools" section of the LAMMPS
documentation, e.g.
% ../../tools/xmovie/xmovie -scale dump.indent
If you uncomment the dump image line(s) in the input script a series
of JPG images will be produced by the run. These can be viewed
individually or turned into a movie or animated by tools like
ImageMagick or QuickTime or various Windows-based tools. See the dump
image doc page for more details. E.g. this Imagemagick command would
create a GIF file suitable for viewing in a browser.
% convert -loop 1 *.jpg foo.gif
------------------------------------------
There is also an ELASTIC directory with an example script for
computing elastic constants, using a zero temperature Si example. See
the in.elastic file for more info.
There is also a USER directory which contains subdirectories of
user-provided examples for user packages. See the README files in
those directories for more info. See the doc/Section_start.html file
for more info about user packages.
diff --git a/examples/kim/in.kim.lj b/examples/kim/in.kim.lj
new file mode 100644
index 000000000..356c0ea4e
--- /dev/null
+++ b/examples/kim/in.kim.lj
@@ -0,0 +1,37 @@
+# 3d Lennard-Jones melt
+
+variable x index 1
+variable y index 1
+variable z index 1
+
+variable xx equal 20*$x
+variable yy equal 20*$y
+variable zz equal 20*$z
+
+units metal
+atom_style atomic
+
+newton off
+
+lattice fcc 4.4300
+region box block 0 ${xx} 0 ${yy} 0 ${zz}
+
+create_box 1 box
+create_atoms 1 box
+
+#pair_style lj/cut 8.1500
+#pair_coeff 1 1 0.0031 2.7400
+#pair_modify shift yes
+
+pair_style kim model_Ne_P_LJ_efficiency
+pair_coeff * * Ne
+
+mass 1 20.18
+velocity all create 200.0 232345 loop geom
+
+neighbor 0.3 bin
+neigh_modify delay 5 every 1 check yes
+
+fix 1 all nve
+
+run 100
diff --git a/examples/kim/in.kim.lj.lmp b/examples/kim/in.kim.lj.lmp
new file mode 100644
index 000000000..3c5ffdc8c
--- /dev/null
+++ b/examples/kim/in.kim.lj.lmp
@@ -0,0 +1,37 @@
+# 3d Lennard-Jones melt
+
+variable x index 1
+variable y index 1
+variable z index 1
+
+variable xx equal 20*$x
+variable yy equal 20*$y
+variable zz equal 20*$z
+
+units metal
+atom_style atomic
+
+#newton off
+
+lattice fcc 4.4300
+region box block 0 ${xx} 0 ${yy} 0 ${zz}
+
+create_box 1 box
+create_atoms 1 box
+
+pair_style lj/cut 8.1500
+pair_coeff 1 1 0.0031 2.7400
+pair_modify shift yes
+
+#pair_style kim model_Ne_P_LJ_efficiency
+#pair_coeff * * Ne
+
+mass 1 20.18
+velocity all create 200.0 232345 loop geom
+
+neighbor 0.3 bin
+neigh_modify delay 0 every 1 check yes
+
+fix 1 all nve
+
+run 100