Homec4science
Diffusion lammps (HEAD -> master) Browse

lammps/doc/compute_pe_atom.html
0cc1d090f44eHEAD -> master

Last Change
Raw File

compute_pe_atom.html
View Options

<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>
c4science · Help