git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@907 f3b2605a-c512-4ea7-a41b-209d697bcdaa

This commit is contained in:
sjplimp
2007-09-27 23:25:52 +00:00
parent 36268e9814
commit 36fbdf7502
43 changed files with 638 additions and 472 deletions

View File

@ -27,7 +27,8 @@ certain kinds of LAMMPS simulations.
4.11 <A HREF = "#4_11">Visualizing LAMMPS snapshots</A><BR>
4.12 <A HREF = "#4_12">Non-orthogonal simulation boxes</A><BR>
4.13 <A HREF = "#4_13">NEMD simulations</A><BR>
4.14 <A HREF = "#4_14">Aspherical particles</A> <BR>
4.14 <A HREF = "#4_14">Aspherical particles</A><BR>
4.15 <A HREF = "#4_15">Output from LAMMPS</A> <BR>
<P>The example input scripts included in the LAMMPS distribution and
highlighted in <A HREF = "Section_example.html">this section</A> also show how to
@ -793,6 +794,105 @@ lj/cut</A>.
</P>
<HR>
<A NAME = "4_15"></A><H4>4.15 Output from LAMMPS
</H4>
<P>There are two basic kinds of LAMMPS output. The first is
thermodynamic output, which is a list of quantities printed every few
timesteps to the screen and logfile. The second is dump files, which
contain snapshots of atoms and various per-atom values and are written
at a specified frequency. A simulation prints one set of
thermodynamic output; it may generate zero, or one, or multiple dump
files. LAMMPS gives you a variety of ways to determine what
quantities are computed and printed when thermodynamic info or dump
files are output. There are also two fixes which perform time and
spatial averaging of user-defined quantities, fix ave/time and fix
ave/spatial. These produce their own output files and are described
below.
</P>
<P>The frequency and format of thermodynamic output is set by the
<A HREF = "thermo.html">thermo</A>, <A HREF = "thermo_style.html">thermo_style</A>, and
<A HREF = "thermo_modify.html">thermo_modify</A> commands. The
<A HREF = "themo_style.html">thermo_style</A> command also specifies what values are
calculated and written out. Pre-defined keywords can be specified
(e.g. press, etotal, etc) which include time-averaged versions of
temperature, pressure, and a few other variables (tave, pave, etc).
Three addtional kinds of keywords can also be specified (c_ID, f_ID,
v_name), where a <A HREF = "compute.html">compute</A> or <A HREF = "fix.html">fix</A> or
<A HREF = "variable.html">variable</A> provides the value(s) to be output. Each of
these are described in turn.
</P>
<P>In LAMMPS, a <A HREF = "compute.html">compute</A> comes in two flavors: ones that
compute one or more global values (e.g. temperature, kinetic energy
tensor) and ones that compute one or more per-atom values. Only the
former can be used for thermodynamic output. The user-defined ID of
the compute is used along with an optional subscript as part of the
<A HREF = "thermo_style.html">thermo_style</A> command. E.g. c_myTemp outputs the
single scalar value generated by the compute; c_myTemp[2] would
output the 2nd vector value.
</P>
<P><A HREF = "fix.html">Fixes</A> can also generate values to output with thermodynamic
output, e.g. the energy of an indenter's interaction with the
simulation atoms. These values are accessed via the same format as
compute's values, as f_ID or f_ID[N]. See the doc pages for
individual fix commands to see which ones generate global values that
can be output with thermodynamic info.
</P>
<P>Input script variables of various kinds are defined by the
<A HREF = "variable.html">variable</A> command. All kinds except the atom-style
variable can be used for thermodynamic output. A variable with name
"abc" is referenced in a thermo_style command as v_abc.
</P>
<P>The variable formula defined in the input script can contain math
functions (add, exp, etc), atom values (x[N], fx[N]), groups
quantities (mass(), vcm(), etc), references to thermodynamic
quantities (e.g. temp, volume, etc), or references to other variables
or <A HREF = "compute.html">computes</A>. Thus a variable is the most general way
to define some quantity you want calculated and output with
thermodynamic info.
</P>
<P>Dump file output is specified by the <A HREF = "dump.html">dump</A> and
<A HREF = "dump_modify.html">dump_modify</A> commands. There are several
pre-defined formats (dump atom, dump xtc, etc). There is also a <A HREF = "dump.html">dump
custom</A> format where you specify what values are output with
each atom. Pre-defined keywords can be specified (e.g. tag, type, x,
etc). Two additional kinds of keywords can also be specified (c_ID,
f_ID), where a <A HREF = "compute.html">compute</A> or <A HREF = "fix.html">fix</A> provides the
values to be output.
</P>
<P><A HREF = "compute.html">Computes</A> that generate per-atom values can be accessed
by the dump custom command. These are computes that have the word
"atom" in their style name, e.g. ke/atom, stress/atom, etc. The
values are accessed as described above: c_myKE or c_myStress[2].
The <A HREF = "compute_variable_atom.html">compute variable/atom</A> command takes a
user-defined atom-style <A HREF = "variable.html">variable</A> as input and
calculates its value for each atom. Since this compute can be
accessed by the dump custom command, this is a general way to define
some quantity you want calculated and output in a dump file.
</P>
<P><A HREF = "fix.html">Fixes</A> can also generate values to output to dump files.
For example, the <A HREF = "fix_ave_atom.html">fix ave/atom</A> command does
time-averaging of atom quantites, such as velocity or energy or stress
which can then be output in a dump file. These values are accessed as
describe above, as f_ID or f_ID[N].
</P>
<P>Two other fixes are of particular note for output. Neither produces
values for thermodynamic or dump output, rather they output their
results directly to a file.
</P>
<P>The <A HREF = "fix_ave_time.html">fix ave/time</A> command enables time-averaging of
global quantities like temperature or pressure. The global quantities
are calculated by a <A HREF = "compute.html">compute</A>.
</P>
<P>The <A HREF = "fix_ave_spatial.html">fix ave/spatial</A> command enables
spatial-averaging of per-atom quantities like per-atom energy or
stress. The per-atom quantities can be atom density (mass or number)
or be calculated by a by a <A HREF = "compute.html">compute</A>. They can also be
quantities calculated by <A HREF = "fix_ave_atom.html">fix ave/atom</A>, which means
you are effectively calculating a time average of a spatial average of
a time-averaged per-atom quantity.
</P>
<HR>
<A NAME = "Cornell"></A>
<P><B>(Cornell)</B> Cornell, Cieplak, Bayly, Gould, Merz, Ferguson,