forked from lijiext/lammps
88 lines
3.2 KiB
HTML
88 lines
3.2 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>compute pe/atom command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>compute ID group-ID pe/atom keyword ...
|
|
</PRE>
|
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
|
<LI>pe/atom = style name of this compute command
|
|
<LI>zero or more keywords may be appended
|
|
<LI>keyword = <I>pair</I> or <I>bond</I> or <I>angle</I> or <I>dihedral</I> or <I>improper</I>
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>compute 1 all pe/atom
|
|
compute 1 all pe/atom pair
|
|
compute 1 all pe/atom pair bond
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>Define a computation that computes the per-atom potential energy for
|
|
each atom in a group. See the <A HREF = "compute_pe.html">compute pe</A> command if
|
|
you want the potential energy of the entire system. The per-atom
|
|
energies can be accessed as scalar values by any command that uses
|
|
per-atom computes, e.g. the <A HREF = "dump.html">dump custom</A> command or <A HREF = "fix_ave_spatial.html">fix
|
|
ave/spatial</A> command or <A HREF = "fix_ave_atom.html">fix
|
|
ave/atom</A> command. See <A HREF = "Section_howto.html#4_15">this
|
|
section</A> for an overview.
|
|
</P>
|
|
<P>The per-atom energy is calculated by the various pair, bond, etc
|
|
potentials defined for the simulation. If no extra keywords are
|
|
listed, then the potential energy is the sum of pair, bond, angle,
|
|
dihedral, and improper energy. If any extra keywords are listed, then
|
|
only those components are summed to compute the potential energy.
|
|
</P>
|
|
<P>Note that the energy of each atom is due to its interaction with all
|
|
other atoms in the simulation, not just with other atoms in the group.
|
|
</P>
|
|
<P>For an energy contribution produced by a small set of atoms (e.g. 4
|
|
atoms in a dihedral or 3 atoms in a Tersoff 3-body interaction), that
|
|
energy is assigned in equal portions to each atom in the set.
|
|
E.g. 1/4 of the dihedral energy to each of the 4 atoms.
|
|
</P>
|
|
<P>The <A HREF = "dihedral_charmm.html">dihedral_style charmm</A> style calculates
|
|
pairwise interactions between 1-4 atoms. The energy contribution of
|
|
these terms is included in the pair energy, not the dihedral energy.
|
|
</P>
|
|
<P>As an example of per-atom potential energy compared to total potential
|
|
energy, these lines in an input script should yield the same result
|
|
in the last 2 columns of thermo output:
|
|
</P>
|
|
<PRE>compute peratom all pe/atom
|
|
compute p all reduce sum c_peratom
|
|
thermo_style custom step temp etotal press pe c_p
|
|
</PRE>
|
|
<P>IMPORTANT NOTE: The per-atom energy does NOT include contributions due
|
|
to long-range Coulombic interactions (via the
|
|
<A HREF = "kspace_style.html">kspace_style</A> command). It's not clear this
|
|
contribution can easily be computed.
|
|
</P>
|
|
<P><B>Output info:</B>
|
|
</P>
|
|
<P>This compute calculates a scalar quantity for each atom, which can be
|
|
accessed by any command that uses per-atom computes as input. See
|
|
<A HREF = "Section_howto.html#4_15">this section</A> for an overview of LAMMPS
|
|
output options.
|
|
</P>
|
|
<P><B>Restrictions:</B>
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "compute_pe.html">compute pe</A>, <A HREF = "compute_stress_atom.html">compute
|
|
stress/atom</A>
|
|
</P>
|
|
<P><B>Default:</B> none
|
|
</P>
|
|
</HTML>
|