forked from lijiext/lammps
159 lines
6.9 KiB
HTML
159 lines
6.9 KiB
HTML
<HTML>
|
|
<CENTER><A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> - <A HREF = "Manual.html">LAMMPS Documentation</A> - <A HREF = "Section_commands.html#comm">LAMMPS Commands</A>
|
|
</CENTER>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<HR>
|
|
|
|
<H3>fix lb/rigid/pc/sphere command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>fix ID group-ID lb/rigid/pc/sphere bodystyle args keyword values ...
|
|
</PRE>
|
|
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
|
|
|
|
<LI>lb/rigid/pc/sphere = style name of this fix command
|
|
|
|
<LI>bodystyle = <I>single</I> or <I>molecule</I> or <I>group</I>
|
|
|
|
<LI> <I>single</I> args = none
|
|
<I>molecule</I> args = none
|
|
<I>group</I> args = N groupID1 groupID2 ...
|
|
N = # of groups
|
|
zero or more keyword/value pairs may be appended
|
|
|
|
<LI>keyword = <I>force</I> or <I>torque</I> or <I>innerNodes</I>
|
|
|
|
<PRE> <I>force</I> values = M xflag yflag zflag
|
|
M = which rigid body from 1-Nbody (see asterisk form below)
|
|
xflag,yflag,zflag = off/on if component of center-of-mass force is active
|
|
<I>torque</I> values = M xflag yflag zflag
|
|
M = which rigid body from 1-Nbody (see asterisk form below)
|
|
xflag,yflag,zflag = off/on if component of center-of-mass torque is active
|
|
<I>innerNodes</I> values = innergroup-ID
|
|
innergroup-ID = ID of the atom group which does not experience a hydrodynamic force from the lattice-Boltzmann fluid
|
|
</PRE>
|
|
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>fix 1 spheres lb/rigid/pc/sphere
|
|
fix 1 all lb/rigid/pc/sphere force 1 0 0 innerNodes ForceAtoms
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>This fix is based on the <A HREF = "fix_rigid.html">fix rigid</A> command, and was
|
|
created to be used in place of that fix, to integrate the equations of
|
|
motion of spherical rigid bodies when a lattice-Boltzmann fluid is
|
|
present with a user-specified value of the force-coupling constant.
|
|
The fix uses the integration algorithm described in <A HREF = "#Mackay">Mackay et
|
|
al.</A> to update the positions, velocities, and orientations of
|
|
a set of spherical rigid bodies experiencing velocity dependent
|
|
hydrodynamic forces. The spherical bodies are assumed to rotate as
|
|
solid, uniform density spheres, with moments of inertia calculated
|
|
using the combined sum of the masses of all the constituent particles
|
|
(which are assumed to be point particles).
|
|
</P>
|
|
<HR>
|
|
|
|
<P>By default, all of the atoms that this fix acts on experience a
|
|
hydrodynamic force due to the presence of the lattice-Boltzmann fluid.
|
|
However, the <I>innerNodes</I> keyword allows the user to specify atoms
|
|
belonging to a rigid object which do not interact with the
|
|
lattice-Boltzmann fluid (i.e. these atoms do not feel a hydrodynamic
|
|
force from the lattice-Boltzmann fluid). This can be used to
|
|
distinguish between atoms on the surface of a non-porous object, and
|
|
those on the inside.
|
|
</P>
|
|
<P>This feature can be used, for example, when implementing a hard sphere
|
|
interaction between two spherical objects. Instead of interactions
|
|
occurring between the particles on the surfaces of the two spheres, it
|
|
is desirable simply to place an atom at the center of each sphere,
|
|
which does not contribute to the hydrodynamic force, and have these
|
|
central atoms interact with one another.
|
|
</P>
|
|
<HR>
|
|
|
|
<P>Apart from the features described above, this fix is very similar to
|
|
the rigid fix (although it includes fewer optional arguments, and
|
|
assumes the constituent atoms are point particles); see
|
|
<A HREF = "fix_rigid.html">fix_rigid</A> for a complete documentation.
|
|
</P>
|
|
<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
|
|
</P>
|
|
<P>No information about the <I>rigid</I> and <I>rigid/nve</I> fixes are written to
|
|
<A HREF = "restart.html">binary restart files</A>.
|
|
</P>
|
|
<P>Similar to the <A HREF = "fix_rigid.html">fix_rigid</A> command: " The rigid
|
|
fix computes a global scalar which can be accessed by various <A HREF = "Section_howto.html#howto_15">output
|
|
commands</A>. The scalar value calculated by
|
|
these fixes is "intensive". The scalar is the current temperature of
|
|
the collection of rigid bodies. This is averaged over all rigid
|
|
bodies and their translational and rotational degrees of freedom. The
|
|
translational energy of a rigid body is 1/2 m v^2, where m = total
|
|
mass of the body and v = the velocity of its center of mass. The
|
|
rotational energy of a rigid body is 1/2 I w^2, where I = the moment
|
|
of inertia tensor of the body and w = its angular velocity. Degrees
|
|
of freedom constrained by the <I>force</I> and <I>torque</I> keywords are
|
|
removed from this calculation."
|
|
</P>
|
|
<P>"All of these fixes compute a global array of values which can be
|
|
accessed by various <A HREF = "Section_howto.html#howto_15">output commands</A>.
|
|
The number of rows in the array is equal to the number of rigid
|
|
bodies. The number of columns is 15. Thus for each rigid body, 15
|
|
values are stored: the xyz coords of the center of mass (COM), the xyz
|
|
components of the COM velocity, the xyz components of the force acting
|
|
on the COM, the xyz components of the torque acting on the COM, and
|
|
the xyz image flags of the COM, which have the same meaning as image
|
|
flags for atom positions (see the "dump" command). The force and
|
|
torque values in the array are not affected by the <I>force</I> and
|
|
<I>torque</I> keywords in the fix rigid command; they reflect values before
|
|
any changes are made by those keywords.
|
|
</P>
|
|
<P>The ordering of the rigid bodies (by row in the array) is as follows.
|
|
For the <I>single</I> keyword there is just one rigid body. For the
|
|
<I>molecule</I> keyword, the bodies are ordered by ascending molecule ID.
|
|
For the <I>group</I> keyword, the list of group IDs determines the ordering
|
|
of bodies.
|
|
</P>
|
|
<P>The array values calculated by these fixes are "intensive", meaning
|
|
they are independent of the number of atoms in the simulation.
|
|
</P>
|
|
<P>No parameter of these fixes can be used with the <I>start/stop</I> keywords
|
|
of the <A HREF = "run.html">run</A> command. These fixes are not invoked during
|
|
<A HREF = "minimize.html">energy minimization</A>. "
|
|
</P>
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P>This fix is part of the USER-LB package. It is only enabled if LAMMPS
|
|
was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
|
LAMMPS</A> section for more info.
|
|
</P>
|
|
<P>Can only be used if a lattice-Boltzmann fluid has been created via the
|
|
<A HREF = "fix_lb_fluid.html">fix lb/fluid</A> command, and must come after this
|
|
command. Should only be used if the force coupling constant used in
|
|
<A HREF = "fix_lb_fluid.html">fix lb/fluid</A> has been set by the user; this
|
|
integration fix cannot be used if the force coupling constant is set
|
|
by default.
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "fix_lb_fluid.html">fix lb/fluid</A>, <A HREF = "fix_lb_pc.html">fix lb/pc</A>
|
|
</P>
|
|
<P><B>Default:</B>
|
|
</P>
|
|
<P>The defaults are force * on on on, and torque * on on on.
|
|
</P>
|
|
<HR>
|
|
|
|
<A NAME = "Mackay"></A>
|
|
|
|
<P><B>(Mackay et al.)</B> 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.
|
|
</P>
|
|
</HTML>
|