forked from lijiext/lammps
113 lines
5.3 KiB
HTML
113 lines
5.3 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>fix ave/time command
|
|
</H3>
|
|
<P><B>Syntax:</B>
|
|
</P>
|
|
<PRE>fix ID group-ID ave/time Nevery Nrepeat Nfreq style ID flag file
|
|
</PRE>
|
|
<UL><LI>ID, group-ID are documented in <A HREF = "fix.html">fix</A> command
|
|
<LI>ave/time = style name of this fix command
|
|
<LI>Nevery = calculate property every this many timesteps
|
|
<LI>Nrepeat = # of times to repeat the Nevery calculation before averaging
|
|
<LI>Nfreq = timestep frequency at which the average value is written to file
|
|
<LI>style = <I>compute</I> or <I>fix</I>
|
|
<LI>ID = ID of compute or fix that performs the calculation
|
|
<LI>flag = 0 for scalar quantity, 1 for vector quantity, 2 for both
|
|
<LI>file = filename to write results to (NULL = no file)
|
|
</UL>
|
|
<P><B>Examples:</B>
|
|
</P>
|
|
<PRE>fix 1 all ave/time 100 5 1000 compute myTemp 0 temp.stats
|
|
fix 1 all ave/time 1 100 1000 fix indenter 0 temp.indent
|
|
</PRE>
|
|
<P><B>Description:</B>
|
|
</P>
|
|
<P>Calculate one or more instantaneous quantities every few timesteps,
|
|
and average them over a longer timescale. The resulting averages can
|
|
be written to a file and/or used by other <A HREF = "Section_howto.html#4_15">output
|
|
commands</A> such as <A HREF = "thermo_style.html">thermo_style
|
|
custom</A>.
|
|
</P>
|
|
<P>This fix can be used to time-average a <A HREF = "compute.html">compute</A> which
|
|
calculates a global quantity such as a temperature or pressure or a
|
|
<A HREF = "fix.html">fix</A> which calculates a global quantity. Note that per-atom
|
|
computes cannot be used with this fix; their values can be averaged by
|
|
the <A HREF = "fix_ave_spatial.html">fix ave/spatial</A> or <A HREF = "fix_ave_atom.html">fix
|
|
ave/atom</A> commands.
|
|
</P>
|
|
<P>For style <I>compute</I> the <I>ID</I> specifies a <A HREF = "compute.html">compute</A> which
|
|
calculates the desired property. The compute must be a "global"
|
|
compute that calculates one or more global properties rather than a
|
|
"per-atom" compute. The fix must be previously defined in the input
|
|
script. Or it can be a compute defined by <A HREF = "thermo_style.html">thermodynamic
|
|
output</A> or other fixes such as <A HREF = "fix_nvt.html">fix
|
|
nvt</A> or <A HREF = "fix_temp_rescale.html">fix temp/rescale</A>. Users
|
|
can write code for their own compute styles and <A HREF = "Section_modify.html">add them to
|
|
LAMMPS</A>.
|
|
</P>
|
|
<P>For style <I>fix</I> the <I>ID</I> specifies a <A HREF = "fix.html">fix</A> which calculates
|
|
the desired property. The fix must calculate a global scalar or
|
|
vector quantity, which only a few fixes do. See the doc page for
|
|
individual fix commands for details. The fix must be previously
|
|
defined in the input script. Users can write code for their own fix
|
|
styles and <A HREF = "Section_modify.html">add them to LAMMPS</A>.
|
|
</P>
|
|
<P>The <I>Nevery</I>, <I>Nrepeat</I>, and <I>Nfreq</I> arguments specify how the
|
|
property will be time-averaged. The final averaged value(s) are
|
|
computed every <I>Nfreq</I> timesteps. The average is over <I>Nrepeat</I>
|
|
values, computed in the preceeding portion of the simulation every
|
|
<I>Nevery</I> timesteps. Thus if Nevery=2, Nrepeat=6, and Nfreq=100, then
|
|
values on timesteps 90,92,94,96,98,100 will be used to compute the
|
|
final average written to the file on timestep 100. Similary for
|
|
timesteps 190,192,194,196,198,200 on timestep 200, etc.
|
|
</P>
|
|
<P>The <I>flag</I> argument chooses whether the scalar and/or vector
|
|
calculation of the compute or fix is invoked. The former computes a
|
|
single global value. The latter computes N global values, where N is
|
|
defined by the compute or fix, e.g. 6 pressure tensor components. In
|
|
the vector case, each of the N values is averaged independently and N
|
|
values are written to the file at each output.
|
|
</P>
|
|
<P>Since the calculation is performed by the compute or fix which stores
|
|
its own "group" definition, the group specified for with the fix
|
|
ave/time command is ignored.
|
|
</P>
|
|
<P>If the style is <I>compute</I> and the compute calculates pressure, it will
|
|
cause the force computations performed by LAMMPS (pair, bond, angle,
|
|
etc) to calculate virial terms each Nevery timesteps. If this is more
|
|
frequent than thermodynamic output, this adds extra cost to a
|
|
simulation. However, if a constant pressure simulation is being run
|
|
(<A HREF = "fix_npt.html">fix npt</A> or <A HREF = "fix_nph.html">fix nph</A>), LAMMPS is already
|
|
calculating virial terms for the pressure every timestep.
|
|
</P>
|
|
<P><B>Restart, fix_modify, output, run start/stop, minimize info:</B>
|
|
</P>
|
|
<P>No information about this fix is written to <A HREF = "restart.html">binary restart
|
|
files</A>. None of the <A HREF = "fix_modify.html">fix_modify</A> options
|
|
are relevant to this fix. No global scalar or vector or per-atom
|
|
quantities are stored by this fix for access by various <A HREF = "Section_howto.html#4_15">output
|
|
commands</A>. No parameter of this fix can be
|
|
used with the <I>start/stop</I> keywords of the <A HREF = "run.html">run</A> command.
|
|
This fix is not invoked during <A HREF = "minimize.html">energy minimization</A>.
|
|
</P>
|
|
<P><B>Restrictions:</B> none
|
|
</P>
|
|
<P><B>Related commands:</B>
|
|
</P>
|
|
<P><A HREF = "compute.html">compute</A>, <A HREF = "fix_ave_atom.html">fix ave/atom</A>, <A HREF = "fix_ave_spatial.html">fix
|
|
ave/spatial</A>
|
|
</P>
|
|
<P><B>Default:</B> none
|
|
</P>
|
|
</HTML>
|