lammps/doc/compute_temp_eff.html

101 lines
4.1 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 temp/eff command
</H3>
<P><B>Syntax:</B>
</P>
<PRE>compute ID group-ID temp/eff
</PRE>
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
<LI>temp/eff = style name of this compute command
</UL>
<P><B>Examples:</B>
</P>
<PRE>compute 1 all temp/eff
compute myTemp mobile temp/eff
</PRE>
<P><B>Description:</B>
</P>
<P>Define a computation that calculates the temperature of a group of
nuclei and electrons in the <A HREF = "pair_eff.html">electron force field</A>
model. A compute of this style can be used by commands that compute a
temperature, e.g. <A HREF = "thermo_modify.html">thermo_modify</A>, <A HREF = "fix_npt_eff.html">fix
npt/eff</A>, etc.
</P>
<P>The temperature is calculated by the formula KE = dim/2 N k T, where
KE = total kinetic energy of the group of atoms (sum of 1/2 m v^2 for
nuclei and sum of 1/2 (m v^2 + 3/4 m s^2) for electrons, where s
includes the radial electron velocity contributions), dim = 2 or 3 =
dimensionality of the simulation, N = number of atoms (only total
number of nuclei in the eFF (see the <A HREF = "pair_style.html">pair_eff</A>
command) in the group, k = Boltzmann constant, and T = temperature.
This expression is summed over all nuclear and electronic degrees of
freedom, essentially by setting the kinetic contribution to the heat
capacity to 3/2k (where only nuclei contribute). This subtlety is
valid for temperatures well below the Fermi temperature, which for
densities two to five times the density of liquid H2 ranges from
86,000 to 170,000 K.
</P>
<P>IMPORTANT NOTE: For eFF models, in order to override the default
temperature reported by LAMMPS in the thermodynamic quantities
reported via the <A HREF = "thermo.html">thermo</A> command, the user should apply a
<A HREF = "thermo_modify.html">thermo_modify</A> command, as shown in the following
example:
</P>
<PRE>compute effTemp all temp/eff
thermo_style custom step etotal pe ke temp press
thermo_modify temp effTemp
</PRE>
<P>A 6-component kinetic energy tensor is also calculated by this compute
for use in the computation of a pressure tensor. The formula for the
components of the tensor is the same as the above formula, except that
v^2 is replaced by vx * vy for the xy component, etc. For the eFF,
again, the radial electronic velocities are also considered.
</P>
<P>The number of atoms contributing to the temperature is assumed to be
constant for the duration of the run; use the <I>dynamic</I> option of the
<A HREF = "compute_modify.html">compute_modify</A> command if this is not the case.
</P>
<P>This compute subtracts out degrees-of-freedom due to fixes that
constrain molecular motion, such as <A HREF = "fix_shake.html">fix shake</A> and
<A HREF = "fix_rigid.html">fix rigid</A>. This means the temperature of groups of
atoms that include these constraints will be computed correctly. If
needed, the subtracted degrees-of-freedom can be altered using the
<I>extra</I> option of the <A HREF = "compute_modify.html">compute_modify</A> command.
</P>
<P>See <A HREF = "Section_howto.html#howto_16">this howto section</A> of the manual for
a discussion of different ways to compute temperature and perform
thermostatting.
</P>
<P><B>Output info:</B>
</P>
<P>The scalar value calculated by this compute is "intensive", meaning it
is independent of the number of atoms in the simulation. The vector
values are "extensive", meaning they scale with the number of atoms in
the simulation.
</P>
<P><B>Restrictions:</B>
</P>
<P>This compute is part of the USER-EFF package. It is only enabled if
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
LAMMPS</A> section for more info.
</P>
<P><B>Related commands:</B>
</P>
<P><A HREF = "compute_temp_partial.html">compute temp/partial</A>, <A HREF = "compute_temp_region.html">compute
temp/region</A>, <A HREF = "compute_pressure.html">compute
pressure</A>
</P>
<P><B>Default:</B> none
</P>
</HTML>