This package contains a LAMMPS implementation of a background
Lattice-Boltzmann fluid, which can be used to model MD particles
influenced by hydrodynamic forces.  Details are described in these two
papers:

Mackay, F. E., Ollila, S.T.T., and Denniston, C., Hydrodynamic Forces
Implemented into LAMMPS through a lattice-Boltzmann fluid, Computer
Physics Communications 184 (2013) 2021-2031.

Mackay, F. E., and Denniston, C., Coupling MD particles to a
lattice-Boltzmann fluid through the use of conservative forces,
J. Comput. Phys. 237 (2013) 289-298.

See the doc page for the fix lb/fluid command to get started, and see
brief descriptions of other fixes below, each of which have their own
doc page.

There are example scripts for using this package in
examples/USER/lb.

IMPORTANT NOTE: This package can only be used if LAMMPS is compiled
with MPI (i.e. the serial makefile should not be used to compile the
code).  Also, several of the test examples provided make use of the
rigid fix.  Therefore, this should be included in the LAMMPS build by
typing "make yes-rigid" prior to the usual compilation (see the
"Including/excluding packages" section of the LAMMPS manual).

The creators of this package are as follows:

Frances Mackay
University of Western Ontario
fmackay@uwo.ca

Dr. Colin Denniston
University of Western Ontario
cdennist@uwo.ca

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

Fixes provided by this package:

fix_lb_fluid.cpp:  fix used to create the lattice-Boltzmann fluid on a 
		   grid covering the LAMMPS simulation domain.

fix_momentum_lb.cpp:  fix used to subtract off the total (atom plus fluid) 
		      linear momentum from the system.

fix_pc.cpp:  integration algorithm for individual atoms.

fix_rigid_pc_sphere.cpp:  integration algorithm for rigid spherical 
			  collections of atoms.

fix_viscous_lb.cpp:  fix to add the fluid force to the atoms when using a
		     built-in LAMMPS integrator.