lammps/doc/fix_pour.txt

"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c

:link(lws,http://lammps.sandia.gov)
:link(ld,Manual.html)
:link(lc,Section_commands.html#comm)

:line

fix pour command :h3

[Syntax:]

fix ID group-ID pour N type seed keyword values ... :pre

ID, group-ID are documented in "fix"_fix.html command :ulb,l
pour = style name of this fix command :l
N = # of atoms to insert :l
type = atom type to assign to inserted atoms :l
seed = random # seed :l
one or more keyword/value pairs may be appended to args :l
keyword = {region} or {diam} or {dens} or {vol} or {rate} or {vel} :l
  {region} value = region-ID
    region-ID = ID of region to use as insertion volume
  {diam} values = lo hi
    lo,hi = range of diameters for inserted particles (distance units)
  {dens} values = lo hi
    lo,hi = range of densities for inserted particles
  {vol} values = fraction Nattempt
    fraction = desired volume fraction for filling insertion volume
    Nattempt = max # of insertion attempts per atom
  {rate} value = V
    V = z velocity (3d) or y velocity (2d) at which
        insertion volume moves (velocity units)
  {vel} values (3d) = vxlo vxhi vylo vyhi vz
  {vel} values (2d) = vxlo vxhi vy
    vxlo,vxhi = range of x velocities for inserted particles (velocity units)
    vylo,vyhi = range of y velocities for inserted particles (velocity units)
    vz = z velocity (3d) assigned to inserted particles (velocity units)
    vy = y velocity (2d) assigned to inserted particles (velocity units) :pre
:ule

[Examples:]

fix 3 all pour 1000 2 29494 region myblock
fix 2 all pour 10000 1 19985583 region disk vol 0.33 100 rate 1.0 diam 0.9 1.1 :pre

[Description:]

Insert particles into a granular run every few timesteps within a
specified region until N particles have been inserted.  This is useful
for simulating the pouring of particles into a container under the
influence of gravity.

Inserted particles are assigned the specified atom type and are
assigned to two groups: the default group "all" and the group
specified in the fix pour command (which can also be "all").

This command must use the {region} keyword to define an insertion
volume.  The specified region must have been previously defined with a
"region"_region.html command.  It must be of type {block} or a z-axis
{cylinder} and must be defined with side = {in}.  The cylinder style
of region can only be used with 3d simulations.

Each timestep particles are inserted, they are placed randomly inside
the insertion volume so as to mimic a stream of poured particles.  The
larger the volume, the more particles that can be inserted at any one
timestep.  Particles are inserted again after enough time has elapsed
that the previously inserted particles fall out of the insertion
volume under the influence of gravity.  Insertions continue every so
many timesteps until the desired # of particles has been inserted.

All other keywords are optional with defaults as shown below.  The
{diam}, {dens}, and {vel} options enable inserted particles to have a
range of diameters or densities or xy velocities.  The specific values
for a particular inserted particle will be chosen randomly and
uniformly between the specified bounds.  The {vz} or {vy} value for
option {vel} assigns a z-velocity (3d) or y-velocity (2d) to each
inserted particle.

The {vol} option specifies what volume fraction of the insertion
volume will be filled with particles.  The higher the value, the more
particles are inserted each timestep.  Since inserted particles cannot
overlap, the maximum volume fraction should be no higher than about
0.6.  Each timestep particles are inserted, LAMMPS will make up to a
total of M tries to insert the new particles without overlaps, where M
= # of inserted particles * Nattempt.  If LAMMPS is unsuccessful at
completing all insertions, it prints a warning.

The {rate} option moves the insertion volume in the z direction (3d)
or y direction (2d).  This enables pouring particles from a
successively higher height over time.

[Restrictions:]

Can only be used if LAMMPS was built with the "granular" package.  Can
only be used with atom_style granular.

For 3d simulations, a gravity fix in the -z direction must be defined
for use in conjunction with this fix.  For 2d simulations, gravity
must be defined in the -y direction.

[Related commands:]

"fix_deposit"_fix_deposit.html, "fix_gravity"_fix_gravity.html,
"region"_region.html

[Default:]

The option defaults are diam = 1.0 1.0, dens = 1.0 1.0, vol = 0.25 50,
rate = 0.0, vel = 0.0 0.0 0.0 0.0 0.0.