lammps/doc/html/dihedral_spherical.html

384 lines
21 KiB
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 spherical 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 table command" href="dihedral_table.html"/>
<link rel="prev" title="dihedral_style quadratic command" href="dihedral_quadratic.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">Bonds</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"><a class="reference internal" href="dihedral_charmm.html">dihedral_style charmm command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_charmm.html#dihedral-style-charmm-intel-command">dihedral_style charmm/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_charmm.html#dihedral-style-charmm-kk-command">dihedral_style charmm/kk command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_charmm.html#dihedral-style-charmm-omp-command">dihedral_style charmm/omp command</a></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 current"><a class="current reference internal" href="#">dihedral_style spherical 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_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"><a class="reference internal" href="dihedral_charmm.html">dihedral_style charmm command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_charmm.html#dihedral-style-charmm-intel-command">dihedral_style charmm/intel command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_charmm.html#dihedral-style-charmm-kk-command">dihedral_style charmm/kk command</a></li>
<li class="toctree-l2"><a class="reference internal" href="dihedral_charmm.html#dihedral-style-charmm-omp-command">dihedral_style charmm/omp command</a></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 current"><a class="current reference internal" href="#">dihedral_style spherical 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_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 spherical 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_table.html" class="btn btn-neutral float-right" title="dihedral_style table command" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="dihedral_quadratic.html" class="btn btn-neutral" title="dihedral_style quadratic command" 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-spherical-command">
<span id="index-0"></span><h1>dihedral_style spherical command</h1>
<div class="section" id="syntax">
<h2>Syntax</h2>
<pre class="literal-block">
dihedral_style spherical
</pre>
</div>
<div class="section" id="examples">
<h2>Examples</h2>
<pre class="literal-block">
dihedral_coeff 1 1 286.1 1 124 1 1 90.0 0 1 90.0 0
dihedral_coeff 1 3 286.1 1 114 1 1 90 0 1 90.0 0 &amp;
17.3 0 0.0 0 1 158 1 0 0.0 0 &amp;
15.1 0 0.0 0 0 0.0 0 1 167.3 1
</pre>
</div>
<div class="section" id="description">
<h2>Description</h2>
<p>The <em>spherical</em> dihedral style uses the potential:</p>
<img alt="_images/dihedral_spherical_angles.jpg" class="align-center" src="_images/dihedral_spherical_angles.jpg" />
<img alt="_images/dihedral_spherical.jpg" class="align-center" src="_images/dihedral_spherical.jpg" />
<p>For this dihedral style, the energy can be any function that combines the
4-body dihedral-angle (phi) and the two 3-body bond-angles (theta1, theta2).
For this reason, there is usually no need to define 3-body &#8220;angle&#8221; forces
separately for the atoms participating in these interactions.
It is probably more efficient to incorporate 3-body angle forces into
the dihedral interaction even if it requires adding additional terms to
the expansion (as was done in the second example). A careful choice of
parameters can prevent singularities that occur with traditional
force-fields whenever theta1 or theta2 approach 0 or 180 degrees.
The last example above corresponds to an interaction with a single energy
minima located at phi=114, theta1=158, theta2=167.3 degrees, and it remains
numerically stable at all angles (phi, theta1, theta2). In this example,
the coefficients 17.3, and 15.1 can be physically interpreted as the
harmonic spring constants for theta1 and theta2 around their minima.
The coefficient 286.1 is the harmonic spring constant for phi after
division by sin(158)*sin(167.3) (the minima positions for theta1 and theta2).</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 Dihedral Coeffs section of a data file file read by the
<a class="reference internal" href="read_data.html"><span class="doc">read_data</span></a> command:</p>
<ul class="simple">
<li>n (integer &gt;= 1)</li>
<li>C1 (energy)</li>
<li>K1 (typically an integer)</li>
<li>a1 (degrees)</li>
<li>u1 (typically 0.0 or 1.0)</li>
<li>L1 (typically an integer)</li>
<li>b1 (degrees, typically 0.0 or 90.0)</li>
<li>v1 (typically 0.0 or 1.0)</li>
<li>M1 (typically an integer)</li>
<li>c1 (degrees, typically 0.0 or 90.0)</li>
<li>w1 (typically 0.0 or 1.0)</li>
<li>[...]</li>
<li>Cn (energy)</li>
<li>Kn (typically an integer)</li>
<li>an (degrees)</li>
<li>un (typically 0.0 or 1.0)</li>
<li>Ln (typically an integer)</li>
<li>bn (degrees, typically 0.0 or 90.0)</li>
<li>vn (typically 0.0 or 1.0)</li>
<li>Mn (typically an integer)</li>
<li>cn (degrees, typically 0.0 or 90.0)</li>
<li>wn (typically 0.0 or 1.0)</li>
</ul>
</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
USER_MISC package. 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>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="dihedral_table.html" class="btn btn-neutral float-right" title="dihedral_style table command" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="dihedral_quadratic.html" class="btn btn-neutral" title="dihedral_style quadratic command" 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>