Homec4science
Diffusion lammps (lammm-devel) Browse

lammps/doc/html/fix_tmd.html
717e719b8300lammm-devel

Last Change
Raw File

fix_tmd.html
View Options

<!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 tmd command &mdash; LAMMPS 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 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 tmd 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-tmd-command">
<span id="index-0"></span><h1>fix tmd command</h1>
<div class="section" id="syntax">
<h2>Syntax</h2>
<pre class="literal-block">
fix ID group-ID tmd rho_final file1 N file2
</pre>
<ul class="simple">
<li>ID, group-ID are documented in <a class="reference internal" href="fix.html"><span class="doc">fix</span></a> command</li>
<li>tmd = style name of this fix command</li>
<li>rho_final = desired value of rho at the end of the run (distance units)</li>
<li>file1 = filename to read target structure from</li>
<li>N = dump TMD statistics every this many timesteps, 0 = no dump</li>
<li>file2 = filename to write TMD statistics to (only needed if N &gt; 0)</li>
</ul>
</div>
<div class="section" id="examples">
<h2>Examples</h2>
<pre class="literal-block">
fix 1 all nve
fix 2 tmdatoms tmd 1.0 target_file 100 tmd_dump_file
</pre>
</div>
<div class="section" id="description">
<h2>Description</h2>
<p>Perform targeted molecular dynamics (TMD) on a group of atoms. A
holonomic constraint is used to force the atoms to move towards (or
away from) the target configuration. The parameter &#8220;rho&#8221; is
monotonically decreased (or increased) from its initial value to
rho_final at the end of the run.</p>
<p>Rho has distance units and is a measure of the root-mean-squared
distance (RMSD) between the current configuration of the atoms in the
group and the target coordinates listed in file1. Thus a value of
rho_final = 0.0 means move the atoms all the way to the final
structure during the course of the run.</p>
<p>The target file1 can be ASCII text or a gzipped text file (detected by
a .gz suffix). The format of the target file1 is as follows:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="mf">0.0</span> <span class="mf">25.0</span> <span class="n">xlo</span> <span class="n">xhi</span>
<span class="mf">0.0</span> <span class="mf">25.0</span> <span class="n">ylo</span> <span class="n">yhi</span>
<span class="mf">0.0</span> <span class="mf">25.0</span> <span class="n">zlo</span> <span class="n">zhi</span>
<span class="mi">125</span> <span class="mf">24.97311</span> <span class="mf">1.69005</span> <span class="mf">23.46956</span> <span class="mi">0</span> <span class="mi">0</span> <span class="o">-</span><span class="mi">1</span>
<span class="mi">126</span> <span class="mf">1.94691</span> <span class="mf">2.79640</span> <span class="mf">1.92799</span> <span class="mi">1</span> <span class="mi">0</span> <span class="mi">0</span>
<span class="mi">127</span> <span class="mf">0.15906</span> <span class="mf">3.46099</span> <span class="mf">0.79121</span> <span class="mi">1</span> <span class="mi">0</span> <span class="mi">0</span>
<span class="o">...</span>
</pre></div>
</div>
<p>The first 3 lines may or may not be needed, depending on the format of
the atoms to follow. If image flags are included with the atoms, the
1st 3 lo/hi lines must appear in the file. If image flags are not
included, the 1st 3 lines should not appear. The 3 lines contain the
simulation box dimensions for the atom coordinates, in the same format
as in a LAMMPS data file (see the <a class="reference internal" href="read_data.html"><span class="doc">read_data</span></a> command).</p>
<p>The remaining lines each contain an atom ID and its target x,y,z
coordinates. The atom lines (all or none of them) can optionally be
followed by 3 integer values: nx,ny,nz. For periodic dimensions, they
specify which image of the box the atom is considered to be in, i.e. a
value of N (positive or negative) means add N times the box length to
the coordinate to get the true value.</p>
<p>The atom lines can be listed in any order, but every atom in the group
must be listed in the file. Atoms not in the fix group may also be
listed; they will be ignored.</p>
<p>TMD statistics are written to file2 every N timesteps, unless N is
specified as 0, which means no statistics.</p>
<p>The atoms in the fix tmd group should be integrated (via a fix nve,
nvt, npt) along with other atoms in the system.</p>
<p>Restarts can be used with a fix tmd command. For example, imagine a
10000 timestep run with a rho_initial = 11 and a rho_final = 1. If a
restart file was written after 2000 time steps, then the configuration
in the file would have a rho value of 9. A new 8000 time step run
could be performed with the same rho_final = 1 to complete the
conformational change at the same transition rate. Note that for
restarted runs, the name of the TMD statistics file should be changed
to prevent it being overwritten.</p>
<p>For more information about TMD, see <a class="reference internal" href="#schlitter1"><span class="std std-ref">(Schlitter1)</span></a> and
<a class="reference internal" href="#schlitter2"><span class="std std-ref">(Schlitter2)</span></a>.</p>
<p><strong>Restart, fix_modify, output, run start/stop, minimize info:</strong></p>
<p>No information about this fix is written to <a class="reference internal" href="restart.html"><span class="doc">binary restart files</span></a>. None of the <a class="reference internal" href="fix_modify.html"><span class="doc">fix_modify</span></a> options
are relevant to this fix. No global or per-atom quantities are stored
by this fix for access by various <a class="reference internal" href="Section_howto.html#howto-15"><span class="std std-ref">output commands</span></a>.</p>
<p>This fix can ramp its rho parameter over multiple runs, using the
<em>start</em> and <em>stop</em> keywords of the <a class="reference internal" href="run.html"><span class="doc">run</span></a> command. See the
<a class="reference internal" href="run.html"><span class="doc">run</span></a> command for details of how to do this.</p>
<p>This fix is not invoked during <a class="reference internal" href="minimize.html"><span class="doc">energy minimization</span></a>.</p>
</div>
<div class="section" id="restrictions">
<h2>Restrictions</h2>
<p>All TMD fixes must be listed in the input script after all integrator
fixes (nve, nvt, npt) are applied. This ensures that atoms are moved
before their positions are corrected to comply with the constraint.</p>
<p>Atoms that have a TMD fix applied should not be part of a group to
which a SHAKE fix is applied. This is because LAMMPS assumes there
are not multiple competing holonomic constraints applied to the same
atoms.</p>
<p>To read gzipped target files, you must compile LAMMPS with the
-DLAMMPS_GZIP option - see the <a class="reference internal" href="Section_start.html#start-2"><span class="std std-ref">Making LAMMPS</span></a> section of the documentation.</p>
<p><strong>Related commands:</strong> none</p>
<p><strong>Default:</strong> none</p>
<hr class="docutils" />
<p id="schlitter1"><strong>(Schlitter1)</strong> Schlitter, Swegat, Mulders, &#8220;Distance-type reaction
coordinates for modelling activated processes&#8221;, J Molecular Modeling,
7, 171-177 (2001).</p>
<p id="schlitter2"><strong>(Schlitter2)</strong> Schlitter and Klahn, &#8220;The free energy of a reaction
coordinate at multiple constraints: a concise formulation&#8221;, Molecular
Physics, 101, 3439-3443 (2003).</p>
</div>
</div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright 2013 Sandia Corporation.
</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:'',
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>
c4science · Help