lammps/doc/fix_wall.html

233 lines
11 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 wall/lj93 command
</H3>
<H3>fix wall/lj126 command
</H3>
<H3>fix wall/colloid command
</H3>
<H3>fix wall/harmonic command
</H3>
<P><B>Syntax:</B>
</P>
<PRE>fix ID group-ID style keyword values ...
</PRE>
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
<LI>style = <I>wall/lj93</I> or <I>wall/lj126</I> or <I>wall/colloid</I> or <I>wall/harmonic</I>
<LI>one or more keyword/value pairs may be appended
<LI>keyword = <I>xlo</I> or <I>xhi</I> or <I>ylo</I> or <I>yhi</I> or <I>zlo</I> or <I>zhi</I> or <I>vel</I> or <I>wiggle/sin</I> or <I>wiggle/cos</I> or <I>units</I>
<PRE> <I>xlo</I>, <I>xhi</I>, <I>ylo</I>, <I>yhi</I>, <I>zlo</I>, <I>zhi</I> values = coord epsilon sigma cutoff
coord = position of wall (distance units)
epsilon = strength factor for wall-particle interaction (energy or energy/distance^2 units)
sigma = size factor for wall-particle interaction (distance units)
cutoff = distance from wall at which wall-particle interaction is cut off (distance units)
<I>vel</I> value = v
v = velocity of wall in perpendicular direction (velocity units)
<I>wiggle/sin</I> values = amplitude period
amplitude = size of oscillation (distance units)
period = time of oscillation (time units)
<I>wiggle/cos</I> values = amplitude period
amplitude = size of oscillation (distance units)
period = time of oscillation (time units)
<I>units</I> value = <I>lattice</I> or <I>box</I>
lattice = the wall is defined in lattice units
box = the wall is defined in simulation box units
</PRE>
</UL>
<P><B>Examples:</B>
</P>
<PRE>fix wallhi all wall/lj93 xhi 10.0 1.0 1.0 2.5
fix wallhi all wall/lj126 xhi 23.2 1.0 1.0 2.5 vel 1.0 units box
fix zwalls all wall/colloid zlo 0.0 1.0 1.0 0.858 zhi 40.0 1.0 1.0 0.858
</PRE>
<P><B>Description:</B>
</P>
<P>Bound the simulation domain on one or more of its faces with a flat
wall that interacts with the atoms in the group by generating a force
on the atom in a direction perpendicular to the wall. The energy of
wall-particle interactions depends on the style.
</P>
<P>For style <I>wall/lj93</I>, the energy E is given by the 9/3 potential:
</P>
<CENTER><IMG SRC = "Eqs/fix_wall_lj93.jpg">
</CENTER>
<P>For style <I>wall/lj126</I>, the energy E is given by the 12/6 potential:
</P>
<CENTER><IMG SRC = "Eqs/pair_lj.jpg">
</CENTER>
<P>For style <I>wall/colloid</I>, the energy E is given by an integrated form of
the <A HREF = "pair_colloid.html">pair_style colloid</A> potential:
</P>
<CENTER><IMG SRC = "Eqs/fix_wall_colloid.jpg">
</CENTER>
<P>For style <I>wall/harmonic</I>, the energy E is given by a harmonic spring
potential:
</P>
<CENTER><IMG SRC = "Eqs/fix_wall_harmonic.jpg">
</CENTER>
<P>In all cases, <I>r</I> is the distance from the particle to the wall at
position <I>coord</I>, and Rc is the <I>cutoff</I> distance at which the
particle and wall no longer interact. The energy of the wall
potential is shifted so that the wall-particle interaction energy is
0.0 at the cutoff distance.
</P>
<P>For the <I>wall/lj93</I> and <I>wall/lj126</I> styles, <I>epsilon</I> and <I>sigma</I> are
the usual Lennard-Jones parameters, which determine the strength and
size of the particle as it interacts with the wall. Epsilon has
energy units. Note that this <I>epsilon</I> and <I>sigma</I> may be different
than any <I>epsilon</I> or <I>sigma</I> values defined for a pair style that
computes particle-particle interactions.
</P>
<P>The <I>wall/lj93</I> interaction is derived by integrating over a 3d
half-lattice of Lennard-Jones 12/6 particles. The <I>wall/lj126</I>
interaction is effectively a harder, more repulsive wall interaction.
</P>
<P>For the <I>wall/colloid</I> style, <I>epsilon</I> is effectively a Hamaker
constant with energy units for the colloid-wall interaction, <I>R</I> is
the radius of the colloid particle, <I>D</I> is the distance from the
surface of the colloid particle to the wall (r-R), and <I>sigma</I> is the
size of a constituent LJ particle inside the colloid particle. Note
that the cutoff distance Rc in this case is the distance from the
colloid particle center to the wall.
</P>
<P>The <I>wall/colloid</I> interaction is derived by integrating over
constituent LJ particles of size <I>sigma</I> within the colloid particle
and a 3d half-lattice of Lennard-Jones 12/6 particles of size <I>sigma</I>
in the wall.
</P>
<P>For the <I>wall/harmonic</I> style, <I>epsilon</I> is effectively the spring
constant K, and has units (energy/distance^2). The input parameter
<I>sigma</I> is ignored. The minimum energy position of the harmonic
spring is at the <I>cutoff</I>. This is a repulsive-only spring since the
interaction is truncated at the <I>cutoff</I>
</P>
<P>IMPORTANT NOTE: For all of the styles, you must insure that r is
always > 0 for all particles in the group, or LAMMPS will generate an
error. This means you cannot start your simulation with particles at
the wall position <I>coord</I> (r = 0) or with particles on the wrong side
of the wall (r < 0). For the <I>wall/lj93</I> and <I>wall/lj126</I> styles, the
energy of the wall/particle interaction (and hence the force on the
particle) blows up as r -> 0. The <I>wall/colloid</I> style is even more
restrictive, since the energy blows up as D = r-R -> 0. This means
the finite-size particles of radius R must be a distance larger than R
from the wall position <I>coord</I>. The <I>harmonic</I> style is a softer
potential and does not blow up as r -> 0, but you must use a large
enough <I>epsilon</I> that particles always reamin on the correct side of
the wall (r > 0).
</P>
<P>If the <I>vel</I> keyword is specified, the position of all walls will move
during the simulation in a perpendicular direction, based on their
initial <I>coord</I> position, the specified velocity <I>vel</I>, and the time
elapsed since the fix was specified. A positive velocity means each
wall moves inward, towards the center of the box. I.e. an <I>xlo</I> wall
will move in the +x direction and an <I>xhi</I> wall will move in the -x
direction. A negative velocity means each wall moves outward, away
from the center of the box. If you want different walls to move with
different velocities, then you need to use multiple fix wall commands.
</P>
<P>If the <I>wiggle/sin</I> keyword is specified, the position of all walls
will oscillate sinusoidally during the simulation in the perpendicular
direction, according to the equation:
</P>
<PRE>position = coord + A sin(omega*delta)
</PRE>
<P>If the <I>wiggle/cos</I> keyword is specified, the position of all walls
will oscillate sinusoidally during the simulation in the perpendicular
direction, according to the equation:
</P>
<PRE>position = coord + A (1 - cos(omega*delta))
</PRE>
<P>In both cases, <I>coord</I> is the specified initial position of the wall,
<I>A</I> is the <I>amplitude</I>, <I>omega</I> is 2 PI / <I>period</I>, and <I>delta</I> is the
time elapsed since the fix was specified. A positive amplitude means
each wall initially moves inward, towards the center of the box.
I.e. an <I>xlo</I> wall will move initially in the +x direction and an
<I>xhi</I> wall will move initially in the -x direction. A negative
velocity means each wall moves initially outward, away from the center
of the box. Note that the <I>wiggle/sin</I> option oscillates with
amplitude <I>A</I> around the pos0 position and the velocity of the wall is
a maximum at time 0. By contrast, for the <I>wiggle/cos</I> option the
wall moves up to <I>2A</I> away from pos0 in one direction and the velocity
of the wall is 0 at time 0. If you want different walls to oscillate
with different amplitudes or periods, then you need to use multiple
fix wall commands.
</P>
<P>The <I>units</I> keyword determines the meaning of the distance units used
to define the position of the wall and its velocity and wiggle
amplitude. A <I>box</I> value selects standard distance units as defined
by the <A HREF = "units.html">units</A> command, e.g. Angstroms for units = real or
metal. A <I>lattice</I> value means the distance units are in lattice
spacings. The <A HREF = "lattice.html">lattice</A> command must have been
previously used to define the lattice spacing. Note that with the
<I>lattice</I> option, the wall's position is specified in lattice
spacings, the wall's velocity is specified in lattice spacings per
time, and the wall's oscillation amplitude is specified in lattice
spacings. Each of these 3 quantities may be dependent on the x,y,z
dimension, since the lattice spacings can be different in x,y,z.
</P>
<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
</P>
<P>No information about this fix is written to <A HREF = "restart.html">binary restart
files</A>.
</P>
<P>The <A HREF = "fix_modify.html">fix_modify</A> <I>energy</I> option is supported by this
fix to add the energy of interaction between atoms and each wall to
the system's potential energy as part of <A HREF = "thermo_style.html">thermodynamic
output</A>.
</P>
<P>This fix computes a global scalar energy and a global 6-length vector
of forces (one force magnitude per wall), which can be accessed by
various <A HREF = "Section_howto.html#4_15">output commands</A>. Note that the
scalar energy is the sum of interactions with all defined walls. If
you want the energy on a per-wall basis, you need to use multiple fix
wall commands. The 6 vector quantities are the force on the <I>xlo</I>
wall, the <I>xhi</I> wall, <I>ylo</I>, <I>yhi</I>, <I>zlo</I>, <I>zhi</I>. These values will
only be non-zero if the corresponding wall is defined. Note that an
outward force on a wall will be a negative value for <I>lo</I> walls and a
positive value for <I>hi</I> walls. The scalar and vector values
calculated by this fix are "extensive".
</P>
<P>No parameter of this fix can be used with the <I>start/stop</I> keywords of
the <A HREF = "run.html">run</A> command.
</P>
<P>The forces due to this fix are imposed during an energy minimization,
invoked by the <A HREF = "minimize.html">minimize</A> command.
</P>
<P>IMPORTANT NOTE: If you want the atom/wall interaction energy to be
included in the total potential energy of the system (the quantity
being minimized), you MUST enable the <A HREF = "fix_modify.html">fix_modify</A>
<I>energy</I> option for this fix.
</P>
<P><B>Restrictions:</B>
</P>
<P>Any dimension (xyz) that has a wall must be non-periodic.
</P>
<P>You cannot use both the <I>vel</I> and either of the <I>wiggle</I> keywords
together.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "fix_wall_reflect.html">fix wall/reflect</A>,
<A HREF = "fix_wall_gran.html">fix wall/gran</A>,
<A HREF = "fix_wall_region.html">fix wall/region</A>
</P>
<P><B>Default:</B>
</P>
<P>The option defaults are no velocity, no wiggle, and units = lattice.
</P>
</HTML>