lammps/examples/COUPLE
Steve Plimpton d9891abdf4 new library functions 2016-10-27 09:34:04 -06:00
..
fortran git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@8636 f3b2605a-c512-4ea7-a41b-209d697bcdaa 2012-08-13 23:49:26 +00:00
fortran2 ignore *.mod generated by fortran compilers 2016-09-13 09:36:19 -04:00
lammps_quest git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@12193 f3b2605a-c512-4ea7-a41b-209d697bcdaa 2014-07-22 18:31:33 +00:00
lammps_spparks git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@9641 f3b2605a-c512-4ea7-a41b-209d697bcdaa 2013-03-11 21:37:15 +00:00
library git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@15084 f3b2605a-c512-4ea7-a41b-209d697bcdaa 2016-05-31 16:38:36 +00:00
multiple git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@14073 f3b2605a-c512-4ea7-a41b-209d697bcdaa 2015-09-24 22:48:45 +00:00
simple new library functions 2016-10-27 09:34:04 -06:00
.gitignore git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@15085 f3b2605a-c512-4ea7-a41b-209d697bcdaa 2016-05-31 16:39:57 +00:00
README git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@14072 f3b2605a-c512-4ea7-a41b-209d697bcdaa 2015-09-24 22:48:28 +00:00

README

This directory has examples of how to use LAMMPS as a library, either
by itself or in tandem with another code or library.

These examples is meant to illustrate what is possible when coupling
codes or calling LAMMPS as a library.  The examples are provided for
demonstration purposes.  The physics they calculate is too simple to
model a realistic problem.

See these sections of the LAMMPS manaul for details:

2.5 Building LAMMPS as a library (doc/Section_start.html#start_5)
6.10 Coupling LAMMPS to other codes (doc/Section_howto.html#howto_10)

In all of the examples included here, LAMMPS must first be built as a
library.  Basically, in the src dir you type one of

make mode=lib machine
make mode=shlib machine

to create the static library liblammps_machine.a or the shared library
liblammps_machine.so for your code to link against.  A soft link
(liblammps.a or liblammps.so) is also created that points to the most
recently built static or shared library.  Your code build can simply
use the soft link if you prefer.

The library interface to LAMMPS is in src/library.cpp.  Routines can
be easily added to this file so an external program can perform the
LAMMPS tasks desired.

-------------------------------------------------------------------

These are the sub-directories included in this directory:

simple		    simple example of driver code calling LAMMPS as a lib
multiple	    example of driver code calling multiple instances of LAMMPS
lammps_quest	    MD with quantum forces, coupling to Quest DFT code
lammps_spparks	    grain-growth Monte Carlo with strain via MD,
		    coupling to SPPARKS kinetic MC code
library		    collection of useful inter-code communication routines
fortran             a simple wrapper on the LAMMPS library API that
 		      can be called from Fortran
fortran2            a more sophisticated wrapper on the LAMMPS library API that
 		      can be called from Fortran

Each sub-directory has its own README.