lammps/doc/delete_atoms.html

86 lines
3.0 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>delete_atoms command
</H3>
<P><B>Syntax:</B>
</P>
<PRE>delete_atoms style args
</PRE>
<UL><LI>style = <I>group</I> or <I>region</I> or <I>overlap</I>
<PRE> <I>group</I> args = group-ID
<I>region</I> args = region-ID
<I>overlap</I> args = distance type1 type2
distance = delete atoms with neighbors within this cutoff (distance units)
type1 = type of first atom in pair (optional)
type2 = type of other atom in pair (optional)
</PRE>
</UL>
<P><B>Examples:</B>
</P>
<PRE>delete_atoms group edge
delete_atoms region sphere
delete_atoms overlap 0.3
delete_atoms overlap 0.3 1 1
</PRE>
<P><B>Description:</B>
</P>
<P>Delete the specified atoms. This command can be used to carve out
voids from a block of material or to delete created atoms that are too
close to each other (e.g. at a grain boundary).
</P>
<P>For style <I>group</I>, all atoms belonging to the group are deleted.
</P>
<P>For style <I>region</I>, all atoms in the region volume are deleted.
</P>
<P>For style <I>overlap</I>, pairs of atoms within the specified cutoff
distance are searched for, and one of the 2 atoms is deleted. If no
atom types are specified, an atom will always be deleted if the cutoff
criterion is met. If a single atom type is specified, then one or
both of the atoms in the pair must be of the specified type for a
deletion to occur. If two atom types are specified, the two atoms in
the pair must be of the specified types for a deletion to occur. For
a given configuration of atoms, the only guarantee is that at the end
of the deletion operation, enough deletions will have occurred that no
atom pairs within the cutoff (and with the specified types) will
remain. There is no guarantee that the minimum number of atoms will
be deleted, or that the same atoms will be deleted when running on
different numbers of processors.
</P>
<P>After atoms are deleted, if the system is not molecular (no bonds),
then atom IDs are re-assigned so that they run from 1 to the number of
atoms in the system. This is not done for molecular systems, since it
would foul up the bond connectivity that has already been assigned.
</P>
<P><B>Restrictions:</B>
</P>
<P>The <I>overlap</I> style requires inter-processor communication to acquire
ghost atoms and setup a neighbor list. This means that your system
must be ready to perform a simulation before using this command (force
fields setup, atom masses set, etc).
</P>
<P>If the <A HREF = "special_bonds.html">special_bonds</A> command is used with a
setting of 0, then a pair of bonded atoms (1-2, 1-3, or 1-4) will not
appear in the neighbor list, and thus will not be considered for
deletion by the <I>overlap</I> style. You probably don't want to be
deleting one atom in a bonded pair anyway.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "create_atoms.html">create_atoms</A>
</P>
<P><B>Default:</B> none
</P>
</HTML>