LAMMPS WWW Site - LAMMPS Documentation - LAMMPS Commands

fix append_atoms command

Syntax:

fix ID group-ID append_atoms face arg ... keyword value ... 

Examples:

fix 1 all append_atoms zhi size 5.0 freq 295 units lattice
fix 4 all append_atoms zhi size 15.0 freq 5 units box
fix A all append_atoms zhi size 1.0 freq 1000 units lattice 

Description:

This fix creates atoms on a lattice, appended on the zhi edge of the system box. This can be useful when a shock or wave is propagating from zlo. This allows the system to grow with time to accommodate an expanding wave. A simulation box must already exist, which is typically created via the create_box command. Before using this command, a lattice must also be defined using the lattice command.

This fix will automatically freeze atoms on the zhi edge of the system, so that overlaps are avoided when new atoms are appended.

The size keyword defines the size in z of the chunk of material to be added.

The random keyword will give the atoms random displacements around their lattice points to simulate some initial temperature.

The temp keyword will cause a region to be thermostated with a Langevin thermostat on the zhi boundary. The size of the region is measured from zhi and is set with the extent argument.

The units keyword determines the meaning of the distance units used to define a wall position, but only when a numeric constant is used. A box value selects standard distance units as defined by the units command, e.g. Angstroms for units = real or metal. A lattice value means the distance units are in lattice spacings. The lattice command must have been previously used to define the lattice spacings.


Restart, fix_modify, output, run start/stop, minimize info:

No information about this fix is written to binary restart files. None of the fix_modify options are relevant to this fix. No global or per-atom quantities are stored by this fix for access by various output commands. No parameter of this fix can be used with the start/stop keywords of the run command. This fix is not invoked during energy minimization.

Restrictions:

This fix style is part of the SHOCK package. It is only enabled if LAMMPS was built with that package. See the Making LAMMPS section for more info.

The zhi boundary on which atoms are added with append_atoms must be shrink-wrapped. The zlo boundary may be any boundary type other than periodic.

Related commands:

fix wall/piston command

Default: size = 0.0, freq = 0, units = lattice.