jianmu
/
lammps
forked from lijiext/lammps
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

'' 

git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@14137 f3b2605a-c512-4ea7-a41b-209d697bcdaa
This commit is contained in:
sjplimp 2015-10-21 19:30:46 +00:00
parent a5abe2a330
commit cb6baee0b1
8 changed files with 496 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/Section_commands.html
View File

@ -758,69 +758,69 @@ g = GPU, i = USER-INTEL, k = KOKKOS, o = USER-OMP, t = OPT.</p>
<a class="reference internal" href="Section_start.html#start-3"><span>LAMMPS is built with the appropriate package</span></a>.</p>
<table border="1" class="docutils">
<colgroup>
<col width="14%" />
<col width="15%" />
<col width="15%" />
<col width="20%" />
<col width="14%" />
<col width="22%" />
<col width="14%" />
</colgroup>
<tbody valign="top">
<tr class="row-odd"><td><a class="reference internal" href="fix_adapt_fep.html"><em>adapt/fep</em></a></td>
<td><a class="reference internal" href="fix_addtorque.html"><em>addtorque</em></a></td>
<td><a class="reference internal" href="fix_atc.html"><em>atc</em></a></td>
<td><a class="reference internal" href="fix_ave_correlate_long.html"><em>ave/correlate/long</em></a></td>
<td><a class="reference internal" href="fix_ave_spatial_sphere.html"><em>ave/spatial/sphere</em></a></td>
<td><a class="reference internal" href="fix_drude.html"><em>drude</em></a></td>
<td><a class="reference internal" href="fix_drude_transform.html"><em>drude/transform/direct</em></a></td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="fix_drude_transform.html"><em>drude/transform/reverse</em></a></td>
<tr class="row-even"><td><a class="reference internal" href="fix_drude_transform.html"><em>drude/transform/direct</em></a></td>
<td><a class="reference internal" href="fix_drude_transform.html"><em>drude/transform/reverse</em></a></td>
<td><a class="reference internal" href="fix_colvars.html"><em>colvars</em></a></td>
<td><a class="reference internal" href="fix_gle.html"><em>gle</em></a></td>
<td><a class="reference internal" href="fix_imd.html"><em>imd</em></a></td>
<td><a class="reference internal" href="fix_ipi.html"><em>ipi</em></a></td>
<td><a class="reference internal" href="fix_langevin_drude.html"><em>langevin/drude</em></a></td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="fix_langevin_eff.html"><em>langevin/eff</em></a></td>
<tr class="row-odd"><td><a class="reference internal" href="fix_langevin_drude.html"><em>langevin/drude</em></a></td>
<td><a class="reference internal" href="fix_langevin_eff.html"><em>langevin/eff</em></a></td>
<td><a class="reference internal" href="fix_lb_fluid.html"><em>lb/fluid</em></a></td>
<td><a class="reference internal" href="fix_lb_momentum.html"><em>lb/momentum</em></a></td>
<td><a class="reference internal" href="fix_lb_pc.html"><em>lb/pc</em></a></td>
<td><a class="reference internal" href="fix_lb_rigid_pc_sphere.html"><em>lb/rigid/pc/sphere</em></a></td>
<td><a class="reference internal" href="fix_lb_viscous.html"><em>lb/viscous</em></a></td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="fix_meso.html"><em>meso</em></a></td>
<tr class="row-even"><td><a class="reference internal" href="fix_lb_viscous.html"><em>lb/viscous</em></a></td>
<td><a class="reference internal" href="fix_meso.html"><em>meso</em></a></td>
<td><a class="reference internal" href="fix_meso_stationary.html"><em>meso/stationary</em></a></td>
<td><a class="reference internal" href="fix_nh_eff.html"><em>nph/eff</em></a></td>
<td><a class="reference internal" href="fix_nh_eff.html"><em>npt/eff</em></a></td>
<td><a class="reference internal" href="fix_nve_eff.html"><em>nve/eff</em></a></td>
<td><a class="reference internal" href="fix_nh_eff.html"><em>nvt/eff</em></a></td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="fix_nvt_sllod_eff.html"><em>nvt/sllod/eff</em></a></td>
<tr class="row-odd"><td><a class="reference internal" href="fix_nh_eff.html"><em>nvt/eff</em></a></td>
<td><a class="reference internal" href="fix_nvt_sllod_eff.html"><em>nvt/sllod/eff</em></a></td>
<td><a class="reference internal" href="fix_phonon.html"><em>phonon</em></a></td>
<td><a class="reference internal" href="fix_pimd.html"><em>pimd</em></a></td>
<td><a class="reference internal" href="fix_qbmsst.html"><em>qbmsst</em></a></td>
<td><a class="reference internal" href="fix_qeq_reax.html"><em>qeq/reax</em></a></td>
<td><a class="reference internal" href="fix_qmmm.html"><em>qmmm</em></a></td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="fix_qtb.html"><em>qtb</em></a></td>
<tr class="row-even"><td><a class="reference internal" href="fix_qmmm.html"><em>qmmm</em></a></td>
<td><a class="reference internal" href="fix_qtb.html"><em>qtb</em></a></td>
<td><a class="reference internal" href="fix_reax_bonds.html"><em>reax/c/bonds</em></a></td>
<td><a class="reference internal" href="fix_reaxc_species.html"><em>reax/c/species</em></a></td>
<td><a class="reference internal" href="fix_saed_vtk.html"><em>saed/vtk</em></a></td>
<td><a class="reference internal" href="fix_smd.html"><em>smd</em></a></td>
<td><a class="reference internal" href="fix_smd_adjust_dt.html"><em>smd/adjust/dt</em></a></td>
</tr>
<tr class="row-odd"><td><a class="reference internal" href="fix_smd_integrate_tlsph.html"><em>smd/integrate/tlsph</em></a></td>
<tr class="row-odd"><td><a class="reference internal" href="fix_smd_adjust_dt.html"><em>smd/adjust/dt</em></a></td>
<td><a class="reference internal" href="fix_smd_integrate_tlsph.html"><em>smd/integrate/tlsph</em></a></td>
<td><a class="reference internal" href="fix_smd_integrate_ulsph.html"><em>smd/integrate/ulsph</em></a></td>
<td><a class="reference internal" href="fix_smd_move_triangulated_surface.html"><em>smd/move/triangulated/surface</em></a></td>
<td><a class="reference internal" href="fix_smd_setvel.html"><em>smd/setvel</em></a></td>
<td><a class="reference internal" href="fix_smd_tlsph_reference_configuration.html"><em>smd/tlsph/reference/configuration</em></a></td>
<td><a class="reference internal" href="fix_smd_wall_surface.html"><em>smd/wall/surface</em></a></td>
</tr>
<tr class="row-even"><td><a class="reference internal" href="fix_temp_rescale_eff.html"><em>temp/rescale/eff</em></a></td>
<tr class="row-even"><td><a class="reference internal" href="fix_smd_wall_surface.html"><em>smd/wall/surface</em></a></td>
<td><a class="reference internal" href="fix_temp_rescale_eff.html"><em>temp/rescale/eff</em></a></td>
<td><a class="reference internal" href="fix_ti_rs.html"><em>ti/rs</em></a></td>
<td><a class="reference internal" href="fix_ti_spring.html"><em>ti/spring</em></a></td>
<td><a class="reference internal" href="fix_ttm.html"><em>ttm/mod</em></a></td>
<td>&nbsp;</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>

1
doc/Section_commands.txt
View File

@ -602,6 +602,7 @@ package"_Section_start.html#start_3.
"adapt/fep"_fix_adapt_fep.html,
"addtorque"_fix_addtorque.html,
"atc"_fix_atc.html,
"ave/correlate/long"_fix_ave_correlate_long.html,
"ave/spatial/sphere"_fix_ave_spatial_sphere.html,
"drude"_fix_drude.html,
"drude/transform/direct"_fix_drude_transform.html,

10
doc/fix_ave_correlate.html
View File

@ -136,7 +136,7 @@
<li>ave/correlate = style name of this fix command</li>
<li>Nevery = use input values every this many timesteps</li>
<li>Nrepeat = # of correlation time windows to accumulate</li>
<li>Nfreq = calculate tine window averages every this many timesteps</li>
<li>Nfreq = calculate time window averages every this many timesteps</li>
<li>one or more input values can be listed</li>
<li>value = c_ID, c_ID[N], f_ID, f_ID[N], v_name</li>
</ul>
@ -192,7 +192,10 @@ fix 1 all ave/correlate 1 50 10000 &amp;
calculate time correlations bewteen them at varying time intervals,
and average the correlation data over longer timescales. The
resulting correlation values can be time integrated by
<a class="reference internal" href="variable.html"><em>variables</em></a> or used by other <a class="reference internal" href="Section_howto.html#howto-15"><span>output commands</span></a> such as <a class="reference internal" href="thermo_style.html"><em>thermo_style custom</em></a>, and can also be written to a file.</p>
<a class="reference internal" href="variable.html"><em>variables</em></a> or used by other <a class="reference internal" href="Section_howto.html#howto-15"><span>output commands</span></a> such as <a class="reference internal" href="thermo_style.html"><em>thermo_style custom</em></a>, and can also be written to a file. See the
<a class="reference internal" href="fix_ave_correlate_long.html"><em>fix ave/correlate/long</em></a> command for an
alternate method for computing correlation functions efficiently over
very long time windows.</p>
<p>The group specified with this command is ignored. However, note that
specified values may represent calculations performed by computes and
fixes which store their own &#8220;group&#8221; definitions.</p>
@ -406,7 +409,8 @@ the <a class="reference internal" href="run.html"><em>run</em></a> command. Thi
</div>
<div class="section" id="related-commands">
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline"></a></h2>
<p><a class="reference internal" href="compute.html"><em>compute</em></a>, <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>, <a class="reference internal" href="fix_ave_atom.html"><em>fix ave/atom</em></a>, <a class="reference internal" href="fix_ave_spatial.html"><em>fix ave/spatial</em></a>,
<p><a class="reference internal" href="fix_ave_correlate_long.html"><em>fix ave/correlate/long</em></a>,
<a class="reference internal" href="compute.html"><em>compute</em></a>, <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>, <a class="reference internal" href="fix_ave_atom.html"><em>fix ave/atom</em></a>, <a class="reference internal" href="fix_ave_spatial.html"><em>fix ave/spatial</em></a>,
<a class="reference internal" href="fix_ave_histo.html"><em>fix ave/histo</em></a>, <a class="reference internal" href="variable.html"><em>variable</em></a></p>
<p><strong>Default:</strong> none</p>
<p>The option defaults are ave = one, type = auto, start = 0, no file

8
doc/fix_ave_correlate.txt
View File

@ -16,7 +16,7 @@ ID, group-ID are documented in "fix"_fix.html command :ulb,l
ave/correlate = style name of this fix command :l
Nevery = use input values every this many timesteps :l
Nrepeat = # of correlation time windows to accumulate :l
Nfreq = calculate tine window averages every this many timesteps :l
Nfreq = calculate time window averages every this many timesteps :l
one or more input values can be listed :l
value = c_ID, c_ID\[N\], f_ID, f_ID\[N\], v_name :l
c_ID = global scalar calculated by a compute with ID
@ -67,7 +67,10 @@ and average the correlation data over longer timescales. The
resulting correlation values can be time integrated by
"variables"_variable.html or used by other "output
commands"_Section_howto.html#howto_15 such as "thermo_style
custom"_thermo_style.html, and can also be written to a file.
custom"_thermo_style.html, and can also be written to a file. See the
"fix ave/correlate/long"_fix_ave_correlate_long.html command for an
alternate method for computing correlation functions efficiently over
very long time windows.
The group specified with this command is ignored. However, note that
specified values may represent calculations performed by computes and
@ -324,6 +327,7 @@ minimization"_minimize.html.
[Related commands:]
"fix ave/correlate/long"_fix_ave_correlate_long.html,
"compute"_compute.html, "fix ave/time"_fix_ave_time.html, "fix
ave/atom"_fix_ave_atom.html, "fix ave/spatial"_fix_ave_spatial.html,
"fix ave/histo"_fix_ave_histo.html, "variable"_variable.html

317
doc/fix_ave_correlate_long.html Normal file
View File

@ -0,0 +1,317 @@
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>fix ave/correlate/long command &mdash; LAMMPS 15 May 2015 version documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/sphinxcontrib-images/LightBox2/lightbox2/css/lightbox.css" type="text/css" />
<link rel="top" title="LAMMPS 15 May 2015 version documentation" href="index.html"/>
<script src="_static/js/modernizr.min.js"></script>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-nav-search">
<a href="Manual.html" class="icon icon-home"> LAMMPS
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul>
<li class="toctree-l1"><a class="reference internal" href="Section_intro.html">1. Introduction</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_start.html">2. Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_commands.html">3. Commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_packages.html">4. Packages</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_accelerate.html">5. Accelerating LAMMPS performance</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_howto.html">6. How-to discussions</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_example.html">7. Example problems</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_perf.html">8. Performance &amp; scalability</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_tools.html">9. Additional tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_modify.html">10. Modifying &amp; extending LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_python.html">11. Python interface to LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_errors.html">12. Errors</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_history.html">13. Future and history</a></li>
</ul>
</div>
&nbsp;
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="Manual.html">LAMMPS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="Manual.html">Docs</a> &raquo;</li>
<li>fix ave/correlate/long command</li>
<li class="wy-breadcrumbs-aside">
<a href="http://lammps.sandia.gov">Website</a>
<a href="Section_commands.html#comm">Commands</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="fix-ave-correlate-long-command">
<span id="index-0"></span><h1>fix ave/correlate/long command<a class="headerlink" href="#fix-ave-correlate-long-command" title="Permalink to this headline"></a></h1>
<div class="section" id="syntax">
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline"></a></h2>
<div class="highlight-python"><div class="highlight"><pre>fix ID group-ID ave/correlate/long Nevery Nfreq value1 value2 ... keyword args ...
</pre></div>
</div>
<ul class="simple">
<li>ID, group-ID are documented in <a class="reference internal" href="fix.html"><em>fix</em></a> command</li>
<li>ave/correlate/long = style name of this fix command</li>
<li>Nevery = use input values every this many timesteps</li>
<li>Nfreq = save state of the time correlation functions every this many timesteps</li>
<li>one or more input values can be listed</li>
<li>value = c_ID, c_ID[N], f_ID, f_ID[N], v_name</li>
</ul>
<div class="highlight-python"><div class="highlight"><pre>c_ID = global scalar calculated by a compute with ID
c_ID[I] = Ith component of global vector calculated by a compute with ID
f_ID = global scalar calculated by a fix with ID
f_ID[I] = Ith component of global vector calculated by a fix with ID
v_name = global value calculated by an equal-style variable with name
</pre></div>
</div>
<ul class="simple">
<li>zero or more keyword/arg pairs may be appended</li>
<li>keyword = <em>type</em> or <em>start</em> or <em>file</em> or <em>overwrite</em> or <em>title1</em> or <em>title2</em> or <em>ncorr</em> or <em>p</em> or <em>m</em></li>
</ul>
<pre class="literal-block">
<em>type</em> arg = <em>auto</em> or <em>upper</em> or <em>lower</em> or <em>auto/upper</em> or <em>auto/lower</em> or <em>full</em>
auto = correlate each value with itself
upper = correlate each value with each succeeding value
lower = correlate each value with each preceding value
auto/upper = auto + upper
auto/lower = auto + lower
full = correlate each value with every other value, including itself = auto + upper + lower
<em>start</em> args = Nstart
Nstart = start accumulating correlations on this timestep
<em>file</em> arg = filename
filename = name of file to output correlation data to
<em>overwrite</em> arg = none = overwrite output file with only latest output
<em>title1</em> arg = string
string = text to print as 1st line of output file
<em>title2</em> arg = string
string = text to print as 2nd line of output file
<em>ncorr</em> arg = Ncorrelators
Ncorrelators = number of correlators to store
<em>nlen</em> args = Nlen
Nlen = length of each correlator
<em>ncount</em> args = Ncount
Ncount = number of values over which succesive correlators are averaged
</pre>
</div>
<div class="section" id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline"></a></h2>
<div class="highlight-python"><div class="highlight"><pre>fix 1 all ave/correlate/long 5 1000 c_myTemp file temp.correlate
fix 1 all ave/correlate/long 1 10000 &amp;
c_thermo_press[1] c_thermo_press[2] c_thermo_press[3] &amp;
type upper title1 &quot;My correlation data&quot; nlen 15 ncount 3
</pre></div>
</div>
</div>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>This fix is similar in spirit and syntax to the <a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a>. However, this fix allows the
efficient calculation of time correlation functions on the fly over
extremely long time windows without too much CPU overhead, using a
multiple-tau method <a class="reference internal" href="#ramirez"><span>(Ramirez)</span></a> that decreases the resolution
of the stored correlation function with time.</p>
<p>The group specified with this command is ignored. However, note that
specified values may represent calculations performed by computes and
fixes which store their own &#8220;group&#8221; definitions.</p>
<p>Each listed value can be the result of a compute or fix or the
evaluation of an equal-style variable. See the <a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a> doc page for details.</p>
<p>The <em>Nevery</em> and <em>Nfreq</em> arguments specify on what timesteps the input
values will be used to calculate correlation data, and the frequency
with which the time correlation functions will be output to a file.
Note that there is no <em>Nrepeat</em> argument, unlike the <a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a> command.</p>
<p>The optional keywords <em>ncorr</em>, <em>nlen</em>, and <em>ncount</em> are unique to this
command and determine the number of correlation points calculated and
the memory and CPU overhead used by this calculation. <em>Nlen</em> and
<em>ncount</em> determine the amount of averaging done at longer correlation
times. The default values <em>nlen=16</em>, <em>ncount=2</em> ensure that the
systematic error of the multiple-tau correlator is always below the
level of the statistical error of a typical simulation (which depends
on the ensemble size and the simulation length).</p>
<p>The maximum correlation time (in time steps) that can be reached is
given by the formula (nlen-1) * ncount^(ncorr-1). Longer correlation
times are discarded and not calculated. With the default values of
the parameters (ncorr=20, nlen=16 and ncount=2), this corresponds to
7864320 time steps. If longer correlation times are needed, the value
of ncorr should be increased. Using nlen=16 and ncount=2, with
ncorr=30, the maximum number of steps that can be correlated is
80530636808. If ncorr=40, correlation times in excess of 8e12 time
steps can be calculated.</p>
<p>The total memory needed for each correlation pair is roughly
4*ncorr*nlen*8 bytes. With the default values of the parameters, this
corresponds to about 10 KB.</p>
<p>For the meaning of the additional optional keywords, see the <a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a> doc page.</p>
</div>
<div class="section" id="restart-fix-modify-output-run-start-stop-minimize-info">
<h2>Restart, fix_modify, output, run start/stop, minimize info<a class="headerlink" href="#restart-fix-modify-output-run-start-stop-minimize-info" title="Permalink to this headline"></a></h2>
<p>Since this fix in intended for the calculation of time correlation
functions over very long MD simulations, the information about this
fix is written automatically to binary restart files, so that the time
correlation calculation can continue in subsequent simulations. None
of the fix_modify options are relevant to this fix.</p>
<p>No parameter of this fix can be used with the start/stop keywords of
the run command. This fix is not invoked during energy minimization.</p>
</div>
<div class="section" id="restrictions">
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline"></a></h2>
<p>This compute is part of the USER-MISC package. It is only enabled if
LAMMPS was built with that package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info.</p>
</div>
<div class="section" id="related-commands">
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline"></a></h2>
<p><a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a></p>
<p><strong>Default:</strong> none</p>
<p>The option defaults for keywords that are also keywords for the <a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a> command are as follows: type =
auto, start = 0, no file output, title 1,2 = strings as described on
the <a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a> doc page.</p>
<p>The option defaults for keywords unique to this command are as
follows: ncorr=20, nlen=16, ncount=2.</p>
<hr class="docutils" />
<p id="ramirez"><strong>(Ramirez)</strong> J. Ramirez, S.K. Sukumaran, B. Vorselaars and
A.E. Likhtman, J. Chem. Phys. 133, 154103 (2010).</p>
</div>
</div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright .
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'15 May 2015 version',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2/js/jquery-1.11.0.min.js"></script>
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2/js/lightbox.min.js"></script>
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2-customize/jquery-noconflict.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
</body>
</html>

144
doc/fix_ave_correlate_long.txt Normal file
View File

@ -0,0 +1,144 @@
"LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
:link(lws,http://lammps.sandia.gov)
:link(ld,Manual.html)
:link(lc,Section_commands.html#comm)
:line
fix ave/correlate/long command :h3
[Syntax:]
fix ID group-ID ave/correlate/long Nevery Nfreq value1 value2 ... keyword args ... :pre
ID, group-ID are documented in "fix"_fix.html command :ulb,l
ave/correlate/long = style name of this fix command :l
Nevery = use input values every this many timesteps :l
Nfreq = save state of the time correlation functions every this many timesteps :l
one or more input values can be listed :l
value = c_ID, c_ID\[N\], f_ID, f_ID\[N\], v_name :l
c_ID = global scalar calculated by a compute with ID
c_ID\[I\] = Ith component of global vector calculated by a compute with ID
f_ID = global scalar calculated by a fix with ID
f_ID\[I\] = Ith component of global vector calculated by a fix with ID
v_name = global value calculated by an equal-style variable with name :pre
zero or more keyword/arg pairs may be appended :l
keyword = {type} or {start} or {file} or {overwrite} or {title1} or {title2} or {ncorr} or {p} or {m} :l
{type} arg = {auto} or {upper} or {lower} or {auto/upper} or {auto/lower} or {full}
auto = correlate each value with itself
upper = correlate each value with each succeeding value
lower = correlate each value with each preceding value
auto/upper = auto + upper
auto/lower = auto + lower
full = correlate each value with every other value, including itself = auto + upper + lower
{start} args = Nstart
Nstart = start accumulating correlations on this timestep
{file} arg = filename
filename = name of file to output correlation data to
{overwrite} arg = none = overwrite output file with only latest output
{title1} arg = string
string = text to print as 1st line of output file
{title2} arg = string
string = text to print as 2nd line of output file
{ncorr} arg = Ncorrelators
Ncorrelators = number of correlators to store
{nlen} args = Nlen
Nlen = length of each correlator
{ncount} args = Ncount
Ncount = number of values over which succesive correlators are averaged :pre
:ule
[Examples:]
fix 1 all ave/correlate/long 5 1000 c_myTemp file temp.correlate
fix 1 all ave/correlate/long 1 10000 &
c_thermo_press\[1\] c_thermo_press\[2\] c_thermo_press\[3\] &
type upper title1 "My correlation data" nlen 15 ncount 3 :pre
[Description:]
This fix is similar in spirit and syntax to the "fix
ave/correlate"_fix_ave_correlate.html. However, this fix allows the
efficient calculation of time correlation functions on the fly over
extremely long time windows without too much CPU overhead, using a
multiple-tau method "(Ramirez)"_#Ramirez that decreases the resolution
of the stored correlation function with time.
The group specified with this command is ignored. However, note that
specified values may represent calculations performed by computes and
fixes which store their own "group" definitions.
Each listed value can be the result of a compute or fix or the
evaluation of an equal-style variable. See the "fix
ave/correlate"_fix_ave_correlate.html doc page for details.
The {Nevery} and {Nfreq} arguments specify on what timesteps the input
values will be used to calculate correlation data, and the frequency
with which the time correlation functions will be output to a file.
Note that there is no {Nrepeat} argument, unlike the "fix
ave/correlate"_fix_ave_correlate.html command.
The optional keywords {ncorr}, {nlen}, and {ncount} are unique to this
command and determine the number of correlation points calculated and
the memory and CPU overhead used by this calculation. {Nlen} and
{ncount} determine the amount of averaging done at longer correlation
times. The default values {nlen=16}, {ncount=2} ensure that the
systematic error of the multiple-tau correlator is always below the
level of the statistical error of a typical simulation (which depends
on the ensemble size and the simulation length).
The maximum correlation time (in time steps) that can be reached is
given by the formula (nlen-1) * ncount^(ncorr-1). Longer correlation
times are discarded and not calculated. With the default values of
the parameters (ncorr=20, nlen=16 and ncount=2), this corresponds to
7864320 time steps. If longer correlation times are needed, the value
of ncorr should be increased. Using nlen=16 and ncount=2, with
ncorr=30, the maximum number of steps that can be correlated is
80530636808. If ncorr=40, correlation times in excess of 8e12 time
steps can be calculated.
The total memory needed for each correlation pair is roughly
4*ncorr*nlen*8 bytes. With the default values of the parameters, this
corresponds to about 10 KB.
For the meaning of the additional optional keywords, see the "fix
ave/correlate"_fix_ave_correlate.html doc page.
[Restart, fix_modify, output, run start/stop, minimize info:]
Since this fix in intended for the calculation of time correlation
functions over very long MD simulations, the information about this
fix is written automatically to binary restart files, so that the time
correlation calculation can continue in subsequent simulations. None
of the fix_modify options are relevant to this fix.
No parameter of this fix can be used with the start/stop keywords of
the run command. This fix is not invoked during energy minimization.
[Restrictions:]
This compute is part of the USER-MISC package. It is only enabled if
LAMMPS was built with that package. See the "Making
LAMMPS"_Section_start.html#start_3 section for more info.
[Related commands:]
"fix ave/correlate"_fix_ave_correlate.html
[Default:] none
The option defaults for keywords that are also keywords for the "fix
ave/correlate"_fix_ave_correlate.html command are as follows: type =
auto, start = 0, no file output, title 1,2 = strings as described on
the "fix ave/correlate"_fix_ave_correlate.html doc page.
The option defaults for keywords unique to this command are as
follows: ncorr=20, nlen=16, ncount=2.
:line
:link(Ramirez)
[(Ramirez)] J. Ramirez, S.K. Sukumaran, B. Vorselaars and
A.E. Likhtman, J. Chem. Phys. 133, 154103 (2010).

4
doc/genindex.html
View File

@ -926,6 +926,10 @@
</dt>
<dt><a href="fix_ave_correlate_long.html#index-0">fix ave/correlate/long</a>
</dt>
<dt><a href="fix_ave_histo.html#index-0">fix ave/histo</a>
</dt>

2
doc/searchindex.js
View File

File diff suppressed because one or more lines are too long