Page MenuHomec4science

dihedral_charmm.html
No OneTemporary

File Metadata

Created
Sat, Nov 30, 10:52

dihedral_charmm.html

<!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>dihedral_style charmm 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"/>
<link rel="up" title="Dihedral Styles" href="dihedrals.html"/>
<link rel="next" title="dihedral_style class2 command" href="dihedral_class2.html"/>
<link rel="prev" title="Dihedral Styles" href="dihedrals.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">
<p class="caption"><span class="caption-text">User Documentation</span></p>
<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>
<p class="caption"><span class="caption-text">Index</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="tutorials.html">Tutorials</a></li>
<li class="toctree-l1"><a class="reference internal" href="commands.html">Commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="fixes.html">Fixes</a></li>
<li class="toctree-l1"><a class="reference internal" href="computes.html">Computes</a></li>
<li class="toctree-l1"><a class="reference internal" href="pairs.html">Pair Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="bonds.html">Bond Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="angles.html">Angle Styles</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="dihedrals.html">Dihedral Styles</a><ul class="current">
<li class="toctree-l2 current"><a class="current reference internal" href="#">dihedral_style charmm command</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dihedral-style-charmm-intel-command">dihedral_style charmm/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dihedral-style-charmm-kk-command">dihedral_style charmm/kk command</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dihedral-style-charmm-omp-command">dihedral_style charmm/omp command</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#syntax">Syntax</a></li>
<li class="toctree-l3"><a class="reference internal" href="#examples">Examples</a></li>
<li class="toctree-l3"><a class="reference internal" href="#description">Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="#restrictions">Restrictions</a></li>
<li class="toctree-l3"><a class="reference internal" href="#related-commands">Related commands</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_class2.html">dihedral_style class2 command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_class2.html#dihedral-style-class2-omp-command">dihedral_style class2/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_cosine_shift_exp.html">dihedral_style cosine/shift/exp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_cosine_shift_exp.html#dihedral-style-cosine-shift-exp-omp-command">dihedral_style cosine/shift/exp/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_fourier.html">dihedral_style fourier command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_fourier.html#dihedral-style-fourier-omp-command">dihedral_style fourier/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_harmonic.html">dihedral_style harmonic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_harmonic.html#dihedral-style-harmonic-intel-command">dihedral_style harmonic/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_harmonic.html#dihedral-style-harmonic-omp-command">dihedral_style harmonic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_helix.html">dihedral_style helix command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_helix.html#dihedral-style-helix-omp-command">dihedral_style helix/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_hybrid.html">dihedral_style hybrid command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_multi_harmonic.html">dihedral_style multi/harmonic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_multi_harmonic.html#dihedral-style-multi-harmonic-omp-command">dihedral_style multi/harmonic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_nharmonic.html">dihedral_style nharmonic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_nharmonic.html#dihedral-style-nharmonic-omp-command">dihedral_style nharmonic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_none.html">dihedral_style none command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html">dihedral_style opls command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html#dihedral-style-opls-intel-command">dihedral_style opls/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html#dihedral-style-opls-kk-command">dihedral_style opls/kk command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html#dihedral-style-opls-omp-command">dihedral_style opls/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_quadratic.html">dihedral_style quadratic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_quadratic.html#dihedral-style-quadratic-omp-command">dihedral_style quadratic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_spherical.html">dihedral_style spherical command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_table.html">dihedral_style table command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_table.html#dihedral-style-table-omp-command">dihedral_style table/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_zero.html">dihedral_style zero command</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">dihedral_style charmm command</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dihedral-style-charmm-intel-command">dihedral_style charmm/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dihedral-style-charmm-kk-command">dihedral_style charmm/kk command</a></li>
<li class="toctree-l2"><a class="reference internal" href="#dihedral-style-charmm-omp-command">dihedral_style charmm/omp command</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#syntax">Syntax</a></li>
<li class="toctree-l3"><a class="reference internal" href="#examples">Examples</a></li>
<li class="toctree-l3"><a class="reference internal" href="#description">Description</a></li>
<li class="toctree-l3"><a class="reference internal" href="#restrictions">Restrictions</a></li>
<li class="toctree-l3"><a class="reference internal" href="#related-commands">Related commands</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_class2.html">dihedral_style class2 command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_class2.html#dihedral-style-class2-omp-command">dihedral_style class2/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_cosine_shift_exp.html">dihedral_style cosine/shift/exp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_cosine_shift_exp.html#dihedral-style-cosine-shift-exp-omp-command">dihedral_style cosine/shift/exp/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_fourier.html">dihedral_style fourier command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_fourier.html#dihedral-style-fourier-omp-command">dihedral_style fourier/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_harmonic.html">dihedral_style harmonic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_harmonic.html#dihedral-style-harmonic-intel-command">dihedral_style harmonic/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_harmonic.html#dihedral-style-harmonic-omp-command">dihedral_style harmonic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_helix.html">dihedral_style helix command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_helix.html#dihedral-style-helix-omp-command">dihedral_style helix/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_hybrid.html">dihedral_style hybrid command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_multi_harmonic.html">dihedral_style multi/harmonic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_multi_harmonic.html#dihedral-style-multi-harmonic-omp-command">dihedral_style multi/harmonic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_nharmonic.html">dihedral_style nharmonic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_nharmonic.html#dihedral-style-nharmonic-omp-command">dihedral_style nharmonic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_none.html">dihedral_style none command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html">dihedral_style opls command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html#dihedral-style-opls-intel-command">dihedral_style opls/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html#dihedral-style-opls-kk-command">dihedral_style opls/kk command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_opls.html#dihedral-style-opls-omp-command">dihedral_style opls/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_quadratic.html">dihedral_style quadratic command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_quadratic.html#dihedral-style-quadratic-omp-command">dihedral_style quadratic/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_spherical.html">dihedral_style spherical command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_table.html">dihedral_style table command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_table.html#dihedral-style-table-omp-command">dihedral_style table/omp command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_zero.html">dihedral_style zero command</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="impropers.html">Improper Styles</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><a href="dihedrals.html">Dihedral Styles</a> &raquo;</li>
<li>dihedral_style charmm 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 class="rst-footer-buttons" style="margin-bottom: 1em" role="navigation" aria-label="footer navigation">
<a href="dihedral_class2.html" class="btn btn-neutral float-right" title="dihedral_style class2 command" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="dihedrals.html" class="btn btn-neutral" title="Dihedral Styles" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="dihedral-style-charmm-command">
<span id="index-0"></span><h1>dihedral_style charmm command</h1>
</div>
<div class="section" id="dihedral-style-charmm-intel-command">
<h1>dihedral_style charmm/intel command</h1>
</div>
<div class="section" id="dihedral-style-charmm-kk-command">
<h1>dihedral_style charmm/kk command</h1>
</div>
<div class="section" id="dihedral-style-charmm-omp-command">
<h1>dihedral_style charmm/omp command</h1>
<div class="section" id="syntax">
<h2>Syntax</h2>
<pre class="literal-block">
dihedral_style charmm
</pre>
</div>
<div class="section" id="examples">
<h2>Examples</h2>
<pre class="literal-block">
dihedral_style charmm
dihedral_coeff 1 0.2 1 180 1.0
dihedral_coeff 2 1.8 1 0 1.0
dihedral_coeff 1 3.1 2 180 0.5
</pre>
</div>
<div class="section" id="description">
<h2>Description</h2>
<p>The <em>charmm</em> dihedral style uses the potential</p>
<img alt="_images/dihedral_charmm.jpg" class="align-center" src="_images/dihedral_charmm.jpg" />
<p>See <a class="reference internal" href="#dihedral-mackerell"><span class="std std-ref">(MacKerell)</span></a> for a description of the CHARMM
force field. This dihedral style can also be used for the AMBER force
field (see comment on weighting factors below). See
<a class="reference internal" href="#dihedral-cornell"><span class="std std-ref">(Cornell)</span></a> for a description of the AMBER force
field.</p>
<p>The following coefficients must be defined for each dihedral type via the
<a class="reference internal" href="dihedral_coeff.html"><span class="doc">dihedral_coeff</span></a> command as in the example above, or in
the data file or restart files read by the <a class="reference internal" href="read_data.html"><span class="doc">read_data</span></a>
or <a class="reference internal" href="read_restart.html"><span class="doc">read_restart</span></a> commands:</p>
<ul class="simple">
<li>K (energy)</li>
<li>n (integer &gt;= 0)</li>
<li>d (integer value of degrees)</li>
<li>weighting factor (1.0, 0.5, or 0.0)</li>
</ul>
<p>The weighting factor is required to correct for double counting
pairwise non-bonded Lennard-Jones interactions in cyclic systems or
when using the CHARMM dihedral style with non-CHARMM force fields.
With the CHARMM dihedral style, interactions between the 1st and 4th
atoms in a dihedral are skipped during the normal non-bonded force
computation and instead evaluated as part of the dihedral using
special epsilon and sigma values specified with the
<a class="reference internal" href="pair_charmm.html"><span class="doc">pair_coeff</span></a> command of pair styles that contain
&#8220;lj/charmm&#8221; (e.g. <a class="reference internal" href="pair_charmm.html"><span class="doc">pair_style lj/charmm/coul/long</span></a>)
In 6-membered rings, the same 1-4 interaction would be computed twice
(once for the clockwise 1-4 pair in dihedral 1-2-3-4 and once in the
counterclockwise dihedral 1-6-5-4) and thus the weighting factor has
to be 0.5 in this case. In 4-membered or 5-membered rings, the 1-4
dihedral also is counted as a 1-2 or 1-3 interaction when going around
the ring in the opposite direction and thus the weighting factor is
0.0, as the 1-2 and 1-3 exclusions take precedence.</p>
<p>Note that this dihedral weighting factor is unrelated to the scaling
factor specified by the <a class="reference internal" href="special_bonds.html"><span class="doc">special bonds</span></a> command
which applies to all 1-4 interactions in the system. For CHARMM force
fields, the special_bonds 1-4 interaction scaling factor should be set
to 0.0. Since the corresponding 1-4 non-bonded interactions are
computed with the dihedral. This means that if any of the weighting
factors defined as dihedral coefficients (4th coeff above) are
non-zero, then you must use a pair style with &#8220;lj/charmm&#8221; and set the
special_bonds 1-4 scaling factor to 0.0 (which is the
default). Otherwise 1-4 non-bonded interactions in dihedrals will be
computed twice.</p>
<p>Also note that for AMBER force fields, which use pair styles with
&#8220;lj/cut&#8221;, the special_bonds 1-4 scaling factor should be set to the
AMBER defaults (1/2 and 5/6) and all the dihedral weighting factors
(4th coeff above) must be set to 0.0. In this case, you can use any
pair style you wish, since the dihedral does not need any
Lennard-Jones parameter information and will not compute any 1-4
non-bonded interactions.</p>
<hr class="docutils" />
<p>Styles with a <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
functionally the same as the corresponding style without the suffix.
They have been optimized to run faster, depending on your available
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><span class="doc">Section 5</span></a>
of the manual. The accelerated styles take the same arguments and
should produce the same results, except for round-off and precision
issues.</p>
<p>These accelerated styles are part of the GPU, USER-INTEL, KOKKOS,
USER-OMP and OPT packages, respectively. They are only enabled if
LAMMPS was built with those packages. See the <a class="reference internal" href="Section_start.html#start-3"><span class="std std-ref">Making LAMMPS</span></a> section for more info.</p>
<p>You can specify the accelerated styles explicitly in your input script
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span class="std std-ref">-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
use the <a class="reference internal" href="suffix.html"><span class="doc">suffix</span></a> command in your input script.</p>
<p>See <a class="reference internal" href="Section_accelerate.html"><span class="doc">Section 5</span></a> of the manual for
more instructions on how to use the accelerated styles effectively.</p>
</div>
<hr class="docutils" />
<div class="section" id="restrictions">
<h2>Restrictions</h2>
<p>This dihedral style can only be used if LAMMPS was built with the
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span class="std std-ref">Making LAMMPS</span></a> section for more info on packages.</p>
</div>
<div class="section" id="related-commands">
<h2>Related commands</h2>
<p><a class="reference internal" href="dihedral_coeff.html"><span class="doc">dihedral_coeff</span></a></p>
<p><strong>Default:</strong> none</p>
<hr class="docutils" />
<p id="dihedral-cornell"><strong>(Cornell)</strong> Cornell, Cieplak, Bayly, Gould, Merz, Ferguson,
Spellmeyer, Fox, Caldwell, Kollman, JACS 117, 5179-5197 (1995).</p>
<p id="dihedral-mackerell"><strong>(MacKerell)</strong> MacKerell, Bashford, Bellott, Dunbrack, Evanseck, Field,
Fischer, Gao, Guo, Ha, et al, J Phys Chem B, 102, 3586 (1998).</p>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="dihedral_class2.html" class="btn btn-neutral float-right" title="dihedral_style class2 command" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="dihedrals.html" class="btn btn-neutral" title="Dihedral Styles" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<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>

Event Timeline