git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@13798 f3b2605a-c512-4ea7-a41b-209d697bcdaa
This commit is contained in:
869
doc/Manual.html
869
doc/Manual.html
@ -1,441 +1,478 @@
|
|||||||
|
<HTML>
|
||||||
|
<!-- HTML_ONLY -->
|
||||||
|
<HEAD>
|
||||||
|
<TITLE>LAMMPS Users Manual</TITLE>
|
||||||
|
<META NAME="docnumber" CONTENT="27 Jul 2015 version">
|
||||||
|
<META NAME="author" CONTENT="http://lammps.sandia.gov - Sandia National Laboratories">
|
||||||
|
<META NAME="copyright" CONTENT="Copyright (2003) Sandia Corporation. This software and manual is distributed under the GNU General Public License.">
|
||||||
|
</HEAD>
|
||||||
|
|
||||||
|
<BODY>
|
||||||
|
|
||||||
|
<!-- END_HTML_ONLY -->
|
||||||
|
|
||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>LAMMPS Documentation — 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"/>
|
|
||||||
<link rel="next" title="1. Introduction" href="Section_intro.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="#" 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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="#">LAMMPS</a>
|
|
||||||
</nav>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<div class="wy-nav-content">
|
|
||||||
<div class="rst-content">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H1></H1>
|
||||||
<li><a href="#">Docs</a> »</li>
|
|
||||||
|
<CENTER><H3>LAMMPS Documentation
|
||||||
<li>LAMMPS Documentation</li>
|
</H3></CENTER>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<CENTER><H4>27 Jul 2015 version
|
||||||
|
</H4></CENTER>
|
||||||
|
<H4>Version info:
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</H4>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P>The LAMMPS "version" is the date when it was released, such as 1 May
|
||||||
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div class="rst-footer-buttons" style="margin-bottom: 1em" role="navigation" aria-label="footer navigation">
|
|
||||||
|
|
||||||
<a href="Section_intro.html" class="btn btn-neutral float-right" title="1. Introduction" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<H1></H1><div class="section" id="lammps-documentation">
|
|
||||||
<h1>LAMMPS Documentation<a class="headerlink" href="#lammps-documentation" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<div class="section" id="jul-2015-version">
|
|
||||||
<h2>27 Jul 2015 version<a class="headerlink" href="#jul-2015-version" title="Permalink to this headline">¶</a></h2>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="version-info">
|
|
||||||
<h2>Version info:<a class="headerlink" href="#version-info" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The LAMMPS “version” is the date when it was released, such as 1 May
|
|
||||||
2010. LAMMPS is updated continuously. Whenever we fix a bug or add a
|
2010. LAMMPS is updated continuously. Whenever we fix a bug or add a
|
||||||
feature, we release it immediately, and post a notice on <a class="reference external" href="http://lammps.sandia.gov/bug.html">this page of the WWW site</a>. Each dated copy of LAMMPS contains all the
|
feature, we release it immediately, and post a notice on <A HREF = "http://lammps.sandia.gov/bug.html">this page of
|
||||||
|
the WWW site</A>. Each dated copy of LAMMPS contains all the
|
||||||
features and bug-fixes up to and including that version date. The
|
features and bug-fixes up to and including that version date. The
|
||||||
version date is printed to the screen and logfile every time you run
|
version date is printed to the screen and logfile every time you run
|
||||||
LAMMPS. It is also in the file src/version.h and in the LAMMPS
|
LAMMPS. It is also in the file src/version.h and in the LAMMPS
|
||||||
directory name created when you unpack a tarball, and at the top of
|
directory name created when you unpack a tarball, and at the top of
|
||||||
the first page of the manual (this page).</p>
|
the first page of the manual (this page).
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>If you browse the HTML doc pages on the LAMMPS WWW site, they always
|
<UL><LI>If you browse the HTML doc pages on the LAMMPS WWW site, they always
|
||||||
describe the most current version of LAMMPS.</li>
|
describe the most current version of LAMMPS.
|
||||||
<li>If you browse the HTML doc pages included in your tarball, they
|
|
||||||
describe the version you have.</li>
|
<LI>If you browse the HTML doc pages included in your tarball, they
|
||||||
<li>The <a class="reference external" href="Manual.pdf">PDF file</a> on the WWW site or in the tarball is updated
|
describe the version you have.
|
||||||
about once per month. This is because it is large, and we don’t want
|
|
||||||
it to be part of every patch.</li>
|
<LI>The <A HREF = "Manual.pdf">PDF file</A> on the WWW site or in the tarball is updated
|
||||||
<li>There is also a <a class="reference external" href="Developer.pdf">Developer.pdf</a> file in the doc
|
about once per month. This is because it is large, and we don't want
|
||||||
|
it to be part of every patch.
|
||||||
|
|
||||||
|
<LI>There is also a <A HREF = "Developer.pdf">Developer.pdf</A> file in the doc
|
||||||
directory, which describes the internal structure and algorithms of
|
directory, which describes the internal structure and algorithms of
|
||||||
LAMMPS.</li>
|
LAMMPS.
|
||||||
</ul>
|
</UL>
|
||||||
<p>LAMMPS stands for Large-scale Atomic/Molecular Massively Parallel
|
<P>LAMMPS stands for Large-scale Atomic/Molecular Massively Parallel
|
||||||
Simulator.</p>
|
Simulator.
|
||||||
<p>LAMMPS is a classical molecular dynamics simulation code designed to
|
</P>
|
||||||
|
<P>LAMMPS is a classical molecular dynamics simulation code designed to
|
||||||
run efficiently on parallel computers. It was developed at Sandia
|
run efficiently on parallel computers. It was developed at Sandia
|
||||||
National Laboratories, a US Department of Energy facility, with
|
National Laboratories, a US Department of Energy facility, with
|
||||||
funding from the DOE. It is an open-source code, distributed freely
|
funding from the DOE. It is an open-source code, distributed freely
|
||||||
under the terms of the GNU Public License (GPL).</p>
|
under the terms of the GNU Public License (GPL).
|
||||||
<p>The primary developers of LAMMPS are <a class="reference external" href="http://www.sandia.gov/~sjplimp">Steve Plimpton</a>, Aidan
|
</P>
|
||||||
|
<P>The primary developers of LAMMPS are <A HREF = "http://www.sandia.gov/~sjplimp">Steve Plimpton</A>, Aidan
|
||||||
Thompson, and Paul Crozier who can be contacted at
|
Thompson, and Paul Crozier who can be contacted at
|
||||||
sjplimp,athomps,pscrozi at sandia.gov. The <a class="reference external" href="http://lammps.sandia.gov">LAMMPS WWW Site</a> at
|
sjplimp,athomps,pscrozi at sandia.gov. The <A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> at
|
||||||
<a class="reference external" href="http://lammps.sandia.gov">http://lammps.sandia.gov</a> has more information about the code and its
|
http://lammps.sandia.gov has more information about the code and its
|
||||||
uses.</p>
|
uses.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The LAMMPS documentation is organized into the following sections. If
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>The LAMMPS documentation is organized into the following sections. If
|
||||||
you find errors or omissions in this manual or have suggestions for
|
you find errors or omissions in this manual or have suggestions for
|
||||||
useful information to add, please send an email to the developers so
|
useful information to add, please send an email to the developers so
|
||||||
we can improve the LAMMPS documentation.</p>
|
we can improve the LAMMPS documentation.
|
||||||
<p>Once you are familiar with LAMMPS, you may want to bookmark <a class="reference internal" href="Section_commands.html#comm"><span>this page</span></a> at Section_commands.html#comm since
|
</P>
|
||||||
it gives quick access to documentation for all LAMMPS commands.</p>
|
<P>Once you are familiar with LAMMPS, you may want to bookmark <A HREF = "Section_commands.html#comm">this
|
||||||
<p><a class="reference external" href="Manual.pdf">PDF file</a> of the entire manual, generated by
|
page</A> at Section_commands.html#comm since
|
||||||
<a class="reference external" href="http://freecode.com/projects/htmldoc">htmldoc</a></p>
|
it gives quick access to documentation for all LAMMPS commands.
|
||||||
<div class="toctree-wrapper compound">
|
</P>
|
||||||
<ul>
|
<P><A HREF = "Manual.pdf">PDF file</A> of the entire manual, generated by
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_intro.html">1. Introduction</a><ul>
|
<A HREF = "http://freecode.com/projects/htmldoc">htmldoc</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_intro.html#what-is-lammps">1.1. What is LAMMPS</a></li>
|
</P>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_intro.html#lammps-features">1.2. LAMMPS features</a></li>
|
<P><!-- RST
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_intro.html#lammps-non-features">1.3. LAMMPS non-features</a></li>
|
</P>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_intro.html#open-source-distribution">1.4. Open source distribution</a></li>
|
<P>.. toctree::
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_intro.html#acknowledgments-and-citations">1.5. Acknowledgments and citations</a></li>
|
:maxdepth: 2
|
||||||
</ul>
|
:numbered: // comment
|
||||||
</li>
|
</P>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_start.html">2. Getting Started</a><ul>
|
<P> Section_intro
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#what-s-in-the-lammps-distribution">2.1. What’s in the LAMMPS distribution</a></li>
|
Section_start
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#making-lammps">2.2. Making LAMMPS</a></li>
|
Section_commands
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#making-lammps-with-optional-packages">2.3. Making LAMMPS with optional packages</a></li>
|
Section_packages
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#building-lammps-via-the-make-py-script">2.4. Building LAMMPS via the Make.py script</a></li>
|
Section_accelerate
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#building-lammps-as-a-library">2.5. Building LAMMPS as a library</a></li>
|
Section_howto
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#running-lammps">2.6. Running LAMMPS</a></li>
|
Section_example
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#command-line-options">2.7. Command-line options</a></li>
|
Section_perf
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#lammps-screen-output">2.8. LAMMPS screen output</a></li>
|
Section_tools
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_start.html#tips-for-users-of-previous-lammps-versions">2.9. Tips for users of previous LAMMPS versions</a></li>
|
Section_modify
|
||||||
</ul>
|
Section_python
|
||||||
</li>
|
Section_errors
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_commands.html">3. Commands</a><ul>
|
Section_history
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#lammps-input-script">3.1. LAMMPS input script</a></li>
|
</P>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#parsing-rules">3.2. Parsing rules</a></li>
|
<P>Indices and tables
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#input-script-structure">3.3. Input script structure</a></li>
|
==================
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#commands-listed-by-category">3.4. Commands listed by category</a></li>
|
</P>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#individual-commands">3.5. Individual commands</a></li>
|
<P>* :ref:`genindex` // comment
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#fix-styles">3.6. Fix styles</a></li>
|
* :ref:`search` // comment
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#compute-styles">3.7. Compute styles</a></li>
|
</P>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#pair-style-potentials">3.8. Pair_style potentials</a></li>
|
<P>END_RST -->
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#bond-style-potentials">3.9. Bond_style potentials</a></li>
|
</P>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#angle-style-potentials">3.10. Angle_style potentials</a></li>
|
<OL><LI><!-- HTML_ONLY -->
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#dihedral-style-potentials">3.11. Dihedral_style potentials</a></li>
|
<A HREF = "Section_intro.html">Introduction</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#improper-style-potentials">3.12. Improper_style potentials</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_commands.html#kspace-solvers">3.13. Kspace solvers</a></li>
|
<UL> 1.1 <A HREF = "Section_intro.html#intro_1">What is LAMMPS</A>
|
||||||
</ul>
|
<BR>
|
||||||
</li>
|
1.2 <A HREF = "Section_intro.html#intro_2">LAMMPS features</A>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_packages.html">4. Packages</a><ul>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#standard-packages">4.1. Standard packages</a></li>
|
1.3 <A HREF = "Section_intro.html#intro_3">LAMMPS non-features</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-packages">4.2. User packages</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-atc-package">4.3. USER-ATC package</a></li>
|
1.4 <A HREF = "Section_intro.html#intro_4">Open source distribution</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-awpmd-package">4.4. USER-AWPMD package</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-cg-cmm-package">4.5. USER-CG-CMM package</a></li>
|
1.5 <A HREF = "Section_intro.html#intro_5">Acknowledgments and citations</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-colvars-package">4.6. USER-COLVARS package</a></li>
|
<BR></UL>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-cuda-package">4.7. USER-CUDA package</a></li>
|
<LI><A HREF = "Section_start.html">Getting started</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-diffraction-package">4.8. USER-DIFFRACTION package</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-drude-package">4.9. USER-DRUDE package</a></li>
|
<UL> 2.1 <A HREF = "Section_start.html#start_1">What's in the LAMMPS distribution</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-eff-package">4.10. USER-EFF package</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-fep-package">4.11. USER-FEP package</a></li>
|
2.2 <A HREF = "Section_start.html#start_2">Making LAMMPS</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-intel-package">4.12. USER-INTEL package</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-lb-package">4.13. USER-LB package</a></li>
|
2.3 <A HREF = "Section_start.html#start_3">Making LAMMPS with optional packages</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-misc-package">4.14. USER-MISC package</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-molfile-package">4.15. USER-MOLFILE package</a></li>
|
2.4 <A HREF = "Section_start.html#start_4">Building LAMMPS via the Make.py script</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-omp-package">4.16. USER-OMP package</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-phonon-package">4.17. USER-PHONON package</a></li>
|
2.5 <A HREF = "Section_start.html#start_5">Building LAMMPS as a library</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-qmmm-package">4.18. USER-QMMM package</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-qtb-package">4.19. USER-QTB package</a></li>
|
2.6 <A HREF = "Section_start.html#start_6">Running LAMMPS</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-reaxc-package">4.20. USER-REAXC package</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_packages.html#user-sph-package">4.21. USER-SPH package</a></li>
|
2.7 <A HREF = "Section_start.html#start_7">Command-line options</A>
|
||||||
</ul>
|
<BR>
|
||||||
</li>
|
2.8 <A HREF = "Section_start.html#start_8">Screen output</A>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_accelerate.html">5. Accelerating LAMMPS performance</a><ul>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_accelerate.html#measuring-performance">5.1. Measuring performance</a></li>
|
2.9 <A HREF = "Section_start.html#start_9">Tips for users of previous versions</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_accelerate.html#general-strategies">5.2. General strategies</a></li>
|
<BR></UL>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_accelerate.html#packages-with-optimized-styles">5.3. Packages with optimized styles</a></li>
|
<LI><A HREF = "Section_commands.html">Commands</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_accelerate.html#comparison-of-various-accelerator-packages">5.4. Comparison of various accelerator packages</a></li>
|
|
||||||
</ul>
|
<UL> 3.1 <A HREF = "Section_commands.html#cmd_1">LAMMPS input script</A>
|
||||||
</li>
|
<BR>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_howto.html">6. How-to discussions</a><ul>
|
3.2 <A HREF = "Section_commands.html#cmd_2">Parsing rules</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#restarting-a-simulation">6.1. Restarting a simulation</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#d-simulations">6.2. 2d simulations</a></li>
|
3.3 <A HREF = "Section_commands.html#cmd_3">Input script structure</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#charmm-amber-and-dreiding-force-fields">6.3. CHARMM, AMBER, and DREIDING force fields</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#running-multiple-simulations-from-one-input-script">6.4. Running multiple simulations from one input script</a></li>
|
3.4 <A HREF = "Section_commands.html#cmd_4">Commands listed by category</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#multi-replica-simulations">6.5. Multi-replica simulations</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#granular-models">6.6. Granular models</a></li>
|
3.5 <A HREF = "Section_commands.html#cmd_5">Commands listed alphabetically</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#tip3p-water-model">6.7. TIP3P water model</a></li>
|
<BR></UL>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#tip4p-water-model">6.8. TIP4P water model</a></li>
|
<LI><A HREF = "Section_packages.html">Packages</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#spc-water-model">6.9. SPC water model</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#coupling-lammps-to-other-codes">6.10. Coupling LAMMPS to other codes</a></li>
|
<UL> 4.1 <A HREF = "Section_packages.html#pkg_1">Standard packages</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#visualizing-lammps-snapshots">6.11. Visualizing LAMMPS snapshots</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#triclinic-non-orthogonal-simulation-boxes">6.12. Triclinic (non-orthogonal) simulation boxes</a></li>
|
4.2 <A HREF = "Section_packages.html#pkg_2">User packages</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#nemd-simulations">6.13. NEMD simulations</a></li>
|
<BR></UL>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#finite-size-spherical-and-aspherical-particles">6.14. Finite-size spherical and aspherical particles</a></li>
|
<LI><A HREF = "Section_accelerate.html">Accelerating LAMMPS performance</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#output-from-lammps-thermo-dumps-computes-fixes-variables">6.15. Output from LAMMPS (thermo, dumps, computes, fixes, variables)</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#thermostatting-barostatting-and-computing-temperature">6.16. Thermostatting, barostatting, and computing temperature</a></li>
|
<UL> 5.1 <A HREF = "Section_accelerate.html#acc_1">Measuring performance</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#walls">6.17. Walls</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#elastic-constants">6.18. Elastic constants</a></li>
|
5.2 <A HREF = "Section_accelerate.html#acc_2">Algorithms and code options to boost performace</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#library-interface-to-lammps">6.19. Library interface to LAMMPS</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#calculating-thermal-conductivity">6.20. Calculating thermal conductivity</a></li>
|
5.3 <A HREF = "Section_accelerate.html#acc_3">Accelerator packages with optimized styles</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#calculating-viscosity">6.21. Calculating viscosity</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#calculating-a-diffusion-coefficient">6.22. Calculating a diffusion coefficient</a></li>
|
<UL> 5.3.1 <A HREF = "accelerate_cuda.html">USER-CUDA package</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#using-chunks-to-calculate-system-properties">6.23. Using chunks to calculate system properties</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#setting-parameters-for-the-kspace-style-pppm-disp-command">6.24. Setting parameters for the <code class="docutils literal"><span class="pre">kspace_style</span> <span class="pre">pppm/disp</span></code> command</a></li>
|
5.3.2 <A HREF = "accelerate_gpu.html">GPU package</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#polarizable-models">6.25. Polarizable models</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#adiabatic-core-shell-model">6.26. Adiabatic core/shell model</a></li>
|
5.3.3 <A HREF = "accelerate_intel.html">USER-INTEL package</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_howto.html#drude-induced-dipoles">6.27. Drude induced dipoles</a></li>
|
<BR>
|
||||||
</ul>
|
5.3.4 <A HREF = "accelerate_kokkos.html">KOKKOS package</A>
|
||||||
</li>
|
<BR>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_example.html">7. Example problems</a></li>
|
5.3.5 <A HREF = "accelerate_omp.html">USER-OMP package</A>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_perf.html">8. Performance & scalability</a></li>
|
<BR>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_tools.html">9. Additional tools</a><ul>
|
5.3.6 <A HREF = "accelerate_opt.html">OPT package</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#amber2lmp-tool">9.1. amber2lmp tool</a></li>
|
<BR></UL>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#binary2txt-tool">9.2. binary2txt tool</a></li>
|
5.4 <A HREF = "Section_accelerate.html#acc_4">Comparison of various accelerator packages</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#ch2lmp-tool">9.3. ch2lmp tool</a></li>
|
<BR></UL>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#chain-tool">9.4. chain tool</a></li>
|
<LI><A HREF = "Section_howto.html">How-to discussions</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#colvars-tools">9.5. colvars tools</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#createatoms-tool">9.6. createatoms tool</a></li>
|
<UL> 6.1 <A HREF = "Section_howto.html#howto_1">Restarting a simulation</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#data2xmovie-tool">9.7. data2xmovie tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#eam-database-tool">9.8. eam database tool</a></li>
|
6.2 <A HREF = "Section_howto.html#howto_2">2d simulations</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#eam-generate-tool">9.9. eam generate tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#eff-tool">9.10. eff tool</a></li>
|
6.3 <A HREF = "Section_howto.html#howto_3">CHARMM and AMBER force fields</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#emacs-tool">9.11. emacs tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#fep-tool">9.12. fep tool</a></li>
|
6.4 <A HREF = "Section_howto.html#howto_4">Running multiple simulations from one input script</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#i-pi-tool">9.13. i-pi tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#ipp-tool">9.14. ipp tool</a></li>
|
6.5 <A HREF = "Section_howto.html#howto_5">Multi-replica simulations</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#kate-tool">9.15. kate tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#lmp2arc-tool">9.16. lmp2arc tool</a></li>
|
6.6 <A HREF = "Section_howto.html#howto_6">Granular models</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#lmp2cfg-tool">9.17. lmp2cfg tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#lmp2vmd-tool">9.18. lmp2vmd tool</a></li>
|
6.7 <A HREF = "Section_howto.html#howto_7">TIP3P water model</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#matlab-tool">9.19. matlab tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#micelle2d-tool">9.20. micelle2d tool</a></li>
|
6.8 <A HREF = "Section_howto.html#howto_8">TIP4P water model</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#moltemplate-tool">9.21. moltemplate tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#msi2lmp-tool">9.22. msi2lmp tool</a></li>
|
6.9 <A HREF = "Section_howto.html#howto_9">SPC water model</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#phonon-tool">9.23. phonon tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#polymer-bonding-tool">9.24. polymer bonding tool</a></li>
|
6.10 <A HREF = "Section_howto.html#howto_10">Coupling LAMMPS to other codes</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#pymol-asphere-tool">9.25. pymol_asphere tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#python-tool">9.26. python tool</a></li>
|
6.11 <A HREF = "Section_howto.html#howto_11">Visualizing LAMMPS snapshots</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#reax-tool">9.27. reax tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#restart2data-tool">9.28. restart2data tool</a></li>
|
6.12 <A HREF = "Section_howto.html#howto_12">Triclinic (non-orthogonal) simulation boxes</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#vim-tool">9.29. vim tool</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#xmgrace-tool">9.30. xmgrace tool</a></li>
|
6.13 <A HREF = "Section_howto.html#howto_13">NEMD simulations</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_tools.html#xmovie-tool">9.31. xmovie tool</a></li>
|
<BR>
|
||||||
</ul>
|
6.14 <A HREF = "Section_howto.html#howto_14">Finite-size spherical and aspherical particles</A>
|
||||||
</li>
|
<BR>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_modify.html">10. Modifying & extending LAMMPS</a><ul>
|
6.15 <A HREF = "Section_howto.html#howto_15">Output from LAMMPS (thermo, dumps, computes, fixes, variables)</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#atom-styles">10.1. Atom styles</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#bond-angle-dihedral-improper-potentials">10.2. Bond, angle, dihedral, improper potentials</a></li>
|
6.16 <A HREF = "Section_howto.html#howto_16">Thermostatting, barostatting, and compute temperature</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#compute-styles">10.3. Compute styles</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#dump-styles">10.4. Dump styles</a></li>
|
6.17 <A HREF = "Section_howto.html#howto_17">Walls</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#dump-custom-output-options">10.5. Dump custom output options</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#fix-styles">10.6. Fix styles</a></li>
|
6.18 <A HREF = "Section_howto.html#howto_18">Elastic constants</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#input-script-commands">10.7. Input script commands</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#kspace-computations">10.8. Kspace computations</a></li>
|
6.19 <A HREF = "Section_howto.html#howto_19">Library interface to LAMMPS</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#minimization-styles">10.9. Minimization styles</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#pairwise-potentials">10.10. Pairwise potentials</a></li>
|
6.20 <A HREF = "Section_howto.html#howto_20">Calculating thermal conductivity</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#region-styles">10.11. Region styles</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#body-styles">10.12. Body styles</a></li>
|
6.21 <A HREF = "Section_howto.html#howto_21">Calculating viscosity</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#thermodynamic-output-options">10.13. Thermodynamic output options</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#variable-options">10.14. Variable options</a></li>
|
6.22 <A HREF = "Section_howto.html#howto_22">Calculating a diffusion coefficient</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_modify.html#submitting-new-features-for-inclusion-in-lammps">10.15. Submitting new features for inclusion in LAMMPS</a></li>
|
<BR>
|
||||||
</ul>
|
6.23 <A HREF = "Section_howto.html#howto_23">Using chunks to calculate system properties</A>
|
||||||
</li>
|
<BR>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_python.html">11. Python interface to LAMMPS</a><ul>
|
6.24 <A HREF = "Section_howto.html#howto_24">Setting parameters for pppm/disp</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#overview-of-running-lammps-from-python">11.1. Overview of running LAMMPS from Python</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#overview-of-using-python-from-a-lammps-script">11.2. Overview of using Python from a LAMMPS script</a></li>
|
6.25 <A HREF = "Section_howto.html#howto_25">Polarizable models</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#building-lammps-as-a-shared-library">11.3. Building LAMMPS as a shared library</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#installing-the-python-wrapper-into-python">11.4. Installing the Python wrapper into Python</a></li>
|
6.26 <A HREF = "Section_howto.html#howto_26">Adiabatic core/shell model</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#extending-python-with-mpi-to-run-in-parallel">11.5. Extending Python with MPI to run in parallel</a></li>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#testing-the-python-lammps-interface">11.6. Testing the Python-LAMMPS interface</a></li>
|
6.27 <A HREF = "Section_howto.html#howto_27">Drude induced dipoles</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#using-lammps-from-python">11.7. Using LAMMPS from Python</a></li>
|
<BR></UL>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_python.html#example-python-scripts-that-use-lammps">11.8. Example Python scripts that use LAMMPS</a></li>
|
<LI><A HREF = "Section_example.html">Example problems</A>
|
||||||
</ul>
|
|
||||||
</li>
|
<LI><A HREF = "Section_perf.html">Performance & scalability</A>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_errors.html">12. Errors</a><ul>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_errors.html#common-problems">12.1. Common problems</a></li>
|
<LI><A HREF = "Section_tools.html">Additional tools</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_errors.html#reporting-bugs">12.2. Reporting bugs</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_errors.html#error-warning-messages">12.3. Error & warning messages</a></li>
|
<LI><A HREF = "Section_modify.html">Modifying & extending LAMMPS</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_errors.html#error">12.4. Errors:</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_errors.html#warnings">12.5. Warnings:</a></li>
|
<UL> 10.1 <A HREF = "Section_modify.html#mod_1">Atom styles</A>
|
||||||
</ul>
|
<BR>
|
||||||
</li>
|
10.2 <A HREF = "Section_modify.html#mod_2">Bond, angle, dihedral, improper potentials</A>
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_history.html">13. Future and history</a><ul>
|
<BR>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_history.html#coming-attractions">13.1. Coming attractions</a></li>
|
10.3 <A HREF = "Section_modify.html#mod_3">Compute styles</A>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="Section_history.html#past-versions">13.2. Past versions</a></li>
|
<BR>
|
||||||
</ul>
|
10.4 <A HREF = "Section_modify.html#mod_4">Dump styles</A>
|
||||||
</li>
|
<BR>
|
||||||
</ul>
|
10.5 <A HREF = "Section_modify.html#mod_5">Dump custom output options</A>
|
||||||
</div>
|
<BR>
|
||||||
</div>
|
10.6 <A HREF = "Section_modify.html#mod_6">Fix styles</A>
|
||||||
</div>
|
<BR>
|
||||||
<div class="section" id="indices-and-tables">
|
10.7 <A HREF = "Section_modify.html#mod_7">Input script commands</A>
|
||||||
<h1>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1>
|
<BR>
|
||||||
<ul class="simple">
|
10.8 <A HREF = "Section_modify.html#mod_8">Kspace computations</A>
|
||||||
<li><a class="reference internal" href="genindex.html"><span>Index</span></a></li>
|
<BR>
|
||||||
<li><a class="reference internal" href="search.html"><span>Search Page</span></a></li>
|
10.9 <A HREF = "Section_modify.html#mod_9">Minimization styles</A>
|
||||||
</ul>
|
<BR>
|
||||||
</BODY></div>
|
10.10 <A HREF = "Section_modify.html#mod_10">Pairwise potentials</A>
|
||||||
|
<BR>
|
||||||
|
10.11 <A HREF = "Section_modify.html#mod_11">Region styles</A>
|
||||||
|
<BR>
|
||||||
|
10.12 <A HREF = "Section_modify.html#mod_12">Body styles</A>
|
||||||
|
<BR>
|
||||||
|
10.13 <A HREF = "Section_modify.html#mod_13">Thermodynamic output options</A>
|
||||||
|
<BR>
|
||||||
|
10.14 <A HREF = "Section_modify.html#mod_14">Variable options</A>
|
||||||
|
<BR>
|
||||||
|
10.15 <A HREF = "Section_modify.html#mod_15">Submitting new features for inclusion in LAMMPS</A>
|
||||||
|
<BR></UL>
|
||||||
|
<LI><A HREF = "Section_python.html">Python interface</A>
|
||||||
|
|
||||||
|
<UL> 11.1 <A HREF = "Section_python.html#py_1">Overview of running LAMMPS from Python</A>
|
||||||
|
<BR>
|
||||||
|
11.2 <A HREF = "Section_python.html#py_2">Overview of using Python from a LAMMPS script</A>
|
||||||
|
<BR>
|
||||||
|
11.3 <A HREF = "Section_python.html#py_3">Building LAMMPS as a shared library</A>
|
||||||
|
<BR>
|
||||||
|
11.4 <A HREF = "Section_python.html#py_4">Installing the Python wrapper into Python</A>
|
||||||
|
<BR>
|
||||||
|
11.5 <A HREF = "Section_python.html#py_5">Extending Python with MPI to run in parallel</A>
|
||||||
|
<BR>
|
||||||
|
11.6 <A HREF = "Section_python.html#py_6">Testing the Python-LAMMPS interface</A>
|
||||||
|
<BR>
|
||||||
|
11.7 <A HREF = "py_7">Using LAMMPS from Python</A>
|
||||||
|
<BR>
|
||||||
|
11.8 <A HREF = "py_8">Example Python scripts that use LAMMPS</A>
|
||||||
|
<BR></UL>
|
||||||
|
<LI><A HREF = "Section_errors.html">Errors</A>
|
||||||
|
|
||||||
|
<UL> 12.1 <A HREF = "Section_errors.html#err_1">Common problems</A>
|
||||||
|
<BR>
|
||||||
|
12.2 <A HREF = "Section_errors.html#err_2">Reporting bugs</A>
|
||||||
|
<BR>
|
||||||
|
12.3 <A HREF = "Section_errors.html#err_3">Error & warning messages</A>
|
||||||
|
<BR></UL>
|
||||||
|
<LI><A HREF = "Section_history.html">Future and history</A>
|
||||||
|
|
||||||
|
<UL> 13.1 <A HREF = "Section_history.html#hist_1">Coming attractions</A>
|
||||||
|
<BR>
|
||||||
|
13.2 <A HREF = "Section_history.html#hist_2">Past versions</A>
|
||||||
|
<BR></UL>
|
||||||
|
|
||||||
|
</OL>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
||||||
|
|
||||||
<a href="Section_intro.html" class="btn btn-neutral float-right" title="1. Introduction" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- END_HTML_ONLY -->
|
||||||
|
|
||||||
|
</BODY>
|
||||||
|
|
||||||
|
</HTML>
|
||||||
|
|||||||
@ -85,7 +85,7 @@ it gives quick access to documentation for all LAMMPS commands.
|
|||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 2
|
:maxdepth: 2
|
||||||
:numbered:
|
:numbered: // comment
|
||||||
|
|
||||||
Section_intro
|
Section_intro
|
||||||
Section_start
|
Section_start
|
||||||
@ -105,8 +105,8 @@ it gives quick access to documentation for all LAMMPS commands.
|
|||||||
Indices and tables
|
Indices and tables
|
||||||
==================
|
==================
|
||||||
|
|
||||||
* :ref:`genindex`
|
* :ref:`genindex` // comment
|
||||||
* :ref:`search`
|
* :ref:`search` // comment
|
||||||
|
|
||||||
END_RST -->
|
END_RST -->
|
||||||
|
|
||||||
|
|||||||
@ -1,197 +1,84 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_packages.html">Previous Section</A> - <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> - <A HREF = "Section_howto.html">Next
|
||||||
|
Section</A>
|
||||||
|
</CENTER>
|
||||||
|
|
||||||
|
|
||||||
<!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>5. Accelerating LAMMPS performance — 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"/>
|
|
||||||
<link rel="next" title="6. How-to discussions" href="Section_howto.html"/>
|
|
||||||
<link rel="prev" title="4. Packages" href="Section_packages.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 class="current">
|
|
||||||
<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 current"><a class="current reference internal" href="">5. Accelerating LAMMPS performance</a><ul>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="#measuring-performance">5.1. Measuring performance</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="#general-strategies">5.2. General strategies</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="#packages-with-optimized-styles">5.3. Packages with optimized styles</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="#comparison-of-various-accelerator-packages">5.4. Comparison of various accelerator packages</a><ul>
|
|
||||||
<li class="toctree-l3"><a class="reference internal" href="#examples">5.4.1. Examples</a></li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
</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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>5. Accelerating LAMMPS performance
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P>This section describes various methods for improving LAMMPS
|
||||||
<li>5. Accelerating LAMMPS performance</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="Section_howto.html" class="btn btn-neutral float-right" title="6. How-to discussions" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
<a href="Section_packages.html" class="btn btn-neutral" title="4. Packages" 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="accelerating-lammps-performance">
|
|
||||||
<h1>5. Accelerating LAMMPS performance<a class="headerlink" href="#accelerating-lammps-performance" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>This section describes various methods for improving LAMMPS
|
|
||||||
performance for different classes of problems running on different
|
performance for different classes of problems running on different
|
||||||
kinds of machines.</p>
|
kinds of machines.
|
||||||
<p>There are two thrusts to the discussion that follows. The
|
</P>
|
||||||
|
<P>There are two thrusts to the discussion that follows. The
|
||||||
first is using code options that implement alternate algorithms
|
first is using code options that implement alternate algorithms
|
||||||
that can speed-up a simulation. The second is to use one
|
that can speed-up a simulation. The second is to use one
|
||||||
of the several accelerator packages provided with LAMMPS that
|
of the several accelerator packages provided with LAMMPS that
|
||||||
contain code optimized for certain kinds of hardware, including
|
contain code optimized for certain kinds of hardware, including
|
||||||
multi-core CPUs, GPUs, and Intel Xeon Phi coprocessors.</p>
|
multi-core CPUs, GPUs, and Intel Xeon Phi coprocessors.
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>5.1 <a class="reference internal" href="#acc-1"><span>Measuring performance</span></a></li>
|
<UL><LI>5.1 <A HREF = "#acc_1">Measuring performance</A>
|
||||||
<li>5.2 <a class="reference internal" href="#acc-2"><span>Algorithms and code options to boost performace</span></a></li>
|
|
||||||
<li>5.3 <a class="reference internal" href="#acc-3"><span>Accelerator packages with optimized styles</span></a></li>
|
<LI>5.2 <A HREF = "#acc_2">Algorithms and code options to boost performace</A>
|
||||||
<li>5.3.1 <a class="reference internal" href="accelerate_cuda.html"><em>USER-CUDA package</em></a></li>
|
|
||||||
<li>5.3.2 <a class="reference internal" href="accelerate_gpu.html"><em>GPU package</em></a></li>
|
<LI>5.3 <A HREF = "#acc_3">Accelerator packages with optimized styles</A>
|
||||||
<li>5.3.3 <a class="reference internal" href="accelerate_intel.html"><em>USER-INTEL package</em></a></li>
|
|
||||||
<li>5.3.4 <a class="reference internal" href="accelerate_kokkos.html"><em>KOKKOS package</em></a></li>
|
<UL><LI> 5.3.1 <A HREF = "accelerate_cuda.html">USER-CUDA package</A>
|
||||||
<li>5.3.5 <a class="reference internal" href="accelerate_omp.html"><em>USER-OMP package</em></a></li>
|
|
||||||
<li>5.3.6 <a class="reference internal" href="accelerate_opt.html"><em>OPT package</em></a></li>
|
<LI> 5.3.2 <A HREF = "accelerate_gpu.html">GPU package</A>
|
||||||
<li>5.4 <a class="reference internal" href="#acc-4"><span>Comparison of various accelerator packages</span></a></li>
|
|
||||||
</ul>
|
<LI> 5.3.3 <A HREF = "accelerate_intel.html">USER-INTEL package</A>
|
||||||
<p>The <a class="reference external" href="http://lammps.sandia.gov/bench.html">Benchmark page</a> of the LAMMPS
|
|
||||||
|
<LI> 5.3.4 <A HREF = "accelerate_kokkos.html">KOKKOS package</A>
|
||||||
|
|
||||||
|
<LI> 5.3.5 <A HREF = "accelerate_omp.html">USER-OMP package</A>
|
||||||
|
|
||||||
|
<LI> 5.3.6 <A HREF = "accelerate_opt.html">OPT package</A>
|
||||||
|
</UL>
|
||||||
|
<LI>5.4 <A HREF = "#acc_4">Comparison of various accelerator packages</A>
|
||||||
|
</UL>
|
||||||
|
<P>The <A HREF = "http://lammps.sandia.gov/bench.html">Benchmark page</A> of the LAMMPS
|
||||||
web site gives performance results for the various accelerator
|
web site gives performance results for the various accelerator
|
||||||
packages discussed in Section 5.2, for several of the standard LAMMPS
|
packages discussed in Section 5.2, for several of the standard LAMMPS
|
||||||
benchmark problems, as a function of problem size and number of
|
benchmark problems, as a function of problem size and number of
|
||||||
compute nodes, on different hardware platforms.</p>
|
compute nodes, on different hardware platforms.
|
||||||
<div class="section" id="measuring-performance">
|
</P>
|
||||||
<span id="acc-1"></span><h2>5.1. Measuring performance<a class="headerlink" href="#measuring-performance" title="Permalink to this headline">¶</a></h2>
|
<HR>
|
||||||
<p>Before trying to make your simulation run faster, you should
|
|
||||||
understand how it currently performs and where the bottlenecks are.</p>
|
<HR>
|
||||||
<p>The best way to do this is run the your system (actual number of
|
|
||||||
|
<H4><A NAME = "acc_1"></A>5.1 Measuring performance
|
||||||
|
</H4>
|
||||||
|
<P>Before trying to make your simulation run faster, you should
|
||||||
|
understand how it currently performs and where the bottlenecks are.
|
||||||
|
</P>
|
||||||
|
<P>The best way to do this is run the your system (actual number of
|
||||||
atoms) for a modest number of timesteps (say 100 steps) on several
|
atoms) for a modest number of timesteps (say 100 steps) on several
|
||||||
different processor counts, including a single processor if possible.
|
different processor counts, including a single processor if possible.
|
||||||
Do this for an equilibrium version of your system, so that the
|
Do this for an equilibrium version of your system, so that the
|
||||||
100-step timings are representative of a much longer run. There is
|
100-step timings are representative of a much longer run. There is
|
||||||
typically no need to run for 1000s of timesteps to get accurate
|
typically no need to run for 1000s of timesteps to get accurate
|
||||||
timings; you can simply extrapolate from short runs.</p>
|
timings; you can simply extrapolate from short runs.
|
||||||
<p>For the set of runs, look at the timing data printed to the screen and
|
</P>
|
||||||
log file at the end of each LAMMPS run. <a class="reference internal" href="Section_start.html#start-8"><span>This section</span></a> of the manual has an overview.</p>
|
<P>For the set of runs, look at the timing data printed to the screen and
|
||||||
<p>Running on one (or a few processors) should give a good estimate of
|
log file at the end of each LAMMPS run. <A HREF = "Section_start.html#start_8">This
|
||||||
|
section</A> of the manual has an overview.
|
||||||
|
</P>
|
||||||
|
<P>Running on one (or a few processors) should give a good estimate of
|
||||||
the serial performance and what portions of the timestep are taking
|
the serial performance and what portions of the timestep are taking
|
||||||
the most time. Running the same problem on a few different processor
|
the most time. Running the same problem on a few different processor
|
||||||
counts should give an estimate of parallel scalability. I.e. if the
|
counts should give an estimate of parallel scalability. I.e. if the
|
||||||
simulation runs 16x faster on 16 processors, its 100% parallel
|
simulation runs 16x faster on 16 processors, its 100% parallel
|
||||||
efficient; if it runs 8x faster on 16 processors, it’s 50% efficient.</p>
|
efficient; if it runs 8x faster on 16 processors, it's 50% efficient.
|
||||||
<p>The most important data to look at in the timing info is the timing
|
</P>
|
||||||
|
<P>The most important data to look at in the timing info is the timing
|
||||||
breakdown and relative percentages. For example, trying different
|
breakdown and relative percentages. For example, trying different
|
||||||
options for speeding up the long-range solvers will have little impact
|
options for speeding up the long-range solvers will have little impact
|
||||||
if they only consume 10% of the run time. If the pairwise time is
|
if they only consume 10% of the run time. If the pairwise time is
|
||||||
@ -201,49 +88,50 @@ you increase the processor count gives you a sense of how different
|
|||||||
operations within the timestep are scaling. Note that if you are
|
operations within the timestep are scaling. Note that if you are
|
||||||
running with a Kspace solver, there is additional output on the
|
running with a Kspace solver, there is additional output on the
|
||||||
breakdown of the Kspace time. For PPPM, this includes the fraction
|
breakdown of the Kspace time. For PPPM, this includes the fraction
|
||||||
spent on FFTs, which can be communication intensive.</p>
|
spent on FFTs, which can be communication intensive.
|
||||||
<p>Another important detail in the timing info are the histograms of
|
</P>
|
||||||
|
<P>Another important detail in the timing info are the histograms of
|
||||||
atoms counts and neighbor counts. If these vary widely across
|
atoms counts and neighbor counts. If these vary widely across
|
||||||
processors, you have a load-imbalance issue. This often results in
|
processors, you have a load-imbalance issue. This often results in
|
||||||
inaccurate relative timing data, because processors have to wait when
|
inaccurate relative timing data, because processors have to wait when
|
||||||
communication occurs for other processors to catch up. Thus the
|
communication occurs for other processors to catch up. Thus the
|
||||||
reported times for “Communication” or “Other” may be higher than they
|
reported times for "Communication" or "Other" may be higher than they
|
||||||
really are, due to load-imbalance. If this is an issue, you can
|
really are, due to load-imbalance. If this is an issue, you can
|
||||||
uncomment the MPI_Barrier() lines in src/timer.cpp, and recompile
|
uncomment the MPI_Barrier() lines in src/timer.cpp, and recompile
|
||||||
LAMMPS, to obtain synchronized timings.</p>
|
LAMMPS, to obtain synchronized timings.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
</div>
|
<HR>
|
||||||
<div class="section" id="general-strategies">
|
|
||||||
<span id="acc-2"></span><h2>5.2. General strategies<a class="headerlink" href="#general-strategies" title="Permalink to this headline">¶</a></h2>
|
<H4><A NAME = "acc_2"></A>5.2 General strategies
|
||||||
<div class="admonition note">
|
</H4>
|
||||||
<p class="first admonition-title">Note</p>
|
<P>NOTE: this section 5.2 is still a work in progress
|
||||||
<p class="last">this section 5.2 is still a work in progress</p>
|
</P>
|
||||||
</div>
|
<P>Here is a list of general ideas for improving simulation performance.
|
||||||
<p>Here is a list of general ideas for improving simulation performance.
|
|
||||||
Most of them are only applicable to certain models and certain
|
Most of them are only applicable to certain models and certain
|
||||||
bottlenecks in the current performance, so let the timing data you
|
bottlenecks in the current performance, so let the timing data you
|
||||||
generate be your guide. It is hard, if not impossible, to predict how
|
generate be your guide. It is hard, if not impossible, to predict how
|
||||||
much difference these options will make, since it is a function of
|
much difference these options will make, since it is a function of
|
||||||
problem size, number of processors used, and your machine. There is
|
problem size, number of processors used, and your machine. There is
|
||||||
no substitute for identifying performance bottlenecks, and trying out
|
no substitute for identifying performance bottlenecks, and trying out
|
||||||
various options.</p>
|
various options.
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>rRESPA</li>
|
<UL><LI>rRESPA
|
||||||
<li>2-FFT PPPM</li>
|
<LI>2-FFT PPPM
|
||||||
<li>Staggered PPPM</li>
|
<LI>Staggered PPPM
|
||||||
<li>single vs double PPPM</li>
|
<LI>single vs double PPPM
|
||||||
<li>partial charge PPPM</li>
|
<LI>partial charge PPPM
|
||||||
<li>verlet/split run style</li>
|
<LI>verlet/split run style
|
||||||
<li>processor command for proc layout and numa layout</li>
|
<LI>processor command for proc layout and numa layout
|
||||||
<li>load-balancing: balance and fix balance</li>
|
<LI>load-balancing: balance and fix balance
|
||||||
</ul>
|
</UL>
|
||||||
<p>2-FFT PPPM, also called <em>analytic differentiation</em> or <em>ad</em> PPPM, uses
|
<P>2-FFT PPPM, also called <I>analytic differentiation</I> or <I>ad</I> PPPM, uses
|
||||||
2 FFTs instead of the 4 FFTs used by the default <em>ik differentiation</em>
|
2 FFTs instead of the 4 FFTs used by the default <I>ik differentiation</I>
|
||||||
PPPM. However, 2-FFT PPPM also requires a slightly larger mesh size to
|
PPPM. However, 2-FFT PPPM also requires a slightly larger mesh size to
|
||||||
achieve the same accuracy as 4-FFT PPPM. For problems where the FFT
|
achieve the same accuracy as 4-FFT PPPM. For problems where the FFT
|
||||||
cost is the performance bottleneck (typically large problems running
|
cost is the performance bottleneck (typically large problems running
|
||||||
on many processors), 2-FFT PPPM may be faster than 4-FFT PPPM.</p>
|
on many processors), 2-FFT PPPM may be faster than 4-FFT PPPM.
|
||||||
<p>Staggered PPPM performs calculations using two different meshes, one
|
</P>
|
||||||
|
<P>Staggered PPPM performs calculations using two different meshes, one
|
||||||
shifted slightly with respect to the other. This can reduce force
|
shifted slightly with respect to the other. This can reduce force
|
||||||
aliasing errors and increase the accuracy of the method, but also
|
aliasing errors and increase the accuracy of the method, but also
|
||||||
doubles the amount of work required. For high relative accuracy, using
|
doubles the amount of work required. For high relative accuracy, using
|
||||||
@ -255,233 +143,194 @@ time. For example, the rhodopsin benchmark was run on a single
|
|||||||
processor, and results for kspace time vs. relative accuracy for the
|
processor, and results for kspace time vs. relative accuracy for the
|
||||||
different methods are shown in the figure below. For this system,
|
different methods are shown in the figure below. For this system,
|
||||||
staggered PPPM (using ik differentiation) becomes useful when using a
|
staggered PPPM (using ik differentiation) becomes useful when using a
|
||||||
relative accuracy of slightly greater than 1e-5 and above.</p>
|
relative accuracy of slightly greater than 1e-5 and above.
|
||||||
<img alt="_images/rhodo_staggered.jpg" class="align-center" src="_images/rhodo_staggered.jpg" />
|
</P>
|
||||||
<div class="admonition warning">
|
<CENTER><IMG SRC = "JPG/rhodo_staggered.jpg">
|
||||||
<p class="first admonition-title">Warning</p>
|
</CENTER>
|
||||||
<p class="last">Using staggered PPPM may not give the same increase in
|
<P>IMPORTANT NOTE: Using staggered PPPM may not give the same increase in
|
||||||
accuracy of energy and pressure as it does in forces, so some caution
|
accuracy of energy and pressure as it does in forces, so some caution
|
||||||
must be used if energy and/or pressure are quantities of interest,
|
must be used if energy and/or pressure are quantities of interest,
|
||||||
such as when using a barostat.</p>
|
such as when using a barostat.
|
||||||
</div>
|
</P>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
</div>
|
|
||||||
<div class="section" id="packages-with-optimized-styles">
|
<H4><A NAME = "acc_3"></A>5.3 Packages with optimized styles
|
||||||
<span id="acc-3"></span><h2>5.3. Packages with optimized styles<a class="headerlink" href="#packages-with-optimized-styles" title="Permalink to this headline">¶</a></h2>
|
</H4>
|
||||||
<p>Accelerated versions of various <a class="reference internal" href="pair_style.html"><em>pair_style</em></a>,
|
<P>Accelerated versions of various <A HREF = "pair_style.html">pair_style</A>,
|
||||||
<a class="reference internal" href="fix.html"><em>fixes</em></a>, <a class="reference internal" href="compute.html"><em>computes</em></a>, and other commands have
|
<A HREF = "fix.html">fixes</A>, <A HREF = "compute.html">computes</A>, and other commands have
|
||||||
been added to LAMMPS, which will typically run faster than the
|
been added to LAMMPS, which will typically run faster than the
|
||||||
standard non-accelerated versions. Some require appropriate hardware
|
standard non-accelerated versions. Some require appropriate hardware
|
||||||
to be present on your system, e.g. GPUs or Intel Xeon Phi
|
to be present on your system, e.g. GPUs or Intel Xeon Phi
|
||||||
coprocessors.</p>
|
coprocessors.
|
||||||
<p>All of these commands are in packages provided with LAMMPS. An
|
</P>
|
||||||
overview of packages is give in <a class="reference internal" href="Section_packages.html"><em>Section packages</em></a>. These are the accelerator packages
|
<P>All of these commands are in packages provided with LAMMPS. An
|
||||||
currently in LAMMPS, either as standard or user packages:</p>
|
overview of packages is give in <A HREF = "Section_packages.html">Section
|
||||||
<table border="1" class="docutils">
|
packages</A>. These are the accelerator packages
|
||||||
<colgroup>
|
currently in LAMMPS, either as standard or user packages:
|
||||||
<col width="44%" />
|
</P>
|
||||||
<col width="56%" />
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
</colgroup>
|
<TR><TD ><A HREF = "accelerate_cuda.html">USER-CUDA</A> </TD><TD > for NVIDIA GPUs</TD></TR>
|
||||||
<tbody valign="top">
|
<TR><TD ><A HREF = "accelerate_gpu.html">GPU</A> </TD><TD > for NVIDIA GPUs as well as OpenCL support</TD></TR>
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="accelerate_cuda.html"><em>USER-CUDA</em></a></td>
|
<TR><TD ><A HREF = "accelerate_intel.html">USER-INTEL</A> </TD><TD > for Intel CPUs and Intel Xeon Phi</TD></TR>
|
||||||
<td>for NVIDIA GPUs</td>
|
<TR><TD ><A HREF = "accelerate_kokkos.html">KOKKOS</A> </TD><TD > for GPUs, Intel Xeon Phi, and OpenMP threading</TD></TR>
|
||||||
</tr>
|
<TR><TD ><A HREF = "accelerate_omp.html">USER-OMP</A> </TD><TD > for OpenMP threading</TD></TR>
|
||||||
<tr class="row-even"><td><a class="reference internal" href="accelerate_gpu.html"><em>GPU</em></a></td>
|
<TR><TD ><A HREF = "accelerate_opt.html">OPT</A> </TD><TD > generic CPU optimizations
|
||||||
<td>for NVIDIA GPUs as well as OpenCL support</td>
|
</TD></TR></TABLE></DIV>
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="accelerate_intel.html"><em>USER-INTEL</em></a></td>
|
<P>Any accelerated style has the same name as the corresponding standard
|
||||||
<td>for Intel CPUs and Intel Xeon Phi</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><a class="reference internal" href="accelerate_kokkos.html"><em>KOKKOS</em></a></td>
|
|
||||||
<td>for GPUs, Intel Xeon Phi, and OpenMP threading</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="accelerate_omp.html"><em>USER-OMP</em></a></td>
|
|
||||||
<td>for OpenMP threading</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><a class="reference internal" href="accelerate_opt.html"><em>OPT</em></a></td>
|
|
||||||
<td>generic CPU optimizations</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>Any accelerated style has the same name as the corresponding standard
|
|
||||||
style, except that a suffix is appended. Otherwise, the syntax for
|
style, except that a suffix is appended. Otherwise, the syntax for
|
||||||
the command that uses the style is identical, their functionality is
|
the command that uses the style is identical, their functionality is
|
||||||
the same, and the numerical results it produces should also be the
|
the same, and the numerical results it produces should also be the
|
||||||
same, except for precision and round-off effects.</p>
|
same, except for precision and round-off effects.
|
||||||
<p>For example, all of these styles are accelerated variants of the
|
</P>
|
||||||
Lennard-Jones <a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut</em></a>:</p>
|
<P>For example, all of these styles are accelerated variants of the
|
||||||
<ul class="simple">
|
Lennard-Jones <A HREF = "pair_lj.html">pair_style lj/cut</A>:
|
||||||
<li><a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut/cuda</em></a></li>
|
</P>
|
||||||
<li><a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut/gpu</em></a></li>
|
<UL><LI><A HREF = "pair_lj.html">pair_style lj/cut/cuda</A>
|
||||||
<li><a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut/intel</em></a></li>
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/gpu</A>
|
||||||
<li><a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut/kk</em></a></li>
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/intel</A>
|
||||||
<li><a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut/omp</em></a></li>
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/kk</A>
|
||||||
<li><a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut/opt</em></a></li>
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/omp</A>
|
||||||
</ul>
|
<LI><A HREF = "pair_lj.html">pair_style lj/cut/opt</A>
|
||||||
<p>To see what accelerate styles are currently available, see
|
</UL>
|
||||||
<a class="reference internal" href="Section_commands.html#cmd-5"><span>Section_commands 5</span></a> of the manual. The
|
<P>To see what accelerate styles are currently available, see
|
||||||
doc pages for individual commands (e.g. <a class="reference internal" href="pair_lj.html"><em>pair lj/cut</em></a> or
|
<A HREF = "Section_commands.html#cmd_5">Section_commands 5</A> of the manual. The
|
||||||
<a class="reference internal" href="fix_nve.html"><em>fix nve</em></a>) also list any accelerated variants available
|
doc pages for individual commands (e.g. <A HREF = "pair_lj.html">pair lj/cut</A> or
|
||||||
for that style.</p>
|
<A HREF = "fix_nve.html">fix nve</A>) also list any accelerated variants available
|
||||||
<p>To use an accelerator package in LAMMPS, and one or more of the styles
|
for that style.
|
||||||
|
</P>
|
||||||
|
<P>To use an accelerator package in LAMMPS, and one or more of the styles
|
||||||
it provides, follow these general steps. Details vary from package to
|
it provides, follow these general steps. Details vary from package to
|
||||||
package and are explained in the individual accelerator doc pages,
|
package and are explained in the individual accelerator doc pages,
|
||||||
listed above:</p>
|
listed above:
|
||||||
<table border="1" class="docutils">
|
</P>
|
||||||
<colgroup>
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
<col width="26%" />
|
<TR><TD >build the accelerator library </TD><TD > only for USER-CUDA and GPU packages </TD></TR>
|
||||||
<col width="74%" />
|
<TR><TD >install the accelerator package </TD><TD > make yes-opt, make yes-user-intel, etc </TD></TR>
|
||||||
</colgroup>
|
<TR><TD >add compile/link flags to Makefile.machine </TD><TD > in src/MAKE, <br> only for USER-INTEL, KOKKOS, USER-OMP packages </TD></TR>
|
||||||
<tbody valign="top">
|
<TR><TD >re-build LAMMPS </TD><TD > make machine </TD></TR>
|
||||||
<tr class="row-odd"><td>build the accelerator library</td>
|
<TR><TD >run a LAMMPS simulation </TD><TD > lmp_machine < in.script </TD></TR>
|
||||||
<td>only for USER-CUDA and GPU packages</td>
|
<TR><TD >enable the accelerator package </TD><TD > via "-c on" and "-k on" <A HREF = "Section_start.html#start_7">command-line switches</A>, <br> only for USER-CUDA and KOKKOS packages </TD></TR>
|
||||||
</tr>
|
<TR><TD >set any needed options for the package </TD><TD > via "-pk" <A HREF = "Section_start.html#start_7">command-line switch</A> or <A HREF = "package.html">package</A> command, <br> only if defaults need to be changed </TD></TR>
|
||||||
<tr class="row-even"><td>install the accelerator package</td>
|
<TR><TD >use accelerated styles in your input script </TD><TD > via "-sf" <A HREF = "Section_start.html#start_7">command-line switch</A> or <A HREF = "suffix.html">suffix</A> command
|
||||||
<td>make yes-opt, make yes-user-intel, etc</td>
|
</TD></TR></TABLE></DIV>
|
||||||
</tr>
|
|
||||||
</tbody>
|
<P>The first 4 steps can be done as a single command, using the
|
||||||
</table>
|
src/Make.py tool. The Make.py tool is discussed in <A HREF = "Section_start.html#start_4">Section
|
||||||
<div class="line-block">
|
2.4</A> of the manual, and its use is
|
||||||
<div class="line">install the accelerator package | make yes-opt, make yes-user-intel, etc |</div>
|
|
||||||
</div>
|
|
||||||
<blockquote>
|
|
||||||
<div>only for USER-INTEL, KOKKOS, USER-OMP packages |</div></blockquote>
|
|
||||||
<table border="1" class="docutils">
|
|
||||||
<colgroup>
|
|
||||||
<col width="26%" />
|
|
||||||
<col width="74%" />
|
|
||||||
</colgroup>
|
|
||||||
<tbody valign="top">
|
|
||||||
<tr class="row-odd"><td>re-build LAMMPS</td>
|
|
||||||
<td>make machine</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>run a LAMMPS simulation</td>
|
|
||||||
<td>lmp_machine < in.script</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<div class="line-block">
|
|
||||||
<div class="line">run a LAMMPS simulation | lmp_machine < in.script |</div>
|
|
||||||
</div>
|
|
||||||
<blockquote>
|
|
||||||
<div>only for USER-CUDA and KOKKOS packages |</div></blockquote>
|
|
||||||
<blockquote>
|
|
||||||
<div><a class="reference internal" href="package.html"><em>package</em></a> command, <br>
|
|
||||||
only if defaults need to be changed |</div></blockquote>
|
|
||||||
<blockquote>
|
|
||||||
<div><a class="reference internal" href="suffix.html"><em>suffix</em></a> command |</div></blockquote>
|
|
||||||
<table border="1" class="docutils">
|
|
||||||
<colgroup>
|
|
||||||
</colgroup>
|
|
||||||
<tbody valign="top">
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>The first 4 steps can be done as a single command, using the
|
|
||||||
src/Make.py tool. The Make.py tool is discussed in <a class="reference internal" href="Section_start.html#start-4"><span>Section 2.4</span></a> of the manual, and its use is
|
|
||||||
illustrated in the individual accelerator sections. Typically these
|
illustrated in the individual accelerator sections. Typically these
|
||||||
steps only need to be done once, to create an executable that uses one
|
steps only need to be done once, to create an executable that uses one
|
||||||
or more accelerator packages.</p>
|
or more accelerator packages.
|
||||||
<p>The last 4 steps can all be done from the command-line when LAMMPS is
|
</P>
|
||||||
|
<P>The last 4 steps can all be done from the command-line when LAMMPS is
|
||||||
launched, without changing your input script, as illustrated in the
|
launched, without changing your input script, as illustrated in the
|
||||||
individual accelerator sections. Or you can add
|
individual accelerator sections. Or you can add
|
||||||
<a class="reference internal" href="package.html"><em>package</em></a> and <a class="reference internal" href="suffix.html"><em>suffix</em></a> commands to your input
|
<A HREF = "package.html">package</A> and <A HREF = "suffix.html">suffix</A> commands to your input
|
||||||
script.</p>
|
script.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: With a few exceptions, you can build a single LAMMPS
|
||||||
<p class="last">With a few exceptions, you can build a single LAMMPS
|
|
||||||
executable with all its accelerator packages installed. Note that the
|
executable with all its accelerator packages installed. Note that the
|
||||||
USER-INTEL and KOKKOS packages require you to choose one of their
|
USER-INTEL and KOKKOS packages require you to choose one of their
|
||||||
options when building. I.e. CPU or Phi for USER-INTEL. OpenMP, Cuda,
|
options when building. I.e. CPU or Phi for USER-INTEL. OpenMP, Cuda,
|
||||||
or Phi for KOKKOS. Here are the exceptions; you cannot build a single
|
or Phi for KOKKOS. Here are the exceptions; you cannot build a single
|
||||||
executable with:</p>
|
executable with:
|
||||||
</div>
|
</P>
|
||||||
<ul class="simple">
|
<UL><LI>both the USER-INTEL Phi and KOKKOS Phi options
|
||||||
<li>both the USER-INTEL Phi and KOKKOS Phi options</li>
|
<LI>the USER-INTEL Phi or Kokkos Phi option, and either the USER-CUDA or GPU packages
|
||||||
<li>the USER-INTEL Phi or Kokkos Phi option, and either the USER-CUDA or GPU packages</li>
|
</UL>
|
||||||
</ul>
|
<P>See the examples/accelerate/README and make.list files for sample
|
||||||
<p>See the examples/accelerate/README and make.list files for sample
|
|
||||||
Make.py commands that build LAMMPS with any or all of the accelerator
|
Make.py commands that build LAMMPS with any or all of the accelerator
|
||||||
packages. As an example, here is a command that builds with all the
|
packages. As an example, here is a command that builds with all the
|
||||||
GPU related packages installed (USER-CUDA, GPU, KOKKOS with Cuda),
|
GPU related packages installed (USER-CUDA, GPU, KOKKOS with Cuda),
|
||||||
including settings to build the needed auxiliary USER-CUDA and GPU
|
including settings to build the needed auxiliary USER-CUDA and GPU
|
||||||
libraries for Kepler GPUs:</p>
|
libraries for Kepler GPUs:
|
||||||
<pre class="literal-block">
|
</P>
|
||||||
Make.py -j 16 -p omp gpu cuda kokkos -cc nvcc wrap=mpi -cuda mode=double arch=35 -gpu mode=double arch=35 -kokkos cuda arch=35 lib-all file mpi
|
<PRE>Make.py -j 16 -p omp gpu cuda kokkos -cc nvcc wrap=mpi -cuda mode=double arch=35 -gpu mode=double arch=35 \ -kokkos cuda arch=35 lib-all file mpi
|
||||||
</pre>
|
</PRE>
|
||||||
<p>The examples/accelerate directory also has input scripts that can be
|
<P>The examples/accelerate directory also has input scripts that can be
|
||||||
used with all of the accelerator packages. See its README file for
|
used with all of the accelerator packages. See its README file for
|
||||||
details.</p>
|
details.
|
||||||
<p>Likewise, the bench directory has FERMI and KEPLER and PHI
|
</P>
|
||||||
|
<P>Likewise, the bench directory has FERMI and KEPLER and PHI
|
||||||
sub-directories with Make.py commands and input scripts for using all
|
sub-directories with Make.py commands and input scripts for using all
|
||||||
the accelerator packages on various machines. See the README files in
|
the accelerator packages on various machines. See the README files in
|
||||||
those dirs.</p>
|
those dirs.
|
||||||
<p>As mentioned above, the <a class="reference external" href="http://lammps.sandia.gov/bench.html">Benchmark page</a> of the LAMMPS web site gives
|
</P>
|
||||||
|
<P>As mentioned above, the <A HREF = "http://lammps.sandia.gov/bench.html">Benchmark
|
||||||
|
page</A> of the LAMMPS web site gives
|
||||||
performance results for the various accelerator packages for several
|
performance results for the various accelerator packages for several
|
||||||
of the standard LAMMPS benchmark problems, as a function of problem
|
of the standard LAMMPS benchmark problems, as a function of problem
|
||||||
size and number of compute nodes, on different hardware platforms.</p>
|
size and number of compute nodes, on different hardware platforms.
|
||||||
<p>Here is a brief summary of what the various packages provide. Details
|
</P>
|
||||||
are in the individual accelerator sections.</p>
|
<P>Here is a brief summary of what the various packages provide. Details
|
||||||
<ul class="simple">
|
are in the individual accelerator sections.
|
||||||
<li>Styles with a “cuda” or “gpu” suffix are part of the USER-CUDA or GPU
|
</P>
|
||||||
|
<UL><LI>Styles with a "cuda" or "gpu" suffix are part of the USER-CUDA or GPU
|
||||||
packages, and can be run on NVIDIA GPUs. The speed-up on a GPU
|
packages, and can be run on NVIDIA GPUs. The speed-up on a GPU
|
||||||
depends on a variety of factors, discussed in the accelerator
|
depends on a variety of factors, discussed in the accelerator
|
||||||
sections.</li>
|
sections.
|
||||||
<li>Styles with an “intel” suffix are part of the USER-INTEL
|
|
||||||
|
<LI>Styles with an "intel" suffix are part of the USER-INTEL
|
||||||
package. These styles support vectorized single and mixed precision
|
package. These styles support vectorized single and mixed precision
|
||||||
calculations, in addition to full double precision. In extreme cases,
|
calculations, in addition to full double precision. In extreme cases,
|
||||||
this can provide speedups over 3.5x on CPUs. The package also
|
this can provide speedups over 3.5x on CPUs. The package also
|
||||||
supports acceleration in “offload” mode to Intel(R) Xeon Phi(TM)
|
supports acceleration in "offload" mode to Intel(R) Xeon Phi(TM)
|
||||||
coprocessors. This can result in additional speedup over 2x depending
|
coprocessors. This can result in additional speedup over 2x depending
|
||||||
on the hardware configuration.</li>
|
on the hardware configuration.
|
||||||
<li>Styles with a “kk” suffix are part of the KOKKOS package, and can be
|
|
||||||
|
<LI>Styles with a "kk" suffix are part of the KOKKOS package, and can be
|
||||||
run using OpenMP on multicore CPUs, on an NVIDIA GPU, or on an Intel
|
run using OpenMP on multicore CPUs, on an NVIDIA GPU, or on an Intel
|
||||||
Xeon Phi in “native” mode. The speed-up depends on a variety of
|
Xeon Phi in "native" mode. The speed-up depends on a variety of
|
||||||
factors, as discussed on the KOKKOS accelerator page.</li>
|
factors, as discussed on the KOKKOS accelerator page.
|
||||||
<li>Styles with an “omp” suffix are part of the USER-OMP package and allow
|
|
||||||
|
<LI>Styles with an "omp" suffix are part of the USER-OMP package and allow
|
||||||
a pair-style to be run in multi-threaded mode using OpenMP. This can
|
a pair-style to be run in multi-threaded mode using OpenMP. This can
|
||||||
be useful on nodes with high-core counts when using less MPI processes
|
be useful on nodes with high-core counts when using less MPI processes
|
||||||
than cores is advantageous, e.g. when running with PPPM so that FFTs
|
than cores is advantageous, e.g. when running with PPPM so that FFTs
|
||||||
are run on fewer MPI processors or when the many MPI tasks would
|
are run on fewer MPI processors or when the many MPI tasks would
|
||||||
overload the available bandwidth for communication.</li>
|
overload the available bandwidth for communication.
|
||||||
<li>Styles with an “opt” suffix are part of the OPT package and typically
|
|
||||||
|
<LI>Styles with an "opt" suffix are part of the OPT package and typically
|
||||||
speed-up the pairwise calculations of your simulation by 5-25% on a
|
speed-up the pairwise calculations of your simulation by 5-25% on a
|
||||||
CPU.</li>
|
CPU.
|
||||||
</ul>
|
</UL>
|
||||||
<p>The individual accelerator package doc pages explain:</p>
|
<P>The individual accelerator package doc pages explain:
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>what hardware and software the accelerated package requires</li>
|
<UL><LI>what hardware and software the accelerated package requires
|
||||||
<li>how to build LAMMPS with the accelerated package</li>
|
<LI>how to build LAMMPS with the accelerated package
|
||||||
<li>how to run with the accelerated package either via command-line switches or modifying the input script</li>
|
<LI>how to run with the accelerated package either via command-line switches or modifying the input script
|
||||||
<li>speed-ups to expect</li>
|
<LI>speed-ups to expect
|
||||||
<li>guidelines for best performance</li>
|
<LI>guidelines for best performance
|
||||||
<li>restrictions</li>
|
<LI>restrictions
|
||||||
</ul>
|
</UL>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
</div>
|
|
||||||
<div class="section" id="comparison-of-various-accelerator-packages">
|
<H4><A NAME = "acc_4"></A>5.4 Comparison of various accelerator packages
|
||||||
<span id="acc-4"></span><h2>5.4. Comparison of various accelerator packages<a class="headerlink" href="#comparison-of-various-accelerator-packages" title="Permalink to this headline">¶</a></h2>
|
</H4>
|
||||||
<div class="admonition note">
|
<P>NOTE: this section still needs to be re-worked with additional KOKKOS
|
||||||
<p class="first admonition-title">Note</p>
|
and USER-INTEL information.
|
||||||
<p class="last">this section still needs to be re-worked with additional KOKKOS
|
</P>
|
||||||
and USER-INTEL information.</p>
|
<P>The next section compares and contrasts the various accelerator
|
||||||
</div>
|
|
||||||
<p>The next section compares and contrasts the various accelerator
|
|
||||||
options, since there are multiple ways to perform OpenMP threading,
|
options, since there are multiple ways to perform OpenMP threading,
|
||||||
run on GPUs, and run on Intel Xeon Phi coprocessors.</p>
|
run on GPUs, and run on Intel Xeon Phi coprocessors.
|
||||||
<p>All 3 of these packages accelerate a LAMMPS calculation using NVIDIA
|
</P>
|
||||||
hardware, but they do it in different ways.</p>
|
<P>All 3 of these packages accelerate a LAMMPS calculation using NVIDIA
|
||||||
<p>As a consequence, for a particular simulation on specific hardware,
|
hardware, but they do it in different ways.
|
||||||
|
</P>
|
||||||
|
<P>As a consequence, for a particular simulation on specific hardware,
|
||||||
one package may be faster than the other. We give guidelines below,
|
one package may be faster than the other. We give guidelines below,
|
||||||
but the best way to determine which package is faster for your input
|
but the best way to determine which package is faster for your input
|
||||||
script is to try both of them on your machine. See the benchmarking
|
script is to try both of them on your machine. See the benchmarking
|
||||||
section below for examples where this has been done.</p>
|
section below for examples where this has been done.
|
||||||
<p><strong>Guidelines for using each package optimally:</strong></p>
|
</P>
|
||||||
<ul class="simple">
|
<P><B>Guidelines for using each package optimally:</B>
|
||||||
<li>The GPU package allows you to assign multiple CPUs (cores) to a single
|
</P>
|
||||||
GPU (a common configuration for “hybrid” nodes that contain multicore
|
<UL><LI>The GPU package allows you to assign multiple CPUs (cores) to a single
|
||||||
|
GPU (a common configuration for "hybrid" nodes that contain multicore
|
||||||
CPU(s) and GPU(s)) and works effectively in this mode. The USER-CUDA
|
CPU(s) and GPU(s)) and works effectively in this mode. The USER-CUDA
|
||||||
package does not allow this; you can only use one CPU per GPU.</li>
|
package does not allow this; you can only use one CPU per GPU.
|
||||||
<li>The GPU package moves per-atom data (coordinates, forces)
|
|
||||||
|
<LI>The GPU package moves per-atom data (coordinates, forces)
|
||||||
back-and-forth between the CPU and GPU every timestep. The USER-CUDA
|
back-and-forth between the CPU and GPU every timestep. The USER-CUDA
|
||||||
package only does this on timesteps when a CPU calculation is required
|
package only does this on timesteps when a CPU calculation is required
|
||||||
(e.g. to invoke a fix or compute that is non-GPU-ized). Hence, if you
|
(e.g. to invoke a fix or compute that is non-GPU-ized). Hence, if you
|
||||||
@ -489,129 +338,64 @@ can formulate your input script to only use GPU-ized fixes and
|
|||||||
computes, and avoid doing I/O too often (thermo output, dump file
|
computes, and avoid doing I/O too often (thermo output, dump file
|
||||||
snapshots, restart files), then the data transfer cost of the
|
snapshots, restart files), then the data transfer cost of the
|
||||||
USER-CUDA package can be very low, causing it to run faster than the
|
USER-CUDA package can be very low, causing it to run faster than the
|
||||||
GPU package.</li>
|
GPU package.
|
||||||
<li>The GPU package is often faster than the USER-CUDA package, if the
|
|
||||||
number of atoms per GPU is “small”. The crossover point, in terms of
|
<LI>The GPU package is often faster than the USER-CUDA package, if the
|
||||||
|
number of atoms per GPU is "small". The crossover point, in terms of
|
||||||
atoms/GPU at which the USER-CUDA package becomes faster depends
|
atoms/GPU at which the USER-CUDA package becomes faster depends
|
||||||
strongly on the pair style. For example, for a simple Lennard Jones
|
strongly on the pair style. For example, for a simple Lennard Jones
|
||||||
system the crossover (in single precision) is often about 50K-100K
|
system the crossover (in single precision) is often about 50K-100K
|
||||||
atoms per GPU. When performing double precision calculations the
|
atoms per GPU. When performing double precision calculations the
|
||||||
crossover point can be significantly smaller.</li>
|
crossover point can be significantly smaller.
|
||||||
<li>Both packages compute bonded interactions (bonds, angles, etc) on the
|
|
||||||
|
<LI>Both packages compute bonded interactions (bonds, angles, etc) on the
|
||||||
CPU. This means a model with bonds will force the USER-CUDA package
|
CPU. This means a model with bonds will force the USER-CUDA package
|
||||||
to transfer per-atom data back-and-forth between the CPU and GPU every
|
to transfer per-atom data back-and-forth between the CPU and GPU every
|
||||||
timestep. If the GPU package is running with several MPI processes
|
timestep. If the GPU package is running with several MPI processes
|
||||||
assigned to one GPU, the cost of computing the bonded interactions is
|
assigned to one GPU, the cost of computing the bonded interactions is
|
||||||
spread across more CPUs and hence the GPU package can run faster.</li>
|
spread across more CPUs and hence the GPU package can run faster.
|
||||||
<li>When using the GPU package with multiple CPUs assigned to one GPU, its
|
|
||||||
|
<LI>When using the GPU package with multiple CPUs assigned to one GPU, its
|
||||||
performance depends to some extent on high bandwidth between the CPUs
|
performance depends to some extent on high bandwidth between the CPUs
|
||||||
and the GPU. Hence its performance is affected if full 16 PCIe lanes
|
and the GPU. Hence its performance is affected if full 16 PCIe lanes
|
||||||
are not available for each GPU. In HPC environments this can be the
|
are not available for each GPU. In HPC environments this can be the
|
||||||
case if S2050/70 servers are used, where two devices generally share
|
case if S2050/70 servers are used, where two devices generally share
|
||||||
one PCIe 2.0 16x slot. Also many multi-GPU mainboards do not provide
|
one PCIe 2.0 16x slot. Also many multi-GPU mainboards do not provide
|
||||||
full 16 lanes to each of the PCIe 2.0 16x slots.</li>
|
full 16 lanes to each of the PCIe 2.0 16x slots.
|
||||||
</ul>
|
</UL>
|
||||||
<p><strong>Differences between the two packages:</strong></p>
|
<P><B>Differences between the two packages:</B>
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>The GPU package accelerates only pair force, neighbor list, and PPPM
|
<UL><LI>The GPU package accelerates only pair force, neighbor list, and PPPM
|
||||||
calculations. The USER-CUDA package currently supports a wider range
|
calculations. The USER-CUDA package currently supports a wider range
|
||||||
of pair styles and can also accelerate many fix styles and some
|
of pair styles and can also accelerate many fix styles and some
|
||||||
compute styles, as well as neighbor list and PPPM calculations.</li>
|
compute styles, as well as neighbor list and PPPM calculations.
|
||||||
<li>The USER-CUDA package does not support acceleration for minimization.</li>
|
|
||||||
<li>The USER-CUDA package does not support hybrid pair styles.</li>
|
<LI>The USER-CUDA package does not support acceleration for minimization.
|
||||||
<li>The USER-CUDA package can order atoms in the neighbor list differently
|
|
||||||
from run to run resulting in a different order for force accumulation.</li>
|
<LI>The USER-CUDA package does not support hybrid pair styles.
|
||||||
<li>The USER-CUDA package has a limit on the number of atom types that can be
|
|
||||||
used in a simulation.</li>
|
<LI>The USER-CUDA package can order atoms in the neighbor list differently
|
||||||
<li>The GPU package requires neighbor lists to be built on the CPU when using
|
from run to run resulting in a different order for force accumulation.
|
||||||
exclusion lists or a triclinic simulation box.</li>
|
|
||||||
<li>The GPU package uses more GPU memory than the USER-CUDA package. This
|
<LI>The USER-CUDA package has a limit on the number of atom types that can be
|
||||||
|
used in a simulation.
|
||||||
|
|
||||||
|
<LI>The GPU package requires neighbor lists to be built on the CPU when using
|
||||||
|
exclusion lists or a triclinic simulation box.
|
||||||
|
|
||||||
|
<LI>The GPU package uses more GPU memory than the USER-CUDA package. This
|
||||||
is generally not a problem since typical runs are computation-limited
|
is generally not a problem since typical runs are computation-limited
|
||||||
rather than memory-limited.</li>
|
rather than memory-limited.
|
||||||
</ul>
|
</UL>
|
||||||
<div class="section" id="examples">
|
<P><B>Examples:</B>
|
||||||
<h3>5.4.1. Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h3>
|
</P>
|
||||||
<p>The LAMMPS distribution has two directories with sample input scripts
|
<P>The LAMMPS distribution has two directories with sample input scripts
|
||||||
for the GPU and USER-CUDA packages.</p>
|
for the GPU and USER-CUDA packages.
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>lammps/examples/gpu = GPU package files</li>
|
<UL><LI>lammps/examples/gpu = GPU package files
|
||||||
<li>lammps/examples/USER/cuda = USER-CUDA package files</li>
|
<LI>lammps/examples/USER/cuda = USER-CUDA package files
|
||||||
</ul>
|
</UL>
|
||||||
<p>These contain input scripts for identical systems, so they can be used
|
<P>These contain input scripts for identical systems, so they can be used
|
||||||
to benchmark the performance of both packages on your system.</p>
|
to benchmark the performance of both packages on your system.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
||||||
|
|
||||||
<a href="Section_howto.html" class="btn btn-neutral float-right" title="6. How-to discussions" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
<a href="Section_packages.html" class="btn btn-neutral" title="4. Packages" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
16896
doc/Section_errors.html
16896
doc/Section_errors.html
File diff suppressed because it is too large
Load Diff
@ -1,143 +1,17 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_howto.html">Previous Section</A> - <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> - <A HREF = "Section_perf.html">Next Section</A>
|
||||||
|
</CENTER>
|
||||||
|
|
||||||
|
|
||||||
<!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>7. Example problems — 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"/>
|
|
||||||
<link rel="next" title="8. Performance & scalability" href="Section_perf.html"/>
|
|
||||||
<link rel="prev" title="6. How-to discussions" href="Section_howto.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 class="current">
|
|
||||||
<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 current"><a class="current reference internal" href="">7. Example problems</a></li>
|
|
||||||
<li class="toctree-l1"><a class="reference internal" href="Section_perf.html">8. Performance & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>7. Example problems
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P>The LAMMPS distribution includes an examples sub-directory with
|
||||||
<li>7. Example problems</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="Section_perf.html" class="btn btn-neutral float-right" title="8. Performance & scalability" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
<a href="Section_howto.html" class="btn btn-neutral" title="6. How-to discussions" 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="example-problems">
|
|
||||||
<h1>7. Example problems<a class="headerlink" href="#example-problems" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>The LAMMPS distribution includes an examples sub-directory with
|
|
||||||
several sample problems. Each problem is in a sub-directory of its
|
several sample problems. Each problem is in a sub-directory of its
|
||||||
own. Most are 2d models so that they run quickly, requiring at most a
|
own. Most are 2d models so that they run quickly, requiring at most a
|
||||||
couple of minutes to run on a desktop machine. Each problem has an
|
couple of minutes to run on a desktop machine. Each problem has an
|
||||||
@ -146,252 +20,107 @@ input script (in.*) and produces a log file (log.*) and dump file
|
|||||||
coordinates as additional input. A few sample log file outputs on
|
coordinates as additional input. A few sample log file outputs on
|
||||||
different machines and different numbers of processors are included in
|
different machines and different numbers of processors are included in
|
||||||
the directories to compare your answers to. E.g. a log file like
|
the directories to compare your answers to. E.g. a log file like
|
||||||
log.crack.foo.P means it ran on P processors of machine “foo”.</p>
|
log.crack.foo.P means it ran on P processors of machine "foo".
|
||||||
<p>For examples that use input data files, many of them were produced by
|
</P>
|
||||||
<a class="reference external" href="http://pizza.sandia.gov">Pizza.py</a> or setup tools described in the
|
<P>For examples that use input data files, many of them were produced by
|
||||||
<a class="reference internal" href="Section_tools.html"><em>Additional Tools</em></a> section of the LAMMPS
|
<A HREF = "http://pizza.sandia.gov">Pizza.py</A> or setup tools described in the
|
||||||
documentation and provided with the LAMMPS distribution.</p>
|
<A HREF = "Section_tools.html">Additional Tools</A> section of the LAMMPS
|
||||||
<p>If you uncomment the <a class="reference internal" href="dump.html"><em>dump</em></a> command in the input script, a
|
documentation and provided with the LAMMPS distribution.
|
||||||
|
</P>
|
||||||
|
<P>If you uncomment the <A HREF = "dump.html">dump</A> command in the input script, a
|
||||||
text dump file will be produced, which can be animated by various
|
text dump file will be produced, which can be animated by various
|
||||||
<a class="reference external" href="http://lammps.sandia.gov/viz.html">visualization programs</a>. It can
|
<A HREF = "http://lammps.sandia.gov/viz.html">visualization programs</A>. It can
|
||||||
also be animated using the xmovie tool described in the <a class="reference internal" href="Section_tools.html"><em>Additional Tools</em></a> section of the LAMMPS documentation.</p>
|
also be animated using the xmovie tool described in the <A HREF = "Section_tools.html">Additional
|
||||||
<p>If you uncomment the <a class="reference internal" href="dump.html"><em>dump image</em></a> command in the input
|
Tools</A> section of the LAMMPS documentation.
|
||||||
|
</P>
|
||||||
|
<P>If you uncomment the <A HREF = "dump.html">dump image</A> command in the input
|
||||||
script, and assuming you have built LAMMPS with a JPG library, JPG
|
script, and assuming you have built LAMMPS with a JPG library, JPG
|
||||||
snapshot images will be produced when the simulation runs. They can
|
snapshot images will be produced when the simulation runs. They can
|
||||||
be quickly post-processed into a movie using commands described on the
|
be quickly post-processed into a movie using commands described on the
|
||||||
<a class="reference internal" href="dump_image.html"><em>dump image</em></a> doc page.</p>
|
<A HREF = "dump_image.html">dump image</A> doc page.
|
||||||
<p>Animations of many of these examples can be viewed on the Movies
|
</P>
|
||||||
section of the <a class="reference external" href="http://lammps.sandia.gov">LAMMPS WWW Site</a>.</p>
|
<P>Animations of many of these examples can be viewed on the Movies
|
||||||
<p>These are the sample problems in the examples sub-directories:</p>
|
section of the <A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A>.
|
||||||
<table border="1" class="docutils">
|
</P>
|
||||||
<colgroup>
|
<P>These are the sample problems in the examples sub-directories:
|
||||||
<col width="15%" />
|
</P>
|
||||||
<col width="85%" />
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
</colgroup>
|
<TR><TD >balance</TD><TD > dynamic load balancing, 2d system</TD></TR>
|
||||||
<tbody valign="top">
|
<TR><TD >body</TD><TD > body particles, 2d system</TD></TR>
|
||||||
<tr class="row-odd"><td>balance</td>
|
<TR><TD >colloid</TD><TD > big colloid particles in a small particle solvent, 2d system</TD></TR>
|
||||||
<td>dynamic load balancing, 2d system</td>
|
<TR><TD >comb</TD><TD > models using the COMB potential</TD></TR>
|
||||||
</tr>
|
<TR><TD >crack</TD><TD > crack propagation in a 2d solid</TD></TR>
|
||||||
<tr class="row-even"><td>body</td>
|
<TR><TD >cuda</TD><TD > use of the USER-CUDA package for GPU acceleration</TD></TR>
|
||||||
<td>body particles, 2d system</td>
|
<TR><TD >dipole</TD><TD > point dipolar particles, 2d system</TD></TR>
|
||||||
</tr>
|
<TR><TD >dreiding</TD><TD > methanol via Dreiding FF</TD></TR>
|
||||||
<tr class="row-odd"><td>colloid</td>
|
<TR><TD >eim</TD><TD > NaCl using the EIM potential</TD></TR>
|
||||||
<td>big colloid particles in a small particle solvent, 2d system</td>
|
<TR><TD >ellipse</TD><TD > ellipsoidal particles in spherical solvent, 2d system</TD></TR>
|
||||||
</tr>
|
<TR><TD >flow</TD><TD > Couette and Poiseuille flow in a 2d channel</TD></TR>
|
||||||
<tr class="row-even"><td>comb</td>
|
<TR><TD >friction</TD><TD > frictional contact of spherical asperities between 2d surfaces</TD></TR>
|
||||||
<td>models using the COMB potential</td>
|
<TR><TD >gpu</TD><TD > use of the GPU package for GPU acceleration</TD></TR>
|
||||||
</tr>
|
<TR><TD >hugoniostat</TD><TD > Hugoniostat shock dynamics</TD></TR>
|
||||||
<tr class="row-odd"><td>crack</td>
|
<TR><TD >indent</TD><TD > spherical indenter into a 2d solid</TD></TR>
|
||||||
<td>crack propagation in a 2d solid</td>
|
<TR><TD >intel</TD><TD > use of the USER-INTEL package for CPU or Intel(R) Xeon Phi(TM) coprocessor</TD></TR>
|
||||||
</tr>
|
<TR><TD >kim</TD><TD > use of potentials in Knowledge Base for Interatomic Models (KIM)</TD></TR>
|
||||||
<tr class="row-even"><td>cuda</td>
|
<TR><TD >line</TD><TD > line segment particles in 2d rigid bodies</TD></TR>
|
||||||
<td>use of the USER-CUDA package for GPU acceleration</td>
|
<TR><TD >meam</TD><TD > MEAM test for SiC and shear (same as shear examples)</TD></TR>
|
||||||
</tr>
|
<TR><TD >melt</TD><TD > rapid melt of 3d LJ system</TD></TR>
|
||||||
<tr class="row-odd"><td>dipole</td>
|
<TR><TD >micelle</TD><TD > self-assembly of small lipid-like molecules into 2d bilayers</TD></TR>
|
||||||
<td>point dipolar particles, 2d system</td>
|
<TR><TD >min</TD><TD > energy minimization of 2d LJ melt</TD></TR>
|
||||||
</tr>
|
<TR><TD >msst</TD><TD > MSST shock dynamics</TD></TR>
|
||||||
<tr class="row-even"><td>dreiding</td>
|
<TR><TD >nb3b</TD><TD > use of nonbonded 3-body harmonic pair style</TD></TR>
|
||||||
<td>methanol via Dreiding FF</td>
|
<TR><TD >neb</TD><TD > nudged elastic band (NEB) calculation for barrier finding</TD></TR>
|
||||||
</tr>
|
<TR><TD >nemd</TD><TD > non-equilibrium MD of 2d sheared system</TD></TR>
|
||||||
<tr class="row-odd"><td>eim</td>
|
<TR><TD >obstacle</TD><TD > flow around two voids in a 2d channel</TD></TR>
|
||||||
<td>NaCl using the EIM potential</td>
|
<TR><TD >peptide</TD><TD > dynamics of a small solvated peptide chain (5-mer)</TD></TR>
|
||||||
</tr>
|
<TR><TD >peri</TD><TD > Peridynamic model of cylinder impacted by indenter</TD></TR>
|
||||||
<tr class="row-even"><td>ellipse</td>
|
<TR><TD >pour</TD><TD > pouring of granular particles into a 3d box, then chute flow</TD></TR>
|
||||||
<td>ellipsoidal particles in spherical solvent, 2d system</td>
|
<TR><TD >prd</TD><TD > parallel replica dynamics of vacancy diffusion in bulk Si</TD></TR>
|
||||||
</tr>
|
<TR><TD >qeq</TD><TD > use of the QEQ pacakge for charge equilibration</TD></TR>
|
||||||
<tr class="row-odd"><td>flow</td>
|
<TR><TD >reax</TD><TD > RDX and TATB models using the ReaxFF</TD></TR>
|
||||||
<td>Couette and Poiseuille flow in a 2d channel</td>
|
<TR><TD >rigid</TD><TD > rigid bodies modeled as independent or coupled</TD></TR>
|
||||||
</tr>
|
<TR><TD >shear</TD><TD > sideways shear applied to 2d solid, with and without a void</TD></TR>
|
||||||
<tr class="row-even"><td>friction</td>
|
<TR><TD >snap</TD><TD > NVE dynamics for BCC tantalum crystal using SNAP potential</TD></TR>
|
||||||
<td>frictional contact of spherical asperities between 2d surfaces</td>
|
<TR><TD >srd</TD><TD > stochastic rotation dynamics (SRD) particles as solvent</TD></TR>
|
||||||
</tr>
|
<TR><TD >tad</TD><TD > temperature-accelerated dynamics of vacancy diffusion in bulk Si</TD></TR>
|
||||||
<tr class="row-odd"><td>gpu</td>
|
<TR><TD >tri</TD><TD > triangular particles in rigid bodies
|
||||||
<td>use of the GPU package for GPU acceleration</td>
|
</TD></TR></TABLE></DIV>
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>hugoniostat</td>
|
<P>Here is how you might run and visualize one of the sample problems:
|
||||||
<td>Hugoniostat shock dynamics</td>
|
</P>
|
||||||
</tr>
|
<PRE>cd indent
|
||||||
<tr class="row-odd"><td>indent</td>
|
|
||||||
<td>spherical indenter into a 2d solid</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>intel</td>
|
|
||||||
<td>use of the USER-INTEL package for CPU or Intel(R) Xeon Phi(TM) coprocessor</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>kim</td>
|
|
||||||
<td>use of potentials in Knowledge Base for Interatomic Models (KIM)</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>line</td>
|
|
||||||
<td>line segment particles in 2d rigid bodies</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>meam</td>
|
|
||||||
<td>MEAM test for SiC and shear (same as shear examples)</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>melt</td>
|
|
||||||
<td>rapid melt of 3d LJ system</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>micelle</td>
|
|
||||||
<td>self-assembly of small lipid-like molecules into 2d bilayers</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>min</td>
|
|
||||||
<td>energy minimization of 2d LJ melt</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>msst</td>
|
|
||||||
<td>MSST shock dynamics</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>nb3b</td>
|
|
||||||
<td>use of nonbonded 3-body harmonic pair style</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>neb</td>
|
|
||||||
<td>nudged elastic band (NEB) calculation for barrier finding</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>nemd</td>
|
|
||||||
<td>non-equilibrium MD of 2d sheared system</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>obstacle</td>
|
|
||||||
<td>flow around two voids in a 2d channel</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>peptide</td>
|
|
||||||
<td>dynamics of a small solvated peptide chain (5-mer)</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>peri</td>
|
|
||||||
<td>Peridynamic model of cylinder impacted by indenter</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>pour</td>
|
|
||||||
<td>pouring of granular particles into a 3d box, then chute flow</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>prd</td>
|
|
||||||
<td>parallel replica dynamics of vacancy diffusion in bulk Si</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>qeq</td>
|
|
||||||
<td>use of the QEQ pacakge for charge equilibration</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>reax</td>
|
|
||||||
<td>RDX and TATB models using the ReaxFF</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>rigid</td>
|
|
||||||
<td>rigid bodies modeled as independent or coupled</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>shear</td>
|
|
||||||
<td>sideways shear applied to 2d solid, with and without a void</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>snap</td>
|
|
||||||
<td>NVE dynamics for BCC tantalum crystal using SNAP potential</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>srd</td>
|
|
||||||
<td>stochastic rotation dynamics (SRD) particles as solvent</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>tad</td>
|
|
||||||
<td>temperature-accelerated dynamics of vacancy diffusion in bulk Si</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>tri</td>
|
|
||||||
<td>triangular particles in rigid bodies</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>Here is how you might run and visualize one of the sample problems:</p>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd indent
|
|
||||||
cp ../../src/lmp_linux . # copy LAMMPS executable to this dir
|
cp ../../src/lmp_linux . # copy LAMMPS executable to this dir
|
||||||
lmp_linux < in.indent # run the problem
|
lmp_linux < in.indent # run the problem
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Running the simulation produces the files <I>dump.indent</I> and
|
||||||
<p>Running the simulation produces the files <em>dump.indent</em> and
|
<I>log.lammps</I>. You can visualize the dump file as follows:
|
||||||
<em>log.lammps</em>. You can visualize the dump file as follows:</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>../../tools/xmovie/xmovie -scale dump.indent
|
<PRE>../../tools/xmovie/xmovie -scale dump.indent
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>If you uncomment the <A HREF = "dump_image.html">dump image</A> line(s) in the input
|
||||||
<p>If you uncomment the <a class="reference internal" href="dump_image.html"><em>dump image</em></a> line(s) in the input
|
|
||||||
script a series of JPG images will be produced by the run. These can
|
script a series of JPG images will be produced by the run. These can
|
||||||
be viewed individually or turned into a movie or animated by tools
|
be viewed individually or turned into a movie or animated by tools
|
||||||
like ImageMagick or QuickTime or various Windows-based tools. See the
|
like ImageMagick or QuickTime or various Windows-based tools. See the
|
||||||
<a class="reference internal" href="dump_image.html"><em>dump image</em></a> doc page for more details. E.g. this
|
<A HREF = "dump_image.html">dump image</A> doc page for more details. E.g. this
|
||||||
Imagemagick command would create a GIF file suitable for viewing in a
|
Imagemagick command would create a GIF file suitable for viewing in a
|
||||||
browser.</p>
|
browser.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>% convert -loop 1 *.jpg foo.gif
|
</P>
|
||||||
</pre></div>
|
<PRE>% convert -loop 1 *.jpg foo.gif
|
||||||
</div>
|
</PRE>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
<p>There is also a COUPLE directory with examples of how to use LAMMPS as
|
|
||||||
|
<P>There is also a COUPLE directory with examples of how to use LAMMPS as
|
||||||
a library, either by itself or in tandem with another code or library.
|
a library, either by itself or in tandem with another code or library.
|
||||||
See the COUPLE/README file to get started.</p>
|
See the COUPLE/README file to get started.
|
||||||
<p>There is also an ELASTIC directory with an example script for
|
</P>
|
||||||
|
<P>There is also an ELASTIC directory with an example script for
|
||||||
computing elastic constants, using a zero temperature Si example. See
|
computing elastic constants, using a zero temperature Si example. See
|
||||||
the in.elastic file for more info.</p>
|
the in.elastic file for more info.
|
||||||
<p>There is also a USER directory which contains subdirectories of
|
</P>
|
||||||
|
<P>There is also a USER directory which contains subdirectories of
|
||||||
user-provided examples for user packages. See the README files in
|
user-provided examples for user packages. See the README files in
|
||||||
those directories for more info. See the
|
those directories for more info. See the
|
||||||
<a class="reference internal" href="Section_start.html"><em>Section_start.html</em></a> file for more info about user
|
<A HREF = "Section_start.html">Section_start.html</A> file for more info about user
|
||||||
packages.</p>
|
packages.
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
||||||
|
|
||||||
<a href="Section_perf.html" class="btn btn-neutral float-right" title="8. Performance & scalability" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
<a href="Section_howto.html" class="btn btn-neutral" title="6. How-to discussions" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,313 +1,129 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_errors.html">Previous Section</A> - <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> - <A HREF = "Manual.html">Next
|
||||||
|
Section</A>
|
||||||
|
</CENTER>
|
||||||
|
|
||||||
|
|
||||||
<!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>13. Future and history — 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"/>
|
|
||||||
<link rel="prev" title="12. Errors" href="Section_errors.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 class="current">
|
|
||||||
<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 & 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 & 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 current"><a class="current reference internal" href="">13. Future and history</a><ul>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="#coming-attractions">13.1. Coming attractions</a></li>
|
|
||||||
<li class="toctree-l2"><a class="reference internal" href="#past-versions">13.2. Past versions</a></li>
|
|
||||||
</ul>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>13. Future and history
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P>This section lists features we plan to add to LAMMPS, features of
|
||||||
<li>13. Future and history</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="Section_errors.html" class="btn btn-neutral" title="12. Errors" 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="future-and-history">
|
|
||||||
<h1>13. Future and history<a class="headerlink" href="#future-and-history" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>This section lists features we plan to add to LAMMPS, features of
|
|
||||||
previous versions of LAMMPS, and features of other parallel molecular
|
previous versions of LAMMPS, and features of other parallel molecular
|
||||||
dynamics codes our group has distributed.</p>
|
dynamics codes our group has distributed.
|
||||||
<div class="line-block">
|
</P>
|
||||||
<div class="line">13.1 <a class="reference internal" href="#hist-1"><span>Coming attractions</span></a></div>
|
13.1 <A HREF = "#hist_1">Coming attractions</A><BR>
|
||||||
<div class="line">13.2 <a class="reference internal" href="#hist-2"><span>Past versions</span></a></div>
|
13.2 <A HREF = "#hist_2">Past versions</A> <BR>
|
||||||
<div class="line"><br /></div>
|
|
||||||
</div>
|
<HR>
|
||||||
<div class="section" id="coming-attractions">
|
|
||||||
<span id="hist-1"></span><h2>13.1. Coming attractions<a class="headerlink" href="#coming-attractions" title="Permalink to this headline">¶</a></h2>
|
<HR>
|
||||||
<p>The <a class="reference external" href="http://lammps.sandia.gov/future.html">Wish list link</a> on the
|
|
||||||
|
<H4><A NAME = "hist_1"></A>13.1 Coming attractions
|
||||||
|
</H4>
|
||||||
|
<P>The <A HREF = "http://lammps.sandia.gov/future.html">Wish list link</A> on the
|
||||||
LAMMPS WWW page gives a list of features we are hoping to add to
|
LAMMPS WWW page gives a list of features we are hoping to add to
|
||||||
LAMMPS in the future, including contact names of individuals you can
|
LAMMPS in the future, including contact names of individuals you can
|
||||||
email if you are interested in contributing to the developement or
|
email if you are interested in contributing to the developement or
|
||||||
would be a future user of that feature.</p>
|
would be a future user of that feature.
|
||||||
<p>You can also send <a class="reference external" href="http://lammps.sandia.gov/authors.html">email to the developers</a> if you want to add
|
</P>
|
||||||
your wish to the list.</p>
|
<P>You can also send <A HREF = "http://lammps.sandia.gov/authors.html">email to the
|
||||||
<hr class="docutils" />
|
developers</A> if you want to add
|
||||||
</div>
|
your wish to the list.
|
||||||
<div class="section" id="past-versions">
|
</P>
|
||||||
<span id="hist-2"></span><h2>13.2. Past versions<a class="headerlink" href="#past-versions" title="Permalink to this headline">¶</a></h2>
|
<HR>
|
||||||
<p>LAMMPS development began in the mid 1990s under a cooperative research
|
|
||||||
& development agreement (CRADA) between two DOE labs (Sandia and LLNL)
|
<H4><A NAME = "hist_2"></A>13.2 Past versions
|
||||||
|
</H4>
|
||||||
|
<P>LAMMPS development began in the mid 1990s under a cooperative research
|
||||||
|
& development agreement (CRADA) between two DOE labs (Sandia and LLNL)
|
||||||
and 3 companies (Cray, Bristol Myers Squibb, and Dupont). The goal was
|
and 3 companies (Cray, Bristol Myers Squibb, and Dupont). The goal was
|
||||||
to develop a large-scale parallel classical MD code; the coding effort
|
to develop a large-scale parallel classical MD code; the coding effort
|
||||||
was led by Steve Plimpton at Sandia.</p>
|
was led by Steve Plimpton at Sandia.
|
||||||
<p>After the CRADA ended, a final F77 version, LAMMPS 99, was
|
</P>
|
||||||
|
<P>After the CRADA ended, a final F77 version, LAMMPS 99, was
|
||||||
released. As development of LAMMPS continued at Sandia, its memory
|
released. As development of LAMMPS continued at Sandia, its memory
|
||||||
management was converted to F90; a final F90 version was released as
|
management was converted to F90; a final F90 version was released as
|
||||||
LAMMPS 2001.</p>
|
LAMMPS 2001.
|
||||||
<p>The current LAMMPS is a rewrite in C++ and was first publicly released
|
</P>
|
||||||
|
<P>The current LAMMPS is a rewrite in C++ and was first publicly released
|
||||||
as an open source code in 2004. It includes many new features beyond
|
as an open source code in 2004. It includes many new features beyond
|
||||||
those in LAMMPS 99 or 2001. It also includes features from older
|
those in LAMMPS 99 or 2001. It also includes features from older
|
||||||
parallel MD codes written at Sandia, namely ParaDyn, Warp, and
|
parallel MD codes written at Sandia, namely ParaDyn, Warp, and
|
||||||
GranFlow (see below).</p>
|
GranFlow (see below).
|
||||||
<p>In late 2006 we began merging new capabilities into LAMMPS that were
|
</P>
|
||||||
|
<P>In late 2006 we began merging new capabilities into LAMMPS that were
|
||||||
developed by Aidan Thompson at Sandia for his MD code GRASP, which has
|
developed by Aidan Thompson at Sandia for his MD code GRASP, which has
|
||||||
a parallel framework similar to LAMMPS. Most notably, these have
|
a parallel framework similar to LAMMPS. Most notably, these have
|
||||||
included many-body potentials - Stillinger-Weber, Tersoff, ReaxFF -
|
included many-body potentials - Stillinger-Weber, Tersoff, ReaxFF -
|
||||||
and the associated charge-equilibration routines needed for ReaxFF.</p>
|
and the associated charge-equilibration routines needed for ReaxFF.
|
||||||
<p>The <a class="reference external" href="http://lammps.sandia.gov/history.html">History link</a> on the
|
</P>
|
||||||
|
<P>The <A HREF = "http://lammps.sandia.gov/history.html">History link</A> on the
|
||||||
LAMMPS WWW page gives a timeline of features added to the
|
LAMMPS WWW page gives a timeline of features added to the
|
||||||
C++ open-source version of LAMMPS over the last several years.</p>
|
C++ open-source version of LAMMPS over the last several years.
|
||||||
<p>These older codes are available for download from the <a class="reference external" href="http://lammps.sandia.gov">LAMMPS WWW site</a>, except for Warp & GranFlow which were primarily used
|
</P>
|
||||||
internally. A brief listing of their features is given here.</p>
|
<P>These older codes are available for download from the <A HREF = "http://lammps.sandia.gov">LAMMPS WWW
|
||||||
<p>LAMMPS 2001</p>
|
site</A>, except for Warp & GranFlow which were primarily used
|
||||||
<ul class="simple">
|
internally. A brief listing of their features is given here.
|
||||||
<li>F90 + MPI</li>
|
</P>
|
||||||
<li>dynamic memory</li>
|
<P>LAMMPS 2001
|
||||||
<li>spatial-decomposition parallelism</li>
|
</P>
|
||||||
<li>NVE, NVT, NPT, NPH, rRESPA integrators</li>
|
<UL><LI> F90 + MPI
|
||||||
<li>LJ and Coulombic pairwise force fields</li>
|
<LI> dynamic memory
|
||||||
<li>all-atom, united-atom, bead-spring polymer force fields</li>
|
<LI> spatial-decomposition parallelism
|
||||||
<li>CHARMM-compatible force fields</li>
|
<LI> NVE, NVT, NPT, NPH, rRESPA integrators
|
||||||
<li>class 2 force fields</li>
|
<LI> LJ and Coulombic pairwise force fields
|
||||||
<li>3d/2d Ewald & PPPM</li>
|
<LI> all-atom, united-atom, bead-spring polymer force fields
|
||||||
<li>various force and temperature constraints</li>
|
<LI> CHARMM-compatible force fields
|
||||||
<li>SHAKE</li>
|
<LI> class 2 force fields
|
||||||
<li>Hessian-free truncated-Newton minimizer</li>
|
<LI> 3d/2d Ewald & PPPM
|
||||||
<li>user-defined diagnostics</li>
|
<LI> various force and temperature constraints
|
||||||
</ul>
|
<LI> SHAKE
|
||||||
<p>LAMMPS 99</p>
|
<LI> Hessian-free truncated-Newton minimizer
|
||||||
<ul class="simple">
|
<LI> user-defined diagnostics
|
||||||
<li>F77 + MPI</li>
|
</UL>
|
||||||
<li>static memory allocation</li>
|
<P>LAMMPS 99
|
||||||
<li>spatial-decomposition parallelism</li>
|
</P>
|
||||||
<li>most of the LAMMPS 2001 features with a few exceptions</li>
|
<UL><LI> F77 + MPI
|
||||||
<li>no 2d Ewald & PPPM</li>
|
<LI> static memory allocation
|
||||||
<li>molecular force fields are missing a few CHARMM terms</li>
|
<LI> spatial-decomposition parallelism
|
||||||
<li>no SHAKE</li>
|
<LI> most of the LAMMPS 2001 features with a few exceptions
|
||||||
</ul>
|
<LI> no 2d Ewald & PPPM
|
||||||
<p>Warp</p>
|
<LI> molecular force fields are missing a few CHARMM terms
|
||||||
<ul class="simple">
|
<LI> no SHAKE
|
||||||
<li>F90 + MPI</li>
|
</UL>
|
||||||
<li>spatial-decomposition parallelism</li>
|
<P>Warp
|
||||||
<li>embedded atom method (EAM) metal potentials + LJ</li>
|
</P>
|
||||||
<li>lattice and grain-boundary atom creation</li>
|
<UL><LI> F90 + MPI
|
||||||
<li>NVE, NVT integrators</li>
|
<LI> spatial-decomposition parallelism
|
||||||
<li>boundary conditions for applying shear stresses</li>
|
<LI> embedded atom method (EAM) metal potentials + LJ
|
||||||
<li>temperature controls for actively sheared systems</li>
|
<LI> lattice and grain-boundary atom creation
|
||||||
<li>per-atom energy and centro-symmetry computation and output</li>
|
<LI> NVE, NVT integrators
|
||||||
</ul>
|
<LI> boundary conditions for applying shear stresses
|
||||||
<p>ParaDyn</p>
|
<LI> temperature controls for actively sheared systems
|
||||||
<ul class="simple">
|
<LI> per-atom energy and centro-symmetry computation and output
|
||||||
<li>F77 + MPI</li>
|
</UL>
|
||||||
<li>atom- and force-decomposition parallelism</li>
|
<P>ParaDyn
|
||||||
<li>embedded atom method (EAM) metal potentials</li>
|
</P>
|
||||||
<li>lattice atom creation</li>
|
<UL><LI> F77 + MPI
|
||||||
<li>NVE, NVT, NPT integrators</li>
|
<LI> atom- and force-decomposition parallelism
|
||||||
<li>all serial DYNAMO features for controls and constraints</li>
|
<LI> embedded atom method (EAM) metal potentials
|
||||||
</ul>
|
<LI> lattice atom creation
|
||||||
<p>GranFlow</p>
|
<LI> NVE, NVT, NPT integrators
|
||||||
<ul class="simple">
|
<LI> all serial DYNAMO features for controls and constraints
|
||||||
<li>F90 + MPI</li>
|
</UL>
|
||||||
<li>spatial-decomposition parallelism</li>
|
<P>GranFlow
|
||||||
<li>frictional granular potentials</li>
|
</P>
|
||||||
<li>NVE integrator</li>
|
<UL><LI> F90 + MPI
|
||||||
<li>boundary conditions for granular flow and packing and walls</li>
|
<LI> spatial-decomposition parallelism
|
||||||
<li>particle insertion</li>
|
<LI> frictional granular potentials
|
||||||
</ul>
|
<LI> NVE integrator
|
||||||
</div>
|
<LI> boundary conditions for granular flow and packing and walls
|
||||||
</div>
|
<LI> particle insertion
|
||||||
|
</UL>
|
||||||
|
</HTML>
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
||||||
|
|
||||||
|
|
||||||
<a href="Section_errors.html" class="btn btn-neutral" title="12. Errors" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -1,167 +1,43 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_example.html">Previous Section</A> - <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> - <A HREF = "Section_tools.html">Next Section</A>
|
||||||
|
</CENTER>
|
||||||
|
|
||||||
|
|
||||||
<!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>8. Performance & scalability — 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"/>
|
|
||||||
<link rel="next" title="9. Additional tools" href="Section_tools.html"/>
|
|
||||||
<link rel="prev" title="7. Example problems" href="Section_example.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 class="current">
|
|
||||||
<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 current"><a class="current reference internal" href="">8. Performance & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>8. Performance & scalability
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P>LAMMPS performance on several prototypical benchmarks and machines is
|
||||||
<li>8. Performance & scalability</li>
|
discussed on the Benchmarks page of the <A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> where
|
||||||
<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="Section_tools.html" class="btn btn-neutral float-right" title="9. Additional tools" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
<a href="Section_example.html" class="btn btn-neutral" title="7. Example problems" 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="performance-scalability">
|
|
||||||
<h1>8. Performance & scalability<a class="headerlink" href="#performance-scalability" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>LAMMPS performance on several prototypical benchmarks and machines is
|
|
||||||
discussed on the Benchmarks page of the <a class="reference external" href="http://lammps.sandia.gov">LAMMPS WWW Site</a> where
|
|
||||||
CPU timings and parallel efficiencies are listed. Here, the
|
CPU timings and parallel efficiencies are listed. Here, the
|
||||||
benchmarks are described briefly and some useful rules of thumb about
|
benchmarks are described briefly and some useful rules of thumb about
|
||||||
their performance are highlighted.</p>
|
their performance are highlighted.
|
||||||
<p>These are the 5 benchmark problems:</p>
|
</P>
|
||||||
<ol class="arabic simple">
|
<P>These are the 5 benchmark problems:
|
||||||
<li>LJ = atomic fluid, Lennard-Jones potential with 2.5 sigma cutoff (55</li>
|
</P>
|
||||||
</ol>
|
<OL><LI>LJ = atomic fluid, Lennard-Jones potential with 2.5 sigma cutoff (55
|
||||||
<blockquote>
|
neighbors per atom), NVE integration
|
||||||
<div>neighbors per atom), NVE integration</div></blockquote>
|
|
||||||
<ol class="arabic simple">
|
<LI>Chain = bead-spring polymer melt of 100-mer chains, FENE bonds and LJ
|
||||||
<li>Chain = bead-spring polymer melt of 100-mer chains, FENE bonds and LJ
|
|
||||||
pairwise interactions with a 2^(1/6) sigma cutoff (5 neighbors per
|
pairwise interactions with a 2^(1/6) sigma cutoff (5 neighbors per
|
||||||
atom), NVE integration</li>
|
atom), NVE integration
|
||||||
<li>EAM = metallic solid, Cu EAM potential with 4.95 Angstrom cutoff (45
|
|
||||||
neighbors per atom), NVE integration</li>
|
<LI>EAM = metallic solid, Cu EAM potential with 4.95 Angstrom cutoff (45
|
||||||
<li>Chute = granular chute flow, frictional history potential with 1.1
|
neighbors per atom), NVE integration
|
||||||
sigma cutoff (7 neighbors per atom), NVE integration</li>
|
|
||||||
<li>Rhodo = rhodopsin protein in solvated lipid bilayer, CHARMM force
|
<LI>Chute = granular chute flow, frictional history potential with 1.1
|
||||||
|
sigma cutoff (7 neighbors per atom), NVE integration
|
||||||
|
|
||||||
|
<LI>Rhodo = rhodopsin protein in solvated lipid bilayer, CHARMM force
|
||||||
field with a 10 Angstrom LJ cutoff (440 neighbors per atom),
|
field with a 10 Angstrom LJ cutoff (440 neighbors per atom),
|
||||||
particle-particle particle-mesh (PPPM) for long-range Coulombics, NPT
|
particle-particle particle-mesh (PPPM) for long-range Coulombics, NPT
|
||||||
integration</li>
|
integration
|
||||||
</ol>
|
</OL>
|
||||||
<p>The input files for running the benchmarks are included in the LAMMPS
|
<P>The input files for running the benchmarks are included in the LAMMPS
|
||||||
distribution, as are sample output files. Each of the 5 problems has
|
distribution, as are sample output files. Each of the 5 problems has
|
||||||
32,000 atoms and runs for 100 timesteps. Each can be run as a serial
|
32,000 atoms and runs for 100 timesteps. Each can be run as a serial
|
||||||
benchmarks (on one processor) or in parallel. In parallel, each
|
benchmarks (on one processor) or in parallel. In parallel, each
|
||||||
@ -170,54 +46,30 @@ fixed-size benchmarking, the same 32K atom problem is run on various
|
|||||||
numbers of processors. For scaled-size benchmarking, the model size
|
numbers of processors. For scaled-size benchmarking, the model size
|
||||||
is increased with the number of processors. E.g. on 8 processors, a
|
is increased with the number of processors. E.g. on 8 processors, a
|
||||||
256K-atom problem is run; on 1024 processors, a 32-million atom
|
256K-atom problem is run; on 1024 processors, a 32-million atom
|
||||||
problem is run, etc.</p>
|
problem is run, etc.
|
||||||
<p>A useful metric from the benchmarks is the CPU cost per atom per
|
</P>
|
||||||
|
<P>A useful metric from the benchmarks is the CPU cost per atom per
|
||||||
timestep. Since LAMMPS performance scales roughly linearly with
|
timestep. Since LAMMPS performance scales roughly linearly with
|
||||||
problem size and timesteps, the run time of any problem using the same
|
problem size and timesteps, the run time of any problem using the same
|
||||||
model (atom style, force field, cutoff, etc) can then be estimated.
|
model (atom style, force field, cutoff, etc) can then be estimated.
|
||||||
For example, on a 1.7 GHz Pentium desktop machine (Intel icc compiler
|
For example, on a 1.7 GHz Pentium desktop machine (Intel icc compiler
|
||||||
under Red Hat Linux), the CPU run-time in seconds/atom/timestep for
|
under Red Hat Linux), the CPU run-time in seconds/atom/timestep for
|
||||||
the 5 problems is</p>
|
the 5 problems is
|
||||||
<table border="1" class="docutils">
|
</P>
|
||||||
<colgroup>
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
<col width="25%" />
|
<TR ALIGN="center"><TD ALIGN ="right">Problem:</TD><TD > LJ</TD><TD > Chain</TD><TD > EAM</TD><TD > Chute</TD><TD > Rhodopsin</TD></TR>
|
||||||
<col width="14%" />
|
<TR ALIGN="center"><TD ALIGN ="right">CPU/atom/step:</TD><TD > 4.55E-6</TD><TD > 2.18E-6</TD><TD > 9.38E-6</TD><TD > 2.18E-6</TD><TD > 1.11E-4</TD></TR>
|
||||||
<col width="14%" />
|
<TR ALIGN="center"><TD ALIGN ="right">Ratio to LJ:</TD><TD > 1.0</TD><TD > 0.48</TD><TD > 2.06</TD><TD > 0.48</TD><TD > 24.5
|
||||||
<col width="14%" />
|
</TD></TR></TABLE></DIV>
|
||||||
<col width="14%" />
|
|
||||||
<col width="17%" />
|
<P>The ratios mean that if the atomic LJ system has a normalized cost of
|
||||||
</colgroup>
|
|
||||||
<tbody valign="top">
|
|
||||||
<tr class="row-odd"><td>Problem:</td>
|
|
||||||
<td>LJ</td>
|
|
||||||
<td>Chain</td>
|
|
||||||
<td>EAM</td>
|
|
||||||
<td>Chute</td>
|
|
||||||
<td>Rhodopsin</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td>CPU/atom/step:</td>
|
|
||||||
<td>4.55E-6</td>
|
|
||||||
<td>2.18E-6</td>
|
|
||||||
<td>9.38E-6</td>
|
|
||||||
<td>2.18E-6</td>
|
|
||||||
<td>1.11E-4</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>Ratio to LJ:</td>
|
|
||||||
<td>1.0</td>
|
|
||||||
<td>0.48</td>
|
|
||||||
<td>2.06</td>
|
|
||||||
<td>0.48</td>
|
|
||||||
<td>24.5</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>The ratios mean that if the atomic LJ system has a normalized cost of
|
|
||||||
1.0, the bead-spring chains and granular systems run 2x faster, while
|
1.0, the bead-spring chains and granular systems run 2x faster, while
|
||||||
the EAM metal and solvated protein models run 2x and 25x slower
|
the EAM metal and solvated protein models run 2x and 25x slower
|
||||||
respectively. The bulk of these cost differences is due to the
|
respectively. The bulk of these cost differences is due to the
|
||||||
expense of computing a particular pairwise force field for a given
|
expense of computing a particular pairwise force field for a given
|
||||||
number of neighbors per atom.</p>
|
number of neighbors per atom.
|
||||||
<p>Performance on a parallel machine can also be predicted from the
|
</P>
|
||||||
|
<P>Performance on a parallel machine can also be predicted from the
|
||||||
one-processor timings if the parallel efficiency can be estimated.
|
one-processor timings if the parallel efficiency can be estimated.
|
||||||
The communication bandwidth and latency of a particular parallel
|
The communication bandwidth and latency of a particular parallel
|
||||||
machine affects the efficiency. On most machines LAMMPS will give
|
machine affects the efficiency. On most machines LAMMPS will give
|
||||||
@ -225,80 +77,8 @@ fixed-size parallel efficiencies on these benchmarks above 50% so long
|
|||||||
as the atoms/processor count is a few 100 or greater - i.e. on 64 to
|
as the atoms/processor count is a few 100 or greater - i.e. on 64 to
|
||||||
128 processors. Likewise, scaled-size parallel efficiencies will
|
128 processors. Likewise, scaled-size parallel efficiencies will
|
||||||
typically be 80% or greater up to very large processor counts. The
|
typically be 80% or greater up to very large processor counts. The
|
||||||
benchmark data on the <a class="reference external" href="http://lammps.sandia.gov">LAMMPS WWW Site</a> gives specific examples on
|
benchmark data on the <A HREF = "http://lammps.sandia.gov">LAMMPS WWW Site</A> gives specific examples on
|
||||||
some different machines, including a run of 3/4 of a billion LJ atoms
|
some different machines, including a run of 3/4 of a billion LJ atoms
|
||||||
on 1500 processors that ran at 85% parallel efficiency.</p>
|
on 1500 processors that ran at 85% parallel efficiency.
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
|
|
||||||
|
|
||||||
<a href="Section_tools.html" class="btn btn-neutral float-right" title="9. Additional tools" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
|
|
||||||
|
|
||||||
|
|
||||||
<a href="Section_example.html" class="btn btn-neutral" title="7. Example problems" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -1,372 +1,228 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_packages.html">Previous Section</A> - <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>
|
||||||
|
|
||||||
|
|
||||||
<!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>5.USER-CUDA package — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<P><A HREF = "Section_accelerate.html">Return to Section accelerate overview</A>
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</P>
|
||||||
|
<H4>5.3.1 USER-CUDA package
|
||||||
<li>5.USER-CUDA package</li>
|
</H4>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P>The USER-CUDA package was developed by Christian Trott (Sandia) while
|
||||||
|
|
||||||
|
|
||||||
<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">
|
|
||||||
|
|
||||||
<p><a class="reference internal" href="Section_accelerate.html"><em>Return to Section accelerate overview</em></a></p>
|
|
||||||
<div class="section" id="user-cuda-package">
|
|
||||||
<h1>5.USER-CUDA package<a class="headerlink" href="#user-cuda-package" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>The USER-CUDA package was developed by Christian Trott (Sandia) while
|
|
||||||
at U Technology Ilmenau in Germany. It provides NVIDIA GPU versions
|
at U Technology Ilmenau in Germany. It provides NVIDIA GPU versions
|
||||||
of many pair styles, many fixes, a few computes, and for long-range
|
of many pair styles, many fixes, a few computes, and for long-range
|
||||||
Coulombics via the PPPM command. It has the following general
|
Coulombics via the PPPM command. It has the following general
|
||||||
features:</p>
|
features:
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>The package is designed to allow an entire LAMMPS calculation, for
|
<UL><LI>The package is designed to allow an entire LAMMPS calculation, for
|
||||||
many timesteps, to run entirely on the GPU (except for inter-processor
|
many timesteps, to run entirely on the GPU (except for inter-processor
|
||||||
MPI communication), so that atom-based data (e.g. coordinates, forces)
|
MPI communication), so that atom-based data (e.g. coordinates, forces)
|
||||||
do not have to move back-and-forth between the CPU and GPU.</li>
|
do not have to move back-and-forth between the CPU and GPU.
|
||||||
<li>The speed-up advantage of this approach is typically better when the
|
|
||||||
number of atoms per GPU is large</li>
|
<LI>The speed-up advantage of this approach is typically better when the
|
||||||
<li>Data will stay on the GPU until a timestep where a non-USER-CUDA fix
|
number of atoms per GPU is large
|
||||||
|
|
||||||
|
<LI>Data will stay on the GPU until a timestep where a non-USER-CUDA fix
|
||||||
or compute is invoked. Whenever a non-GPU operation occurs (fix,
|
or compute is invoked. Whenever a non-GPU operation occurs (fix,
|
||||||
compute, output), data automatically moves back to the CPU as needed.
|
compute, output), data automatically moves back to the CPU as needed.
|
||||||
This may incur a performance penalty, but should otherwise work
|
This may incur a performance penalty, but should otherwise work
|
||||||
transparently.</li>
|
transparently.
|
||||||
<li>Neighbor lists are constructed on the GPU.</li>
|
|
||||||
<li>The package only supports use of a single MPI task, running on a
|
<LI>Neighbor lists are constructed on the GPU.
|
||||||
single CPU (core), assigned to each GPU.</li>
|
|
||||||
</ul>
|
<LI>The package only supports use of a single MPI task, running on a
|
||||||
<p>Here is a quick overview of how to use the USER-CUDA package:</p>
|
single CPU (core), assigned to each GPU.
|
||||||
<ul class="simple">
|
</UL>
|
||||||
<li>build the library in lib/cuda for your GPU hardware with desired precision</li>
|
<P>Here is a quick overview of how to use the USER-CUDA package:
|
||||||
<li>include the USER-CUDA package and build LAMMPS</li>
|
</P>
|
||||||
<li>use the mpirun command to specify 1 MPI task per GPU (on each node)</li>
|
<UL><LI>build the library in lib/cuda for your GPU hardware with desired precision
|
||||||
<li>enable the USER-CUDA package via the “-c on” command-line switch</li>
|
<LI>include the USER-CUDA package and build LAMMPS
|
||||||
<li>specify the # of GPUs per node</li>
|
<LI>use the mpirun command to specify 1 MPI task per GPU (on each node)
|
||||||
<li>use USER-CUDA styles in your input script</li>
|
<LI>enable the USER-CUDA package via the "-c on" command-line switch
|
||||||
</ul>
|
<LI>specify the # of GPUs per node
|
||||||
<p>The latter two steps can be done using the “-pk cuda” and “-sf cuda”
|
<LI>use USER-CUDA styles in your input script
|
||||||
<a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> respectively. Or
|
</UL>
|
||||||
the effect of the “-pk” or “-sf” switches can be duplicated by adding
|
<P>The latter two steps can be done using the "-pk cuda" and "-sf cuda"
|
||||||
the <a class="reference internal" href="package.html"><em>package cuda</em></a> or <a class="reference internal" href="suffix.html"><em>suffix cuda</em></a> commands
|
<A HREF = "Section_start.html#start_7">command-line switches</A> respectively. Or
|
||||||
respectively to your input script.</p>
|
the effect of the "-pk" or "-sf" switches can be duplicated by adding
|
||||||
<p><strong>Required hardware/software:</strong></p>
|
the <A HREF = "package.html">package cuda</A> or <A HREF = "suffix.html">suffix cuda</A> commands
|
||||||
<p>To use this package, you need to have one or more NVIDIA GPUs and
|
respectively to your input script.
|
||||||
install the NVIDIA Cuda software on your system:</p>
|
</P>
|
||||||
<p>Your NVIDIA GPU needs to support Compute Capability 1.3. This list may
|
<P><B>Required hardware/software:</B>
|
||||||
help you to find out the Compute Capability of your card:</p>
|
</P>
|
||||||
<p><a class="reference external" href="http://en.wikipedia.org/wiki/Comparison_of_Nvidia_graphics_processing_units">http://en.wikipedia.org/wiki/Comparison_of_Nvidia_graphics_processing_units</a></p>
|
<P>To use this package, you need to have one or more NVIDIA GPUs and
|
||||||
<p>Install the Nvidia Cuda Toolkit (version 3.2 or higher) and the
|
install the NVIDIA Cuda software on your system:
|
||||||
|
</P>
|
||||||
|
<P>Your NVIDIA GPU needs to support Compute Capability 1.3. This list may
|
||||||
|
help you to find out the Compute Capability of your card:
|
||||||
|
</P>
|
||||||
|
<P>http://en.wikipedia.org/wiki/Comparison_of_Nvidia_graphics_processing_units
|
||||||
|
</P>
|
||||||
|
<P>Install the Nvidia Cuda Toolkit (version 3.2 or higher) and the
|
||||||
corresponding GPU drivers. The Nvidia Cuda SDK is not required, but
|
corresponding GPU drivers. The Nvidia Cuda SDK is not required, but
|
||||||
we recommend it also be installed. You can then make sure its sample
|
we recommend it also be installed. You can then make sure its sample
|
||||||
projects can be compiled without problems.</p>
|
projects can be compiled without problems.
|
||||||
<p><strong>Building LAMMPS with the USER-CUDA package:</strong></p>
|
</P>
|
||||||
<p>This requires two steps (a,b): build the USER-CUDA library, then build
|
<P><B>Building LAMMPS with the USER-CUDA package:</B>
|
||||||
LAMMPS with the USER-CUDA package.</p>
|
</P>
|
||||||
<p>You can do both these steps in one line, using the src/Make.py script,
|
<P>This requires two steps (a,b): build the USER-CUDA library, then build
|
||||||
described in <a class="reference internal" href="Section_start.html#start-4"><span>Section 2.4</span></a> of the manual.
|
LAMMPS with the USER-CUDA package.
|
||||||
Type “Make.py -h” for help. If run from the src directory, this
|
</P>
|
||||||
|
<P>You can do both these steps in one line, using the src/Make.py script,
|
||||||
|
described in <A HREF = "Section_start.html#start_4">Section 2.4</A> of the manual.
|
||||||
|
Type "Make.py -h" for help. If run from the src directory, this
|
||||||
command will create src/lmp_cuda using src/MAKE/Makefile.mpi as the
|
command will create src/lmp_cuda using src/MAKE/Makefile.mpi as the
|
||||||
starting Makefile.machine:</p>
|
starting Makefile.machine:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Make.py -p cuda -cuda mode=single arch=20 -o cuda lib-cuda file mpi
|
</P>
|
||||||
</pre></div>
|
<PRE>Make.py -p cuda -cuda mode=single arch=20 -o cuda lib-cuda file mpi
|
||||||
</div>
|
</PRE>
|
||||||
<p>Or you can follow these two (a,b) steps:</p>
|
<P>Or you can follow these two (a,b) steps:
|
||||||
<ol class="loweralpha simple">
|
</P>
|
||||||
<li>Build the USER-CUDA library</li>
|
<P>(a) Build the USER-CUDA library
|
||||||
</ol>
|
</P>
|
||||||
<p>The USER-CUDA library is in lammps/lib/cuda. If your <em>CUDA</em> toolkit
|
<P>The USER-CUDA library is in lammps/lib/cuda. If your <I>CUDA</I> toolkit
|
||||||
is not installed in the default system directoy <em>/usr/local/cuda</em> edit
|
is not installed in the default system directoy <I>/usr/local/cuda</I> edit
|
||||||
the file <em>lib/cuda/Makefile.common</em> accordingly.</p>
|
the file <I>lib/cuda/Makefile.common</I> accordingly.
|
||||||
<p>To build the library with the settings in lib/cuda/Makefile.default,
|
</P>
|
||||||
simply type:</p>
|
<P>To build the library with the settings in lib/cuda/Makefile.default,
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="n">make</span>
|
simply type:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>make
|
||||||
<p>To set options when the library is built, type “make OPTIONS”, where
|
</PRE>
|
||||||
<em>OPTIONS</em> are one or more of the following. The settings will be
|
<P>To set options when the library is built, type "make OPTIONS", where
|
||||||
written to the <em>lib/cuda/Makefile.defaults</em> before the build.</p>
|
<I>OPTIONS</I> are one or more of the following. The settings will be
|
||||||
<pre class="literal-block">
|
written to the <I>lib/cuda/Makefile.defaults</I> before the build.
|
||||||
<em>precision=N</em> to set the precision level
|
</P>
|
||||||
|
<PRE><I>precision=N</I> to set the precision level
|
||||||
N = 1 for single precision (default)
|
N = 1 for single precision (default)
|
||||||
N = 2 for double precision
|
N = 2 for double precision
|
||||||
N = 3 for positions in double precision
|
N = 3 for positions in double precision
|
||||||
N = 4 for positions and velocities in double precision
|
N = 4 for positions and velocities in double precision
|
||||||
<em>arch=M</em> to set GPU compute capability
|
<I>arch=M</I> to set GPU compute capability
|
||||||
M = 35 for Kepler GPUs
|
M = 35 for Kepler GPUs
|
||||||
M = 20 for CC2.0 (GF100/110, e.g. C2050,GTX580,GTX470) (default)
|
M = 20 for CC2.0 (GF100/110, e.g. C2050,GTX580,GTX470) (default)
|
||||||
M = 21 for CC2.1 (GF104/114, e.g. GTX560, GTX460, GTX450)
|
M = 21 for CC2.1 (GF104/114, e.g. GTX560, GTX460, GTX450)
|
||||||
M = 13 for CC1.3 (GF200, e.g. C1060, GTX285)
|
M = 13 for CC1.3 (GF200, e.g. C1060, GTX285)
|
||||||
<em>prec_timer=0/1</em> to use hi-precision timers
|
<I>prec_timer=0/1</I> to use hi-precision timers
|
||||||
0 = do not use them (default)
|
0 = do not use them (default)
|
||||||
1 = use them
|
1 = use them
|
||||||
this is usually only useful for Mac machines
|
this is usually only useful for Mac machines
|
||||||
<em>dbg=0/1</em> to activate debug mode
|
<I>dbg=0/1</I> to activate debug mode
|
||||||
0 = no debug mode (default)
|
0 = no debug mode (default)
|
||||||
1 = yes debug mode
|
1 = yes debug mode
|
||||||
this is only useful for developers
|
this is only useful for developers
|
||||||
<em>cufft=1</em> for use of the CUDA FFT library
|
<I>cufft=1</I> for use of the CUDA FFT library
|
||||||
0 = no CUFFT support (default)
|
0 = no CUFFT support (default)
|
||||||
in the future other CUDA-enabled FFT libraries might be supported
|
in the future other CUDA-enabled FFT libraries might be supported
|
||||||
</pre>
|
</PRE>
|
||||||
<p>If the build is successful, it will produce the files liblammpscuda.a and
|
<P>If the build is successful, it will produce the files liblammpscuda.a and
|
||||||
Makefile.lammps.</p>
|
Makefile.lammps.
|
||||||
<p>Note that if you change any of the options (like precision), you need
|
</P>
|
||||||
to re-build the entire library. Do a “make clean” first, followed by
|
<P>Note that if you change any of the options (like precision), you need
|
||||||
“make”.</p>
|
to re-build the entire library. Do a "make clean" first, followed by
|
||||||
<ol class="loweralpha simple" start="2">
|
"make".
|
||||||
<li>Build LAMMPS with the USER-CUDA package</li>
|
</P>
|
||||||
</ol>
|
<P>(b) Build LAMMPS with the USER-CUDA package
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
</P>
|
||||||
|
<PRE>cd lammps/src
|
||||||
make yes-user-cuda
|
make yes-user-cuda
|
||||||
make machine
|
make machine
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>No additional compile/link flags are needed in Makefile.machine.
|
||||||
<p>No additional compile/link flags are needed in Makefile.machine.</p>
|
</P>
|
||||||
<p>Note that if you change the USER-CUDA library precision (discussed
|
<P>Note that if you change the USER-CUDA library precision (discussed
|
||||||
above) and rebuild the USER-CUDA library, then you also need to
|
above) and rebuild the USER-CUDA library, then you also need to
|
||||||
re-install the USER-CUDA package and re-build LAMMPS, so that all
|
re-install the USER-CUDA package and re-build LAMMPS, so that all
|
||||||
affected files are re-compiled and linked to the new USER-CUDA
|
affected files are re-compiled and linked to the new USER-CUDA
|
||||||
library.</p>
|
library.
|
||||||
<p><strong>Run with the USER-CUDA package from the command line:</strong></p>
|
</P>
|
||||||
<p>The mpirun or mpiexec command sets the total number of MPI tasks used
|
<P><B>Run with the USER-CUDA package from the command line:</B>
|
||||||
|
</P>
|
||||||
|
<P>The mpirun or mpiexec command sets the total number of MPI tasks used
|
||||||
by LAMMPS (one or multiple per compute node) and the number of MPI
|
by LAMMPS (one or multiple per compute node) and the number of MPI
|
||||||
tasks used per node. E.g. the mpirun command in MPICH does this via
|
tasks used per node. E.g. the mpirun command in MPICH does this via
|
||||||
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.</p>
|
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.
|
||||||
<p>When using the USER-CUDA package, you must use exactly one MPI task
|
</P>
|
||||||
per physical GPU.</p>
|
<P>When using the USER-CUDA package, you must use exactly one MPI task
|
||||||
<p>You must use the “-c on” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to enable the USER-CUDA package.
|
per physical GPU.
|
||||||
The “-c on” switch also issues a default <a class="reference internal" href="package.html"><em>package cuda 1</em></a>
|
</P>
|
||||||
|
<P>You must use the "-c on" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switch</A> to enable the USER-CUDA package.
|
||||||
|
The "-c on" switch also issues a default <A HREF = "package.html">package cuda 1</A>
|
||||||
command which sets various USER-CUDA options to default values, as
|
command which sets various USER-CUDA options to default values, as
|
||||||
discussed on the <a class="reference internal" href="package.html"><em>package</em></a> command doc page.</p>
|
discussed on the <A HREF = "package.html">package</A> command doc page.
|
||||||
<p>Use the “-sf cuda” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>,
|
</P>
|
||||||
which will automatically append “cuda” to styles that support it. Use
|
<P>Use the "-sf cuda" <A HREF = "Section_start.html#start_7">command-line switch</A>,
|
||||||
the “-pk cuda Ng” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to
|
which will automatically append "cuda" to styles that support it. Use
|
||||||
|
the "-pk cuda Ng" <A HREF = "Section_start.html#start_7">command-line switch</A> to
|
||||||
set Ng = # of GPUs per node to a different value than the default set
|
set Ng = # of GPUs per node to a different value than the default set
|
||||||
by the “-c on” switch (1 GPU) or change other <a class="reference internal" href="package.html"><em>package cuda</em></a> options.</p>
|
by the "-c on" switch (1 GPU) or change other <A HREF = "package.html">package
|
||||||
<div class="highlight-python"><div class="highlight"><pre>lmp_machine -c on -sf cuda -pk cuda 1 -in in.script # 1 MPI task uses 1 GPU
|
cuda</A> options.
|
||||||
|
</P>
|
||||||
|
<PRE>lmp_machine -c on -sf cuda -pk cuda 1 -in in.script # 1 MPI task uses 1 GPU
|
||||||
mpirun -np 2 lmp_machine -c on -sf cuda -pk cuda 2 -in in.script # 2 MPI tasks use 2 GPUs on a single 16-core (or whatever) node
|
mpirun -np 2 lmp_machine -c on -sf cuda -pk cuda 2 -in in.script # 2 MPI tasks use 2 GPUs on a single 16-core (or whatever) node
|
||||||
mpirun -np 24 -ppn 2 lmp_machine -c on -sf cuda -pk cuda 2 -in in.script # ditto on 12 16-core nodes
|
mpirun -np 24 -ppn 2 lmp_machine -c on -sf cuda -pk cuda 2 -in in.script # ditto on 12 16-core nodes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>The syntax for the "-pk" switch is the same as same as the "package
|
||||||
<p>The syntax for the “-pk” switch is the same as same as the “package
|
cuda" command. See the <A HREF = "package.html">package</A> command doc page for
|
||||||
cuda” command. See the <a class="reference internal" href="package.html"><em>package</em></a> command doc page for
|
|
||||||
details, including the default values used for all its options if it
|
details, including the default values used for all its options if it
|
||||||
is not specified.</p>
|
is not specified.
|
||||||
<p>Note that the default for the <a class="reference internal" href="package.html"><em>package cuda</em></a> command is
|
</P>
|
||||||
to set the Newton flag to “off” for both pairwise and bonded
|
<P>Note that the default for the <A HREF = "package.html">package cuda</A> command is
|
||||||
|
to set the Newton flag to "off" for both pairwise and bonded
|
||||||
interactions. This typically gives fastest performance. If the
|
interactions. This typically gives fastest performance. If the
|
||||||
<a class="reference internal" href="newton.html"><em>newton</em></a> command is used in the input script, it can
|
<A HREF = "newton.html">newton</A> command is used in the input script, it can
|
||||||
override these defaults.</p>
|
override these defaults.
|
||||||
<p><strong>Or run with the USER-CUDA package by editing an input script:</strong></p>
|
</P>
|
||||||
<p>The discussion above for the mpirun/mpiexec command and the requirement
|
<P><B>Or run with the USER-CUDA package by editing an input script:</B>
|
||||||
of one MPI task per GPU is the same.</p>
|
</P>
|
||||||
<p>You must still use the “-c on” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to enable the USER-CUDA package.</p>
|
<P>The discussion above for the mpirun/mpiexec command and the requirement
|
||||||
<p>Use the <a class="reference internal" href="suffix.html"><em>suffix cuda</em></a> command, or you can explicitly add a
|
of one MPI task per GPU is the same.
|
||||||
“cuda” suffix to individual styles in your input script, e.g.</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>pair_style lj/cut/cuda 2.5
|
<P>You must still use the "-c on" <A HREF = "Section_start.html#start_7">command-line
|
||||||
</pre></div>
|
switch</A> to enable the USER-CUDA package.
|
||||||
</div>
|
</P>
|
||||||
<p>You only need to use the <a class="reference internal" href="package.html"><em>package cuda</em></a> command if you
|
<P>Use the <A HREF = "suffix.html">suffix cuda</A> command, or you can explicitly add a
|
||||||
|
"cuda" suffix to individual styles in your input script, e.g.
|
||||||
|
</P>
|
||||||
|
<PRE>pair_style lj/cut/cuda 2.5
|
||||||
|
</PRE>
|
||||||
|
<P>You only need to use the <A HREF = "package.html">package cuda</A> command if you
|
||||||
wish to change any of its option defaults, including the number of
|
wish to change any of its option defaults, including the number of
|
||||||
GPUs/node (default = 1), as set by the “-c on” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>.</p>
|
GPUs/node (default = 1), as set by the "-c on" <A HREF = "Section_start.html#start_7">command-line
|
||||||
<p><strong>Speed-ups to expect:</strong></p>
|
switch</A>.
|
||||||
<p>The performance of a GPU versus a multi-core CPU is a function of your
|
</P>
|
||||||
|
<P><B>Speed-ups to expect:</B>
|
||||||
|
</P>
|
||||||
|
<P>The performance of a GPU versus a multi-core CPU is a function of your
|
||||||
hardware, which pair style is used, the number of atoms/GPU, and the
|
hardware, which pair style is used, the number of atoms/GPU, and the
|
||||||
precision used on the GPU (double, single, mixed).</p>
|
precision used on the GPU (double, single, mixed).
|
||||||
<p>See the <a class="reference external" href="http://lammps.sandia.gov/bench.html">Benchmark page</a> of the
|
</P>
|
||||||
|
<P>See the <A HREF = "http://lammps.sandia.gov/bench.html">Benchmark page</A> of the
|
||||||
LAMMPS web site for performance of the USER-CUDA package on different
|
LAMMPS web site for performance of the USER-CUDA package on different
|
||||||
hardware.</p>
|
hardware.
|
||||||
<p><strong>Guidelines for best performance:</strong></p>
|
</P>
|
||||||
<ul class="simple">
|
<P><B>Guidelines for best performance:</B>
|
||||||
<li>The USER-CUDA package offers more speed-up relative to CPU performance
|
</P>
|
||||||
|
<UL><LI>The USER-CUDA package offers more speed-up relative to CPU performance
|
||||||
when the number of atoms per GPU is large, e.g. on the order of tens
|
when the number of atoms per GPU is large, e.g. on the order of tens
|
||||||
or hundreds of 1000s.</li>
|
or hundreds of 1000s.
|
||||||
<li>As noted above, this package will continue to run a simulation
|
|
||||||
|
<LI>As noted above, this package will continue to run a simulation
|
||||||
entirely on the GPU(s) (except for inter-processor MPI communication),
|
entirely on the GPU(s) (except for inter-processor MPI communication),
|
||||||
for multiple timesteps, until a CPU calculation is required, either by
|
for multiple timesteps, until a CPU calculation is required, either by
|
||||||
a fix or compute that is non-GPU-ized, or until output is performed
|
a fix or compute that is non-GPU-ized, or until output is performed
|
||||||
(thermo or dump snapshot or restart file). The less often this
|
(thermo or dump snapshot or restart file). The less often this
|
||||||
occurs, the faster your simulation will run.</li>
|
occurs, the faster your simulation will run.
|
||||||
</ul>
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>None.</p>
|
<P>None.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,401 +1,257 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_packages.html">Previous Section</A> - <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>
|
||||||
|
|
||||||
|
|
||||||
<!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>5.GPU package — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<P><A HREF = "Section_accelerate.html">Return to Section accelerate overview</A>
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</P>
|
||||||
|
<H4>5.3.2 GPU package
|
||||||
<li>5.GPU package</li>
|
</H4>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P>The GPU package was developed by Mike Brown at ORNL and his
|
||||||
|
|
||||||
|
|
||||||
<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">
|
|
||||||
|
|
||||||
<p><a class="reference internal" href="Section_accelerate.html"><em>Return to Section accelerate overview</em></a></p>
|
|
||||||
<div class="section" id="gpu-package">
|
|
||||||
<h1>5.GPU package<a class="headerlink" href="#gpu-package" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>The GPU package was developed by Mike Brown at ORNL and his
|
|
||||||
collaborators, particularly Trung Nguyen (ORNL). It provides GPU
|
collaborators, particularly Trung Nguyen (ORNL). It provides GPU
|
||||||
versions of many pair styles, including the 3-body Stillinger-Weber
|
versions of many pair styles, including the 3-body Stillinger-Weber
|
||||||
pair style, and for <a class="reference internal" href="kspace_style.html"><em>kspace_style pppm</em></a> for
|
pair style, and for <A HREF = "kspace_style.html">kspace_style pppm</A> for
|
||||||
long-range Coulombics. It has the following general features:</p>
|
long-range Coulombics. It has the following general features:
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>It is designed to exploit common GPU hardware configurations where one
|
<UL><LI>It is designed to exploit common GPU hardware configurations where one
|
||||||
or more GPUs are coupled to many cores of one or more multi-core CPUs,
|
or more GPUs are coupled to many cores of one or more multi-core CPUs,
|
||||||
e.g. within a node of a parallel machine.</li>
|
e.g. within a node of a parallel machine.
|
||||||
<li>Atom-based data (e.g. coordinates, forces) moves back-and-forth
|
|
||||||
between the CPU(s) and GPU every timestep.</li>
|
<LI>Atom-based data (e.g. coordinates, forces) moves back-and-forth
|
||||||
<li>Neighbor lists can be built on the CPU or on the GPU</li>
|
between the CPU(s) and GPU every timestep.
|
||||||
<li>The charge assignement and force interpolation portions of PPPM can be
|
|
||||||
|
<LI>Neighbor lists can be built on the CPU or on the GPU
|
||||||
|
|
||||||
|
<LI>The charge assignement and force interpolation portions of PPPM can be
|
||||||
run on the GPU. The FFT portion, which requires MPI communication
|
run on the GPU. The FFT portion, which requires MPI communication
|
||||||
between processors, runs on the CPU.</li>
|
between processors, runs on the CPU.
|
||||||
<li>Asynchronous force computations can be performed simultaneously on the
|
|
||||||
CPU(s) and GPU.</li>
|
<LI>Asynchronous force computations can be performed simultaneously on the
|
||||||
<li>It allows for GPU computations to be performed in single or double
|
CPU(s) and GPU.
|
||||||
|
|
||||||
|
<LI>It allows for GPU computations to be performed in single or double
|
||||||
precision, or in mixed-mode precision, where pairwise forces are
|
precision, or in mixed-mode precision, where pairwise forces are
|
||||||
computed in single precision, but accumulated into double-precision
|
computed in single precision, but accumulated into double-precision
|
||||||
force vectors.</li>
|
force vectors.
|
||||||
<li>LAMMPS-specific code is in the GPU package. It makes calls to a
|
|
||||||
|
<LI>LAMMPS-specific code is in the GPU package. It makes calls to a
|
||||||
generic GPU library in the lib/gpu directory. This library provides
|
generic GPU library in the lib/gpu directory. This library provides
|
||||||
NVIDIA support as well as more general OpenCL support, so that the
|
NVIDIA support as well as more general OpenCL support, so that the
|
||||||
same functionality can eventually be supported on a variety of GPU
|
same functionality can eventually be supported on a variety of GPU
|
||||||
hardware.</li>
|
hardware.
|
||||||
</ul>
|
</UL>
|
||||||
<p>Here is a quick overview of how to use the GPU package:</p>
|
<P>Here is a quick overview of how to use the GPU package:
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>build the library in lib/gpu for your GPU hardware wity desired precision</li>
|
<UL><LI>build the library in lib/gpu for your GPU hardware wity desired precision
|
||||||
<li>include the GPU package and build LAMMPS</li>
|
<LI>include the GPU package and build LAMMPS
|
||||||
<li>use the mpirun command to set the number of MPI tasks/node which determines the number of MPI tasks/GPU</li>
|
<LI>use the mpirun command to set the number of MPI tasks/node which determines the number of MPI tasks/GPU
|
||||||
<li>specify the # of GPUs per node</li>
|
<LI>specify the # of GPUs per node
|
||||||
<li>use GPU styles in your input script</li>
|
<LI>use GPU styles in your input script
|
||||||
</ul>
|
</UL>
|
||||||
<p>The latter two steps can be done using the “-pk gpu” and “-sf gpu”
|
<P>The latter two steps can be done using the "-pk gpu" and "-sf gpu"
|
||||||
<a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> respectively. Or
|
<A HREF = "Section_start.html#start_7">command-line switches</A> respectively. Or
|
||||||
the effect of the “-pk” or “-sf” switches can be duplicated by adding
|
the effect of the "-pk" or "-sf" switches can be duplicated by adding
|
||||||
the <a class="reference internal" href="package.html"><em>package gpu</em></a> or <a class="reference internal" href="suffix.html"><em>suffix gpu</em></a> commands
|
the <A HREF = "package.html">package gpu</A> or <A HREF = "suffix.html">suffix gpu</A> commands
|
||||||
respectively to your input script.</p>
|
respectively to your input script.
|
||||||
<p><strong>Required hardware/software:</strong></p>
|
</P>
|
||||||
<p>To use this package, you currently need to have an NVIDIA GPU and
|
<P><B>Required hardware/software:</B>
|
||||||
install the NVIDIA Cuda software on your system:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>To use this package, you currently need to have an NVIDIA GPU and
|
||||||
<li>Check if you have an NVIDIA GPU: cat /proc/driver/nvidia/gpus/0/information</li>
|
install the NVIDIA Cuda software on your system:
|
||||||
<li>Go to <a class="reference external" href="http://www.nvidia.com/object/cuda_get.html">http://www.nvidia.com/object/cuda_get.html</a></li>
|
</P>
|
||||||
<li>Install a driver and toolkit appropriate for your system (SDK is not necessary)</li>
|
<UL><LI>Check if you have an NVIDIA GPU: cat /proc/driver/nvidia/gpus/0/information
|
||||||
<li>Run lammps/lib/gpu/nvc_get_devices (after building the GPU library, see below) to list supported devices and properties</li>
|
<LI>Go to http://www.nvidia.com/object/cuda_get.html
|
||||||
</ul>
|
<LI>Install a driver and toolkit appropriate for your system (SDK is not necessary)
|
||||||
<p><strong>Building LAMMPS with the GPU package:</strong></p>
|
<LI>Run lammps/lib/gpu/nvc_get_devices (after building the GPU library, see below) to list supported devices and properties
|
||||||
<p>This requires two steps (a,b): build the GPU library, then build
|
</UL>
|
||||||
LAMMPS with the GPU package.</p>
|
<P><B>Building LAMMPS with the GPU package:</B>
|
||||||
<p>You can do both these steps in one line, using the src/Make.py script,
|
</P>
|
||||||
described in <a class="reference internal" href="Section_start.html#start-4"><span>Section 2.4</span></a> of the manual.
|
<P>This requires two steps (a,b): build the GPU library, then build
|
||||||
Type “Make.py -h” for help. If run from the src directory, this
|
LAMMPS with the GPU package.
|
||||||
|
</P>
|
||||||
|
<P>You can do both these steps in one line, using the src/Make.py script,
|
||||||
|
described in <A HREF = "Section_start.html#start_4">Section 2.4</A> of the manual.
|
||||||
|
Type "Make.py -h" for help. If run from the src directory, this
|
||||||
command will create src/lmp_gpu using src/MAKE/Makefile.mpi as the
|
command will create src/lmp_gpu using src/MAKE/Makefile.mpi as the
|
||||||
starting Makefile.machine:</p>
|
starting Makefile.machine:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Make.py -p gpu -gpu mode=single arch=31 -o gpu lib-gpu file mpi
|
</P>
|
||||||
</pre></div>
|
<PRE>Make.py -p gpu -gpu mode=single arch=31 -o gpu lib-gpu file mpi
|
||||||
</div>
|
</PRE>
|
||||||
<p>Or you can follow these two (a,b) steps:</p>
|
<P>Or you can follow these two (a,b) steps:
|
||||||
<ol class="loweralpha simple">
|
</P>
|
||||||
<li>Build the GPU library</li>
|
<P>(a) Build the GPU library
|
||||||
</ol>
|
</P>
|
||||||
<p>The GPU library is in lammps/lib/gpu. Select a Makefile.machine (in
|
<P>The GPU library is in lammps/lib/gpu. Select a Makefile.machine (in
|
||||||
lib/gpu) appropriate for your system. You should pay special
|
lib/gpu) appropriate for your system. You should pay special
|
||||||
attention to 3 settings in this makefile.</p>
|
attention to 3 settings in this makefile.
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>CUDA_HOME = needs to be where NVIDIA Cuda software is installed on your system</li>
|
<UL><LI>CUDA_HOME = needs to be where NVIDIA Cuda software is installed on your system
|
||||||
<li>CUDA_ARCH = needs to be appropriate to your GPUs</li>
|
<LI>CUDA_ARCH = needs to be appropriate to your GPUs
|
||||||
<li>CUDA_PREC = precision (double, mixed, single) you desire</li>
|
<LI>CUDA_PREC = precision (double, mixed, single) you desire
|
||||||
</ul>
|
</UL>
|
||||||
<p>See lib/gpu/Makefile.linux.double for examples of the ARCH settings
|
<P>See lib/gpu/Makefile.linux.double for examples of the ARCH settings
|
||||||
for different GPU choices, e.g. Fermi vs Kepler. It also lists the
|
for different GPU choices, e.g. Fermi vs Kepler. It also lists the
|
||||||
possible precision settings:</p>
|
possible precision settings:
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="n">CUDA_PREC</span> <span class="o">=</span> <span class="o">-</span><span class="n">D_SINGLE_SINGLE</span> <span class="c"># single precision for all calculations</span>
|
</P>
|
||||||
<span class="n">CUDA_PREC</span> <span class="o">=</span> <span class="o">-</span><span class="n">D_DOUBLE_DOUBLE</span> <span class="c"># double precision for all calculations</span>
|
<PRE>CUDA_PREC = -D_SINGLE_SINGLE # single precision for all calculations
|
||||||
<span class="n">CUDA_PREC</span> <span class="o">=</span> <span class="o">-</span><span class="n">D_SINGLE_DOUBLE</span> <span class="c"># accumulation of forces, etc, in double</span>
|
CUDA_PREC = -D_DOUBLE_DOUBLE # double precision for all calculations
|
||||||
</pre></div>
|
CUDA_PREC = -D_SINGLE_DOUBLE # accumulation of forces, etc, in double
|
||||||
</div>
|
</PRE>
|
||||||
<p>The last setting is the mixed mode referred to above. Note that your
|
<P>The last setting is the mixed mode referred to above. Note that your
|
||||||
GPU must support double precision to use either the 2nd or 3rd of
|
GPU must support double precision to use either the 2nd or 3rd of
|
||||||
these settings.</p>
|
these settings.
|
||||||
<p>To build the library, type:</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>make -f Makefile.machine
|
<P>To build the library, type:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>make -f Makefile.machine
|
||||||
<p>If successful, it will produce the files libgpu.a and Makefile.lammps.</p>
|
</PRE>
|
||||||
<p>The latter file has 3 settings that need to be appropriate for the
|
<P>If successful, it will produce the files libgpu.a and Makefile.lammps.
|
||||||
|
</P>
|
||||||
|
<P>The latter file has 3 settings that need to be appropriate for the
|
||||||
paths and settings for the CUDA system software on your machine.
|
paths and settings for the CUDA system software on your machine.
|
||||||
Makefile.lammps is a copy of the file specified by the EXTRAMAKE
|
Makefile.lammps is a copy of the file specified by the EXTRAMAKE
|
||||||
setting in Makefile.machine. You can change EXTRAMAKE or create your
|
setting in Makefile.machine. You can change EXTRAMAKE or create your
|
||||||
own Makefile.lammps.machine if needed.</p>
|
own Makefile.lammps.machine if needed.
|
||||||
<p>Note that to change the precision of the GPU library, you need to
|
</P>
|
||||||
re-build the entire library. Do a “clean” first, e.g. “make -f
|
<P>Note that to change the precision of the GPU library, you need to
|
||||||
Makefile.linux clean”, followed by the make command above.</p>
|
re-build the entire library. Do a "clean" first, e.g. "make -f
|
||||||
<ol class="loweralpha simple" start="2">
|
Makefile.linux clean", followed by the make command above.
|
||||||
<li>Build LAMMPS with the GPU package</li>
|
</P>
|
||||||
</ol>
|
<P>(b) Build LAMMPS with the GPU package
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
</P>
|
||||||
|
<PRE>cd lammps/src
|
||||||
make yes-gpu
|
make yes-gpu
|
||||||
make machine
|
make machine
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>No additional compile/link flags are needed in Makefile.machine.
|
||||||
<p>No additional compile/link flags are needed in Makefile.machine.</p>
|
</P>
|
||||||
<p>Note that if you change the GPU library precision (discussed above)
|
<P>Note that if you change the GPU library precision (discussed above)
|
||||||
and rebuild the GPU library, then you also need to re-install the GPU
|
and rebuild the GPU library, then you also need to re-install the GPU
|
||||||
package and re-build LAMMPS, so that all affected files are
|
package and re-build LAMMPS, so that all affected files are
|
||||||
re-compiled and linked to the new GPU library.</p>
|
re-compiled and linked to the new GPU library.
|
||||||
<p><strong>Run with the GPU package from the command line:</strong></p>
|
</P>
|
||||||
<p>The mpirun or mpiexec command sets the total number of MPI tasks used
|
<P><B>Run with the GPU package from the command line:</B>
|
||||||
|
</P>
|
||||||
|
<P>The mpirun or mpiexec command sets the total number of MPI tasks used
|
||||||
by LAMMPS (one or multiple per compute node) and the number of MPI
|
by LAMMPS (one or multiple per compute node) and the number of MPI
|
||||||
tasks used per node. E.g. the mpirun command in MPICH does this via
|
tasks used per node. E.g. the mpirun command in MPICH does this via
|
||||||
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.</p>
|
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.
|
||||||
<p>When using the GPU package, you cannot assign more than one GPU to a
|
</P>
|
||||||
|
<P>When using the GPU package, you cannot assign more than one GPU to a
|
||||||
single MPI task. However multiple MPI tasks can share the same GPU,
|
single MPI task. However multiple MPI tasks can share the same GPU,
|
||||||
and in many cases it will be more efficient to run this way. Likewise
|
and in many cases it will be more efficient to run this way. Likewise
|
||||||
it may be more efficient to use less MPI tasks/node than the available
|
it may be more efficient to use less MPI tasks/node than the available
|
||||||
# of CPU cores. Assignment of multiple MPI tasks to a GPU will happen
|
# of CPU cores. Assignment of multiple MPI tasks to a GPU will happen
|
||||||
automatically if you create more MPI tasks/node than there are
|
automatically if you create more MPI tasks/node than there are
|
||||||
GPUs/mode. E.g. with 8 MPI tasks/node and 2 GPUs, each GPU will be
|
GPUs/mode. E.g. with 8 MPI tasks/node and 2 GPUs, each GPU will be
|
||||||
shared by 4 MPI tasks.</p>
|
shared by 4 MPI tasks.
|
||||||
<p>Use the “-sf gpu” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>,
|
</P>
|
||||||
which will automatically append “gpu” to styles that support it. Use
|
<P>Use the "-sf gpu" <A HREF = "Section_start.html#start_7">command-line switch</A>,
|
||||||
the “-pk gpu Ng” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to
|
which will automatically append "gpu" to styles that support it. Use
|
||||||
set Ng = # of GPUs/node to use.</p>
|
the "-pk gpu Ng" <A HREF = "Section_start.html#start_7">command-line switch</A> to
|
||||||
<div class="highlight-python"><div class="highlight"><pre>lmp_machine -sf gpu -pk gpu 1 -in in.script # 1 MPI task uses 1 GPU
|
set Ng = # of GPUs/node to use.
|
||||||
|
</P>
|
||||||
|
<PRE>lmp_machine -sf gpu -pk gpu 1 -in in.script # 1 MPI task uses 1 GPU
|
||||||
mpirun -np 12 lmp_machine -sf gpu -pk gpu 2 -in in.script # 12 MPI tasks share 2 GPUs on a single 16-core (or whatever) node
|
mpirun -np 12 lmp_machine -sf gpu -pk gpu 2 -in in.script # 12 MPI tasks share 2 GPUs on a single 16-core (or whatever) node
|
||||||
mpirun -np 48 -ppn 12 lmp_machine -sf gpu -pk gpu 2 -in in.script # ditto on 4 16-core nodes
|
mpirun -np 48 -ppn 12 lmp_machine -sf gpu -pk gpu 2 -in in.script # ditto on 4 16-core nodes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Note that if the "-sf gpu" switch is used, it also issues a default
|
||||||
<p>Note that if the “-sf gpu” switch is used, it also issues a default
|
<A HREF = "package.html">package gpu 1</A> command, which sets the number of
|
||||||
<a class="reference internal" href="package.html"><em>package gpu 1</em></a> command, which sets the number of
|
GPUs/node to 1.
|
||||||
GPUs/node to 1.</p>
|
</P>
|
||||||
<p>Using the “-pk” switch explicitly allows for setting of the number of
|
<P>Using the "-pk" switch explicitly allows for setting of the number of
|
||||||
GPUs/node to use and additional options. Its syntax is the same as
|
GPUs/node to use and additional options. Its syntax is the same as
|
||||||
same as the “package gpu” command. See the <a class="reference internal" href="package.html"><em>package</em></a>
|
same as the "package gpu" command. See the <A HREF = "package.html">package</A>
|
||||||
command doc page for details, including the default values used for
|
command doc page for details, including the default values used for
|
||||||
all its options if it is not specified.</p>
|
all its options if it is not specified.
|
||||||
<p>Note that the default for the <a class="reference internal" href="package.html"><em>package gpu</em></a> command is to
|
</P>
|
||||||
set the Newton flag to “off” pairwise interactions. It does not
|
<P>Note that the default for the <A HREF = "package.html">package gpu</A> command is to
|
||||||
affect the setting for bonded interactions (LAMMPS default is “on”).
|
set the Newton flag to "off" pairwise interactions. It does not
|
||||||
The “off” setting for pairwise interaction is currently required for
|
affect the setting for bonded interactions (LAMMPS default is "on").
|
||||||
GPU package pair styles.</p>
|
The "off" setting for pairwise interaction is currently required for
|
||||||
<p><strong>Or run with the GPU package by editing an input script:</strong></p>
|
GPU package pair styles.
|
||||||
<p>The discussion above for the mpirun/mpiexec command, MPI tasks/node,
|
</P>
|
||||||
and use of multiple MPI tasks/GPU is the same.</p>
|
<P><B>Or run with the GPU package by editing an input script:</B>
|
||||||
<p>Use the <a class="reference internal" href="suffix.html"><em>suffix gpu</em></a> command, or you can explicitly add an
|
</P>
|
||||||
“gpu” suffix to individual styles in your input script, e.g.</p>
|
<P>The discussion above for the mpirun/mpiexec command, MPI tasks/node,
|
||||||
<div class="highlight-python"><div class="highlight"><pre>pair_style lj/cut/gpu 2.5
|
and use of multiple MPI tasks/GPU is the same.
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<P>Use the <A HREF = "suffix.html">suffix gpu</A> command, or you can explicitly add an
|
||||||
<p>You must also use the <a class="reference internal" href="package.html"><em>package gpu</em></a> command to enable the
|
"gpu" suffix to individual styles in your input script, e.g.
|
||||||
GPU package, unless the “-sf gpu” or “-pk gpu” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> were used. It specifies the
|
</P>
|
||||||
number of GPUs/node to use, as well as other options.</p>
|
<PRE>pair_style lj/cut/gpu 2.5
|
||||||
<p><strong>Speed-ups to expect:</strong></p>
|
</PRE>
|
||||||
<p>The performance of a GPU versus a multi-core CPU is a function of your
|
<P>You must also use the <A HREF = "package.html">package gpu</A> command to enable the
|
||||||
|
GPU package, unless the "-sf gpu" or "-pk gpu" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switches</A> were used. It specifies the
|
||||||
|
number of GPUs/node to use, as well as other options.
|
||||||
|
</P>
|
||||||
|
<P><B>Speed-ups to expect:</B>
|
||||||
|
</P>
|
||||||
|
<P>The performance of a GPU versus a multi-core CPU is a function of your
|
||||||
hardware, which pair style is used, the number of atoms/GPU, and the
|
hardware, which pair style is used, the number of atoms/GPU, and the
|
||||||
precision used on the GPU (double, single, mixed).</p>
|
precision used on the GPU (double, single, mixed).
|
||||||
<p>See the <a class="reference external" href="http://lammps.sandia.gov/bench.html">Benchmark page</a> of the
|
</P>
|
||||||
|
<P>See the <A HREF = "http://lammps.sandia.gov/bench.html">Benchmark page</A> of the
|
||||||
LAMMPS web site for performance of the GPU package on various
|
LAMMPS web site for performance of the GPU package on various
|
||||||
hardware, including the Titan HPC platform at ORNL.</p>
|
hardware, including the Titan HPC platform at ORNL.
|
||||||
<p>You should also experiment with how many MPI tasks per GPU to use to
|
</P>
|
||||||
|
<P>You should also experiment with how many MPI tasks per GPU to use to
|
||||||
give the best performance for your problem and machine. This is also
|
give the best performance for your problem and machine. This is also
|
||||||
a function of the problem size and the pair style being using.
|
a function of the problem size and the pair style being using.
|
||||||
Likewise, you should experiment with the precision setting for the GPU
|
Likewise, you should experiment with the precision setting for the GPU
|
||||||
library to see if single or mixed precision will give accurate
|
library to see if single or mixed precision will give accurate
|
||||||
results, since they will typically be faster.</p>
|
results, since they will typically be faster.
|
||||||
<p><strong>Guidelines for best performance:</strong></p>
|
</P>
|
||||||
<ul class="simple">
|
<P><B>Guidelines for best performance:</B>
|
||||||
<li>Using multiple MPI tasks per GPU will often give the best performance,
|
</P>
|
||||||
as allowed my most multi-core CPU/GPU configurations.</li>
|
<UL><LI>Using multiple MPI tasks per GPU will often give the best performance,
|
||||||
<li>If the number of particles per MPI task is small (e.g. 100s of
|
as allowed my most multi-core CPU/GPU configurations.
|
||||||
|
|
||||||
|
<LI>If the number of particles per MPI task is small (e.g. 100s of
|
||||||
particles), it can be more efficient to run with fewer MPI tasks per
|
particles), it can be more efficient to run with fewer MPI tasks per
|
||||||
GPU, even if you do not use all the cores on the compute node.</li>
|
GPU, even if you do not use all the cores on the compute node.
|
||||||
<li>The <a class="reference internal" href="package.html"><em>package gpu</em></a> command has several options for tuning
|
|
||||||
|
<LI>The <A HREF = "package.html">package gpu</A> command has several options for tuning
|
||||||
performance. Neighbor lists can be built on the GPU or CPU. Force
|
performance. Neighbor lists can be built on the GPU or CPU. Force
|
||||||
calculations can be dynamically balanced across the CPU cores and
|
calculations can be dynamically balanced across the CPU cores and
|
||||||
GPUs. GPU-specific settings can be made which can be optimized
|
GPUs. GPU-specific settings can be made which can be optimized
|
||||||
for different hardware. See the <a class="reference internal" href="package.html"><em>packakge</em></a> command
|
for different hardware. See the <A HREF = "package.html">packakge</A> command
|
||||||
doc page for details.</li>
|
doc page for details.
|
||||||
<li>As described by the <a class="reference internal" href="package.html"><em>package gpu</em></a> command, GPU
|
|
||||||
|
<LI>As described by the <A HREF = "package.html">package gpu</A> command, GPU
|
||||||
accelerated pair styles can perform computations asynchronously with
|
accelerated pair styles can perform computations asynchronously with
|
||||||
CPU computations. The “Pair” time reported by LAMMPS will be the
|
CPU computations. The "Pair" time reported by LAMMPS will be the
|
||||||
maximum of the time required to complete the CPU pair style
|
maximum of the time required to complete the CPU pair style
|
||||||
computations and the time required to complete the GPU pair style
|
computations and the time required to complete the GPU pair style
|
||||||
computations. Any time spent for GPU-enabled pair styles for
|
computations. Any time spent for GPU-enabled pair styles for
|
||||||
computations that run simultaneously with <a class="reference internal" href="bond_style.html"><em>bond</em></a>,
|
computations that run simultaneously with <A HREF = "bond_style.html">bond</A>,
|
||||||
<a class="reference internal" href="angle_style.html"><em>angle</em></a>, <a class="reference internal" href="dihedral_style.html"><em>dihedral</em></a>,
|
<A HREF = "angle_style.html">angle</A>, <A HREF = "dihedral_style.html">dihedral</A>,
|
||||||
<a class="reference internal" href="improper_style.html"><em>improper</em></a>, and <a class="reference internal" href="kspace_style.html"><em>long-range</em></a>
|
<A HREF = "improper_style.html">improper</A>, and <A HREF = "kspace_style.html">long-range</A>
|
||||||
calculations will not be included in the “Pair” time.</li>
|
calculations will not be included in the "Pair" time.
|
||||||
<li>When the <em>mode</em> setting for the package gpu command is force/neigh,
|
|
||||||
|
<LI>When the <I>mode</I> setting for the package gpu command is force/neigh,
|
||||||
the time for neighbor list calculations on the GPU will be added into
|
the time for neighbor list calculations on the GPU will be added into
|
||||||
the “Pair” time, not the “Neigh” time. An additional breakdown of the
|
the "Pair" time, not the "Neigh" time. An additional breakdown of the
|
||||||
times required for various tasks on the GPU (data copy, neighbor
|
times required for various tasks on the GPU (data copy, neighbor
|
||||||
calculations, force computations, etc) are output only with the LAMMPS
|
calculations, force computations, etc) are output only with the LAMMPS
|
||||||
screen output (not in the log file) at the end of each run. These
|
screen output (not in the log file) at the end of each run. These
|
||||||
timings represent total time spent on the GPU for each routine,
|
timings represent total time spent on the GPU for each routine,
|
||||||
regardless of asynchronous CPU calculations.</li>
|
regardless of asynchronous CPU calculations.
|
||||||
<li>The output section “GPU Time Info (average)” reports “Max Mem / Proc”.
|
|
||||||
|
<LI>The output section "GPU Time Info (average)" reports "Max Mem / Proc".
|
||||||
This is the maximum memory used at one time on the GPU for data
|
This is the maximum memory used at one time on the GPU for data
|
||||||
storage by a single MPI process.</li>
|
storage by a single MPI process.
|
||||||
</ul>
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>None.</p>
|
<P>None.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,133 +1,20 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_packages.html">Previous Section</A> - <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>
|
||||||
|
|
||||||
|
|
||||||
<!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>5.USER-INTEL package — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<P><A HREF = "Section_accelerate.html">Return to Section accelerate overview</A>
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</P>
|
||||||
|
<H4>5.3.3 USER-INTEL package
|
||||||
<li>5.USER-INTEL package</li>
|
</H4>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P>The USER-INTEL package was developed by Mike Brown at Intel
|
||||||
|
|
||||||
|
|
||||||
<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">
|
|
||||||
|
|
||||||
<p><a class="reference internal" href="Section_accelerate.html"><em>Return to Section accelerate overview</em></a></p>
|
|
||||||
<div class="section" id="user-intel-package">
|
|
||||||
<h1>5.USER-INTEL package<a class="headerlink" href="#user-intel-package" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>The USER-INTEL package was developed by Mike Brown at Intel
|
|
||||||
Corporation. It provides a capability to accelerate simulations by
|
Corporation. It provides a capability to accelerate simulations by
|
||||||
offloading neighbor list and non-bonded force calculations to Intel(R)
|
offloading neighbor list and non-bonded force calculations to Intel(R)
|
||||||
Xeon Phi(TM) coprocessors (not native mode like the KOKKOS package).
|
Xeon Phi(TM) coprocessors (not native mode like the KOKKOS package).
|
||||||
@ -135,225 +22,264 @@ Additionally, it supports running simulations in single, mixed, or
|
|||||||
double precision with vectorization, even if a coprocessor is not
|
double precision with vectorization, even if a coprocessor is not
|
||||||
present, i.e. on an Intel(R) CPU. The same C++ code is used for both
|
present, i.e. on an Intel(R) CPU. The same C++ code is used for both
|
||||||
cases. When offloading to a coprocessor, the routine is run twice,
|
cases. When offloading to a coprocessor, the routine is run twice,
|
||||||
once with an offload flag.</p>
|
once with an offload flag.
|
||||||
<p>The USER-INTEL package can be used in tandem with the USER-OMP
|
</P>
|
||||||
|
<P>The USER-INTEL package can be used in tandem with the USER-OMP
|
||||||
package. This is useful when offloading pair style computations to
|
package. This is useful when offloading pair style computations to
|
||||||
coprocessors, so that other styles not supported by the USER-INTEL
|
coprocessors, so that other styles not supported by the USER-INTEL
|
||||||
package, e.g. bond, angle, dihedral, improper, and long-range
|
package, e.g. bond, angle, dihedral, improper, and long-range
|
||||||
electrostatics, can run simultaneously in threaded mode on the CPU
|
electrostatics, can run simultaneously in threaded mode on the CPU
|
||||||
cores. Since less MPI tasks than CPU cores will typically be invoked
|
cores. Since less MPI tasks than CPU cores will typically be invoked
|
||||||
when running with coprocessors, this enables the extra CPU cores to be
|
when running with coprocessors, this enables the extra CPU cores to be
|
||||||
used for useful computation.</p>
|
used for useful computation.
|
||||||
<p>If LAMMPS is built with both the USER-INTEL and USER-OMP packages
|
</P>
|
||||||
|
<P>If LAMMPS is built with both the USER-INTEL and USER-OMP packages
|
||||||
intsalled, this mode of operation is made easier to use, because the
|
intsalled, this mode of operation is made easier to use, because the
|
||||||
“-suffix intel” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> or
|
"-suffix intel" <A HREF = "Section_start.html#start_7">command-line switch</A> or
|
||||||
the <a class="reference internal" href="suffix.html"><em>suffix intel</em></a> command will both set a second-choice
|
the <A HREF = "suffix.html">suffix intel</A> command will both set a second-choice
|
||||||
suffix to “omp” so that styles from the USER-OMP package will be used
|
suffix to "omp" so that styles from the USER-OMP package will be used
|
||||||
if available, after first testing if a style from the USER-INTEL
|
if available, after first testing if a style from the USER-INTEL
|
||||||
package is available.</p>
|
package is available.
|
||||||
<p>When using the USER-INTEL package, you must choose at build time
|
</P>
|
||||||
|
<P>When using the USER-INTEL package, you must choose at build time
|
||||||
whether you are building for CPU-only acceleration or for using the
|
whether you are building for CPU-only acceleration or for using the
|
||||||
Xeon Phi in offload mode.</p>
|
Xeon Phi in offload mode.
|
||||||
<p>Here is a quick overview of how to use the USER-INTEL package
|
</P>
|
||||||
for CPU-only acceleration:</p>
|
<P>Here is a quick overview of how to use the USER-INTEL package
|
||||||
<ul class="simple">
|
for CPU-only acceleration:
|
||||||
<li>specify these CCFLAGS in your src/MAKE/Makefile.machine: -openmp, -DLAMMPS_MEMALIGN=64, -restrict, -xHost</li>
|
</P>
|
||||||
<li>specify -openmp with LINKFLAGS in your Makefile.machine</li>
|
<UL><LI>specify these CCFLAGS in your src/MAKE/Makefile.machine: -openmp, -DLAMMPS_MEMALIGN=64, -restrict, -xHost
|
||||||
<li>include the USER-INTEL package and (optionally) USER-OMP package and build LAMMPS</li>
|
<LI>specify -openmp with LINKFLAGS in your Makefile.machine
|
||||||
<li>specify how many OpenMP threads per MPI task to use</li>
|
<LI>include the USER-INTEL package and (optionally) USER-OMP package and build LAMMPS
|
||||||
<li>use USER-INTEL and (optionally) USER-OMP styles in your input script</li>
|
<LI>specify how many OpenMP threads per MPI task to use
|
||||||
</ul>
|
<LI>use USER-INTEL and (optionally) USER-OMP styles in your input script
|
||||||
<p>Note that many of these settings can only be used with the Intel
|
</UL>
|
||||||
compiler, as discussed below.</p>
|
<P>Note that many of these settings can only be used with the Intel
|
||||||
<p>Using the USER-INTEL package to offload work to the Intel(R)
|
compiler, as discussed below.
|
||||||
|
</P>
|
||||||
|
<P>Using the USER-INTEL package to offload work to the Intel(R)
|
||||||
Xeon Phi(TM) coprocessor is the same except for these additional
|
Xeon Phi(TM) coprocessor is the same except for these additional
|
||||||
steps:</p>
|
steps:
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>add the flag -DLMP_INTEL_OFFLOAD to CCFLAGS in your Makefile.machine</li>
|
<UL><LI>add the flag -DLMP_INTEL_OFFLOAD to CCFLAGS in your Makefile.machine
|
||||||
<li>add the flag -offload to LINKFLAGS in your Makefile.machine</li>
|
<LI>add the flag -offload to LINKFLAGS in your Makefile.machine
|
||||||
</ul>
|
</UL>
|
||||||
<p>The latter two steps in the first case and the last step in the
|
<P>The latter two steps in the first case and the last step in the
|
||||||
coprocessor case can be done using the “-pk intel” and “-sf intel”
|
coprocessor case can be done using the "-pk intel" and "-sf intel"
|
||||||
<a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> respectively. Or
|
<A HREF = "Section_start.html#start_7">command-line switches</A> respectively. Or
|
||||||
the effect of the “-pk” or “-sf” switches can be duplicated by adding
|
the effect of the "-pk" or "-sf" switches can be duplicated by adding
|
||||||
the <a class="reference internal" href="package.html"><em>package intel</em></a> or <a class="reference internal" href="suffix.html"><em>suffix intel</em></a>
|
the <A HREF = "package.html">package intel</A> or <A HREF = "suffix.html">suffix intel</A>
|
||||||
commands respectively to your input script.</p>
|
commands respectively to your input script.
|
||||||
<p><strong>Required hardware/software:</strong></p>
|
</P>
|
||||||
<p>To use the offload option, you must have one or more Intel(R) Xeon
|
<P><B>Required hardware/software:</B>
|
||||||
Phi(TM) coprocessors and use an Intel(R) C++ compiler.</p>
|
</P>
|
||||||
<p>Optimizations for vectorization have only been tested with the
|
<P>To use the offload option, you must have one or more Intel(R) Xeon
|
||||||
|
Phi(TM) coprocessors and use an Intel(R) C++ compiler.
|
||||||
|
</P>
|
||||||
|
<P>Optimizations for vectorization have only been tested with the
|
||||||
Intel(R) compiler. Use of other compilers may not result in
|
Intel(R) compiler. Use of other compilers may not result in
|
||||||
vectorization or give poor performance.</p>
|
vectorization or give poor performance.
|
||||||
<p>Use of an Intel C++ compiler is recommended, but not required (though
|
</P>
|
||||||
|
<P>Use of an Intel C++ compiler is recommended, but not required (though
|
||||||
g++ will not recognize some of the settings, so they cannot be used).
|
g++ will not recognize some of the settings, so they cannot be used).
|
||||||
The compiler must support the OpenMP interface.</p>
|
The compiler must support the OpenMP interface.
|
||||||
<p>The recommended version of the Intel(R) compiler is 14.0.1.106.
|
</P>
|
||||||
Versions 15.0.1.133 and later are also supported. If using Intel(R)
|
<P>The recommended version of the Intel(R) compiler is 14.0.1.106.
|
||||||
MPI, versions 15.0.2.044 and later are recommended.</p>
|
Versions 15.0.1.133 and later are also supported. If using Intel(R)
|
||||||
<p><strong>Building LAMMPS with the USER-INTEL package:</strong></p>
|
MPI, versions 15.0.2.044 and later are recommended.
|
||||||
<p>You can choose to build with or without support for offload to a
|
</P>
|
||||||
|
<P><B>Building LAMMPS with the USER-INTEL package:</B>
|
||||||
|
</P>
|
||||||
|
<P>You can choose to build with or without support for offload to a
|
||||||
Intel(R) Xeon Phi(TM) coprocessor. If you build with support for a
|
Intel(R) Xeon Phi(TM) coprocessor. If you build with support for a
|
||||||
coprocessor, the same binary can be used on nodes with and without
|
coprocessor, the same binary can be used on nodes with and without
|
||||||
coprocessors installed. However, if you do not have coprocessors
|
coprocessors installed. However, if you do not have coprocessors
|
||||||
on your system, building without offload support will produce a
|
on your system, building without offload support will produce a
|
||||||
smaller binary.</p>
|
smaller binary.
|
||||||
<p>You can do either in one line, using the src/Make.py script, described
|
</P>
|
||||||
in <a class="reference internal" href="Section_start.html#start-4"><span>Section 2.4</span></a> of the manual. Type
|
<P>You can do either in one line, using the src/Make.py script, described
|
||||||
“Make.py -h” for help. If run from the src directory, these commands
|
in <A HREF = "Section_start.html#start_4">Section 2.4</A> of the manual. Type
|
||||||
|
"Make.py -h" for help. If run from the src directory, these commands
|
||||||
will create src/lmp_intel_cpu and lmp_intel_phi using
|
will create src/lmp_intel_cpu and lmp_intel_phi using
|
||||||
src/MAKE/Makefile.mpi as the starting Makefile.machine:</p>
|
src/MAKE/Makefile.mpi as the starting Makefile.machine:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Make.py -p intel omp -intel cpu -o intel_cpu -cc icc file mpi
|
</P>
|
||||||
Make.py -p intel omp -intel phi -o intel_phi -cc icc file mpi
|
<PRE>Make.py -p intel omp -intel cpu -o intel_cpu -cc icc file mpi
|
||||||
</pre></div>
|
Make.py -p intel omp -intel phi -o intel_phi -cc icc file mpi
|
||||||
</div>
|
</PRE>
|
||||||
<p>Note that this assumes that your MPI and its mpicxx wrapper
|
<P>Note that this assumes that your MPI and its mpicxx wrapper
|
||||||
is using the Intel compiler. If it is not, you should
|
is using the Intel compiler. If it is not, you should
|
||||||
leave off the “-cc icc” switch.</p>
|
leave off the "-cc icc" switch.
|
||||||
<p>Or you can follow these steps:</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
<P>Or you can follow these steps:
|
||||||
|
</P>
|
||||||
|
<PRE>cd lammps/src
|
||||||
make yes-user-intel
|
make yes-user-intel
|
||||||
make yes-user-omp (if desired)
|
make yes-user-omp (if desired)
|
||||||
make machine
|
make machine
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Note that if the USER-OMP package is also installed, you can use
|
||||||
<p>Note that if the USER-OMP package is also installed, you can use
|
styles from both packages, as described below.
|
||||||
styles from both packages, as described below.</p>
|
</P>
|
||||||
<p>The Makefile.machine needs a “-fopenmp” flag for OpenMP support in
|
<P>The Makefile.machine needs a "-fopenmp" flag for OpenMP support in
|
||||||
both the CCFLAGS and LINKFLAGS variables. You also need to add
|
both the CCFLAGS and LINKFLAGS variables. You also need to add
|
||||||
-DLAMMPS_MEMALIGN=64 and -restrict to CCFLAGS.</p>
|
-DLAMMPS_MEMALIGN=64 and -restrict to CCFLAGS.
|
||||||
<p>If you are compiling on the same architecture that will be used for
|
</P>
|
||||||
the runs, adding the flag <em>-xHost</em> to CCFLAGS will enable
|
<P>If you are compiling on the same architecture that will be used for
|
||||||
|
the runs, adding the flag <I>-xHost</I> to CCFLAGS will enable
|
||||||
vectorization with the Intel(R) compiler. Otherwise, you must
|
vectorization with the Intel(R) compiler. Otherwise, you must
|
||||||
provide the correct compute node architecture to the -x option
|
provide the correct compute node architecture to the -x option
|
||||||
(e.g. -xAVX).</p>
|
(e.g. -xAVX).
|
||||||
<p>In order to build with support for an Intel(R) Xeon Phi(TM)
|
</P>
|
||||||
coprocessor, the flag <em>-offload</em> should be added to the LINKFLAGS line
|
<P>In order to build with support for an Intel(R) Xeon Phi(TM)
|
||||||
and the flag -DLMP_INTEL_OFFLOAD should be added to the CCFLAGS line.</p>
|
coprocessor, the flag <I>-offload</I> should be added to the LINKFLAGS line
|
||||||
<p>Example makefiles Makefile.intel_cpu and Makefile.intel_phi are
|
and the flag -DLMP_INTEL_OFFLOAD should be added to the CCFLAGS line.
|
||||||
|
</P>
|
||||||
|
<P>Example makefiles Makefile.intel_cpu and Makefile.intel_phi are
|
||||||
included in the src/MAKE/OPTIONS directory with settings that perform
|
included in the src/MAKE/OPTIONS directory with settings that perform
|
||||||
well with the Intel(R) compiler. The latter file has support for
|
well with the Intel(R) compiler. The latter file has support for
|
||||||
offload to coprocessors; the former does not.</p>
|
offload to coprocessors; the former does not.
|
||||||
<p><strong>Notes on CPU and core affinity:</strong></p>
|
</P>
|
||||||
<p>Setting core affinity is often used to pin MPI tasks and OpenMP
|
<P><B>Notes on CPU and core affinity:</B>
|
||||||
|
</P>
|
||||||
|
<P>Setting core affinity is often used to pin MPI tasks and OpenMP
|
||||||
threads to a core or group of cores so that memory access can be
|
threads to a core or group of cores so that memory access can be
|
||||||
uniform. Unless disabled at build time, affinity for MPI tasks and
|
uniform. Unless disabled at build time, affinity for MPI tasks and
|
||||||
OpenMP threads on the host will be set by default on the host
|
OpenMP threads on the host will be set by default on the host
|
||||||
when using offload to a coprocessor. In this case, it is unnecessary
|
when using offload to a coprocessor. In this case, it is unnecessary
|
||||||
to use other methods to control affinity (e.g. taskset, numactl,
|
to use other methods to control affinity (e.g. taskset, numactl,
|
||||||
I_MPI_PIN_DOMAIN, etc.). This can be disabled in an input script
|
I_MPI_PIN_DOMAIN, etc.). This can be disabled in an input script
|
||||||
with the <em>no_affinity</em> option to the <a class="reference internal" href="package.html"><em>package intel</em></a>
|
with the <I>no_affinity</I> option to the <A HREF = "package.html">package intel</A>
|
||||||
command or by disabling the option at build time (by adding
|
command or by disabling the option at build time (by adding
|
||||||
-DINTEL_OFFLOAD_NOAFFINITY to the CCFLAGS line of your Makefile).
|
-DINTEL_OFFLOAD_NOAFFINITY to the CCFLAGS line of your Makefile).
|
||||||
Disabling this option is not recommended, especially when running
|
Disabling this option is not recommended, especially when running
|
||||||
on a machine with hyperthreading disabled.</p>
|
on a machine with hyperthreading disabled.
|
||||||
<p><strong>Running with the USER-INTEL package from the command line:</strong></p>
|
</P>
|
||||||
<p>The mpirun or mpiexec command sets the total number of MPI tasks used
|
<P><B>Running with the USER-INTEL package from the command line:</B>
|
||||||
|
</P>
|
||||||
|
<P>The mpirun or mpiexec command sets the total number of MPI tasks used
|
||||||
by LAMMPS (one or multiple per compute node) and the number of MPI
|
by LAMMPS (one or multiple per compute node) and the number of MPI
|
||||||
tasks used per node. E.g. the mpirun command in MPICH does this via
|
tasks used per node. E.g. the mpirun command in MPICH does this via
|
||||||
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.</p>
|
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.
|
||||||
<p>If you plan to compute (any portion of) pairwise interactions using
|
</P>
|
||||||
|
<P>If you plan to compute (any portion of) pairwise interactions using
|
||||||
USER-INTEL pair styles on the CPU, or use USER-OMP styles on the CPU,
|
USER-INTEL pair styles on the CPU, or use USER-OMP styles on the CPU,
|
||||||
you need to choose how many OpenMP threads per MPI task to use. Note
|
you need to choose how many OpenMP threads per MPI task to use. Note
|
||||||
that the product of MPI tasks * OpenMP threads/task should not exceed
|
that the product of MPI tasks * OpenMP threads/task should not exceed
|
||||||
the physical number of cores (on a node), otherwise performance will
|
the physical number of cores (on a node), otherwise performance will
|
||||||
suffer.</p>
|
suffer.
|
||||||
<p>If LAMMPS was built with coprocessor support for the USER-INTEL
|
</P>
|
||||||
|
<P>If LAMMPS was built with coprocessor support for the USER-INTEL
|
||||||
package, you also need to specify the number of coprocessor/node and
|
package, you also need to specify the number of coprocessor/node and
|
||||||
the number of coprocessor threads per MPI task to use. Note that
|
the number of coprocessor threads per MPI task to use. Note that
|
||||||
coprocessor threads (which run on the coprocessor) are totally
|
coprocessor threads (which run on the coprocessor) are totally
|
||||||
independent from OpenMP threads (which run on the CPU). The default
|
independent from OpenMP threads (which run on the CPU). The default
|
||||||
values for the settings that affect coprocessor threads are typically
|
values for the settings that affect coprocessor threads are typically
|
||||||
fine, as discussed below.</p>
|
fine, as discussed below.
|
||||||
<p>Use the “-sf intel” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>,
|
</P>
|
||||||
which will automatically append “intel” to styles that support it. If
|
<P>Use the "-sf intel" <A HREF = "Section_start.html#start_7">command-line switch</A>,
|
||||||
a style does not support it, an “omp” suffix is tried next. OpenMP
|
which will automatically append "intel" to styles that support it. If
|
||||||
threads per MPI task can be set via the “-pk intel Nphi omp Nt” or
|
a style does not support it, an "omp" suffix is tried next. OpenMP
|
||||||
“-pk omp Nt” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a>, which
|
threads per MPI task can be set via the "-pk intel Nphi omp Nt" or
|
||||||
set Nt = # of OpenMP threads per MPI task to use. The “-pk omp” form
|
"-pk omp Nt" <A HREF = "Section_start.html#start_7">command-line switches</A>, which
|
||||||
is only allowed if LAMMPS was also built with the USER-OMP package.</p>
|
set Nt = # of OpenMP threads per MPI task to use. The "-pk omp" form
|
||||||
<p>Use the “-pk intel Nphi” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to set Nphi = # of Xeon Phi(TM)
|
is only allowed if LAMMPS was also built with the USER-OMP package.
|
||||||
|
</P>
|
||||||
|
<P>Use the "-pk intel Nphi" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switch</A> to set Nphi = # of Xeon Phi(TM)
|
||||||
coprocessors/node, if LAMMPS was built with coprocessor support. All
|
coprocessors/node, if LAMMPS was built with coprocessor support. All
|
||||||
the available coprocessor threads on each Phi will be divided among
|
the available coprocessor threads on each Phi will be divided among
|
||||||
MPI tasks, unless the <em>tptask</em> option of the “-pk intel” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> is used to limit the coprocessor
|
MPI tasks, unless the <I>tptask</I> option of the "-pk intel" <A HREF = "Section_start.html#start_7">command-line
|
||||||
threads per MPI task. See the <a class="reference internal" href="package.html"><em>package intel</em></a> command
|
switch</A> is used to limit the coprocessor
|
||||||
for details.</p>
|
threads per MPI task. See the <A HREF = "package.html">package intel</A> command
|
||||||
<div class="highlight-python"><div class="highlight"><pre>CPU-only without USER-OMP (but using Intel vectorization on CPU):
|
for details.
|
||||||
|
</P>
|
||||||
|
<PRE>CPU-only without USER-OMP (but using Intel vectorization on CPU):
|
||||||
lmp_machine -sf intel -in in.script # 1 MPI task
|
lmp_machine -sf intel -in in.script # 1 MPI task
|
||||||
mpirun -np 32 lmp_machine -sf intel -in in.script # 32 MPI tasks on as many nodes as needed (e.g. 2 16-core nodes)
|
mpirun -np 32 lmp_machine -sf intel -in in.script # 32 MPI tasks on as many nodes as needed (e.g. 2 16-core nodes)
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE>CPU-only with USER-OMP (and Intel vectorization on CPU):
|
||||||
<div class="highlight-python"><div class="highlight"><pre>CPU-only with USER-OMP (and Intel vectorization on CPU):
|
|
||||||
lmp_machine -sf intel -pk intel 16 0 -in in.script # 1 MPI task on a 16-core node
|
lmp_machine -sf intel -pk intel 16 0 -in in.script # 1 MPI task on a 16-core node
|
||||||
mpirun -np 4 lmp_machine -sf intel -pk omp 4 -in in.script # 4 MPI tasks each with 4 threads on a single 16-core node
|
mpirun -np 4 lmp_machine -sf intel -pk omp 4 -in in.script # 4 MPI tasks each with 4 threads on a single 16-core node
|
||||||
mpirun -np 32 lmp_machine -sf intel -pk omp 4 -in in.script # ditto on 8 16-core nodes
|
mpirun -np 32 lmp_machine -sf intel -pk omp 4 -in in.script # ditto on 8 16-core nodes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE>CPUs + Xeon Phi(TM) coprocessors with or without USER-OMP:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>CPUs + Xeon Phi(TM) coprocessors with or without USER-OMP:
|
|
||||||
lmp_machine -sf intel -pk intel 1 omp 16 -in in.script # 1 MPI task, 16 OpenMP threads on CPU, 1 coprocessor, all 240 coprocessor threads
|
lmp_machine -sf intel -pk intel 1 omp 16 -in in.script # 1 MPI task, 16 OpenMP threads on CPU, 1 coprocessor, all 240 coprocessor threads
|
||||||
lmp_machine -sf intel -pk intel 1 omp 16 tptask 32 -in in.script # 1 MPI task, 16 OpenMP threads on CPU, 1 coprocessor, only 32 coprocessor threads
|
lmp_machine -sf intel -pk intel 1 omp 16 tptask 32 -in in.script # 1 MPI task, 16 OpenMP threads on CPU, 1 coprocessor, only 32 coprocessor threads
|
||||||
mpirun -np 4 lmp_machine -sf intel -pk intel 1 omp 4 -in in.script # 4 MPI tasks, 4 OpenMP threads/task, 1 coprocessor, 60 coprocessor threads/task
|
mpirun -np 4 lmp_machine -sf intel -pk intel 1 omp 4 -in in.script # 4 MPI tasks, 4 OpenMP threads/task, 1 coprocessor, 60 coprocessor threads/task
|
||||||
mpirun -np 32 -ppn 4 lmp_machine -sf intel -pk intel 1 omp 4 -in in.script # ditto on 8 16-core nodes
|
mpirun -np 32 -ppn 4 lmp_machine -sf intel -pk intel 1 omp 4 -in in.script # ditto on 8 16-core nodes
|
||||||
mpirun -np 8 lmp_machine -sf intel -pk intel 4 omp 2 -in in.script # 8 MPI tasks, 2 OpenMP threads/task, 4 coprocessors, 120 coprocessor threads/task
|
mpirun -np 8 lmp_machine -sf intel -pk intel 4 omp 2 -in in.script # 8 MPI tasks, 2 OpenMP threads/task, 4 coprocessors, 120 coprocessor threads/task
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Note that if the "-sf intel" switch is used, it also invokes two
|
||||||
<p>Note that if the “-sf intel” switch is used, it also invokes two
|
default commands: <A HREF = "package.html">package intel 1</A>, followed by <A HREF = "package.html">package
|
||||||
default commands: <a class="reference internal" href="package.html"><em>package intel 1</em></a>, followed by <a class="reference internal" href="package.html"><em>package omp 0</em></a>. These both set the number of OpenMP threads per
|
omp 0</A>. These both set the number of OpenMP threads per
|
||||||
MPI task via the OMP_NUM_THREADS environment variable. The first
|
MPI task via the OMP_NUM_THREADS environment variable. The first
|
||||||
command sets the number of Xeon Phi(TM) coprocessors/node to 1 (and
|
command sets the number of Xeon Phi(TM) coprocessors/node to 1 (and
|
||||||
the precision mode to “mixed”, as one of its option defaults). The
|
the precision mode to "mixed", as one of its option defaults). The
|
||||||
latter command is not invoked if LAMMPS was not built with the
|
latter command is not invoked if LAMMPS was not built with the
|
||||||
USER-OMP package. The Nphi = 1 value for the first command is ignored
|
USER-OMP package. The Nphi = 1 value for the first command is ignored
|
||||||
if LAMMPS was not built with coprocessor support.</p>
|
if LAMMPS was not built with coprocessor support.
|
||||||
<p>Using the “-pk intel” or “-pk omp” switches explicitly allows for
|
</P>
|
||||||
|
<P>Using the "-pk intel" or "-pk omp" switches explicitly allows for
|
||||||
direct setting of the number of OpenMP threads per MPI task, and
|
direct setting of the number of OpenMP threads per MPI task, and
|
||||||
additional options for either of the USER-INTEL or USER-OMP packages.
|
additional options for either of the USER-INTEL or USER-OMP packages.
|
||||||
In particular, the “-pk intel” switch sets the number of
|
In particular, the "-pk intel" switch sets the number of
|
||||||
coprocessors/node and can limit the number of coprocessor threads per
|
coprocessors/node and can limit the number of coprocessor threads per
|
||||||
MPI task. The syntax for these two switches is the same as the
|
MPI task. The syntax for these two switches is the same as the
|
||||||
<a class="reference internal" href="package.html"><em>package omp</em></a> and <a class="reference internal" href="package.html"><em>package intel</em></a> commands.
|
<A HREF = "package.html">package omp</A> and <A HREF = "package.html">package intel</A> commands.
|
||||||
See the <a class="reference internal" href="package.html"><em>package</em></a> command doc page for details, including
|
See the <A HREF = "package.html">package</A> command doc page for details, including
|
||||||
the default values used for all its options if these switches are not
|
the default values used for all its options if these switches are not
|
||||||
specified, and how to set the number of OpenMP threads via the
|
specified, and how to set the number of OpenMP threads via the
|
||||||
OMP_NUM_THREADS environment variable if desired.</p>
|
OMP_NUM_THREADS environment variable if desired.
|
||||||
<p><strong>Or run with the USER-INTEL package by editing an input script:</strong></p>
|
</P>
|
||||||
<p>The discussion above for the mpirun/mpiexec command, MPI tasks/node,
|
<P><B>Or run with the USER-INTEL package by editing an input script:</B>
|
||||||
|
</P>
|
||||||
|
<P>The discussion above for the mpirun/mpiexec command, MPI tasks/node,
|
||||||
OpenMP threads per MPI task, and coprocessor threads per MPI task is
|
OpenMP threads per MPI task, and coprocessor threads per MPI task is
|
||||||
the same.</p>
|
the same.
|
||||||
<p>Use the <a class="reference internal" href="suffix.html"><em>suffix intel</em></a> command, or you can explicitly add an
|
</P>
|
||||||
“intel” suffix to individual styles in your input script, e.g.</p>
|
<P>Use the <A HREF = "suffix.html">suffix intel</A> command, or you can explicitly add an
|
||||||
<div class="highlight-python"><div class="highlight"><pre>pair_style lj/cut/intel 2.5
|
"intel" suffix to individual styles in your input script, e.g.
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>pair_style lj/cut/intel 2.5
|
||||||
<p>You must also use the <a class="reference internal" href="package.html"><em>package intel</em></a> command, unless the
|
</PRE>
|
||||||
“-sf intel” or “-pk intel” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> were used. It specifies how many
|
<P>You must also use the <A HREF = "package.html">package intel</A> command, unless the
|
||||||
|
"-sf intel" or "-pk intel" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switches</A> were used. It specifies how many
|
||||||
coprocessors/node to use, as well as other OpenMP threading and
|
coprocessors/node to use, as well as other OpenMP threading and
|
||||||
coprocessor options. Its doc page explains how to set the number of
|
coprocessor options. Its doc page explains how to set the number of
|
||||||
OpenMP threads via an environment variable if desired.</p>
|
OpenMP threads via an environment variable if desired.
|
||||||
<p>If LAMMPS was also built with the USER-OMP package, you must also use
|
</P>
|
||||||
the <a class="reference internal" href="package.html"><em>package omp</em></a> command to enable that package, unless
|
<P>If LAMMPS was also built with the USER-OMP package, you must also use
|
||||||
the “-sf intel” or “-pk omp” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> were used. It specifies how many
|
the <A HREF = "package.html">package omp</A> command to enable that package, unless
|
||||||
|
the "-sf intel" or "-pk omp" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switches</A> were used. It specifies how many
|
||||||
OpenMP threads per MPI task to use, as well as other options. Its doc
|
OpenMP threads per MPI task to use, as well as other options. Its doc
|
||||||
page explains how to set the number of OpenMP threads via an
|
page explains how to set the number of OpenMP threads via an
|
||||||
environment variable if desired.</p>
|
environment variable if desired.
|
||||||
<p><strong>Speed-ups to expect:</strong></p>
|
</P>
|
||||||
<p>If LAMMPS was not built with coprocessor support when including the
|
<P><B>Speed-ups to expect:</B>
|
||||||
|
</P>
|
||||||
|
<P>If LAMMPS was not built with coprocessor support when including the
|
||||||
USER-INTEL package, then acclerated styles will run on the CPU using
|
USER-INTEL package, then acclerated styles will run on the CPU using
|
||||||
vectorization optimizations and the specified precision. This may
|
vectorization optimizations and the specified precision. This may
|
||||||
give a substantial speed-up for a pair style, particularly if mixed or
|
give a substantial speed-up for a pair style, particularly if mixed or
|
||||||
single precision is used.</p>
|
single precision is used.
|
||||||
<p>If LAMMPS was built with coproccesor support, the pair styles will run
|
</P>
|
||||||
|
<P>If LAMMPS was built with coproccesor support, the pair styles will run
|
||||||
on one or more Intel(R) Xeon Phi(TM) coprocessors (per node). The
|
on one or more Intel(R) Xeon Phi(TM) coprocessors (per node). The
|
||||||
performance of a Xeon Phi versus a multi-core CPU is a function of
|
performance of a Xeon Phi versus a multi-core CPU is a function of
|
||||||
your hardware, which pair style is used, the number of
|
your hardware, which pair style is used, the number of
|
||||||
atoms/coprocessor, and the precision used on the coprocessor (double,
|
atoms/coprocessor, and the precision used on the coprocessor (double,
|
||||||
single, mixed).</p>
|
single, mixed).
|
||||||
<p>See the <a class="reference external" href="http://lammps.sandia.gov/bench.html">Benchmark page</a> of the
|
</P>
|
||||||
|
<P>See the <A HREF = "http://lammps.sandia.gov/bench.html">Benchmark page</A> of the
|
||||||
LAMMPS web site for performance of the USER-INTEL package on different
|
LAMMPS web site for performance of the USER-INTEL package on different
|
||||||
hardware.</p>
|
hardware.
|
||||||
<p><strong>Guidelines for best performance on an Intel(R) Xeon Phi(TM)
|
</P>
|
||||||
coprocessor:</strong></p>
|
<P><B>Guidelines for best performance on an Intel(R) Xeon Phi(TM)
|
||||||
<ul class="simple">
|
coprocessor:</B>
|
||||||
<li>The default for the <a class="reference internal" href="package.html"><em>package intel</em></a> command is to have
|
</P>
|
||||||
|
<UL><LI>The default for the <A HREF = "package.html">package intel</A> command is to have
|
||||||
all the MPI tasks on a given compute node use a single Xeon Phi(TM)
|
all the MPI tasks on a given compute node use a single Xeon Phi(TM)
|
||||||
coprocessor. In general, running with a large number of MPI tasks on
|
coprocessor. In general, running with a large number of MPI tasks on
|
||||||
each node will perform best with offload. Each MPI task will
|
each node will perform best with offload. Each MPI task will
|
||||||
@ -364,121 +290,63 @@ with 60 cores available for offload and 4 hardware threads per core
|
|||||||
each MPI task to use a subset of 10 threads on the coprocessor. Fine
|
each MPI task to use a subset of 10 threads on the coprocessor. Fine
|
||||||
tuning of the number of threads to use per MPI task or the number of
|
tuning of the number of threads to use per MPI task or the number of
|
||||||
threads to use per core can be accomplished with keyword settings of
|
threads to use per core can be accomplished with keyword settings of
|
||||||
the <a class="reference internal" href="package.html"><em>package intel</em></a> command.</li>
|
the <A HREF = "package.html">package intel</A> command.
|
||||||
<li>If desired, only a fraction of the pair style computation can be
|
|
||||||
|
<LI>If desired, only a fraction of the pair style computation can be
|
||||||
offloaded to the coprocessors. This is accomplished by using the
|
offloaded to the coprocessors. This is accomplished by using the
|
||||||
<em>balance</em> keyword in the <a class="reference internal" href="package.html"><em>package intel</em></a> command. A
|
<I>balance</I> keyword in the <A HREF = "package.html">package intel</A> command. A
|
||||||
balance of 0 runs all calculations on the CPU. A balance of 1 runs
|
balance of 0 runs all calculations on the CPU. A balance of 1 runs
|
||||||
all calculations on the coprocessor. A balance of 0.5 runs half of
|
all calculations on the coprocessor. A balance of 0.5 runs half of
|
||||||
the calculations on the coprocessor. Setting the balance to -1 (the
|
the calculations on the coprocessor. Setting the balance to -1 (the
|
||||||
default) will enable dynamic load balancing that continously adjusts
|
default) will enable dynamic load balancing that continously adjusts
|
||||||
the fraction of offloaded work throughout the simulation. This option
|
the fraction of offloaded work throughout the simulation. This option
|
||||||
typically produces results within 5 to 10 percent of the optimal fixed
|
typically produces results within 5 to 10 percent of the optimal fixed
|
||||||
balance.</li>
|
balance.
|
||||||
<li>When using offload with CPU hyperthreading disabled, it may help
|
|
||||||
|
<LI>When using offload with CPU hyperthreading disabled, it may help
|
||||||
performance to use fewer MPI tasks and OpenMP threads than available
|
performance to use fewer MPI tasks and OpenMP threads than available
|
||||||
cores. This is due to the fact that additional threads are generated
|
cores. This is due to the fact that additional threads are generated
|
||||||
internally to handle the asynchronous offload tasks.</li>
|
internally to handle the asynchronous offload tasks.
|
||||||
<li>If running short benchmark runs with dynamic load balancing, adding a
|
|
||||||
|
<LI>If running short benchmark runs with dynamic load balancing, adding a
|
||||||
short warm-up run (10-20 steps) will allow the load-balancer to find a
|
short warm-up run (10-20 steps) will allow the load-balancer to find a
|
||||||
near-optimal setting that will carry over to additional runs.</li>
|
near-optimal setting that will carry over to additional runs.
|
||||||
<li>If pair computations are being offloaded to an Intel(R) Xeon Phi(TM)
|
|
||||||
|
<LI>If pair computations are being offloaded to an Intel(R) Xeon Phi(TM)
|
||||||
coprocessor, a diagnostic line is printed to the screen (not to the
|
coprocessor, a diagnostic line is printed to the screen (not to the
|
||||||
log file), during the setup phase of a run, indicating that offload
|
log file), during the setup phase of a run, indicating that offload
|
||||||
mode is being used and indicating the number of coprocessor threads
|
mode is being used and indicating the number of coprocessor threads
|
||||||
per MPI task. Additionally, an offload timing summary is printed at
|
per MPI task. Additionally, an offload timing summary is printed at
|
||||||
the end of each run. When offloading, the frequency for <a class="reference internal" href="atom_modify.html"><em>atom sorting</em></a> is changed to 1 so that the per-atom data is
|
the end of each run. When offloading, the frequency for <A HREF = "atom_modify.html">atom
|
||||||
effectively sorted at every rebuild of the neighbor lists.</li>
|
sorting</A> is changed to 1 so that the per-atom data is
|
||||||
<li>For simulations with long-range electrostatics or bond, angle,
|
effectively sorted at every rebuild of the neighbor lists.
|
||||||
|
|
||||||
|
<LI>For simulations with long-range electrostatics or bond, angle,
|
||||||
dihedral, improper calculations, computation and data transfer to the
|
dihedral, improper calculations, computation and data transfer to the
|
||||||
coprocessor will run concurrently with computations and MPI
|
coprocessor will run concurrently with computations and MPI
|
||||||
communications for these calculations on the host CPU. The USER-INTEL
|
communications for these calculations on the host CPU. The USER-INTEL
|
||||||
package has two modes for deciding which atoms will be handled by the
|
package has two modes for deciding which atoms will be handled by the
|
||||||
coprocessor. This choice is controlled with the <em>ghost</em> keyword of
|
coprocessor. This choice is controlled with the <I>ghost</I> keyword of
|
||||||
the <a class="reference internal" href="package.html"><em>package intel</em></a> command. When set to 0, ghost atoms
|
the <A HREF = "package.html">package intel</A> command. When set to 0, ghost atoms
|
||||||
(atoms at the borders between MPI tasks) are not offloaded to the
|
(atoms at the borders between MPI tasks) are not offloaded to the
|
||||||
card. This allows for overlap of MPI communication of forces with
|
card. This allows for overlap of MPI communication of forces with
|
||||||
computation on the coprocessor when the <a class="reference internal" href="newton.html"><em>newton</em></a> setting
|
computation on the coprocessor when the <A HREF = "newton.html">newton</A> setting
|
||||||
is “on”. The default is dependent on the style being used, however,
|
is "on". The default is dependent on the style being used, however,
|
||||||
better performance may be achieved by setting this option
|
better performance may be achieved by setting this option
|
||||||
explictly.</li>
|
explictly.
|
||||||
</ul>
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>When offloading to a coprocessor, <a class="reference internal" href="pair_hybrid.html"><em>hybrid</em></a> styles
|
<P>When offloading to a coprocessor, <A HREF = "pair_hybrid.html">hybrid</A> styles
|
||||||
that require skip lists for neighbor builds cannot be offloaded.
|
that require skip lists for neighbor builds cannot be offloaded.
|
||||||
Using <a class="reference internal" href="pair_hybrid.html"><em>hybrid/overlay</em></a> is allowed. Only one intel
|
Using <A HREF = "pair_hybrid.html">hybrid/overlay</A> is allowed. Only one intel
|
||||||
accelerated style may be used with hybrid styles.
|
accelerated style may be used with hybrid styles.
|
||||||
<a class="reference internal" href="special_bonds.html"><em>Special_bonds</em></a> exclusion lists are not currently
|
<A HREF = "special_bonds.html">Special_bonds</A> exclusion lists are not currently
|
||||||
supported with offload, however, the same effect can often be
|
supported with offload, however, the same effect can often be
|
||||||
accomplished by setting cutoffs for excluded atom types to 0. None of
|
accomplished by setting cutoffs for excluded atom types to 0. None of
|
||||||
the pair styles in the USER-INTEL package currently support the
|
the pair styles in the USER-INTEL package currently support the
|
||||||
“inner”, “middle”, “outer” options for rRESPA integration via the
|
"inner", "middle", "outer" options for rRESPA integration via the
|
||||||
<a class="reference internal" href="run_style.html"><em>run_style respa</em></a> command; only the “pair” option is
|
<A HREF = "run_style.html">run_style respa</A> command; only the "pair" option is
|
||||||
supported.</p>
|
supported.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,502 +1,446 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_packages.html">Previous Section</A> - <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>
|
||||||
|
|
||||||
|
|
||||||
<!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>5.KOKKOS package — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<P><A HREF = "Section_accelerate.html">Return to Section accelerate overview</A>
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</P>
|
||||||
|
<H4>5.3.4 KOKKOS package
|
||||||
<li>5.KOKKOS package</li>
|
</H4>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P>The KOKKOS package was developed primaritly by Christian Trott
|
||||||
|
|
||||||
|
|
||||||
<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">
|
|
||||||
|
|
||||||
<p><a class="reference internal" href="Section_accelerate.html"><em>Return to Section accelerate overview</em></a></p>
|
|
||||||
<div class="section" id="kokkos-package">
|
|
||||||
<h1>5.KOKKOS package<a class="headerlink" href="#kokkos-package" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>The KOKKOS package was developed primaritly by Christian Trott
|
|
||||||
(Sandia) with contributions of various styles by others, including
|
(Sandia) with contributions of various styles by others, including
|
||||||
Sikandar Mashayak (UIUC), Stan Moore (Sandia), and Ray Shan (Sandia).
|
Sikandar Mashayak (UIUC), Stan Moore (Sandia), and Ray Shan (Sandia).
|
||||||
The underlying Kokkos library was written
|
The underlying Kokkos library was written
|
||||||
primarily by Carter Edwards, Christian Trott, and Dan Sunderland (all
|
primarily by Carter Edwards, Christian Trott, and Dan Sunderland (all
|
||||||
Sandia).</p>
|
Sandia).
|
||||||
<p>The KOKKOS package contains versions of pair, fix, and atom styles
|
</P>
|
||||||
|
<P>The KOKKOS package contains versions of pair, fix, and atom styles
|
||||||
that use data structures and macros provided by the Kokkos library,
|
that use data structures and macros provided by the Kokkos library,
|
||||||
which is included with LAMMPS in lib/kokkos.</p>
|
which is included with LAMMPS in lib/kokkos.
|
||||||
<p>The Kokkos library is part of
|
</P>
|
||||||
<a class="reference external" href="http://trilinos.sandia.gov/packages/kokkos">Trilinos</a> and can also
|
<P>The Kokkos library is part of
|
||||||
be downloaded from <a class="reference external" href="https://github.com/kokkos/kokkos">Github</a>. Kokkos is a
|
<A HREF = "http://trilinos.sandia.gov/packages/kokkos">Trilinos</A> and can also
|
||||||
|
be downloaded from <A HREF = "https://github.com/kokkos/kokkos">Github</A>. Kokkos is a
|
||||||
templated C++ library that provides two key abstractions for an
|
templated C++ library that provides two key abstractions for an
|
||||||
application like LAMMPS. First, it allows a single implementation of
|
application like LAMMPS. First, it allows a single implementation of
|
||||||
an application kernel (e.g. a pair style) to run efficiently on
|
an application kernel (e.g. a pair style) to run efficiently on
|
||||||
different kinds of hardware, such as a GPU, Intel Phi, or many-core
|
different kinds of hardware, such as a GPU, Intel Phi, or many-core
|
||||||
chip.</p>
|
chip.
|
||||||
<p>The Kokkos library also provides data abstractions to adjust (at
|
</P>
|
||||||
|
<P>The Kokkos library also provides data abstractions to adjust (at
|
||||||
compile time) the memory layout of basic data structures like 2d and
|
compile time) the memory layout of basic data structures like 2d and
|
||||||
3d arrays and allow the transparent utilization of special hardware
|
3d arrays and allow the transparent utilization of special hardware
|
||||||
load and store operations. Such data structures are used in LAMMPS to
|
load and store operations. Such data structures are used in LAMMPS to
|
||||||
store atom coordinates or forces or neighbor lists. The layout is
|
store atom coordinates or forces or neighbor lists. The layout is
|
||||||
chosen to optimize performance on different platforms. Again this
|
chosen to optimize performance on different platforms. Again this
|
||||||
functionality is hidden from the developer, and does not affect how
|
functionality is hidden from the developer, and does not affect how
|
||||||
the kernel is coded.</p>
|
the kernel is coded.
|
||||||
<p>These abstractions are set at build time, when LAMMPS is compiled with
|
</P>
|
||||||
the KOKKOS package installed. This is done by selecting a “host” and
|
<P>These abstractions are set at build time, when LAMMPS is compiled with
|
||||||
“device” to build for, compatible with the compute nodes in your
|
the KOKKOS package installed. This is done by selecting a "host" and
|
||||||
machine (one on a desktop machine or 1000s on a supercomputer).</p>
|
"device" to build for, compatible with the compute nodes in your
|
||||||
<p>All Kokkos operations occur within the context of an individual MPI
|
machine (one on a desktop machine or 1000s on a supercomputer).
|
||||||
|
</P>
|
||||||
|
<P>All Kokkos operations occur within the context of an individual MPI
|
||||||
task running on a single node of the machine. The total number of MPI
|
task running on a single node of the machine. The total number of MPI
|
||||||
tasks used by LAMMPS (one or multiple per compute node) is set in the
|
tasks used by LAMMPS (one or multiple per compute node) is set in the
|
||||||
usual manner via the mpirun or mpiexec commands, and is independent of
|
usual manner via the mpirun or mpiexec commands, and is independent of
|
||||||
Kokkos.</p>
|
Kokkos.
|
||||||
<p>Kokkos provides support for two different modes of execution per MPI
|
</P>
|
||||||
|
<P>Kokkos provides support for two different modes of execution per MPI
|
||||||
task. This means that computational tasks (pairwise interactions,
|
task. This means that computational tasks (pairwise interactions,
|
||||||
neighbor list builds, time integration, etc) can be parallelized for
|
neighbor list builds, time integration, etc) can be parallelized for
|
||||||
one or the other of the two modes. The first mode is called the
|
one or the other of the two modes. The first mode is called the
|
||||||
“host” and is one or more threads running on one or more physical CPUs
|
"host" and is one or more threads running on one or more physical CPUs
|
||||||
(within the node). Currently, both multi-core CPUs and an Intel Phi
|
(within the node). Currently, both multi-core CPUs and an Intel Phi
|
||||||
processor (running in native mode, not offload mode like the
|
processor (running in native mode, not offload mode like the
|
||||||
USER-INTEL package) are supported. The second mode is called the
|
USER-INTEL package) are supported. The second mode is called the
|
||||||
“device” and is an accelerator chip of some kind. Currently only an
|
"device" and is an accelerator chip of some kind. Currently only an
|
||||||
NVIDIA GPU is supported via Cuda. If your compute node does not have
|
NVIDIA GPU is supported via Cuda. If your compute node does not have
|
||||||
a GPU, then there is only one mode of execution, i.e. the host and
|
a GPU, then there is only one mode of execution, i.e. the host and
|
||||||
device are the same.</p>
|
device are the same.
|
||||||
<p>When using the KOKKOS package, you must choose at build time whether
|
</P>
|
||||||
|
<P>When using the KOKKOS package, you must choose at build time whether
|
||||||
you are building for OpenMP, GPU, or for using the Xeon Phi in native
|
you are building for OpenMP, GPU, or for using the Xeon Phi in native
|
||||||
mode.</p>
|
mode.
|
||||||
<p>Here is a quick overview of how to use the KOKKOS package:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>Here is a quick overview of how to use the KOKKOS package:
|
||||||
<li>specify variables and settings in your Makefile.machine that enable OpenMP, GPU, or Phi support</li>
|
</P>
|
||||||
<li>include the KOKKOS package and build LAMMPS</li>
|
<UL><LI>specify variables and settings in your Makefile.machine that enable OpenMP, GPU, or Phi support
|
||||||
<li>enable the KOKKOS package and its hardware options via the “-k on” command-line switch use KOKKOS styles in your input script</li>
|
<LI>include the KOKKOS package and build LAMMPS
|
||||||
</ul>
|
<LI>enable the KOKKOS package and its hardware options via the "-k on" command-line switch use KOKKOS styles in your input script
|
||||||
<p>The latter two steps can be done using the “-k on”, “-pk kokkos” and
|
</UL>
|
||||||
“-sf kk” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a>
|
<P>The latter two steps can be done using the "-k on", "-pk kokkos" and
|
||||||
respectively. Or the effect of the “-pk” or “-sf” switches can be
|
"-sf kk" <A HREF = "Section_start.html#start_7">command-line switches</A>
|
||||||
duplicated by adding the <a class="reference internal" href="package.html"><em>package kokkos</em></a> or <a class="reference internal" href="suffix.html"><em>suffix kk</em></a> commands respectively to your input script.</p>
|
respectively. Or the effect of the "-pk" or "-sf" switches can be
|
||||||
<p><strong>Required hardware/software:</strong></p>
|
duplicated by adding the <A HREF = "package.html">package kokkos</A> or <A HREF = "suffix.html">suffix
|
||||||
<p>The KOKKOS package can be used to build and run LAMMPS on the
|
kk</A> commands respectively to your input script.
|
||||||
following kinds of hardware:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P><B>Required hardware/software:</B>
|
||||||
<li>CPU-only: one MPI task per CPU core (MPI-only, but using KOKKOS styles)</li>
|
</P>
|
||||||
<li>CPU-only: one or a few MPI tasks per node with additional threading via OpenMP</li>
|
<P>The KOKKOS package can be used to build and run LAMMPS on the
|
||||||
<li>Phi: on one or more Intel Phi coprocessors (per node)</li>
|
following kinds of hardware:
|
||||||
<li>GPU: on the GPUs of a node with additional OpenMP threading on the CPUs</li>
|
</P>
|
||||||
</ul>
|
<UL><LI>CPU-only: one MPI task per CPU core (MPI-only, but using KOKKOS styles)
|
||||||
<p>Kokkos support within LAMMPS must be built with a C++11 compatible
|
<LI>CPU-only: one or a few MPI tasks per node with additional threading via OpenMP
|
||||||
compiler. For example, gcc 4.7.2 or later.</p>
|
<LI>Phi: on one or more Intel Phi coprocessors (per node)
|
||||||
<p>Note that Intel Xeon Phi coprocessors are supported in “native” mode,
|
<LI>GPU: on the GPUs of a node with additional OpenMP threading on the CPUs
|
||||||
not “offload” mode like the USER-INTEL package supports.</p>
|
</UL>
|
||||||
<p>Only NVIDIA GPUs are currently supported.</p>
|
<P>Kokkos support within LAMMPS must be built with a C++11 compatible
|
||||||
<div class="admonition warning">
|
compiler. For example, gcc 4.7.2 or later.
|
||||||
<p class="first admonition-title">Warning</p>
|
</P>
|
||||||
<p class="last">For good performance of the KOKKOS package on GPUs,
|
<P>Note that Intel Xeon Phi coprocessors are supported in "native" mode,
|
||||||
|
not "offload" mode like the USER-INTEL package supports.
|
||||||
|
</P>
|
||||||
|
<P>Only NVIDIA GPUs are currently supported.
|
||||||
|
</P>
|
||||||
|
<P>IMPORTANT NOTE: For good performance of the KOKKOS package on GPUs,
|
||||||
you must have Kepler generation GPUs (or later). The Kokkos library
|
you must have Kepler generation GPUs (or later). The Kokkos library
|
||||||
exploits texture cache options not supported by Telsa generation GPUs
|
exploits texture cache options not supported by Telsa generation GPUs
|
||||||
(or older).</p>
|
(or older).
|
||||||
</div>
|
</P>
|
||||||
<p>To build the KOKKOS package for GPUs, NVIDIA Cuda software must be
|
<P>To build the KOKKOS package for GPUs, NVIDIA Cuda software must be
|
||||||
installed on your system. See the discussion above for the USER-CUDA
|
installed on your system. See the discussion above for the USER-CUDA
|
||||||
and GPU packages for details of how to check and do this.</p>
|
and GPU packages for details of how to check and do this.
|
||||||
<p><strong>Building LAMMPS with the KOKKOS package:</strong></p>
|
</P>
|
||||||
<p>You must choose at build time whether to build for OpenMP, Cuda, or
|
<P><B>Building LAMMPS with the KOKKOS package:</B>
|
||||||
Phi.</p>
|
</P>
|
||||||
<p>You can do any of these in one line, using the src/Make.py script,
|
<P>You must choose at build time whether to build for OpenMP, Cuda, or
|
||||||
described in <a class="reference internal" href="Section_start.html#start-4"><span>Section 2.4</span></a> of the manual.
|
Phi.
|
||||||
Type “Make.py -h” for help. If run from the src directory, these
|
</P>
|
||||||
|
<P>You can do any of these in one line, using the src/Make.py script,
|
||||||
|
described in <A HREF = "Section_start.html#start_4">Section 2.4</A> of the manual.
|
||||||
|
Type "Make.py -h" for help. If run from the src directory, these
|
||||||
commands will create src/lmp_kokkos_omp, lmp_kokkos_cuda, and
|
commands will create src/lmp_kokkos_omp, lmp_kokkos_cuda, and
|
||||||
lmp_kokkos_phi. Note that the OMP and PHI options use
|
lmp_kokkos_phi. Note that the OMP and PHI options use
|
||||||
src/MAKE/Makefile.mpi as the starting Makefile.machine. The CUDA
|
src/MAKE/Makefile.mpi as the starting Makefile.machine. The CUDA
|
||||||
option uses src/MAKE/OPTIONS/Makefile.kokkos_cuda.</p>
|
option uses src/MAKE/OPTIONS/Makefile.kokkos_cuda.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Make.py -p kokkos -kokkos omp -o kokkos_omp -a file mpi
|
</P>
|
||||||
|
<PRE>Make.py -p kokkos -kokkos omp -o kokkos_omp -a file mpi
|
||||||
Make.py -p kokkos -kokkos cuda arch=31 -o kokkos_cuda -a file kokkos_cuda
|
Make.py -p kokkos -kokkos cuda arch=31 -o kokkos_cuda -a file kokkos_cuda
|
||||||
Make.py -p kokkos -kokkos phi -o kokkos_phi -a file mpi
|
Make.py -p kokkos -kokkos phi -o kokkos_phi -a file mpi
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Or you can follow these steps:
|
||||||
<p>Or you can follow these steps:</p>
|
</P>
|
||||||
<p>CPU-only (run all-MPI or with OpenMP threading):</p>
|
<P>CPU-only (run all-MPI or with OpenMP threading):
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
</P>
|
||||||
|
<PRE>cd lammps/src
|
||||||
make yes-kokkos
|
make yes-kokkos
|
||||||
make g++ KOKKOS_DEVICES=OpenMP
|
make g++ KOKKOS_DEVICES=OpenMP
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Intel Xeon Phi:
|
||||||
<p>Intel Xeon Phi:</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
<PRE>cd lammps/src
|
||||||
make yes-kokkos
|
make yes-kokkos
|
||||||
make g++ KOKKOS_DEVICES=OpenMP KOKKOS_ARCH=KNC
|
make g++ KOKKOS_DEVICES=OpenMP KOKKOS_ARCH=KNC
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>CPUs and GPUs:
|
||||||
<p>CPUs and GPUs:</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
<PRE>cd lammps/src
|
||||||
make yes-kokkos
|
make yes-kokkos
|
||||||
make cuda KOKKOS_DEVICES=Cuda
|
make cuda KOKKOS_DEVICES=Cuda
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>These examples set the KOKKOS-specific OMP, MIC, CUDA variables on the
|
||||||
<p>These examples set the KOKKOS-specific OMP, MIC, CUDA variables on the
|
|
||||||
make command line which requires a GNU-compatible make command. Try
|
make command line which requires a GNU-compatible make command. Try
|
||||||
“gmake” if your system’s standard make complains.</p>
|
"gmake" if your system's standard make complains.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: If you build using make line variables and re-build
|
||||||
<p class="last">If you build using make line variables and re-build
|
LAMMPS twice with different KOKKOS options and the *same* target,
|
||||||
LAMMPS twice with different KOKKOS options and the <em>same</em> target,
|
e.g. g++ in the first two examples above, then you *must* perform a
|
||||||
e.g. g++ in the first two examples above, then you <em>must</em> perform a
|
"make clean-all" or "make clean-machine" before each build. This is
|
||||||
“make clean-all” or “make clean-machine” before each build. This is
|
|
||||||
to force all the KOKKOS-dependent files to be re-compiled with the new
|
to force all the KOKKOS-dependent files to be re-compiled with the new
|
||||||
options.</p>
|
options.
|
||||||
</div>
|
</P>
|
||||||
<p>You can also hardwire these make variables in the specified machine
|
<P>You can also hardwire these make variables in the specified machine
|
||||||
makefile, e.g. src/MAKE/Makefile.g++ in the first two examples above,
|
makefile, e.g. src/MAKE/Makefile.g++ in the first two examples above,
|
||||||
with a line like:</p>
|
with a line like:
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="n">KOKKOS_ARCH</span> <span class="o">=</span> <span class="n">KNC</span>
|
</P>
|
||||||
</pre></div>
|
<PRE>KOKKOS_ARCH = KNC
|
||||||
</div>
|
</PRE>
|
||||||
<p>Note that if you build LAMMPS multiple times in this manner, using
|
<P>Note that if you build LAMMPS multiple times in this manner, using
|
||||||
different KOKKOS options (defined in different machine makefiles), you
|
different KOKKOS options (defined in different machine makefiles), you
|
||||||
do not have to worry about doing a “clean” in between. This is
|
do not have to worry about doing a "clean" in between. This is
|
||||||
because the targets will be different.</p>
|
because the targets will be different.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The 3rd example above for a GPU, uses a different
|
||||||
<p class="last">The 3rd example above for a GPU, uses a different
|
|
||||||
machine makefile, in this case src/MAKE/Makefile.cuda, which is
|
machine makefile, in this case src/MAKE/Makefile.cuda, which is
|
||||||
included in the LAMMPS distribution. To build the KOKKOS package for
|
included in the LAMMPS distribution. To build the KOKKOS package for
|
||||||
a GPU, this makefile must use the NVIDA “nvcc” compiler. And it must
|
a GPU, this makefile must use the NVIDA "nvcc" compiler. And it must
|
||||||
have a KOKKOS_ARCH setting that is appropriate for your NVIDIA
|
have a KOKKOS_ARCH setting that is appropriate for your NVIDIA
|
||||||
hardware and installed software. Typical values for KOKKOS_ARCH are given
|
hardware and installed software. Typical values for KOKKOS_ARCH are given
|
||||||
below, as well
|
below, as well
|
||||||
as other settings that must be included in the machine makefile, if
|
as other settings that must be included in the machine makefile, if
|
||||||
you create your own.</p>
|
you create your own.
|
||||||
</div>
|
</P>
|
||||||
<div class="admonition warning">
|
<P>IMPORTANT NOTE: Currently, there are no precision options with the
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">Currently, there are no precision options with the
|
|
||||||
KOKKOS package. All compilation and computation is performed in
|
KOKKOS package. All compilation and computation is performed in
|
||||||
double precision.</p>
|
double precision.
|
||||||
</div>
|
</P>
|
||||||
<p>There are other allowed options when building with the KOKKOS package.
|
<P>There are other allowed options when building with the KOKKOS package.
|
||||||
As above, they can be set either as variables on the make command line
|
As above, they can be set either as variables on the make command line
|
||||||
or in Makefile.machine. This is the full list of options, including
|
or in Makefile.machine. This is the full list of options, including
|
||||||
those discussed above, Each takes a value shown below. The
|
those discussed above, Each takes a value shown below. The
|
||||||
default value is listed, which is set in the
|
default value is listed, which is set in the
|
||||||
lib/kokkos/Makefile.kokkos file.</p>
|
lib/kokkos/Makefile.kokkos file.
|
||||||
<p>#Default settings specific options
|
</P>
|
||||||
#Options: force_uvm,use_ldg,rdc</p>
|
<P>#Default settings specific options
|
||||||
<ul class="simple">
|
#Options: force_uvm,use_ldg,rdc
|
||||||
<li>KOKKOS_DEVICES, values = <em>OpenMP</em>, <em>Serial</em>, <em>Pthreads</em>, <em>Cuda</em>, default = <em>OpenMP</em></li>
|
</P>
|
||||||
<li>KOKKOS_ARCH, values = <em>KNC</em>, <em>SNB</em>, <em>HSW</em>, <em>Kepler</em>, <em>Kepler30</em>, <em>Kepler32</em>, <em>Kepler35</em>, <em>Kepler37</em>, <em>Maxwell</em>, <em>Maxwell50</em>, <em>Maxwell52</em>, <em>Maxwell53</em>, <em>ARMv8</em>, <em>BGQ</em>, <em>Power7</em>, <em>Power8</em>, default = <em>none</em></li>
|
<UL><LI>KOKKOS_DEVICES, values = <I>OpenMP</I>, <I>Serial</I>, <I>Pthreads</I>, <I>Cuda</I>, default = <I>OpenMP</I>
|
||||||
<li>KOKKOS_DEBUG, values = <em>yes</em>, <em>no</em>, default = <em>no</em></li>
|
<LI>KOKKOS_ARCH, values = <I>KNC</I>, <I>SNB</I>, <I>HSW</I>, <I>Kepler</I>, <I>Kepler30</I>, <I>Kepler32</I>, <I>Kepler35</I>, <I>Kepler37</I>, <I>Maxwell</I>, <I>Maxwell50</I>, <I>Maxwell52</I>, <I>Maxwell53</I>, <I>ARMv8</I>, <I>BGQ</I>, <I>Power7</I>, <I>Power8</I>, default = <I>none</I>
|
||||||
<li>KOKKOS_USE_TPLS, values = <em>hwloc</em>, <em>librt</em>, default = <em>none</em></li>
|
<LI>KOKKOS_DEBUG, values = <I>yes</I>, <I>no</I>, default = <I>no</I>
|
||||||
<li>KOKKOS_CUDA_OPTIONS, values = <em>force_uvm</em>, <em>use_ldg</em>, <em>rdc</em></li>
|
<LI>KOKKOS_USE_TPLS, values = <I>hwloc</I>, <I>librt</I>, default = <I>none</I>
|
||||||
</ul>
|
<LI>KOKKOS_CUDA_OPTIONS, values = <I>force_uvm</I>, <I>use_ldg</I>, <I>rdc</I>
|
||||||
<p>KOKKOS_DEVICE sets the parallelization method used for Kokkos code
|
</UL>
|
||||||
|
<P>KOKKOS_DEVICE sets the parallelization method used for Kokkos code
|
||||||
(within LAMMPS). KOKKOS_DEVICES=OpenMP means that OpenMP will be
|
(within LAMMPS). KOKKOS_DEVICES=OpenMP means that OpenMP will be
|
||||||
used. KOKKOS_DEVICES=Pthreads means that pthreads will be used.
|
used. KOKKOS_DEVICES=Pthreads means that pthreads will be used.
|
||||||
KOKKOS_DEVICES=Cuda means an NVIDIA GPU running CUDA will be used.</p>
|
KOKKOS_DEVICES=Cuda means an NVIDIA GPU running CUDA will be used.
|
||||||
<p>If KOKKOS_DEVICES=Cuda, then the lo-level Makefile in the src/MAKE
|
</P>
|
||||||
directory must use “nvcc” as its compiler, via its CC setting. For
|
<P>If KOKKOS_DEVICES=Cuda, then the lo-level Makefile in the src/MAKE
|
||||||
|
directory must use "nvcc" as its compiler, via its CC setting. For
|
||||||
best performance its CCFLAGS setting should use -O3 and have a
|
best performance its CCFLAGS setting should use -O3 and have a
|
||||||
KOKKOS_ARCH setting that matches the compute capability of your NVIDIA
|
KOKKOS_ARCH setting that matches the compute capability of your NVIDIA
|
||||||
hardware and software installation, e.g. KOKKOS_ARCH=Kepler30. Note
|
hardware and software installation, e.g. KOKKOS_ARCH=Kepler30. Note
|
||||||
the minimal required compute capability is 2.0, but this will give
|
the minimal required compute capability is 2.0, but this will give
|
||||||
signicantly reduced performance compared to Kepler generation GPUs
|
signicantly reduced performance compared to Kepler generation GPUs
|
||||||
with compute capability 3.x. For the LINK setting, “nvcc” should not
|
with compute capability 3.x. For the LINK setting, "nvcc" should not
|
||||||
be used; instead use g++ or another compiler suitable for linking C++
|
be used; instead use g++ or another compiler suitable for linking C++
|
||||||
applications. Often you will want to use your MPI compiler wrapper
|
applications. Often you will want to use your MPI compiler wrapper
|
||||||
for this setting (i.e. mpicxx). Finally, the lo-level Makefile must
|
for this setting (i.e. mpicxx). Finally, the lo-level Makefile must
|
||||||
also have a “Compilation rule” for creating <a href="#id1"><span class="problematic" id="id2">*</span></a>.o files from <a href="#id3"><span class="problematic" id="id4">*</span></a>.cu files.
|
also have a "Compilation rule" for creating *.o files from *.cu files.
|
||||||
See src/Makefile.cuda for an example of a lo-level Makefile with all
|
See src/Makefile.cuda for an example of a lo-level Makefile with all
|
||||||
of these settings.</p>
|
of these settings.
|
||||||
<p>KOKKOS_USE_TPLS=hwloc binds threads to hardware cores, so they do not
|
</P>
|
||||||
|
<P>KOKKOS_USE_TPLS=hwloc binds threads to hardware cores, so they do not
|
||||||
migrate during a simulation. KOKKOS_USE_TPLS=hwloc should always be
|
migrate during a simulation. KOKKOS_USE_TPLS=hwloc should always be
|
||||||
used if running with KOKKOS_DEVICES=Pthreads for pthreads. It is not
|
used if running with KOKKOS_DEVICES=Pthreads for pthreads. It is not
|
||||||
necessary for KOKKOS_DEVICES=OpenMP for OpenMP, because OpenMP
|
necessary for KOKKOS_DEVICES=OpenMP for OpenMP, because OpenMP
|
||||||
provides alternative methods via environment variables for binding
|
provides alternative methods via environment variables for binding
|
||||||
threads to hardware cores. More info on binding threads to cores is
|
threads to hardware cores. More info on binding threads to cores is
|
||||||
given in <span class="xref std std-ref">this section</span>.</p>
|
given in <A HREF = "Section_accelerate.html#acc_8">this section</A>.
|
||||||
<p>KOKKOS_ARCH=KNC enables compiler switches needed when compling for an
|
</P>
|
||||||
Intel Phi processor.</p>
|
<P>KOKKOS_ARCH=KNC enables compiler switches needed when compling for an
|
||||||
<p>KOKKOS_USE_TPLS=librt enables use of a more accurate timer mechanism
|
Intel Phi processor.
|
||||||
|
</P>
|
||||||
|
<P>KOKKOS_USE_TPLS=librt enables use of a more accurate timer mechanism
|
||||||
on most Unix platforms. This library is not available on all
|
on most Unix platforms. This library is not available on all
|
||||||
platforms.</p>
|
platforms.
|
||||||
<p>KOKKOS_DEBUG is only useful when developing a Kokkos-enabled style
|
</P>
|
||||||
|
<P>KOKKOS_DEBUG is only useful when developing a Kokkos-enabled style
|
||||||
within LAMMPS. KOKKOS_DEBUG=yes enables printing of run-time
|
within LAMMPS. KOKKOS_DEBUG=yes enables printing of run-time
|
||||||
debugging information that can be useful. It also enables runtime
|
debugging information that can be useful. It also enables runtime
|
||||||
bounds checking on Kokkos data structures.</p>
|
bounds checking on Kokkos data structures.
|
||||||
<p>KOKKOS_CUDA_OPTIONS are additional options for CUDA.</p>
|
</P>
|
||||||
<p>For more information on Kokkos see the Kokkos programmers’ guide here:
|
<P>KOKKOS_CUDA_OPTIONS are additional options for CUDA.
|
||||||
/lib/kokkos/doc/Kokkos_PG.pdf.</p>
|
</P>
|
||||||
<p><strong>Run with the KOKKOS package from the command line:</strong></p>
|
<P>For more information on Kokkos see the Kokkos programmers' guide here:
|
||||||
<p>The mpirun or mpiexec command sets the total number of MPI tasks used
|
/lib/kokkos/doc/Kokkos_PG.pdf.
|
||||||
|
</P>
|
||||||
|
<P><B>Run with the KOKKOS package from the command line:</B>
|
||||||
|
</P>
|
||||||
|
<P>The mpirun or mpiexec command sets the total number of MPI tasks used
|
||||||
by LAMMPS (one or multiple per compute node) and the number of MPI
|
by LAMMPS (one or multiple per compute node) and the number of MPI
|
||||||
tasks used per node. E.g. the mpirun command in MPICH does this via
|
tasks used per node. E.g. the mpirun command in MPICH does this via
|
||||||
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.</p>
|
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.
|
||||||
<p>When using KOKKOS built with host=OMP, you need to choose how many
|
</P>
|
||||||
OpenMP threads per MPI task will be used (via the “-k” command-line
|
<P>When using KOKKOS built with host=OMP, you need to choose how many
|
||||||
|
OpenMP threads per MPI task will be used (via the "-k" command-line
|
||||||
switch discussed below). Note that the product of MPI tasks * OpenMP
|
switch discussed below). Note that the product of MPI tasks * OpenMP
|
||||||
threads/task should not exceed the physical number of cores (on a
|
threads/task should not exceed the physical number of cores (on a
|
||||||
node), otherwise performance will suffer.</p>
|
node), otherwise performance will suffer.
|
||||||
<p>When using the KOKKOS package built with device=CUDA, you must use
|
</P>
|
||||||
exactly one MPI task per physical GPU.</p>
|
<P>When using the KOKKOS package built with device=CUDA, you must use
|
||||||
<p>When using the KOKKOS package built with host=MIC for Intel Xeon Phi
|
exactly one MPI task per physical GPU.
|
||||||
|
</P>
|
||||||
|
<P>When using the KOKKOS package built with host=MIC for Intel Xeon Phi
|
||||||
coprocessor support you need to insure there are one or more MPI tasks
|
coprocessor support you need to insure there are one or more MPI tasks
|
||||||
per coprocessor, and choose the number of coprocessor threads to use
|
per coprocessor, and choose the number of coprocessor threads to use
|
||||||
per MPI task (via the “-k” command-line switch discussed below). The
|
per MPI task (via the "-k" command-line switch discussed below). The
|
||||||
product of MPI tasks * coprocessor threads/task should not exceed the
|
product of MPI tasks * coprocessor threads/task should not exceed the
|
||||||
maximum number of threads the coproprocessor is designed to run,
|
maximum number of threads the coproprocessor is designed to run,
|
||||||
otherwise performance will suffer. This value is 240 for current
|
otherwise performance will suffer. This value is 240 for current
|
||||||
generation Xeon Phi(TM) chips, which is 60 physical cores * 4
|
generation Xeon Phi(TM) chips, which is 60 physical cores * 4
|
||||||
threads/core. Note that with the KOKKOS package you do not need to
|
threads/core. Note that with the KOKKOS package you do not need to
|
||||||
specify how many Phi coprocessors there are per node; each
|
specify how many Phi coprocessors there are per node; each
|
||||||
coprocessors is simply treated as running some number of MPI tasks.</p>
|
coprocessors is simply treated as running some number of MPI tasks.
|
||||||
<p>You must use the “-k on” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to enable the KOKKOS package. It
|
</P>
|
||||||
|
<P>You must use the "-k on" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switch</A> to enable the KOKKOS package. It
|
||||||
takes additional arguments for hardware settings appropriate to your
|
takes additional arguments for hardware settings appropriate to your
|
||||||
system. Those arguments are <a class="reference internal" href="Section_start.html#start-7"><span>documented here</span></a>. The two most commonly used
|
system. Those arguments are <A HREF = "Section_start.html#start_7">documented
|
||||||
options are:</p>
|
here</A>. The two most commonly used
|
||||||
<div class="highlight-python"><div class="highlight"><pre>-k on t Nt g Ng
|
options are:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>-k on t Nt g Ng
|
||||||
<p>The “t Nt” option applies to host=OMP (even if device=CUDA) and
|
</PRE>
|
||||||
|
<P>The "t Nt" option applies to host=OMP (even if device=CUDA) and
|
||||||
host=MIC. For host=OMP, it specifies how many OpenMP threads per MPI
|
host=MIC. For host=OMP, it specifies how many OpenMP threads per MPI
|
||||||
task to use with a node. For host=MIC, it specifies how many Xeon Phi
|
task to use with a node. For host=MIC, it specifies how many Xeon Phi
|
||||||
threads per MPI task to use within a node. The default is Nt = 1.
|
threads per MPI task to use within a node. The default is Nt = 1.
|
||||||
Note that for host=OMP this is effectively MPI-only mode which may be
|
Note that for host=OMP this is effectively MPI-only mode which may be
|
||||||
fine. But for host=MIC you will typically end up using far less than
|
fine. But for host=MIC you will typically end up using far less than
|
||||||
all the 240 available threads, which could give very poor performance.</p>
|
all the 240 available threads, which could give very poor performance.
|
||||||
<p>The “g Ng” option applies to device=CUDA. It specifies how many GPUs
|
</P>
|
||||||
|
<P>The "g Ng" option applies to device=CUDA. It specifies how many GPUs
|
||||||
per compute node to use. The default is 1, so this only needs to be
|
per compute node to use. The default is 1, so this only needs to be
|
||||||
specified is you have 2 or more GPUs per compute node.</p>
|
specified is you have 2 or more GPUs per compute node.
|
||||||
<p>The “-k on” switch also issues a “package kokkos” command (with no
|
</P>
|
||||||
|
<P>The "-k on" switch also issues a "package kokkos" command (with no
|
||||||
additional arguments) which sets various KOKKOS options to default
|
additional arguments) which sets various KOKKOS options to default
|
||||||
values, as discussed on the <a class="reference internal" href="package.html"><em>package</em></a> command doc page.</p>
|
values, as discussed on the <A HREF = "package.html">package</A> command doc page.
|
||||||
<p>Use the “-sf kk” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>,
|
</P>
|
||||||
which will automatically append “kk” to styles that support it. Use
|
<P>Use the "-sf kk" <A HREF = "Section_start.html#start_7">command-line switch</A>,
|
||||||
the “-pk kokkos” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> if
|
which will automatically append "kk" to styles that support it. Use
|
||||||
you wish to change any of the default <a class="reference internal" href="package.html"><em>package kokkos</em></a>
|
the "-pk kokkos" <A HREF = "Section_start.html#start_7">command-line switch</A> if
|
||||||
optionns set by the “-k on” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>.</p>
|
you wish to change any of the default <A HREF = "package.html">package kokkos</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>host=OMP, dual hex-core nodes (12 threads/node):
|
optionns set by the "-k on" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switch</A>.
|
||||||
|
</P>
|
||||||
|
<PRE>host=OMP, dual hex-core nodes (12 threads/node):
|
||||||
mpirun -np 12 lmp_g++ -in in.lj # MPI-only mode with no Kokkos
|
mpirun -np 12 lmp_g++ -in in.lj # MPI-only mode with no Kokkos
|
||||||
mpirun -np 12 lmp_g++ -k on -sf kk -in in.lj # MPI-only mode with Kokkos
|
mpirun -np 12 lmp_g++ -k on -sf kk -in in.lj # MPI-only mode with Kokkos
|
||||||
mpirun -np 1 lmp_g++ -k on t 12 -sf kk -in in.lj # one MPI task, 12 threads
|
mpirun -np 1 lmp_g++ -k on t 12 -sf kk -in in.lj # one MPI task, 12 threads
|
||||||
mpirun -np 2 lmp_g++ -k on t 6 -sf kk -in in.lj # two MPI tasks, 6 threads/task
|
mpirun -np 2 lmp_g++ -k on t 6 -sf kk -in in.lj # two MPI tasks, 6 threads/task
|
||||||
mpirun -np 32 -ppn 2 lmp_g++ -k on t 6 -sf kk -in in.lj # ditto on 16 nodes
|
mpirun -np 32 -ppn 2 lmp_g++ -k on t 6 -sf kk -in in.lj # ditto on 16 nodes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>host=MIC, Intel Phi with 61 cores (240 threads/phi via 4x hardware threading):
|
||||||
<p>host=MIC, Intel Phi with 61 cores (240 threads/phi via 4x hardware threading):
|
|
||||||
mpirun -np 1 lmp_g++ -k on t 240 -sf kk -in in.lj # 1 MPI task on 1 Phi, 1*240 = 240
|
mpirun -np 1 lmp_g++ -k on t 240 -sf kk -in in.lj # 1 MPI task on 1 Phi, 1*240 = 240
|
||||||
mpirun -np 30 lmp_g++ -k on t 8 -sf kk -in in.lj # 30 MPI tasks on 1 Phi, 30*8 = 240
|
mpirun -np 30 lmp_g++ -k on t 8 -sf kk -in in.lj # 30 MPI tasks on 1 Phi, 30*8 = 240
|
||||||
mpirun -np 12 lmp_g++ -k on t 20 -sf kk -in in.lj # 12 MPI tasks on 1 Phi, 12*20 = 240
|
mpirun -np 12 lmp_g++ -k on t 20 -sf kk -in in.lj # 12 MPI tasks on 1 Phi, 12*20 = 240
|
||||||
mpirun -np 96 -ppn 12 lmp_g++ -k on t 20 -sf kk -in in.lj # ditto on 8 Phis</p>
|
mpirun -np 96 -ppn 12 lmp_g++ -k on t 20 -sf kk -in in.lj # ditto on 8 Phis
|
||||||
<div class="highlight-python"><div class="highlight"><pre>host=OMP, device=CUDA, node = dual hex-core CPUs and a single GPU:
|
</P>
|
||||||
|
<PRE>host=OMP, device=CUDA, node = dual hex-core CPUs and a single GPU:
|
||||||
mpirun -np 1 lmp_cuda -k on t 6 -sf kk -in in.lj # one MPI task, 6 threads on CPU
|
mpirun -np 1 lmp_cuda -k on t 6 -sf kk -in in.lj # one MPI task, 6 threads on CPU
|
||||||
mpirun -np 4 -ppn 1 lmp_cuda -k on t 6 -sf kk -in in.lj # ditto on 4 nodes
|
mpirun -np 4 -ppn 1 lmp_cuda -k on t 6 -sf kk -in in.lj # ditto on 4 nodes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE>host=OMP, device=CUDA, node = dual 8-core CPUs and 2 GPUs:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>host=OMP, device=CUDA, node = dual 8-core CPUs and 2 GPUs:
|
|
||||||
mpirun -np 2 lmp_cuda -k on t 8 g 2 -sf kk -in in.lj # two MPI tasks, 8 threads per CPU
|
mpirun -np 2 lmp_cuda -k on t 8 g 2 -sf kk -in in.lj # two MPI tasks, 8 threads per CPU
|
||||||
mpirun -np 32 -ppn 2 lmp_cuda -k on t 8 g 2 -sf kk -in in.lj # ditto on 16 nodes
|
mpirun -np 32 -ppn 2 lmp_cuda -k on t 8 g 2 -sf kk -in in.lj # ditto on 16 nodes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Note that the default for the <A HREF = "package.html">package kokkos</A> command is
|
||||||
<p>Note that the default for the <a class="reference internal" href="package.html"><em>package kokkos</em></a> command is
|
to use "full" neighbor lists and set the Newton flag to "off" for both
|
||||||
to use “full” neighbor lists and set the Newton flag to “off” for both
|
|
||||||
pairwise and bonded interactions. This typically gives fastest
|
pairwise and bonded interactions. This typically gives fastest
|
||||||
performance. If the <a class="reference internal" href="newton.html"><em>newton</em></a> command is used in the input
|
performance. If the <A HREF = "newton.html">newton</A> command is used in the input
|
||||||
script, it can override the Newton flag defaults.</p>
|
script, it can override the Newton flag defaults.
|
||||||
<p>However, when running in MPI-only mode with 1 thread per MPI task, it
|
</P>
|
||||||
will typically be faster to use “half” neighbor lists and set the
|
<P>However, when running in MPI-only mode with 1 thread per MPI task, it
|
||||||
Newton flag to “on”, just as is the case for non-accelerated pair
|
will typically be faster to use "half" neighbor lists and set the
|
||||||
styles. You can do this with the “-pk” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>.</p>
|
Newton flag to "on", just as is the case for non-accelerated pair
|
||||||
<p><strong>Or run with the KOKKOS package by editing an input script:</strong></p>
|
styles. You can do this with the "-pk" <A HREF = "Section_start.html#start_7">command-line
|
||||||
<p>The discussion above for the mpirun/mpiexec command and setting
|
switch</A>.
|
||||||
|
</P>
|
||||||
|
<P><B>Or run with the KOKKOS package by editing an input script:</B>
|
||||||
|
</P>
|
||||||
|
<P>The discussion above for the mpirun/mpiexec command and setting
|
||||||
appropriate thread and GPU values for host=OMP or host=MIC or
|
appropriate thread and GPU values for host=OMP or host=MIC or
|
||||||
device=CUDA are the same.</p>
|
device=CUDA are the same.
|
||||||
<p>You must still use the “-k on” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to enable the KOKKOS package, and
|
</P>
|
||||||
|
<P>You must still use the "-k on" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switch</A> to enable the KOKKOS package, and
|
||||||
specify its additional arguments for hardware options appopriate to
|
specify its additional arguments for hardware options appopriate to
|
||||||
your system, as documented above.</p>
|
your system, as documented above.
|
||||||
<p>Use the <a class="reference internal" href="suffix.html"><em>suffix kk</em></a> command, or you can explicitly add a
|
</P>
|
||||||
“kk” suffix to individual styles in your input script, e.g.</p>
|
<P>Use the <A HREF = "suffix.html">suffix kk</A> command, or you can explicitly add a
|
||||||
<div class="highlight-python"><div class="highlight"><pre>pair_style lj/cut/kk 2.5
|
"kk" suffix to individual styles in your input script, e.g.
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>pair_style lj/cut/kk 2.5
|
||||||
<p>You only need to use the <a class="reference internal" href="package.html"><em>package kokkos</em></a> command if you
|
</PRE>
|
||||||
wish to change any of its option defaults, as set by the “-k on”
|
<P>You only need to use the <A HREF = "package.html">package kokkos</A> command if you
|
||||||
<a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>.</p>
|
wish to change any of its option defaults, as set by the "-k on"
|
||||||
<p><strong>Speed-ups to expect:</strong></p>
|
<A HREF = "Section_start.html#start_7">command-line switch</A>.
|
||||||
<p>The performance of KOKKOS running in different modes is a function of
|
</P>
|
||||||
|
<P><B>Speed-ups to expect:</B>
|
||||||
|
</P>
|
||||||
|
<P>The performance of KOKKOS running in different modes is a function of
|
||||||
your hardware, which KOKKOS-enable styles are used, and the problem
|
your hardware, which KOKKOS-enable styles are used, and the problem
|
||||||
size.</p>
|
size.
|
||||||
<p>Generally speaking, the following rules of thumb apply:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>Generally speaking, the following rules of thumb apply:
|
||||||
<li>When running on CPUs only, with a single thread per MPI task,
|
</P>
|
||||||
|
<UL><LI>When running on CPUs only, with a single thread per MPI task,
|
||||||
performance of a KOKKOS style is somewhere between the standard
|
performance of a KOKKOS style is somewhere between the standard
|
||||||
(un-accelerated) styles (MPI-only mode), and those provided by the
|
(un-accelerated) styles (MPI-only mode), and those provided by the
|
||||||
USER-OMP package. However the difference between all 3 is small (less
|
USER-OMP package. However the difference between all 3 is small (less
|
||||||
than 20%).</li>
|
than 20%).
|
||||||
<li>When running on CPUs only, with multiple threads per MPI task,
|
|
||||||
|
<LI>When running on CPUs only, with multiple threads per MPI task,
|
||||||
performance of a KOKKOS style is a bit slower than the USER-OMP
|
performance of a KOKKOS style is a bit slower than the USER-OMP
|
||||||
package.</li>
|
package.
|
||||||
<li>When running on GPUs, KOKKOS is typically faster than the USER-CUDA
|
|
||||||
and GPU packages.</li>
|
<LI>When running on GPUs, KOKKOS is typically faster than the USER-CUDA
|
||||||
<li>When running on Intel Xeon Phi, KOKKOS is not as fast as
|
and GPU packages.
|
||||||
the USER-INTEL package, which is optimized for that hardware.</li>
|
|
||||||
</ul>
|
<LI>When running on Intel Xeon Phi, KOKKOS is not as fast as
|
||||||
<p>See the <a class="reference external" href="http://lammps.sandia.gov/bench.html">Benchmark page</a> of the
|
the USER-INTEL package, which is optimized for that hardware.
|
||||||
|
</UL>
|
||||||
|
<P>See the <A HREF = "http://lammps.sandia.gov/bench.html">Benchmark page</A> of the
|
||||||
LAMMPS web site for performance of the KOKKOS package on different
|
LAMMPS web site for performance of the KOKKOS package on different
|
||||||
hardware.</p>
|
hardware.
|
||||||
<p><strong>Guidelines for best performance:</strong></p>
|
</P>
|
||||||
<p>Here are guidline for using the KOKKOS package on the different
|
<P><B>Guidelines for best performance:</B>
|
||||||
hardware configurations listed above.</p>
|
</P>
|
||||||
<p>Many of the guidelines use the <a class="reference internal" href="package.html"><em>package kokkos</em></a> command
|
<P>Here are guidline for using the KOKKOS package on the different
|
||||||
|
hardware configurations listed above.
|
||||||
|
</P>
|
||||||
|
<P>Many of the guidelines use the <A HREF = "package.html">package kokkos</A> command
|
||||||
See its doc page for details and default settings. Experimenting with
|
See its doc page for details and default settings. Experimenting with
|
||||||
its options can provide a speed-up for specific calculations.</p>
|
its options can provide a speed-up for specific calculations.
|
||||||
<p><strong>Running on a multi-core CPU:</strong></p>
|
</P>
|
||||||
<p>If N is the number of physical cores/node, then the number of MPI
|
<P><B>Running on a multi-core CPU:</B>
|
||||||
|
</P>
|
||||||
|
<P>If N is the number of physical cores/node, then the number of MPI
|
||||||
tasks/node * number of threads/task should not exceed N, and should
|
tasks/node * number of threads/task should not exceed N, and should
|
||||||
typically equal N. Note that the default threads/task is 1, as set by
|
typically equal N. Note that the default threads/task is 1, as set by
|
||||||
the “t” keyword of the “-k” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>. If you do not change this, no
|
the "t" keyword of the "-k" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switch</A>. If you do not change this, no
|
||||||
additional parallelism (beyond MPI) will be invoked on the host
|
additional parallelism (beyond MPI) will be invoked on the host
|
||||||
CPU(s).</p>
|
CPU(s).
|
||||||
<p>You can compare the performance running in different modes:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>You can compare the performance running in different modes:
|
||||||
<li>run with 1 MPI task/node and N threads/task</li>
|
</P>
|
||||||
<li>run with N MPI tasks/node and 1 thread/task</li>
|
<UL><LI>run with 1 MPI task/node and N threads/task
|
||||||
<li>run with settings in between these extremes</li>
|
<LI>run with N MPI tasks/node and 1 thread/task
|
||||||
</ul>
|
<LI>run with settings in between these extremes
|
||||||
<p>Examples of mpirun commands in these modes are shown above.</p>
|
</UL>
|
||||||
<p>When using KOKKOS to perform multi-threading, it is important for
|
<P>Examples of mpirun commands in these modes are shown above.
|
||||||
|
</P>
|
||||||
|
<P>When using KOKKOS to perform multi-threading, it is important for
|
||||||
performance to bind both MPI tasks to physical cores, and threads to
|
performance to bind both MPI tasks to physical cores, and threads to
|
||||||
physical cores, so they do not migrate during a simulation.</p>
|
physical cores, so they do not migrate during a simulation.
|
||||||
<p>If you are not certain MPI tasks are being bound (check the defaults
|
</P>
|
||||||
for your MPI installation), binding can be forced with these flags:</p>
|
<P>If you are not certain MPI tasks are being bound (check the defaults
|
||||||
<div class="highlight-python"><div class="highlight"><pre>OpenMPI 1.8: mpirun -np 2 -bind-to socket -map-by socket ./lmp_openmpi ...
|
for your MPI installation), binding can be forced with these flags:
|
||||||
Mvapich2 2.0: mpiexec -np 2 -bind-to socket -map-by socket ./lmp_mvapich ...
|
</P>
|
||||||
</pre></div>
|
<PRE>OpenMPI 1.8: mpirun -np 2 -bind-to socket -map-by socket ./lmp_openmpi ...
|
||||||
</div>
|
Mvapich2 2.0: mpiexec -np 2 -bind-to socket -map-by socket ./lmp_mvapich ...
|
||||||
<p>For binding threads with the KOKKOS OMP option, use thread affinity
|
</PRE>
|
||||||
|
<P>For binding threads with the KOKKOS OMP option, use thread affinity
|
||||||
environment variables to force binding. With OpenMP 3.1 (gcc 4.7 or
|
environment variables to force binding. With OpenMP 3.1 (gcc 4.7 or
|
||||||
later, intel 12 or later) setting the environment variable
|
later, intel 12 or later) setting the environment variable
|
||||||
OMP_PROC_BIND=true should be sufficient. For binding threads with the
|
OMP_PROC_BIND=true should be sufficient. For binding threads with the
|
||||||
KOKKOS pthreads option, compile LAMMPS the KOKKOS HWLOC=yes option, as
|
KOKKOS pthreads option, compile LAMMPS the KOKKOS HWLOC=yes option, as
|
||||||
discussed in <a class="reference internal" href="Section_start.html#start-3-4"><span>Section 2.3.4</span></a> of the
|
discussed in <A HREF = "Sections_start.html#start_3_4">Section 2.3.4</A> of the
|
||||||
manual.</p>
|
manual.
|
||||||
<p><strong>Running on GPUs:</strong></p>
|
</P>
|
||||||
<p>Insure the -arch setting in the machine makefile you are using,
|
<P><B>Running on GPUs:</B>
|
||||||
|
</P>
|
||||||
|
<P>Insure the -arch setting in the machine makefile you are using,
|
||||||
e.g. src/MAKE/Makefile.cuda, is correct for your GPU hardware/software
|
e.g. src/MAKE/Makefile.cuda, is correct for your GPU hardware/software
|
||||||
(see <a class="reference internal" href="Section_start.html#start-3-4"><span>this section</span></a> of the manual for
|
(see <A HREF = "Section_start.html#start_3_4">this section</A> of the manual for
|
||||||
details).</p>
|
details).
|
||||||
<p>The -np setting of the mpirun command should set the number of MPI
|
</P>
|
||||||
tasks/node to be equal to the # of physical GPUs on the node.</p>
|
<P>The -np setting of the mpirun command should set the number of MPI
|
||||||
<p>Use the “-k” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a> to
|
tasks/node to be equal to the # of physical GPUs on the node.
|
||||||
|
</P>
|
||||||
|
<P>Use the "-k" <A HREF = "Section_commands.html#start_7">command-line switch</A> to
|
||||||
specify the number of GPUs per node, and the number of threads per MPI
|
specify the number of GPUs per node, and the number of threads per MPI
|
||||||
task. As above for multi-core CPUs (and no GPU), if N is the number
|
task. As above for multi-core CPUs (and no GPU), if N is the number
|
||||||
of physical cores/node, then the number of MPI tasks/node * number of
|
of physical cores/node, then the number of MPI tasks/node * number of
|
||||||
@ -504,117 +448,62 @@ threads/task should not exceed N. With one GPU (and one MPI task) it
|
|||||||
may be faster to use less than all the available cores, by setting
|
may be faster to use less than all the available cores, by setting
|
||||||
threads/task to a smaller value. This is because using all the cores
|
threads/task to a smaller value. This is because using all the cores
|
||||||
on a dual-socket node will incur extra cost to copy memory from the
|
on a dual-socket node will incur extra cost to copy memory from the
|
||||||
2nd socket to the GPU.</p>
|
2nd socket to the GPU.
|
||||||
<p>Examples of mpirun commands that follow these rules are shown above.</p>
|
</P>
|
||||||
<div class="admonition warning">
|
<P>Examples of mpirun commands that follow these rules are shown above.
|
||||||
<p class="first admonition-title">Warning</p>
|
</P>
|
||||||
<p class="last">When using a GPU, you will achieve the best
|
<P>IMPORTANT NOTE: When using a GPU, you will achieve the best
|
||||||
performance if your input script does not use any fix or compute
|
performance if your input script does not use any fix or compute
|
||||||
styles which are not yet Kokkos-enabled. This allows data to stay on
|
styles which are not yet Kokkos-enabled. This allows data to stay on
|
||||||
the GPU for multiple timesteps, without being copied back to the host
|
the GPU for multiple timesteps, without being copied back to the host
|
||||||
CPU. Invoking a non-Kokkos fix or compute, or performing I/O for
|
CPU. Invoking a non-Kokkos fix or compute, or performing I/O for
|
||||||
<a class="reference internal" href="thermo_style.html"><em>thermo</em></a> or <a class="reference internal" href="dump.html"><em>dump</em></a> output will cause data
|
<A HREF = "thermo_style.html">thermo</A> or <A HREF = "dump.html">dump</A> output will cause data
|
||||||
to be copied back to the CPU.</p>
|
to be copied back to the CPU.
|
||||||
</div>
|
</P>
|
||||||
<p>You cannot yet assign multiple MPI tasks to the same GPU with the
|
<P>You cannot yet assign multiple MPI tasks to the same GPU with the
|
||||||
KOKKOS package. We plan to support this in the future, similar to the
|
KOKKOS package. We plan to support this in the future, similar to the
|
||||||
GPU package in LAMMPS.</p>
|
GPU package in LAMMPS.
|
||||||
<p>You cannot yet use both the host (multi-threaded) and device (GPU)
|
</P>
|
||||||
|
<P>You cannot yet use both the host (multi-threaded) and device (GPU)
|
||||||
together to compute pairwise interactions with the KOKKOS package. We
|
together to compute pairwise interactions with the KOKKOS package. We
|
||||||
hope to support this in the future, similar to the GPU package in
|
hope to support this in the future, similar to the GPU package in
|
||||||
LAMMPS.</p>
|
LAMMPS.
|
||||||
<p><strong>Running on an Intel Phi:</strong></p>
|
</P>
|
||||||
<p>Kokkos only uses Intel Phi processors in their “native” mode, i.e.
|
<P><B>Running on an Intel Phi:</B>
|
||||||
not hosted by a CPU.</p>
|
</P>
|
||||||
<p>As illustrated above, build LAMMPS with OMP=yes (the default) and
|
<P>Kokkos only uses Intel Phi processors in their "native" mode, i.e.
|
||||||
|
not hosted by a CPU.
|
||||||
|
</P>
|
||||||
|
<P>As illustrated above, build LAMMPS with OMP=yes (the default) and
|
||||||
MIC=yes. The latter insures code is correctly compiled for the Intel
|
MIC=yes. The latter insures code is correctly compiled for the Intel
|
||||||
Phi. The OMP setting means OpenMP will be used for parallelization on
|
Phi. The OMP setting means OpenMP will be used for parallelization on
|
||||||
the Phi, which is currently the best option within Kokkos. In the
|
the Phi, which is currently the best option within Kokkos. In the
|
||||||
future, other options may be added.</p>
|
future, other options may be added.
|
||||||
<p>Current-generation Intel Phi chips have either 61 or 57 cores. One
|
</P>
|
||||||
|
<P>Current-generation Intel Phi chips have either 61 or 57 cores. One
|
||||||
core should be excluded for running the OS, leaving 60 or 56 cores.
|
core should be excluded for running the OS, leaving 60 or 56 cores.
|
||||||
Each core is hyperthreaded, so there are effectively N = 240 (4*60) or
|
Each core is hyperthreaded, so there are effectively N = 240 (4*60) or
|
||||||
N = 224 (4*56) cores to run on.</p>
|
N = 224 (4*56) cores to run on.
|
||||||
<p>The -np setting of the mpirun command sets the number of MPI
|
</P>
|
||||||
tasks/node. The “-k on t Nt” command-line switch sets the number of
|
<P>The -np setting of the mpirun command sets the number of MPI
|
||||||
|
tasks/node. The "-k on t Nt" command-line switch sets the number of
|
||||||
threads/task as Nt. The product of these 2 values should be N, i.e.
|
threads/task as Nt. The product of these 2 values should be N, i.e.
|
||||||
240 or 224. Also, the number of threads/task should be a multiple of
|
240 or 224. Also, the number of threads/task should be a multiple of
|
||||||
4 so that logical threads from more than one MPI task do not run on
|
4 so that logical threads from more than one MPI task do not run on
|
||||||
the same physical core.</p>
|
the same physical core.
|
||||||
<p>Examples of mpirun commands that follow these rules are shown above.</p>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>Examples of mpirun commands that follow these rules are shown above.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>As noted above, if using GPUs, the number of MPI tasks per compute
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>As noted above, if using GPUs, the number of MPI tasks per compute
|
||||||
node should equal to the number of GPUs per compute node. In the
|
node should equal to the number of GPUs per compute node. In the
|
||||||
future Kokkos will support assigning multiple MPI tasks to a single
|
future Kokkos will support assigning multiple MPI tasks to a single
|
||||||
GPU.</p>
|
GPU.
|
||||||
<p>Currently Kokkos does not support AMD GPUs due to limits in the
|
</P>
|
||||||
|
<P>Currently Kokkos does not support AMD GPUs due to limits in the
|
||||||
available backend programming models. Specifically, Kokkos requires
|
available backend programming models. Specifically, Kokkos requires
|
||||||
extensive C++ support from the Kernel language. This is expected to
|
extensive C++ support from the Kernel language. This is expected to
|
||||||
change in the future.</p>
|
change in the future.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,243 +1,153 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_packages.html">Previous Section</A> - <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>
|
||||||
|
|
||||||
|
|
||||||
<!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>5.USER-OMP package — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<P><A HREF = "Section_accelerate.html">Return to Section accelerate overview</A>
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</P>
|
||||||
|
<H4>5.3.5 USER-OMP package
|
||||||
<li>5.USER-OMP package</li>
|
</H4>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P>The USER-OMP package was developed by Axel Kohlmeyer at Temple
|
||||||
|
|
||||||
|
|
||||||
<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">
|
|
||||||
|
|
||||||
<p><a class="reference internal" href="Section_accelerate.html"><em>Return to Section accelerate overview</em></a></p>
|
|
||||||
<div class="section" id="user-omp-package">
|
|
||||||
<h1>5.USER-OMP package<a class="headerlink" href="#user-omp-package" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>The USER-OMP package was developed by Axel Kohlmeyer at Temple
|
|
||||||
University. It provides multi-threaded versions of most pair styles,
|
University. It provides multi-threaded versions of most pair styles,
|
||||||
nearly all bonded styles (bond, angle, dihedral, improper), several
|
nearly all bonded styles (bond, angle, dihedral, improper), several
|
||||||
Kspace styles, and a few fix styles. The package currently
|
Kspace styles, and a few fix styles. The package currently
|
||||||
uses the OpenMP interface for multi-threading.</p>
|
uses the OpenMP interface for multi-threading.
|
||||||
<p>Here is a quick overview of how to use the USER-OMP package:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>Here is a quick overview of how to use the USER-OMP package:
|
||||||
<li>use the -fopenmp flag for compiling and linking in your Makefile.machine</li>
|
</P>
|
||||||
<li>include the USER-OMP package and build LAMMPS</li>
|
<UL><LI>use the -fopenmp flag for compiling and linking in your Makefile.machine
|
||||||
<li>use the mpirun command to set the number of MPI tasks/node</li>
|
<LI>include the USER-OMP package and build LAMMPS
|
||||||
<li>specify how many threads per MPI task to use</li>
|
<LI>use the mpirun command to set the number of MPI tasks/node
|
||||||
<li>use USER-OMP styles in your input script</li>
|
<LI>specify how many threads per MPI task to use
|
||||||
</ul>
|
<LI>use USER-OMP styles in your input script
|
||||||
<p>The latter two steps can be done using the “-pk omp” and “-sf omp”
|
</UL>
|
||||||
<a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> respectively. Or
|
<P>The latter two steps can be done using the "-pk omp" and "-sf omp"
|
||||||
the effect of the “-pk” or “-sf” switches can be duplicated by adding
|
<A HREF = "Section_start.html#start_7">command-line switches</A> respectively. Or
|
||||||
the <a class="reference internal" href="package.html"><em>package omp</em></a> or <a class="reference internal" href="suffix.html"><em>suffix omp</em></a> commands
|
the effect of the "-pk" or "-sf" switches can be duplicated by adding
|
||||||
respectively to your input script.</p>
|
the <A HREF = "package.html">package omp</A> or <A HREF = "suffix.html">suffix omp</A> commands
|
||||||
<p><strong>Required hardware/software:</strong></p>
|
respectively to your input script.
|
||||||
<p>Your compiler must support the OpenMP interface. You should have one
|
</P>
|
||||||
|
<P><B>Required hardware/software:</B>
|
||||||
|
</P>
|
||||||
|
<P>Your compiler must support the OpenMP interface. You should have one
|
||||||
or more multi-core CPUs so that multiple threads can be launched by an
|
or more multi-core CPUs so that multiple threads can be launched by an
|
||||||
MPI task running on a CPU.</p>
|
MPI task running on a CPU.
|
||||||
<p><strong>Building LAMMPS with the USER-OMP package:</strong></p>
|
</P>
|
||||||
<p>To do this in one line, use the src/Make.py script, described in
|
<P><B>Building LAMMPS with the USER-OMP package:</B>
|
||||||
<a class="reference internal" href="Section_start.html#start-4"><span>Section 2.4</span></a> of the manual. Type “Make.py
|
</P>
|
||||||
-h” for help. If run from the src directory, this command will create
|
<P>To do this in one line, use the src/Make.py script, described in
|
||||||
|
<A HREF = "Section_start.html#start_4">Section 2.4</A> of the manual. Type "Make.py
|
||||||
|
-h" for help. If run from the src directory, this command will create
|
||||||
src/lmp_omp using src/MAKE/Makefile.mpi as the starting
|
src/lmp_omp using src/MAKE/Makefile.mpi as the starting
|
||||||
Makefile.machine:</p>
|
Makefile.machine:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Make.py -p omp -o omp file mpi
|
</P>
|
||||||
</pre></div>
|
<PRE>Make.py -p omp -o omp file mpi
|
||||||
</div>
|
</PRE>
|
||||||
<p>Or you can follow these steps:</p>
|
<P>Or you can follow these steps:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
</P>
|
||||||
|
<PRE>cd lammps/src
|
||||||
make yes-user-omp
|
make yes-user-omp
|
||||||
make machine
|
make machine
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>The CCFLAGS setting in Makefile.machine needs "-fopenmp" to add OpenMP
|
||||||
<p>The CCFLAGS setting in Makefile.machine needs “-fopenmp” to add OpenMP
|
|
||||||
support. This works for both the GNU and Intel compilers. Without
|
support. This works for both the GNU and Intel compilers. Without
|
||||||
this flag the USER-OMP styles will still be compiled and work, but
|
this flag the USER-OMP styles will still be compiled and work, but
|
||||||
will not support multi-threading. For the Intel compilers the CCFLAGS
|
will not support multi-threading. For the Intel compilers the CCFLAGS
|
||||||
setting also needs to include “-restrict”.</p>
|
setting also needs to include "-restrict".
|
||||||
<p><strong>Run with the USER-OMP package from the command line:</strong></p>
|
</P>
|
||||||
<p>The mpirun or mpiexec command sets the total number of MPI tasks used
|
<P><B>Run with the USER-OMP package from the command line:</B>
|
||||||
|
</P>
|
||||||
|
<P>The mpirun or mpiexec command sets the total number of MPI tasks used
|
||||||
by LAMMPS (one or multiple per compute node) and the number of MPI
|
by LAMMPS (one or multiple per compute node) and the number of MPI
|
||||||
tasks used per node. E.g. the mpirun command in MPICH does this via
|
tasks used per node. E.g. the mpirun command in MPICH does this via
|
||||||
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.</p>
|
its -np and -ppn switches. Ditto for OpenMPI via -np and -npernode.
|
||||||
<p>You need to choose how many threads per MPI task will be used by the
|
</P>
|
||||||
|
<P>You need to choose how many threads per MPI task will be used by the
|
||||||
USER-OMP package. Note that the product of MPI tasks * threads/task
|
USER-OMP package. Note that the product of MPI tasks * threads/task
|
||||||
should not exceed the physical number of cores (on a node), otherwise
|
should not exceed the physical number of cores (on a node), otherwise
|
||||||
performance will suffer.</p>
|
performance will suffer.
|
||||||
<p>Use the “-sf omp” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>,
|
</P>
|
||||||
which will automatically append “omp” to styles that support it. Use
|
<P>Use the "-sf omp" <A HREF = "Section_start.html#start_7">command-line switch</A>,
|
||||||
the “-pk omp Nt” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>, to
|
which will automatically append "omp" to styles that support it. Use
|
||||||
set Nt = # of OpenMP threads per MPI task to use.</p>
|
the "-pk omp Nt" <A HREF = "Section_start.html#start_7">command-line switch</A>, to
|
||||||
<div class="highlight-python"><div class="highlight"><pre>lmp_machine -sf omp -pk omp 16 -in in.script # 1 MPI task on a 16-core node
|
set Nt = # of OpenMP threads per MPI task to use.
|
||||||
|
</P>
|
||||||
|
<PRE>lmp_machine -sf omp -pk omp 16 -in in.script # 1 MPI task on a 16-core node
|
||||||
mpirun -np 4 lmp_machine -sf omp -pk omp 4 -in in.script # 4 MPI tasks each with 4 threads on a single 16-core node
|
mpirun -np 4 lmp_machine -sf omp -pk omp 4 -in in.script # 4 MPI tasks each with 4 threads on a single 16-core node
|
||||||
mpirun -np 32 -ppn 4 lmp_machine -sf omp -pk omp 4 -in in.script # ditto on 8 16-core nodes
|
mpirun -np 32 -ppn 4 lmp_machine -sf omp -pk omp 4 -in in.script # ditto on 8 16-core nodes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Note that if the "-sf omp" switch is used, it also issues a default
|
||||||
<p>Note that if the “-sf omp” switch is used, it also issues a default
|
<A HREF = "package.html">package omp 0</A> command, which sets the number of threads
|
||||||
<a class="reference internal" href="package.html"><em>package omp 0</em></a> command, which sets the number of threads
|
per MPI task via the OMP_NUM_THREADS environment variable.
|
||||||
per MPI task via the OMP_NUM_THREADS environment variable.</p>
|
</P>
|
||||||
<p>Using the “-pk” switch explicitly allows for direct setting of the
|
<P>Using the "-pk" switch explicitly allows for direct setting of the
|
||||||
number of threads and additional options. Its syntax is the same as
|
number of threads and additional options. Its syntax is the same as
|
||||||
the “package omp” command. See the <a class="reference internal" href="package.html"><em>package</em></a> command doc
|
the "package omp" command. See the <A HREF = "package.html">package</A> command doc
|
||||||
page for details, including the default values used for all its
|
page for details, including the default values used for all its
|
||||||
options if it is not specified, and how to set the number of threads
|
options if it is not specified, and how to set the number of threads
|
||||||
via the OMP_NUM_THREADS environment variable if desired.</p>
|
via the OMP_NUM_THREADS environment variable if desired.
|
||||||
<p><strong>Or run with the USER-OMP package by editing an input script:</strong></p>
|
</P>
|
||||||
<p>The discussion above for the mpirun/mpiexec command, MPI tasks/node,
|
<P><B>Or run with the USER-OMP package by editing an input script:</B>
|
||||||
and threads/MPI task is the same.</p>
|
</P>
|
||||||
<p>Use the <a class="reference internal" href="suffix.html"><em>suffix omp</em></a> command, or you can explicitly add an
|
<P>The discussion above for the mpirun/mpiexec command, MPI tasks/node,
|
||||||
“omp” suffix to individual styles in your input script, e.g.</p>
|
and threads/MPI task is the same.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>pair_style lj/cut/omp 2.5
|
</P>
|
||||||
</pre></div>
|
<P>Use the <A HREF = "suffix.html">suffix omp</A> command, or you can explicitly add an
|
||||||
</div>
|
"omp" suffix to individual styles in your input script, e.g.
|
||||||
<p>You must also use the <a class="reference internal" href="package.html"><em>package omp</em></a> command to enable the
|
</P>
|
||||||
USER-OMP package, unless the “-sf omp” or “-pk omp” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switches</span></a> were used. It specifies how many
|
<PRE>pair_style lj/cut/omp 2.5
|
||||||
|
</PRE>
|
||||||
|
<P>You must also use the <A HREF = "package.html">package omp</A> command to enable the
|
||||||
|
USER-OMP package, unless the "-sf omp" or "-pk omp" <A HREF = "Section_start.html#start_7">command-line
|
||||||
|
switches</A> were used. It specifies how many
|
||||||
threads per MPI task to use, as well as other options. Its doc page
|
threads per MPI task to use, as well as other options. Its doc page
|
||||||
explains how to set the number of threads via an environment variable
|
explains how to set the number of threads via an environment variable
|
||||||
if desired.</p>
|
if desired.
|
||||||
<p><strong>Speed-ups to expect:</strong></p>
|
</P>
|
||||||
<p>Depending on which styles are accelerated, you should look for a
|
<P><B>Speed-ups to expect:</B>
|
||||||
reduction in the “Pair time”, “Bond time”, “KSpace time”, and “Loop
|
</P>
|
||||||
time” values printed at the end of a run.</p>
|
<P>Depending on which styles are accelerated, you should look for a
|
||||||
<p>You may see a small performance advantage (5 to 20%) when running a
|
reduction in the "Pair time", "Bond time", "KSpace time", and "Loop
|
||||||
|
time" values printed at the end of a run.
|
||||||
|
</P>
|
||||||
|
<P>You may see a small performance advantage (5 to 20%) when running a
|
||||||
USER-OMP style (in serial or parallel) with a single thread per MPI
|
USER-OMP style (in serial or parallel) with a single thread per MPI
|
||||||
task, versus running standard LAMMPS with its standard
|
task, versus running standard LAMMPS with its standard
|
||||||
(un-accelerated) styles (in serial or all-MPI parallelization with 1
|
(un-accelerated) styles (in serial or all-MPI parallelization with 1
|
||||||
task/core). This is because many of the USER-OMP styles contain
|
task/core). This is because many of the USER-OMP styles contain
|
||||||
similar optimizations to those used in the OPT package, as described
|
similar optimizations to those used in the OPT package, as described
|
||||||
above.</p>
|
above.
|
||||||
<p>With multiple threads/task, the optimal choice of MPI tasks/node and
|
</P>
|
||||||
|
<P>With multiple threads/task, the optimal choice of MPI tasks/node and
|
||||||
OpenMP threads/task can vary a lot and should always be tested via
|
OpenMP threads/task can vary a lot and should always be tested via
|
||||||
benchmark runs for a specific simulation running on a specific
|
benchmark runs for a specific simulation running on a specific
|
||||||
machine, paying attention to guidelines discussed in the next
|
machine, paying attention to guidelines discussed in the next
|
||||||
sub-section.</p>
|
sub-section.
|
||||||
<p>A description of the multi-threading strategy used in the USER-OMP
|
</P>
|
||||||
package and some performance examples are <a class="reference external" href="http://sites.google.com/site/akohlmey/software/lammps-icms/lammps-icms-tms2011-talk.pdf?attredirects=0&d=1">presented here</a></p>
|
<P>A description of the multi-threading strategy used in the USER-OMP
|
||||||
<p><strong>Guidelines for best performance:</strong></p>
|
package and some performance examples are <A HREF = "http://sites.google.com/site/akohlmey/software/lammps-icms/lammps-icms-tms2011-talk.pdf?attredirects=0&d=1">presented
|
||||||
<p>For many problems on current generation CPUs, running the USER-OMP
|
here</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Guidelines for best performance:</B>
|
||||||
|
</P>
|
||||||
|
<P>For many problems on current generation CPUs, running the USER-OMP
|
||||||
package with a single thread/task is faster than running with multiple
|
package with a single thread/task is faster than running with multiple
|
||||||
threads/task. This is because the MPI parallelization in LAMMPS is
|
threads/task. This is because the MPI parallelization in LAMMPS is
|
||||||
often more efficient than multi-threading as implemented in the
|
often more efficient than multi-threading as implemented in the
|
||||||
USER-OMP package. The parallel efficiency (in a threaded sense) also
|
USER-OMP package. The parallel efficiency (in a threaded sense) also
|
||||||
varies for different USER-OMP styles.</p>
|
varies for different USER-OMP styles.
|
||||||
<p>Using multiple threads/task can be more effective under the following
|
</P>
|
||||||
circumstances:</p>
|
<P>Using multiple threads/task can be more effective under the following
|
||||||
<ul class="simple">
|
circumstances:
|
||||||
<li>Individual compute nodes have a significant number of CPU cores but
|
</P>
|
||||||
|
<UL><LI>Individual compute nodes have a significant number of CPU cores but
|
||||||
the CPU itself has limited memory bandwidth, e.g. for Intel Xeon 53xx
|
the CPU itself has limited memory bandwidth, e.g. for Intel Xeon 53xx
|
||||||
(Clovertown) and 54xx (Harpertown) quad core processors. Running one
|
(Clovertown) and 54xx (Harpertown) quad core processors. Running one
|
||||||
MPI task per CPU core will result in significant performance
|
MPI task per CPU core will result in significant performance
|
||||||
@ -245,111 +155,52 @@ degradation, so that running with 4 or even only 2 MPI tasks per node
|
|||||||
is faster. Running in hybrid MPI+OpenMP mode will reduce the
|
is faster. Running in hybrid MPI+OpenMP mode will reduce the
|
||||||
inter-node communication bandwidth contention in the same way, but
|
inter-node communication bandwidth contention in the same way, but
|
||||||
offers an additional speedup by utilizing the otherwise idle CPU
|
offers an additional speedup by utilizing the otherwise idle CPU
|
||||||
cores.</li>
|
cores.
|
||||||
<li>The interconnect used for MPI communication does not provide
|
|
||||||
|
<LI>The interconnect used for MPI communication does not provide
|
||||||
sufficient bandwidth for a large number of MPI tasks per node. For
|
sufficient bandwidth for a large number of MPI tasks per node. For
|
||||||
example, this applies to running over gigabit ethernet or on Cray XT4
|
example, this applies to running over gigabit ethernet or on Cray XT4
|
||||||
or XT5 series supercomputers. As in the aforementioned case, this
|
or XT5 series supercomputers. As in the aforementioned case, this
|
||||||
effect worsens when using an increasing number of nodes.</li>
|
effect worsens when using an increasing number of nodes.
|
||||||
<li>The system has a spatially inhomogeneous particle density which does
|
|
||||||
not map well to the <a class="reference internal" href="processors.html"><em>domain decomposition scheme</em></a> or
|
<LI>The system has a spatially inhomogeneous particle density which does
|
||||||
<a class="reference internal" href="balance.html"><em>load-balancing</em></a> options that LAMMPS provides. This is
|
not map well to the <A HREF = "processors.html">domain decomposition scheme</A> or
|
||||||
|
<A HREF = "balance.html">load-balancing</A> options that LAMMPS provides. This is
|
||||||
because multi-threading achives parallelism over the number of
|
because multi-threading achives parallelism over the number of
|
||||||
particles, not via their distribution in space.</li>
|
particles, not via their distribution in space.
|
||||||
<li>A machine is being used in “capability mode”, i.e. near the point
|
|
||||||
|
<LI>A machine is being used in "capability mode", i.e. near the point
|
||||||
where MPI parallelism is maxed out. For example, this can happen when
|
where MPI parallelism is maxed out. For example, this can happen when
|
||||||
using the <a class="reference internal" href="kspace_style.html"><em>PPPM solver</em></a> for long-range
|
using the <A HREF = "kspace_style.html">PPPM solver</A> for long-range
|
||||||
electrostatics on large numbers of nodes. The scaling of the KSpace
|
electrostatics on large numbers of nodes. The scaling of the KSpace
|
||||||
calculation (see the <a class="reference internal" href="kspace_style.html"><em>kspace_style</em></a> command) becomes
|
calculation (see the <A HREF = "kspace_style.html">kspace_style</A> command) becomes
|
||||||
the performance-limiting factor. Using multi-threading allows less
|
the performance-limiting factor. Using multi-threading allows less
|
||||||
MPI tasks to be invoked and can speed-up the long-range solver, while
|
MPI tasks to be invoked and can speed-up the long-range solver, while
|
||||||
increasing overall performance by parallelizing the pairwise and
|
increasing overall performance by parallelizing the pairwise and
|
||||||
bonded calculations via OpenMP. Likewise additional speedup can be
|
bonded calculations via OpenMP. Likewise additional speedup can be
|
||||||
sometimes be achived by increasing the length of the Coulombic cutoff
|
sometimes be achived by increasing the length of the Coulombic cutoff
|
||||||
and thus reducing the work done by the long-range solver. Using the
|
and thus reducing the work done by the long-range solver. Using the
|
||||||
<a class="reference internal" href="run_style.html"><em>run_style verlet/split</em></a> command, which is compatible
|
<A HREF = "run_style.html">run_style verlet/split</A> command, which is compatible
|
||||||
with the USER-OMP package, is an alternative way to reduce the number
|
with the USER-OMP package, is an alternative way to reduce the number
|
||||||
of MPI tasks assigned to the KSpace calculation.</li>
|
of MPI tasks assigned to the KSpace calculation.
|
||||||
</ul>
|
</UL>
|
||||||
<p>Additional performance tips are as follows:</p>
|
<P>Additional performance tips are as follows:
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>The best parallel efficiency from <em>omp</em> styles is typically achieved
|
<UL><LI>The best parallel efficiency from <I>omp</I> styles is typically achieved
|
||||||
when there is at least one MPI task per physical processor,
|
when there is at least one MPI task per physical processor,
|
||||||
i.e. socket or die.</li>
|
i.e. socket or die.
|
||||||
<li>It is usually most efficient to restrict threading to a single
|
|
||||||
socket, i.e. use one or more MPI task per socket.</li>
|
<LI>It is usually most efficient to restrict threading to a single
|
||||||
<li>Several current MPI implementation by default use a processor affinity
|
socket, i.e. use one or more MPI task per socket.
|
||||||
|
|
||||||
|
<LI>Several current MPI implementation by default use a processor affinity
|
||||||
setting that restricts each MPI task to a single CPU core. Using
|
setting that restricts each MPI task to a single CPU core. Using
|
||||||
multi-threading in this mode will force the threads to share that core
|
multi-threading in this mode will force the threads to share that core
|
||||||
and thus is likely to be counterproductive. Instead, binding MPI
|
and thus is likely to be counterproductive. Instead, binding MPI
|
||||||
tasks to a (multi-core) socket, should solve this issue.</li>
|
tasks to a (multi-core) socket, should solve this issue.
|
||||||
</ul>
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>None.</p>
|
<P>None.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,250 +1,87 @@
|
|||||||
|
<HTML>
|
||||||
|
<CENTER><A HREF = "Section_packages.html">Previous Section</A> - <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>
|
||||||
|
|
||||||
|
|
||||||
<!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>5.OPT package — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<P><A HREF = "Section_accelerate.html">Return to Section accelerate overview</A>
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</P>
|
||||||
|
<H4>5.3.6 OPT package
|
||||||
<li>5.OPT package</li>
|
</H4>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P>The OPT package was developed by James Fischer (High Performance
|
||||||
|
|
||||||
|
|
||||||
<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">
|
|
||||||
|
|
||||||
<p><a class="reference internal" href="Section_accelerate.html"><em>Return to Section accelerate overview</em></a></p>
|
|
||||||
<div class="section" id="opt-package">
|
|
||||||
<h1>5.OPT package<a class="headerlink" href="#opt-package" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p>The OPT package was developed by James Fischer (High Performance
|
|
||||||
Technologies), David Richie, and Vincent Natoli (Stone Ridge
|
Technologies), David Richie, and Vincent Natoli (Stone Ridge
|
||||||
Technologies). It contains a handful of pair styles whose compute()
|
Technologies). It contains a handful of pair styles whose compute()
|
||||||
methods were rewritten in C++ templated form to reduce the overhead
|
methods were rewritten in C++ templated form to reduce the overhead
|
||||||
due to if tests and other conditional code.</p>
|
due to if tests and other conditional code.
|
||||||
<p>Here is a quick overview of how to use the OPT package:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>Here is a quick overview of how to use the OPT package:
|
||||||
<li>include the OPT package and build LAMMPS</li>
|
</P>
|
||||||
<li>use OPT pair styles in your input script</li>
|
<UL><LI>include the OPT package and build LAMMPS
|
||||||
</ul>
|
<LI>use OPT pair styles in your input script
|
||||||
<p>The last step can be done using the “-sf opt” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>. Or the effect of the “-sf” switch
|
</UL>
|
||||||
can be duplicated by adding a <a class="reference internal" href="suffix.html"><em>suffix opt</em></a> command to your
|
<P>The last step can be done using the "-sf opt" <A HREF = "Section_start.html#start_7">command-line
|
||||||
input script.</p>
|
switch</A>. Or the effect of the "-sf" switch
|
||||||
<p><strong>Required hardware/software:</strong></p>
|
can be duplicated by adding a <A HREF = "suffix.html">suffix opt</A> command to your
|
||||||
<p>None.</p>
|
input script.
|
||||||
<p><strong>Building LAMMPS with the OPT package:</strong></p>
|
</P>
|
||||||
<p>Include the package and build LAMMPS:</p>
|
<P><B>Required hardware/software:</B>
|
||||||
<p>To do this in one line, use the src/Make.py script, described in
|
</P>
|
||||||
<a class="reference internal" href="Section_start.html#start-4"><span>Section 2.4</span></a> of the manual. Type “Make.py
|
<P>None.
|
||||||
-h” for help. If run from the src directory, this command will create
|
</P>
|
||||||
|
<P><B>Building LAMMPS with the OPT package:</B>
|
||||||
|
</P>
|
||||||
|
<P>Include the package and build LAMMPS:
|
||||||
|
</P>
|
||||||
|
<P>To do this in one line, use the src/Make.py script, described in
|
||||||
|
<A HREF = "Section_start.html#start_4">Section 2.4</A> of the manual. Type "Make.py
|
||||||
|
-h" for help. If run from the src directory, this command will create
|
||||||
src/lmp_opt using src/MAKE/Makefile.mpi as the starting
|
src/lmp_opt using src/MAKE/Makefile.mpi as the starting
|
||||||
Makefile.machine:</p>
|
Makefile.machine:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Make.py -p opt -o opt file mpi
|
</P>
|
||||||
</pre></div>
|
<PRE>Make.py -p opt -o opt file mpi
|
||||||
</div>
|
</PRE>
|
||||||
<p>Or you can follow these steps:</p>
|
<P>Or you can follow these steps:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>cd lammps/src
|
</P>
|
||||||
|
<PRE>cd lammps/src
|
||||||
make yes-opt
|
make yes-opt
|
||||||
make machine
|
make machine
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>If you are using Intel compilers, then the CCFLAGS setting in
|
||||||
<p>If you are using Intel compilers, then the CCFLAGS setting in
|
Makefile.machine needs to include "-restrict".
|
||||||
Makefile.machine needs to include “-restrict”.</p>
|
</P>
|
||||||
<p><strong>Run with the OPT package from the command line:</strong></p>
|
<P><B>Run with the OPT package from the command line:</B>
|
||||||
<p>Use the “-sf opt” <a class="reference internal" href="Section_start.html#start-7"><span>command-line switch</span></a>,
|
</P>
|
||||||
which will automatically append “opt” to styles that support it.</p>
|
<P>Use the "-sf opt" <A HREF = "Section_start.html#start_7">command-line switch</A>,
|
||||||
<div class="highlight-python"><div class="highlight"><pre>lmp_machine -sf opt -in in.script
|
which will automatically append "opt" to styles that support it.
|
||||||
mpirun -np 4 lmp_machine -sf opt -in in.script
|
</P>
|
||||||
</pre></div>
|
<PRE>lmp_machine -sf opt -in in.script
|
||||||
</div>
|
mpirun -np 4 lmp_machine -sf opt -in in.script
|
||||||
<p><strong>Or run with the OPT package by editing an input script:</strong></p>
|
</PRE>
|
||||||
<p>Use the <a class="reference internal" href="suffix.html"><em>suffix opt</em></a> command, or you can explicitly add an
|
<P><B>Or run with the OPT package by editing an input script:</B>
|
||||||
“opt” suffix to individual styles in your input script, e.g.</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>pair_style lj/cut/opt 2.5
|
<P>Use the <A HREF = "suffix.html">suffix opt</A> command, or you can explicitly add an
|
||||||
</pre></div>
|
"opt" suffix to individual styles in your input script, e.g.
|
||||||
</div>
|
</P>
|
||||||
<p><strong>Speed-ups to expect:</strong></p>
|
<PRE>pair_style lj/cut/opt 2.5
|
||||||
<p>You should see a reduction in the “Pair time” value printed at the end
|
</PRE>
|
||||||
|
<P><B>Speed-ups to expect:</B>
|
||||||
|
</P>
|
||||||
|
<P>You should see a reduction in the "Pair time" value printed at the end
|
||||||
of a run. On most machines for reasonable problem sizes, it will be a
|
of a run. On most machines for reasonable problem sizes, it will be a
|
||||||
5 to 20% savings.</p>
|
5 to 20% savings.
|
||||||
<p><strong>Guidelines for best performance:</strong></p>
|
</P>
|
||||||
<p>None. Just try out an OPT pair style to see how it performs.</p>
|
<P><B>Guidelines for best performance:</B>
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P>None. Just try out an OPT pair style to see how it performs.
|
||||||
<p>None.</p>
|
</P>
|
||||||
</div>
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
|
<P>None.
|
||||||
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,264 +1,97 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style charmm command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style charmm command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style charmm/kk command
|
||||||
<li>angle_style charmm command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<H3>angle_style charmm/omp command
|
||||||
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</P>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE>angle_style charmm
|
||||||
|
</PRE>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>angle_style charmm
|
||||||
|
angle_coeff 1 300.0 107.0 50.0 3.0
|
||||||
</div>
|
</PRE>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P><B>Description:</B>
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<P>The <I>charmm</I> angle style uses the potential
|
||||||
<div class="section" id="angle-style-charmm-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>angle_style charmm command<a class="headerlink" href="#angle-style-charmm-command" title="Permalink to this headline">¶</a></h1>
|
<CENTER><IMG SRC = "Eqs/angle_charmm.jpg">
|
||||||
</div>
|
</CENTER>
|
||||||
<div class="section" id="angle-style-charmm-kk-command">
|
<P>with an additional Urey_Bradley term based on the distance <I>r</I> between
|
||||||
<h1>angle_style charmm/kk command<a class="headerlink" href="#angle-style-charmm-kk-command" title="Permalink to this headline">¶</a></h1>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="angle-style-charmm-omp-command">
|
|
||||||
<h1>angle_style charmm/omp command<a class="headerlink" href="#angle-style-charmm-omp-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>angle_style charmm
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>angle_style charmm
|
|
||||||
angle_coeff 1 300.0 107.0 50.0 3.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>charmm</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_charmm.jpg" class="align-center" src="_images/angle_charmm.jpg" />
|
|
||||||
<p>with an additional Urey_Bradley term based on the distance <em>r</em> between
|
|
||||||
the 1st and 3rd atoms in the angle. K, theta0, Kub, and Rub are
|
the 1st and 3rd atoms in the angle. K, theta0, Kub, and Rub are
|
||||||
coefficients defined for each angle type.</p>
|
coefficients defined for each angle type.
|
||||||
<p>See <a class="reference internal" href="special_bonds.html#mackerell"><span>(MacKerell)</span></a> for a description of the CHARMM force
|
</P>
|
||||||
field.</p>
|
<P>See <A HREF = "#MacKerell">(MacKerell)</A> for a description of the CHARMM force
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
field.
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above, or in
|
</P>
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<ul class="simple">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<li>K (energy/radian^2)</li>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>theta0 (degrees)</li>
|
</P>
|
||||||
<li>K_ub (energy/distance^2)</li>
|
<UL><LI>K (energy/radian^2)
|
||||||
<li>r_ub (distance)</li>
|
<LI>theta0 (degrees)
|
||||||
</ul>
|
<LI>K_ub (energy/distance^2)
|
||||||
<p>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
<LI>r_ub (distance)
|
||||||
internally; hence the units of K are in energy/radian^2.</p>
|
</UL>
|
||||||
<hr class="docutils" />
|
<P>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
internally; hence the units of K are in energy/radian^2.
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="mackerell"><strong>(MacKerell)</strong> MacKerell, Bashford, Bellott, Dunbrack, Evanseck, Field,
|
|
||||||
Fischer, Gao, Guo, Ha, et al, J Phys Chem, 102, 3586 (1998).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
</div>
|
<A NAME = "MacKerell"></A>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(MacKerell)</B> MacKerell, Bashford, Bellott, Dunbrack, Evanseck, Field,
|
||||||
|
Fischer, Gao, Guo, Ha, et al, J Phys Chem, 102, 3586 (1998).
|
||||||
<div role="contentinfo">
|
</P>
|
||||||
<p>
|
</HTML>
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,291 +1,126 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style class2 command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style class2 command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style class2/omp command
|
||||||
<li>angle_style class2 command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style class2
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style class2
|
||||||
</ul>
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="angle-style-class2-command">
|
|
||||||
<span id="index-0"></span><h1>angle_style class2 command<a class="headerlink" href="#angle-style-class2-command" title="Permalink to this headline">¶</a></h1>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="angle-style-class2-omp-command">
|
|
||||||
<h1>angle_style class2/omp command<a class="headerlink" href="#angle-style-class2-omp-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>angle_style class2
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>angle_style class2
|
|
||||||
angle_coeff * 75.0
|
angle_coeff * 75.0
|
||||||
angle_coeff 1 bb 10.5872 1.0119 1.5228
|
angle_coeff 1 bb 10.5872 1.0119 1.5228
|
||||||
angle_coeff * ba 3.6551 24.895 1.0119 1.5228
|
angle_coeff * ba 3.6551 24.895 1.0119 1.5228
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>The <I>class2</I> angle style uses the potential
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>The <em>class2</em> angle style uses the potential</p>
|
<CENTER><IMG SRC = "Eqs/angle_class2.jpg">
|
||||||
<img alt="_images/angle_class2.jpg" class="align-center" src="_images/angle_class2.jpg" />
|
</CENTER>
|
||||||
<p>where Ea is the angle term, Ebb is a bond-bond term, and Eba is a
|
<P>where Ea is the angle term, Ebb is a bond-bond term, and Eba is a
|
||||||
bond-angle term. Theta0 is the equilibrium angle and r1 and r2 are
|
bond-angle term. Theta0 is the equilibrium angle and r1 and r2 are
|
||||||
the equilibrium bond lengths.</p>
|
the equilibrium bond lengths.
|
||||||
<p>See <a class="reference internal" href="pair_modify.html#sun"><span>(Sun)</span></a> for a description of the COMPASS class2 force field.</p>
|
</P>
|
||||||
<p>Coefficients for the Ea, Ebb, and Eba formulas must be defined for
|
<P>See <A HREF = "#Sun">(Sun)</A> for a description of the COMPASS class2 force field.
|
||||||
each angle type via the <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in
|
</P>
|
||||||
|
<P>Coefficients for the Ea, Ebb, and Eba formulas must be defined for
|
||||||
|
each angle type via the <A HREF = "angle_coeff.html">angle_coeff</A> command as in
|
||||||
the example above, or in the data file or restart files read by the
|
the example above, or in the data file or restart files read by the
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>
|
<A HREF = "read_data.html">read_data</A> or <A HREF = "read_restart.html">read_restart</A>
|
||||||
commands.</p>
|
commands.
|
||||||
<p>These are the 4 coefficients for the Ea formula:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>These are the 4 coefficients for the Ea formula:
|
||||||
<li>theta0 (degrees)</li>
|
</P>
|
||||||
<li>K2 (energy/radian^2)</li>
|
<UL><LI>theta0 (degrees)
|
||||||
<li>K3 (energy/radian^3)</li>
|
<LI>K2 (energy/radian^2)
|
||||||
<li>K4 (energy/radian^4)</li>
|
<LI>K3 (energy/radian^3)
|
||||||
</ul>
|
<LI>K4 (energy/radian^4)
|
||||||
<p>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
</UL>
|
||||||
internally; hence the units of the various K are in per-radian.</p>
|
<P>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
||||||
<p>For the Ebb formula, each line in a <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a>
|
internally; hence the units of the various K are in per-radian.
|
||||||
|
</P>
|
||||||
|
<P>For the Ebb formula, each line in a <A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
command in the input script lists 4 coefficients, the first of which
|
command in the input script lists 4 coefficients, the first of which
|
||||||
is “bb” to indicate they are BondBond coefficients. In a data file,
|
is "bb" to indicate they are BondBond coefficients. In a data file,
|
||||||
these coefficients should be listed under a “BondBond Coeffs” heading
|
these coefficients should be listed under a "BondBond Coeffs" heading
|
||||||
and you must leave out the “bb”, i.e. only list 3 coefficients after
|
and you must leave out the "bb", i.e. only list 3 coefficients after
|
||||||
the angle type.</p>
|
the angle type.
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>bb</li>
|
<UL><LI>bb
|
||||||
<li>M (energy/distance^2)</li>
|
<LI>M (energy/distance^2)
|
||||||
<li>r1 (distance)</li>
|
<LI>r1 (distance)
|
||||||
<li>r2 (distance)</li>
|
<LI>r2 (distance)
|
||||||
</ul>
|
</UL>
|
||||||
<p>For the Eba formula, each line in a <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a>
|
<P>For the Eba formula, each line in a <A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
command in the input script lists 5 coefficients, the first of which
|
command in the input script lists 5 coefficients, the first of which
|
||||||
is “ba” to indicate they are BondAngle coefficients. In a data file,
|
is "ba" to indicate they are BondAngle coefficients. In a data file,
|
||||||
these coefficients should be listed under a “BondAngle Coeffs” heading
|
these coefficients should be listed under a "BondAngle Coeffs" heading
|
||||||
and you must leave out the “ba”, i.e. only list 4 coefficients after
|
and you must leave out the "ba", i.e. only list 4 coefficients after
|
||||||
the angle type.</p>
|
the angle type.
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>ba</li>
|
<UL><LI>ba
|
||||||
<li>N1 (energy/distance^2)</li>
|
<LI>N1 (energy/distance^2)
|
||||||
<li>N2 (energy/distance^2)</li>
|
<LI>N2 (energy/distance^2)
|
||||||
<li>r1 (distance)</li>
|
<LI>r1 (distance)
|
||||||
<li>r2 (distance)</li>
|
<LI>r2 (distance)
|
||||||
</ul>
|
</UL>
|
||||||
<p>The theta0 value in the Eba formula is not specified, since it is the
|
<P>The theta0 value in the Eba formula is not specified, since it is the
|
||||||
same value from the Ea formula.</p>
|
same value from the Ea formula.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the CLASS2
|
</P>
|
||||||
package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section
|
<HR>
|
||||||
for more info on packages.</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="sun"><strong>(Sun)</strong> Sun, J Phys Chem B 102, 7338-7364 (1998).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This angle style can only be used if LAMMPS was built with the CLASS2
|
||||||
|
package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A> section
|
||||||
|
for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
</div>
|
<A NAME = "Sun"></A>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Sun)</B> Sun, J Phys Chem B 102, 7338-7364 (1998).
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
</HTML>
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,279 +1,104 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_coeff command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_coeff command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>angle_coeff command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>angle_coeff N args
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>N = angle type (see asterisk form below)
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>args = coefficients for one or more angle types
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>angle_coeff 1 300.0 107.0
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="angle-coeff-command">
|
|
||||||
<span id="index-0"></span><h1>angle_coeff command<a class="headerlink" href="#angle-coeff-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>angle_coeff N args
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>N = angle type (see asterisk form below)</li>
|
|
||||||
<li>args = coefficients for one or more angle types</li>
|
|
||||||
</ul>
|
|
||||||
</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>angle_coeff 1 300.0 107.0
|
|
||||||
angle_coeff * 5.0
|
angle_coeff * 5.0
|
||||||
angle_coeff 2*10 5.0
|
angle_coeff 2*10 5.0
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Specify the angle force field coefficients for one or more angle types.
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Specify the angle force field coefficients for one or more angle types.
|
|
||||||
The number and meaning of the coefficients depends on the angle style.
|
The number and meaning of the coefficients depends on the angle style.
|
||||||
Angle coefficients can also be set in the data file read by the
|
Angle coefficients can also be set in the data file read by the
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command or in a restart file.</p>
|
<A HREF = "read_data.html">read_data</A> command or in a restart file.
|
||||||
<p>N can be specified in one of two ways. An explicit numeric value can
|
</P>
|
||||||
|
<P>N can be specified in one of two ways. An explicit numeric value can
|
||||||
be used, as in the 1st example above. Or a wild-card asterisk can be
|
be used, as in the 1st example above. Or a wild-card asterisk can be
|
||||||
used to set the coefficients for multiple angle types. This takes the
|
used to set the coefficients for multiple angle types. This takes the
|
||||||
form “*” or “<em>n” or “n</em>” or “m*n”. If N = the number of angle types,
|
form "*" or "*n" or "n*" or "m*n". If N = the number of angle types,
|
||||||
then an asterisk with no numeric values means all types from 1 to N. A
|
then an asterisk with no numeric values means all types from 1 to N. A
|
||||||
leading asterisk means all types from 1 to n (inclusive). A trailing
|
leading asterisk means all types from 1 to n (inclusive). A trailing
|
||||||
asterisk means all types from n to N (inclusive). A middle asterisk
|
asterisk means all types from n to N (inclusive). A middle asterisk
|
||||||
means all types from m to n (inclusive).</p>
|
means all types from m to n (inclusive).
|
||||||
<p>Note that using an angle_coeff command can override a previous setting
|
</P>
|
||||||
|
<P>Note that using an angle_coeff command can override a previous setting
|
||||||
for the same angle type. For example, these commands set the coeffs
|
for the same angle type. For example, these commands set the coeffs
|
||||||
for all angle types, then overwrite the coeffs for just angle type 2:</p>
|
for all angle types, then overwrite the coeffs for just angle type 2:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_coeff * 200.0 107.0 1.2
|
</P>
|
||||||
angle_coeff 2 50.0 107.0
|
<PRE>angle_coeff * 200.0 107.0 1.2
|
||||||
</pre></div>
|
angle_coeff 2 50.0 107.0
|
||||||
</div>
|
</PRE>
|
||||||
<p>A line in a data file that specifies angle coefficients uses the exact
|
<P>A line in a data file that specifies angle coefficients uses the exact
|
||||||
same format as the arguments of the angle_coeff command in an input
|
same format as the arguments of the angle_coeff command in an input
|
||||||
script, except that wild-card asterisks should not be used since
|
script, except that wild-card asterisks should not be used since
|
||||||
coefficients for all N types must be listed in the file. For example,
|
coefficients for all N types must be listed in the file. For example,
|
||||||
under the “Angle Coeffs” section of a data file, the line that
|
under the "Angle Coeffs" section of a data file, the line that
|
||||||
corresponds to the 1st example above would be listed as</p>
|
corresponds to the 1st example above would be listed as
|
||||||
<div class="highlight-python"><div class="highlight"><pre>1 300.0 107.0
|
</P>
|
||||||
</pre></div>
|
<PRE>1 300.0 107.0
|
||||||
</div>
|
</PRE>
|
||||||
<p>The <a class="reference internal" href="angle_class2.html"><em>angle_style class2</em></a> is an exception to this
|
<P>The <A HREF = "angle_class2.html">angle_style class2</A> is an exception to this
|
||||||
rule, in that an additional argument is used in the input script to
|
rule, in that an additional argument is used in the input script to
|
||||||
allow specification of the cross-term coefficients. See its
|
allow specification of the cross-term coefficients. See its
|
||||||
doc page for details.</p>
|
doc page for details.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>Here is an alphabetic list of angle styles defined in LAMMPS. Click on
|
<HR>
|
||||||
|
|
||||||
|
<P>Here is an alphabetic list of angle styles defined in LAMMPS. Click on
|
||||||
the style to display the formula it computes and coefficients
|
the style to display the formula it computes and coefficients
|
||||||
specified by the associated <a class="reference internal" href=""><em>angle_coeff</em></a> command.</p>
|
specified by the associated <A HREF = "angle_coeff.html">angle_coeff</A> command.
|
||||||
<p>Note that there are also additional angle styles submitted by users
|
</P>
|
||||||
|
<P>Note that there are also additional angle styles submitted by users
|
||||||
which are included in the LAMMPS distribution. The list of these with
|
which are included in the LAMMPS distribution. The list of these with
|
||||||
links to the individual styles are given in the angle section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
links to the individual styles are given in the angle section of <A HREF = "Section_commands.html#cmd_5">this
|
||||||
<ul class="simple">
|
page</A>.
|
||||||
<li><a class="reference internal" href="angle_none.html"><em>angle_style none</em></a> - turn off angle interactions</li>
|
</P>
|
||||||
<li><a class="reference internal" href="angle_hybrid.html"><em>angle_style hybrid</em></a> - define multiple styles of angle interactions</li>
|
<UL><LI><A HREF = "angle_none.html">angle_style none</A> - turn off angle interactions
|
||||||
<li><a class="reference internal" href="angle_charmm.html"><em>angle_style charmm</em></a> - CHARMM angle</li>
|
<LI><A HREF = "angle_hybrid.html">angle_style hybrid</A> - define multiple styles of angle interactions
|
||||||
<li><a class="reference internal" href="angle_class2.html"><em>angle_style class2</em></a> - COMPASS (class 2) angle</li>
|
</UL>
|
||||||
<li><a class="reference internal" href="angle_cosine.html"><em>angle_style cosine</em></a> - cosine angle potential</li>
|
<UL><LI><A HREF = "angle_charmm.html">angle_style charmm</A> - CHARMM angle
|
||||||
<li><a class="reference internal" href="angle_cosine_delta.html"><em>angle_style cosine/delta</em></a> - difference of cosines angle potential</li>
|
<LI><A HREF = "angle_class2.html">angle_style class2</A> - COMPASS (class 2) angle
|
||||||
<li><a class="reference internal" href="angle_cosine_periodic.html"><em>angle_style cosine/periodic</em></a> - DREIDING angle</li>
|
<LI><A HREF = "angle_cosine.html">angle_style cosine</A> - cosine angle potential
|
||||||
<li><a class="reference internal" href="angle_cosine_squared.html"><em>angle_style cosine/squared</em></a> - cosine squared angle potential</li>
|
<LI><A HREF = "angle_cosine_delta.html">angle_style cosine/delta</A> - difference of cosines angle potential
|
||||||
<li><a class="reference internal" href="angle_harmonic.html"><em>angle_style harmonic</em></a> - harmonic angle</li>
|
<LI><A HREF = "angle_cosine_periodic.html">angle_style cosine/periodic</A> - DREIDING angle
|
||||||
<li><a class="reference internal" href="angle_table.html"><em>angle_style table</em></a> - tabulated by angle</li>
|
<LI><A HREF = "angle_cosine_squared.html">angle_style cosine/squared</A> - cosine squared angle potential
|
||||||
</ul>
|
<LI><A HREF = "angle_harmonic.html">angle_style harmonic</A> - harmonic angle
|
||||||
</div>
|
<LI><A HREF = "angle_table.html">angle_style table</A> - tabulated by angle
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<HR>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>This command must come after the simulation box is defined by a
|
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a>, <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>, or
|
|
||||||
<a class="reference internal" href="create_box.html"><em>create_box</em></a> command.</p>
|
|
||||||
<p>An angle style must be defined before any angle coefficients are
|
|
||||||
set, either in the input script or in a data file.</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="angle_style.html"><em>angle_style</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This command must come after the simulation box is defined by a
|
||||||
<footer>
|
<A HREF = "read_data.html">read_data</A>, <A HREF = "read_restart.html">read_restart</A>, or
|
||||||
|
<A HREF = "create_box.html">create_box</A> command.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P>An angle style must be defined before any angle coefficients are
|
||||||
|
set, either in the input script or in a data file.
|
||||||
<div role="contentinfo">
|
</P>
|
||||||
<p>
|
<P><B>Related commands:</B>
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
<P><A HREF = "angle_style.html">angle_style</A>
|
||||||
</div>
|
</P>
|
||||||
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>.
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
</footer>
|
</HTML>
|
||||||
|
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,249 +1,77 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style cosine command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style cosine command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style cosine/omp command
|
||||||
<li>angle_style cosine command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style cosine
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style cosine
|
||||||
</ul>
|
angle_coeff * 75.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>cosine</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_cosine.jpg">
|
||||||
<div class="section" id="angle-style-cosine-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style cosine command<a class="headerlink" href="#angle-style-cosine-command" title="Permalink to this headline">¶</a></h1>
|
<P>where K is defined for each angle type.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="angle-style-cosine-omp-command">
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
<h1>angle_style cosine/omp command<a class="headerlink" href="#angle-style-cosine-omp-command" title="Permalink to this headline">¶</a></h1>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<div class="section" id="syntax">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine
|
</P>
|
||||||
</pre></div>
|
<UL><LI>K (energy)
|
||||||
</div>
|
</UL>
|
||||||
</div>
|
<HR>
|
||||||
<div class="section" id="examples">
|
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine
|
|
||||||
angle_coeff * 75.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>cosine</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_cosine.jpg" class="align-center" src="_images/angle_cosine.jpg" />
|
|
||||||
<p>where K is defined for each angle type.</p>
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>K (energy)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,253 +1,83 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style cosine/delta command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style cosine/delta command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style cosine/delta/omp command
|
||||||
<li>angle_style cosine/delta command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style cosine/delta
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style cosine/delta
|
||||||
</ul>
|
angle_coeff 2*4 75.0 100.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>cosine/delta</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_cosine_delta.jpg">
|
||||||
<div class="section" id="angle-style-cosine-delta-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style cosine/delta command<a class="headerlink" href="#angle-style-cosine-delta-command" title="Permalink to this headline">¶</a></h1>
|
<P>where theta0 is the equilibrium value of the angle, and K is a
|
||||||
</div>
|
prefactor. Note that the usual 1/2 factor is included in K.
|
||||||
<div class="section" id="angle-style-cosine-delta-omp-command">
|
</P>
|
||||||
<h1>angle_style cosine/delta/omp command<a class="headerlink" href="#angle-style-cosine-delta-omp-command" title="Permalink to this headline">¶</a></h1>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
<div class="section" id="syntax">
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine/delta
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<UL><LI>K (energy)
|
||||||
</div>
|
<LI>theta0 (degrees)
|
||||||
<div class="section" id="examples">
|
</UL>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<P>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine/delta
|
internally.
|
||||||
angle_coeff 2*4 75.0 100.0
|
</P>
|
||||||
</pre></div>
|
<HR>
|
||||||
</div>
|
|
||||||
</div>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>cosine/delta</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_cosine_delta.jpg" class="align-center" src="_images/angle_cosine_delta.jpg" />
|
|
||||||
<p>where theta0 is the equilibrium value of the angle, and K is a
|
|
||||||
prefactor. Note that the usual 1/2 factor is included in K.</p>
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>K (energy)</li>
|
|
||||||
<li>theta0 (degrees)</li>
|
|
||||||
</ul>
|
|
||||||
<p>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
|
||||||
internally.</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="angle_coeff.html"><em>angle_coeff</em></a>, <a class="reference internal" href="angle_cosine_squared.html"><em>angle_style cosine/squared</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>, <A HREF = "angle_cosine_squared.html">angle_style
|
||||||
<p>
|
cosine/squared</A>
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
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>.
|
</HTML>
|
||||||
|
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,263 +1,97 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style cosine/periodic command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style cosine/periodic command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style cosine/periodic/omp command
|
||||||
<li>angle_style cosine/periodic command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style cosine/periodic
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style cosine/periodic
|
||||||
</ul>
|
angle_coeff * 75.0 1 6
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>cosine/periodic</I> angle style uses the following potential, which
|
||||||
<div itemprop="articleBody">
|
is commonly used in the <A HREF = "Section_howto.html#howto_4">DREIDING</A> force
|
||||||
|
field, particularly for organometallic systems where <I>n</I> = 4 might be
|
||||||
<div class="section" id="angle-style-cosine-periodic-command">
|
used for an octahedral complex and <I>n</I> = 3 might be used for a
|
||||||
<span id="index-0"></span><h1>angle_style cosine/periodic command<a class="headerlink" href="#angle-style-cosine-periodic-command" title="Permalink to this headline">¶</a></h1>
|
trigonal center:
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="angle-style-cosine-periodic-omp-command">
|
<CENTER><IMG SRC = "Eqs/angle_cosine_periodic.jpg">
|
||||||
<h1>angle_style cosine/periodic/omp command<a class="headerlink" href="#angle-style-cosine-periodic-omp-command" title="Permalink to this headline">¶</a></h1>
|
</CENTER>
|
||||||
<div class="section" id="syntax">
|
<P>where C, B and n are coefficients defined for each angle type.
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine/periodic
|
<P>See <A HREF = "#Mayo">(Mayo)</A> for a description of the DREIDING force field
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
</div>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<div class="section" id="examples">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine/periodic
|
</P>
|
||||||
angle_coeff * 75.0 1 6
|
<UL><LI>C (energy)
|
||||||
</pre></div>
|
<LI>B = 1 or -1
|
||||||
</div>
|
<LI>n = 1, 2, 3, 4, 5 or 6 for periodicity
|
||||||
</div>
|
</UL>
|
||||||
<div class="section" id="description">
|
<P>Note that the prefactor C is specified and not the overall force
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>cosine/periodic</em> angle style uses the following potential, which
|
|
||||||
is commonly used in the <a class="reference internal" href="Section_howto.html#howto-4"><span>DREIDING</span></a> force
|
|
||||||
field, particularly for organometallic systems where <em>n</em> = 4 might be
|
|
||||||
used for an octahedral complex and <em>n</em> = 3 might be used for a
|
|
||||||
trigonal center:</p>
|
|
||||||
<img alt="_images/angle_cosine_periodic.jpg" class="align-center" src="_images/angle_cosine_periodic.jpg" />
|
|
||||||
<p>where C, B and n are coefficients defined for each angle type.</p>
|
|
||||||
<p>See <a class="reference internal" href="special_bonds.html#mayo"><span>(Mayo)</span></a> for a description of the DREIDING force field</p>
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>C (energy)</li>
|
|
||||||
<li>B = 1 or -1</li>
|
|
||||||
<li>n = 1, 2, 3, 4, 5 or 6 for periodicity</li>
|
|
||||||
</ul>
|
|
||||||
<p>Note that the prefactor C is specified and not the overall force
|
|
||||||
constant K = C / n^2. When B = 1, it leads to a minimum for the
|
constant K = C / n^2. When B = 1, it leads to a minimum for the
|
||||||
linear geometry. When B = -1, it leads to a maximum for the linear
|
linear geometry. When B = -1, it leads to a maximum for the linear
|
||||||
geometry.</p>
|
geometry.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="mayo"><strong>(Mayo)</strong> Mayo, Olfason, Goddard III, J Phys Chem, 94, 8897-8909
|
|
||||||
(1990).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
</div>
|
<A NAME = "Mayo"></A>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Mayo)</B> Mayo, Olfason, Goddard III, J Phys Chem, 94, 8897-8909
|
||||||
|
(1990).
|
||||||
<div role="contentinfo">
|
</P>
|
||||||
<p>
|
</HTML>
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,254 +1,81 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style cosine/shift command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style cosine/shift command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style cosine/shift/omp command
|
||||||
<li>angle_style cosine/shift command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style cosine/shift
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style cosine/shift
|
||||||
</ul>
|
angle_coeff * 10.0 45.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>cosine/shift</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_cosine_shift.jpg">
|
||||||
<div class="section" id="angle-style-cosine-shift-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style cosine/shift command<a class="headerlink" href="#angle-style-cosine-shift-command" title="Permalink to this headline">¶</a></h1>
|
<P>where theta0 is the equilibrium angle. The potential is bounded
|
||||||
</div>
|
|
||||||
<div class="section" id="angle-style-cosine-shift-omp-command">
|
|
||||||
<h1>angle_style cosine/shift/omp command<a class="headerlink" href="#angle-style-cosine-shift-omp-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>angle_style cosine/shift
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>angle_style cosine/shift
|
|
||||||
angle_coeff * 10.0 45.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>cosine/shift</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_cosine_shift.jpg" class="align-center" src="_images/angle_cosine_shift.jpg" />
|
|
||||||
<p>where theta0 is the equilibrium angle. The potential is bounded
|
|
||||||
between -Umin and zero. In the neighborhood of the minimum E=- Umin +
|
between -Umin and zero. In the neighborhood of the minimum E=- Umin +
|
||||||
Umin/4(theta-theta0)^2 hence the spring constant is umin/2.</p>
|
Umin/4(theta-theta0)^2 hence the spring constant is umin/2.
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
</P>
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above, or in
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<ul class="simple">
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>umin (energy)</li>
|
</P>
|
||||||
<li>theta (angle)</li>
|
<UL><LI>umin (energy)
|
||||||
</ul>
|
<LI>theta (angle)
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
USER-MISC package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a>
|
<HR>
|
||||||
section for more info on packages.</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="angle_coeff.html"><em>angle_coeff</em></a>,
|
|
||||||
<code class="xref doc docutils literal"><span class="pre">angle_cosineshiftexp</span></code></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
USER-MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
||||||
|
section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>,
|
||||||
<p>
|
<A HREF = "angle_cosineshiftexp.html">angle_cosineshiftexp</A>
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
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>.
|
</HTML>
|
||||||
|
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,265 +1,94 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style cosine/shift/exp command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style cosine/shift/exp command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style cosine/shift/exp/omp command
|
||||||
<li>angle_style cosine/shift/exp command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style cosine/shift/exp
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style cosine/shift/exp
|
||||||
</ul>
|
angle_coeff * 10.0 45.0 2.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>cosine/shift/exp</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_cosine_shift_exp.jpg">
|
||||||
<div class="section" id="angle-style-cosine-shift-exp-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style cosine/shift/exp command<a class="headerlink" href="#angle-style-cosine-shift-exp-command" title="Permalink to this headline">¶</a></h1>
|
<P>where Umin, theta, and a are defined for each angle type.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="angle-style-cosine-shift-exp-omp-command">
|
<P>The potential is bounded between [-Umin:0] and the minimum is
|
||||||
<h1>angle_style cosine/shift/exp/omp command<a class="headerlink" href="#angle-style-cosine-shift-exp-omp-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>angle_style cosine/shift/exp
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>angle_style cosine/shift/exp
|
|
||||||
angle_coeff * 10.0 45.0 2.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>cosine/shift/exp</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_cosine_shift_exp.jpg" class="align-center" src="_images/angle_cosine_shift_exp.jpg" />
|
|
||||||
<p>where Umin, theta, and a are defined for each angle type.</p>
|
|
||||||
<p>The potential is bounded between [-Umin:0] and the minimum is
|
|
||||||
located at the angle theta0. The a parameter can be both positive or
|
located at the angle theta0. The a parameter can be both positive or
|
||||||
negative and is used to control the spring constant at the
|
negative and is used to control the spring constant at the
|
||||||
equilibrium.</p>
|
equilibrium.
|
||||||
<p>The spring constant is given by k = A exp(A) Umin / [2 (Exp(a)-1)].
|
</P>
|
||||||
For a > 3, k/Umin = a/2 to better than 5% relative error. For negative
|
<P>The spring constant is given by k = A exp(A) Umin / [2 (Exp(a)-1)].
|
||||||
|
For a > 3, k/Umin = a/2 to better than 5% relative error. For negative
|
||||||
values of the a parameter, the spring constant is essentially zero,
|
values of the a parameter, the spring constant is essentially zero,
|
||||||
and anharmonic terms takes over. The potential is furthermore well
|
and anharmonic terms takes over. The potential is furthermore well
|
||||||
behaved in the limit a -> 0, where it has been implemented to linear
|
behaved in the limit a -> 0, where it has been implemented to linear
|
||||||
order in a for a < 0.001. In this limit the potential reduces to the
|
order in a for a < 0.001. In this limit the potential reduces to the
|
||||||
cosineshifted potential.</p>
|
cosineshifted potential.
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
</P>
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above, or in
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<ul class="simple">
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>umin (energy)</li>
|
</P>
|
||||||
<li>theta (angle)</li>
|
<UL><LI>umin (energy)
|
||||||
<li>A (real number)</li>
|
<LI>theta (angle)
|
||||||
</ul>
|
<LI>A (real number)
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
USER-MISC package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a>
|
<HR>
|
||||||
section for more info on packages.</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="angle_coeff.html"><em>angle_coeff</em></a>,
|
|
||||||
<code class="xref doc docutils literal"><span class="pre">angle_cosineshift</span></code>,
|
|
||||||
<code class="xref doc docutils literal"><span class="pre">dihedral_cosineshift</span></code></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
USER-MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
||||||
|
section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>,
|
||||||
<p>
|
<A HREF = "angle_cosineshift.html">angle_cosineshift</A>,
|
||||||
© Copyright .
|
<A HREF = "dihedral_cosineshift.html">dihedral_cosineshift</A>
|
||||||
</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
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>.
|
</P>
|
||||||
|
</HTML>
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,253 +1,82 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style cosine/squared command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style cosine/squared command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style cosine/squared/omp command
|
||||||
<li>angle_style cosine/squared command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style cosine/squared
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style cosine/squared
|
||||||
</ul>
|
angle_coeff 2*4 75.0 100.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>cosine/squared</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_cosine_squared.jpg">
|
||||||
<div class="section" id="angle-style-cosine-squared-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style cosine/squared command<a class="headerlink" href="#angle-style-cosine-squared-command" title="Permalink to this headline">¶</a></h1>
|
<P>where theta0 is the equilibrium value of the angle, and K is a
|
||||||
</div>
|
prefactor. Note that the usual 1/2 factor is included in K.
|
||||||
<div class="section" id="angle-style-cosine-squared-omp-command">
|
</P>
|
||||||
<h1>angle_style cosine/squared/omp command<a class="headerlink" href="#angle-style-cosine-squared-omp-command" title="Permalink to this headline">¶</a></h1>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
<div class="section" id="syntax">
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine/squared
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<UL><LI>K (energy)
|
||||||
</div>
|
<LI>theta0 (degrees)
|
||||||
<div class="section" id="examples">
|
</UL>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<P>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style cosine/squared
|
internally.
|
||||||
angle_coeff 2*4 75.0 100.0
|
</P>
|
||||||
</pre></div>
|
<HR>
|
||||||
</div>
|
|
||||||
</div>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>cosine/squared</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_cosine_squared.jpg" class="align-center" src="_images/angle_cosine_squared.jpg" />
|
|
||||||
<p>where theta0 is the equilibrium value of the angle, and K is a
|
|
||||||
prefactor. Note that the usual 1/2 factor is included in K.</p>
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>K (energy)</li>
|
|
||||||
<li>theta0 (degrees)</li>
|
|
||||||
</ul>
|
|
||||||
<p>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
|
||||||
internally.</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,290 +1,130 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style dipole command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style dipole command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style dipole/omp command
|
||||||
<li>angle_style dipole command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style dipole
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style dipole
|
||||||
</ul>
|
angle_coeff 6 2.1 180.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>dipole</I> angle style is used to control the orientation of a dipolar
|
||||||
<div itemprop="articleBody">
|
atom within a molecule <A HREF = "#Orsi">(Orsi)</A>. Specifically, the <I>dipole</I> angle
|
||||||
|
style restrains the orientation of a point dipole mu_j (embedded in atom
|
||||||
<div class="section" id="angle-style-dipole-command">
|
'j') with respect to a reference (bond) vector r_ij = r_i - r_j, where 'i'
|
||||||
<span id="index-0"></span><h1>angle_style dipole command<a class="headerlink" href="#angle-style-dipole-command" title="Permalink to this headline">¶</a></h1>
|
is another atom of the same molecule (typically, 'i' and 'j' are also
|
||||||
</div>
|
covalently bonded).
|
||||||
<div class="section" id="angle-style-dipole-omp-command">
|
</P>
|
||||||
<h1>angle_style dipole/omp command<a class="headerlink" href="#angle-style-dipole-omp-command" title="Permalink to this headline">¶</a></h1>
|
<P>It is convenient to define an angle gamma between the 'free' vector mu_j
|
||||||
<div class="section" id="syntax">
|
and the reference (bond) vector r_ij:
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style dipole
|
<CENTER><IMG SRC = "Eqs/angle_dipole_gamma.jpg">
|
||||||
</pre></div>
|
</CENTER>
|
||||||
</div>
|
<P>The <I>dipole</I> angle style uses the potential:
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="examples">
|
<CENTER><IMG SRC = "Eqs/angle_dipole_potential.jpg">
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
</CENTER>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style dipole
|
<P>where K is a rigidity constant and gamma0 is an equilibrium (reference)
|
||||||
angle_coeff 6 2.1 180.0
|
angle.
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<P>The torque on the dipole can be obtained by differentiating the
|
||||||
</div>
|
potential using the 'chain rule' as in appendix C.3 of
|
||||||
<div class="section" id="description">
|
<A HREF = "#Allen">(Allen)</A>:
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>The <em>dipole</em> angle style is used to control the orientation of a dipolar
|
<CENTER><IMG SRC = "Eqs/angle_dipole_torque.jpg">
|
||||||
atom within a molecule <a class="reference internal" href="#orsi"><span>(Orsi)</span></a>. Specifically, the <em>dipole</em> angle
|
</CENTER>
|
||||||
style restrains the orientation of a point dipole mu_j (embedded in atom
|
<P>Example: if gamma0 is set to 0 degrees, the torque generated by
|
||||||
‘j’) with respect to a reference (bond) vector r_ij = r_i - r_j, where ‘i’
|
the potential will tend to align the dipole along the reference
|
||||||
is another atom of the same molecule (typically, ‘i’ and ‘j’ are also
|
|
||||||
covalently bonded).</p>
|
|
||||||
<p>It is convenient to define an angle gamma between the ‘free’ vector mu_j
|
|
||||||
and the reference (bond) vector r_ij:</p>
|
|
||||||
<img alt="_images/angle_dipole_gamma.jpg" class="align-center" src="_images/angle_dipole_gamma.jpg" />
|
|
||||||
<p>The <em>dipole</em> angle style uses the potential:</p>
|
|
||||||
<img alt="_images/angle_dipole_potential.jpg" class="align-center" src="_images/angle_dipole_potential.jpg" />
|
|
||||||
<p>where K is a rigidity constant and gamma0 is an equilibrium (reference)
|
|
||||||
angle.</p>
|
|
||||||
<p>The torque on the dipole can be obtained by differentiating the
|
|
||||||
potential using the ‘chain rule’ as in appendix C.3 of
|
|
||||||
<a class="reference internal" href="pair_gayberne.html#allen"><span>(Allen)</span></a>:</p>
|
|
||||||
<img alt="_images/angle_dipole_torque.jpg" class="align-center" src="_images/angle_dipole_torque.jpg" />
|
|
||||||
<p>Example: if gamma0 is set to 0 degrees, the torque generated by
|
|
||||||
the potential will tend to align the dipole along the reference
|
|
||||||
direction defined by the (bond) vector r_ij (in other words, mu_j is
|
direction defined by the (bond) vector r_ij (in other words, mu_j is
|
||||||
restrained to point towards atom ‘i’).</p>
|
restrained to point towards atom 'i').
|
||||||
<p>Note that the angle dipole potential does not give rise to any force,
|
</P>
|
||||||
because it does not depend on the distance between i and j (it only
|
<P>Note that the angle dipole potential does not give rise to any force,
|
||||||
depends on the angle between mu_j and r_ij).</p>
|
because it does not depend on the distance between i and j (it only
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
depends on the angle between mu_j and r_ij).
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above, or in
|
</P>
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<ul class="simple">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<li>K (energy)</li>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>gamma0 (degrees)</li>
|
</P>
|
||||||
</ul>
|
<UL><LI>K (energy)
|
||||||
<hr class="docutils" />
|
<LI>gamma0 (degrees)
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
</UL>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-6"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_6">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
more instructions on how to use the accelerated styles effectively.
|
||||||
USER-MISC package. See the <span class="xref std std-ref">Making LAMMPS</span>
|
</P>
|
||||||
section for more info on packages.</p>
|
<P><B>Restrictions:</B>
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<p class="last">In the “Angles” section of the data file, the atom ID
|
USER-MISC package. See the <A HREF = "Section_start.html#2_3">Making LAMMPS</A>
|
||||||
‘j’ corresponding to the dipole to restrain must come before the atom
|
section for more info on packages.
|
||||||
ID of the reference atom ‘i’. A third atom ID ‘k’ must also be
|
</P>
|
||||||
provided, although ‘k’ is just a ‘dummy’ atom which can be any atom;
|
<P>IMPORTANT NOTE: In the "Angles" section of the data file, the atom ID
|
||||||
it may be useful to choose a convention (e.g., ‘k’=’i’) and adhere to
|
'j' corresponding to the dipole to restrain must come before the atom
|
||||||
|
ID of the reference atom 'i'. A third atom ID 'k' must also be
|
||||||
|
provided, although 'k' is just a 'dummy' atom which can be any atom;
|
||||||
|
it may be useful to choose a convention (e.g., 'k'='i') and adhere to
|
||||||
it. For example, if ID=1 for the dipolar atom to restrain, and ID=2
|
it. For example, if ID=1 for the dipolar atom to restrain, and ID=2
|
||||||
for the reference atom, the corresponding line in the “Angles” section
|
for the reference atom, the corresponding line in the "Angles" section
|
||||||
of the data file would read: X X 1 2 2</p>
|
of the data file would read: X X 1 2 2
|
||||||
</div>
|
</P>
|
||||||
<p>The “newton” command for intramolecular interactions must be “on”
|
<P>The "newton" command for intramolecular interactions must be "on"
|
||||||
(which is the default).</p>
|
(which is the default).
|
||||||
<p>This angle style should not be used with SHAKE.</p>
|
</P>
|
||||||
</div>
|
<P>This angle style should not be used with SHAKE.
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><B>Related commands:</B>
|
||||||
<p><a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a>, <a class="reference internal" href="angle_hybrid.html"><em>angle_hybrid</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>, <A HREF = "angle_hybrid.html">angle_hybrid</A>
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p id="orsi"><strong>(Orsi)</strong> Orsi & Essex, The ELBA force field for coarse-grain modeling of
|
<P><B>Default:</B> none
|
||||||
lipid membranes, PloS ONE 6(12): e28637, 2011.</p>
|
</P>
|
||||||
<p id="allen"><strong>(Allen)</strong> Allen & Tildesley, Computer Simulation of Liquids,
|
<HR>
|
||||||
Clarendon Press, Oxford, 1987.</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<A NAME = "Orsi"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Orsi)</B> Orsi & Essex, The ELBA force field for coarse-grain modeling of
|
||||||
</div>
|
lipid membranes, PloS ONE 6(12): e28637, 2011.
|
||||||
<footer>
|
</P>
|
||||||
|
<A NAME = "Allen"></A>
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Allen)</B> Allen & Tildesley, Computer Simulation of Liquids,
|
||||||
|
Clarendon Press, Oxford, 1987.
|
||||||
<div role="contentinfo">
|
</P>
|
||||||
<p>
|
</HTML>
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,250 +1,78 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style fourier command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style fourier command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style fourier/omp command
|
||||||
<li>angle_style fourier command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style fourier
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<P>angle_style fourier
|
||||||
</ul>
|
angle_coeff 75.0 1.0 1.0 1.0
|
||||||
<hr/>
|
</P>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>fourier</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_fourier.jpg">
|
||||||
<div class="section" id="angle-style-fourier-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style fourier command<a class="headerlink" href="#angle-style-fourier-command" title="Permalink to this headline">¶</a></h1>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
</div>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<div class="section" id="angle-style-fourier-omp-command">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<h1>angle_style fourier/omp command<a class="headerlink" href="#angle-style-fourier-omp-command" title="Permalink to this headline">¶</a></h1>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<UL><LI>K (energy)
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style fourier
|
<LI>C0 (real)
|
||||||
</pre></div>
|
<LI>C1 (real)
|
||||||
</div>
|
<LI>C2 (real)
|
||||||
</div>
|
</UL>
|
||||||
<div class="section" id="examples">
|
<HR>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>angle_style fourier
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
angle_coeff 75.0 1.0 1.0 1.0</p>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>fourier</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_fourier.jpg" class="align-center" src="_images/angle_fourier.jpg" />
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>K (energy)</li>
|
|
||||||
<li>C0 (real)</li>
|
|
||||||
<li>C1 (real)</li>
|
|
||||||
<li>C2 (real)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
USER_MISC package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a>
|
<HR>
|
||||||
section for more info on packages.</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
USER_MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
||||||
|
section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,249 +1,77 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style fourier/simple command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style fourier/simple command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style fourier/simple/omp command
|
||||||
<li>angle_style fourier/simple command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style fourier/simple
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<P>angle_style fourier/simple
|
||||||
</ul>
|
angle_coeff 100.0 -1.0 1.0
|
||||||
<hr/>
|
</P>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>fourier/simple</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_fourier_simple.jpg">
|
||||||
<div class="section" id="angle-style-fourier-simple-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style fourier/simple command<a class="headerlink" href="#angle-style-fourier-simple-command" title="Permalink to this headline">¶</a></h1>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
</div>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<div class="section" id="angle-style-fourier-simple-omp-command">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<h1>angle_style fourier/simple/omp command<a class="headerlink" href="#angle-style-fourier-simple-omp-command" title="Permalink to this headline">¶</a></h1>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<UL><LI>K (energy)
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style fourier/simple
|
<LI>c (real)
|
||||||
</pre></div>
|
<LI>n (real)
|
||||||
</div>
|
</UL>
|
||||||
</div>
|
<HR>
|
||||||
<div class="section" id="examples">
|
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
<p>angle_style fourier/simple
|
|
||||||
angle_coeff 100.0 -1.0 1.0</p>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>fourier/simple</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_fourier_simple.jpg" class="align-center" src="_images/angle_fourier_simple.jpg" />
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>K (energy)</li>
|
|
||||||
<li>c (real)</li>
|
|
||||||
<li>n (real)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
USER_MISC package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a>
|
<HR>
|
||||||
section for more info on packages.</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
USER_MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
||||||
|
section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,258 +1,84 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style harmonic command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style harmonic command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style harmonic/kk command
|
||||||
<li>angle_style harmonic command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<H3>angle_style harmonic/omp command
|
||||||
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</P>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE>angle_style harmonic
|
||||||
|
</PRE>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>angle_style harmonic
|
||||||
|
angle_coeff 1 300.0 107.0
|
||||||
</div>
|
</PRE>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P><B>Description:</B>
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<P>The <I>harmonic</I> angle style uses the potential
|
||||||
<div class="section" id="angle-style-harmonic-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>angle_style harmonic command<a class="headerlink" href="#angle-style-harmonic-command" title="Permalink to this headline">¶</a></h1>
|
<CENTER><IMG SRC = "Eqs/angle_harmonic.jpg">
|
||||||
</div>
|
</CENTER>
|
||||||
<div class="section" id="angle-style-harmonic-kk-command">
|
<P>where theta0 is the equilibrium value of the angle, and K is a
|
||||||
<h1>angle_style harmonic/kk command<a class="headerlink" href="#angle-style-harmonic-kk-command" title="Permalink to this headline">¶</a></h1>
|
prefactor. Note that the usual 1/2 factor is included in K.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="angle-style-harmonic-omp-command">
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
<h1>angle_style harmonic/omp command<a class="headerlink" href="#angle-style-harmonic-omp-command" title="Permalink to this headline">¶</a></h1>
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<div class="section" id="syntax">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style harmonic
|
</P>
|
||||||
</pre></div>
|
<UL><LI>K (energy/radian^2)
|
||||||
</div>
|
<LI>theta0 (degrees)
|
||||||
</div>
|
</UL>
|
||||||
<div class="section" id="examples">
|
<P>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
internally; hence the units of K are in energy/radian^2.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style harmonic
|
</P>
|
||||||
angle_coeff 1 300.0 107.0
|
<HR>
|
||||||
</pre></div>
|
|
||||||
</div>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>harmonic</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_harmonic.jpg" class="align-center" src="_images/angle_harmonic.jpg" />
|
|
||||||
<p>where theta0 is the equilibrium value of the angle, and K is a
|
|
||||||
prefactor. Note that the usual 1/2 factor is included in K.</p>
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>K (energy/radian^2)</li>
|
|
||||||
<li>theta0 (degrees)</li>
|
|
||||||
</ul>
|
|
||||||
<p>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
|
||||||
internally; hence the units of K are in energy/radian^2.</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<HR>
|
||||||
<p>This angle 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>Making LAMMPS</span></a> section for more info on packages.</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,274 +1,96 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style hybrid command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style hybrid command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>angle_style hybrid command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>angle_style hybrid style1 style2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>style1,style2 = list of one or more angle styles
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</UL>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style hybrid harmonic cosine
|
||||||
</ul>
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="angle-style-hybrid-command">
|
|
||||||
<span id="index-0"></span><h1>angle_style hybrid command<a class="headerlink" href="#angle-style-hybrid-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>angle_style hybrid style1 style2 ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style1,style2 = list of one or more angle styles</li>
|
|
||||||
</ul>
|
|
||||||
</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>angle_style hybrid harmonic cosine
|
|
||||||
angle_coeff 1 harmonic 80.0 30.0
|
angle_coeff 1 harmonic 80.0 30.0
|
||||||
angle_coeff 2* cosine 50.0
|
angle_coeff 2* cosine 50.0
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>The <I>hybrid</I> style enables the use of multiple angle styles in one
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>hybrid</em> style enables the use of multiple angle styles in one
|
|
||||||
simulation. An angle style is assigned to each angle type. For
|
simulation. An angle style is assigned to each angle type. For
|
||||||
example, angles in a polymer flow (of angle type 1) could be computed
|
example, angles in a polymer flow (of angle type 1) could be computed
|
||||||
with a <em>harmonic</em> potential and angles in the wall boundary (of angle
|
with a <I>harmonic</I> potential and angles in the wall boundary (of angle
|
||||||
type 2) could be computed with a <em>cosine</em> potential. The assignment
|
type 2) could be computed with a <I>cosine</I> potential. The assignment
|
||||||
of angle type to style is made via the <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a>
|
of angle type to style is made via the <A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
command or in the data file.</p>
|
command or in the data file.
|
||||||
<p>In the angle_coeff commands, the name of an angle style must be added
|
</P>
|
||||||
|
<P>In the angle_coeff commands, the name of an angle style must be added
|
||||||
after the angle type, with the remaining coefficients being those
|
after the angle type, with the remaining coefficients being those
|
||||||
appropriate to that style. In the example above, the 2 angle_coeff
|
appropriate to that style. In the example above, the 2 angle_coeff
|
||||||
commands set angles of angle type 1 to be computed with a <em>harmonic</em>
|
commands set angles of angle type 1 to be computed with a <I>harmonic</I>
|
||||||
potential with coefficients 80.0, 30.0 for K, theta0. All other angle
|
potential with coefficients 80.0, 30.0 for K, theta0. All other angle
|
||||||
types (2-N) are computed with a <em>cosine</em> potential with coefficient
|
types (2-N) are computed with a <I>cosine</I> potential with coefficient
|
||||||
50.0 for K.</p>
|
50.0 for K.
|
||||||
<p>If angle coefficients are specified in the data file read via the
|
</P>
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command, then the same rule applies.
|
<P>If angle coefficients are specified in the data file read via the
|
||||||
E.g. “harmonic” or “cosine”, must be added after the angle type, for each
|
<A HREF = "read_data.html">read_data</A> command, then the same rule applies.
|
||||||
line in the “Angle Coeffs” section, e.g.</p>
|
E.g. "harmonic" or "cosine", must be added after the angle type, for each
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Angle Coeffs
|
line in the "Angle Coeffs" section, e.g.
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>Angle Coeffs
|
||||||
<div class="highlight-python"><div class="highlight"><pre>1 harmonic 80.0 30.0
|
</PRE>
|
||||||
|
<PRE>1 harmonic 80.0 30.0
|
||||||
2 cosine 50.0
|
2 cosine 50.0
|
||||||
...
|
...
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>If <I>class2</I> is one of the angle hybrid styles, the same rule holds for
|
||||||
<p>If <em>class2</em> is one of the angle hybrid styles, the same rule holds for
|
|
||||||
specifying additional BondBond (and BondAngle) coefficients either via
|
specifying additional BondBond (and BondAngle) coefficients either via
|
||||||
the input script or in the data file. I.e. <em>class2</em> must be added to
|
the input script or in the data file. I.e. <I>class2</I> must be added to
|
||||||
each line after the angle type. For lines in the BondBond (or
|
each line after the angle type. For lines in the BondBond (or
|
||||||
BondAngle) section of the data file for angle types that are not
|
BondAngle) section of the data file for angle types that are not
|
||||||
<em>class2</em>, you must use an angle style of <em>skip</em> as a placeholder, e.g.</p>
|
<I>class2</I>, you must use an angle style of <I>skip</I> as a placeholder, e.g.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>BondBond Coeffs
|
</P>
|
||||||
</pre></div>
|
<PRE>BondBond Coeffs
|
||||||
</div>
|
</PRE>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>1 skip
|
<PRE>1 skip
|
||||||
2 class2 3.6512 1.0119 1.0119
|
2 class2 3.6512 1.0119 1.0119
|
||||||
...
|
...
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Note that it is not necessary to use the angle style <I>skip</I> in the
|
||||||
<p>Note that it is not necessary to use the angle style <em>skip</em> in the
|
|
||||||
input script, since BondBond (or BondAngle) coefficients need not be
|
input script, since BondBond (or BondAngle) coefficients need not be
|
||||||
specified at all for angle types that are not <em>class2</em>.</p>
|
specified at all for angle types that are not <I>class2</I>.
|
||||||
<p>An angle style of <em>none</em> with no additional coefficients can be used
|
</P>
|
||||||
|
<P>An angle style of <I>none</I> with no additional coefficients can be used
|
||||||
in place of an angle style, either in a input script angle_coeff
|
in place of an angle style, either in a input script angle_coeff
|
||||||
command or in the data file, if you desire to turn off interactions
|
command or in the data file, if you desire to turn off interactions
|
||||||
for specific angle types.</p>
|
for specific angle types.
|
||||||
</div>
|
</P>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
<div class="section" id="restrictions">
|
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>This angle 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>Making LAMMPS</span></a> section for more info on packages.</p>
|
|
||||||
<p>Unlike other angle styles, the hybrid angle style does not store angle
|
|
||||||
coefficient info for individual sub-styles in a <a class="reference internal" href="restart.html"><em>binary restart files</em></a>. Thus when retarting a simulation from a restart
|
|
||||||
file, you need to re-specify angle_coeff commands.</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P>Unlike other angle styles, the hybrid angle style does not store angle
|
||||||
|
coefficient info for individual sub-styles in a <A HREF = "restart.html">binary restart
|
||||||
<div role="contentinfo">
|
files</A>. Thus when retarting a simulation from a restart
|
||||||
<p>
|
file, you need to re-specify angle_coeff commands.
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
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>.
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
|
</P>
|
||||||
</footer>
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,218 +1,34 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style none command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style none command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>angle_style none command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>angle_style none
|
||||||
|
</PRE>
|
||||||
|
<P><B>Examples:</B>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</P>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE>angle_style none
|
||||||
|
</PRE>
|
||||||
</li>
|
<P><B>Description:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<P>Using an angle style of none means angle forces are not computed, even
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="angle-style-none-command">
|
|
||||||
<span id="index-0"></span><h1>angle_style none command<a class="headerlink" href="#angle-style-none-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>angle_style none
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>angle_style none
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Using an angle style of none means angle forces are not computed, even
|
|
||||||
if triplets of angle atoms were listed in the data file read by the
|
if triplets of angle atoms were listed in the data file read by the
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command.</p>
|
<A HREF = "read_data.html">read_data</A> command.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B> none
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Related commands:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
<p><strong>Related commands:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,256 +1,84 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style quartic command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style quartic command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style quartic/omp command
|
||||||
<li>angle_style quartic command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style quartic
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style quartic
|
||||||
</ul>
|
angle_coeff 1 129.1948 56.8726 -25.9442 -14.2221
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>quartic</I> angle style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_quartic.jpg">
|
||||||
<div class="section" id="angle-style-quartic-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style quartic command<a class="headerlink" href="#angle-style-quartic-command" title="Permalink to this headline">¶</a></h1>
|
<P>where theta0 is the equilibrium value of the angle, and K is a
|
||||||
</div>
|
prefactor. Note that the usual 1/2 factor is included in K.
|
||||||
<div class="section" id="angle-style-quartic-omp-command">
|
</P>
|
||||||
<h1>angle_style quartic/omp command<a class="headerlink" href="#angle-style-quartic-omp-command" title="Permalink to this headline">¶</a></h1>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
<div class="section" id="syntax">
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above, or in
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style quartic
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<UL><LI>theta0 (degrees)
|
||||||
</div>
|
<LI>K2 (energy/radian^2)
|
||||||
<div class="section" id="examples">
|
<LI>K3 (energy/radian^3)
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<LI>K4 (energy/radian^4)
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style quartic
|
</UL>
|
||||||
angle_coeff 1 129.1948 56.8726 -25.9442 -14.2221
|
<P>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
||||||
</pre></div>
|
internally; hence the units of K are in energy/radian^2.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<HR>
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
<p>The <em>quartic</em> angle style uses the potential</p>
|
|
||||||
<img alt="_images/angle_quartic.jpg" class="align-center" src="_images/angle_quartic.jpg" />
|
|
||||||
<p>where theta0 is the equilibrium value of the angle, and K is a
|
|
||||||
prefactor. Note that the usual 1/2 factor is included in K.</p>
|
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>theta0 (degrees)</li>
|
|
||||||
<li>K2 (energy/radian^2)</li>
|
|
||||||
<li>K3 (energy/radian^3)</li>
|
|
||||||
<li>K4 (energy/radian^4)</li>
|
|
||||||
</ul>
|
|
||||||
<p>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
|
||||||
internally; hence the units of K are in energy/radian^2.</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
USER_MISC package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a>
|
<HR>
|
||||||
section for more info on packages.</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
USER_MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
||||||
|
section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,242 +1,64 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style sdk command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style sdk command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>angle_style sdk command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>angle_style sdk
|
||||||
|
</PRE>
|
||||||
|
<PRE>angle_style sdk/omp
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style sdk
|
||||||
</ul>
|
angle_coeff 1 300.0 107.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>sdk</I> angle style is a combination of the harmonic angle potential,
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/angle_harmonic.jpg">
|
||||||
<div class="section" id="angle-style-sdk-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>angle_style sdk command<a class="headerlink" href="#angle-style-sdk-command" title="Permalink to this headline">¶</a></h1>
|
<P>where theta0 is the equilibrium value of the angle and K a prefactor,
|
||||||
<div class="section" id="syntax">
|
with the <I>repulsive</I> part of the non-bonded <I>lj/sdk</I> pair style
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style sdk
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style sdk/omp
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>angle_style sdk
|
|
||||||
angle_coeff 1 300.0 107.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>sdk</em> angle style is a combination of the harmonic angle potential,</p>
|
|
||||||
<img alt="_images/angle_harmonic.jpg" class="align-center" src="_images/angle_harmonic.jpg" />
|
|
||||||
<p>where theta0 is the equilibrium value of the angle and K a prefactor,
|
|
||||||
with the <em>repulsive</em> part of the non-bonded <em>lj/sdk</em> pair style
|
|
||||||
between the atoms 1 and 3. This angle potential is intended for
|
between the atoms 1 and 3. This angle potential is intended for
|
||||||
coarse grained MD simulations with the CMM parametrization using the
|
coarse grained MD simulations with the CMM parametrization using the
|
||||||
<a class="reference internal" href="pair_sdk.html"><em>pair_style lj/sdk</em></a>. Relative to the pair_style
|
<A HREF = "pair_sdk.html">pair_style lj/sdk</A>. Relative to the pair_style
|
||||||
<em>lj/sdk</em>, however, the energy is shifted by <em>epsilon</em>, to avoid sudden
|
<I>lj/sdk</I>, however, the energy is shifted by <I>epsilon</I>, to avoid sudden
|
||||||
jumps. Note that the usual 1/2 factor is included in K.</p>
|
jumps. Note that the usual 1/2 factor is included in K.
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
</P>
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above:</p>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
<ul class="simple">
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above:
|
||||||
<li>K (energy/radian^2)</li>
|
</P>
|
||||||
<li>theta0 (degrees)</li>
|
<UL><LI>K (energy/radian^2)
|
||||||
</ul>
|
<LI>theta0 (degrees)
|
||||||
<p>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
</UL>
|
||||||
|
<P>Theta0 is specified in degrees, but LAMMPS converts it to radians
|
||||||
internally; hence the units of K are in energy/radian^2.
|
internally; hence the units of K are in energy/radian^2.
|
||||||
The also required <em>lj/sdk</em> parameters will be extracted automatically
|
The also required <I>lj/sdk</I> parameters will be extracted automatically
|
||||||
from the pair_style.</p>
|
from the pair_style.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
USER-CG-CMM package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
USER-CG-CMM package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
</div>
|
LAMMPS</A> section for more info on packages.
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><B>Related commands:</B>
|
||||||
<p><a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a>, <a class="reference internal" href="angle_harmonic.html"><em>angle_style harmonic</em></a>, <a class="reference internal" href="pair_sdk.html"><em>pair_style lj/sdk</em></a>,
|
</P>
|
||||||
<a class="reference internal" href="pair_sdk.html"><em>pair_style lj/sdk/coul/long</em></a></p>
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>, <A HREF = "angle_harmonic.html">angle_style
|
||||||
<p><strong>Default:</strong> none</p>
|
harmonic</A>, <A HREF = "pair_sdk.html">pair_style lj/sdk</A>,
|
||||||
</div>
|
<A HREF = "pair_sdk.html">pair_style lj/sdk/coul/long</A>
|
||||||
</div>
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,277 +1,100 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>angle_style command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>angle_style style
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>style = <I>none</I> or <I>hybrid</I> or <I>charmm</I> or <I>class2</I> or <I>cosine</I> or <I>cosine/squared</I> or <I>harmonic</I>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</UL>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>angle_style harmonic
|
||||||
</ul>
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="angle-style-command">
|
|
||||||
<span id="index-0"></span><h1>angle_style command<a class="headerlink" href="#angle-style-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>angle_style style
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style = <em>none</em> or <em>hybrid</em> or <em>charmm</em> or <em>class2</em> or <em>cosine</em> or <em>cosine/squared</em> or <em>harmonic</em></li>
|
|
||||||
</ul>
|
|
||||||
</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>angle_style harmonic
|
|
||||||
angle_style charmm
|
angle_style charmm
|
||||||
angle_style hybrid harmonic cosine
|
angle_style hybrid harmonic cosine
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Set the formula(s) LAMMPS uses to compute angle interactions between
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Set the formula(s) LAMMPS uses to compute angle interactions between
|
|
||||||
triplets of atoms, which remain in force for the duration of the
|
triplets of atoms, which remain in force for the duration of the
|
||||||
simulation. The list of angle triplets is read in by a
|
simulation. The list of angle triplets is read in by a
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> command
|
<A HREF = "read_data.html">read_data</A> or <A HREF = "read_restart.html">read_restart</A> command
|
||||||
from a data or restart file.</p>
|
from a data or restart file.
|
||||||
<p>Hybrid models where angles are computed using different angle
|
</P>
|
||||||
potentials can be setup using the <em>hybrid</em> angle style.</p>
|
<P>Hybrid models where angles are computed using different angle
|
||||||
<p>The coefficients associated with a angle style can be specified in a
|
potentials can be setup using the <I>hybrid</I> angle style.
|
||||||
data or restart file or via the <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command.</p>
|
</P>
|
||||||
<p>All angle potentials store their coefficient data in binary restart
|
<P>The coefficients associated with a angle style can be specified in a
|
||||||
files which means angle_style and <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a>
|
data or restart file or via the <A HREF = "angle_coeff.html">angle_coeff</A> command.
|
||||||
|
</P>
|
||||||
|
<P>All angle potentials store their coefficient data in binary restart
|
||||||
|
files which means angle_style and <A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
commands do not need to be re-specified in an input script that
|
commands do not need to be re-specified in an input script that
|
||||||
restarts a simulation. See the <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>
|
restarts a simulation. See the <A HREF = "read_restart.html">read_restart</A>
|
||||||
command for details on how to do this. The one exception is that
|
command for details on how to do this. The one exception is that
|
||||||
angle_style <em>hybrid</em> only stores the list of sub-styles in the restart
|
angle_style <I>hybrid</I> only stores the list of sub-styles in the restart
|
||||||
file; angle coefficients need to be re-specified.</p>
|
file; angle coefficients need to be re-specified.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: When both an angle and pair style is defined, the
|
||||||
<p class="last">When both an angle and pair style is defined, the
|
<A HREF = "special_bonds.html">special_bonds</A> command often needs to be used to
|
||||||
<a class="reference internal" href="special_bonds.html"><em>special_bonds</em></a> command often needs to be used to
|
|
||||||
turn off (or weight) the pairwise interaction that would otherwise
|
turn off (or weight) the pairwise interaction that would otherwise
|
||||||
exist between 3 bonded atoms.</p>
|
exist between 3 bonded atoms.
|
||||||
</div>
|
</P>
|
||||||
<p>In the formulas listed for each angle style, <em>theta</em> is the angle
|
<P>In the formulas listed for each angle style, <I>theta</I> is the angle
|
||||||
between the 3 atoms in the angle.</p>
|
between the 3 atoms in the angle.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>Here is an alphabetic list of angle styles defined in LAMMPS. Click on
|
<HR>
|
||||||
|
|
||||||
|
<P>Here is an alphabetic list of angle styles defined in LAMMPS. Click on
|
||||||
the style to display the formula it computes and coefficients
|
the style to display the formula it computes and coefficients
|
||||||
specified by the associated <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command.</p>
|
specified by the associated <A HREF = "angle_coeff.html">angle_coeff</A> command.
|
||||||
<p>Note that there are also additional angle styles submitted by users
|
</P>
|
||||||
|
<P>Note that there are also additional angle styles submitted by users
|
||||||
which are included in the LAMMPS distribution. The list of these with
|
which are included in the LAMMPS distribution. The list of these with
|
||||||
links to the individual styles are given in the angle section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
links to the individual styles are given in the angle section of <A HREF = "Section_commands.html#cmd_5">this
|
||||||
<ul class="simple">
|
page</A>.
|
||||||
<li><a class="reference internal" href="angle_none.html"><em>angle_style none</em></a> - turn off angle interactions</li>
|
</P>
|
||||||
<li><a class="reference internal" href="angle_hybrid.html"><em>angle_style hybrid</em></a> - define multiple styles of angle interactions</li>
|
<UL><LI><A HREF = "angle_none.html">angle_style none</A> - turn off angle interactions
|
||||||
<li><a class="reference internal" href="angle_charmm.html"><em>angle_style charmm</em></a> - CHARMM angle</li>
|
<LI><A HREF = "angle_hybrid.html">angle_style hybrid</A> - define multiple styles of angle interactions
|
||||||
<li><a class="reference internal" href="angle_class2.html"><em>angle_style class2</em></a> - COMPASS (class 2) angle</li>
|
</UL>
|
||||||
<li><a class="reference internal" href="angle_cosine.html"><em>angle_style cosine</em></a> - cosine angle potential</li>
|
<UL><LI><A HREF = "angle_charmm.html">angle_style charmm</A> - CHARMM angle
|
||||||
<li><a class="reference internal" href="angle_cosine_delta.html"><em>angle_style cosine/delta</em></a> - difference of cosines angle potential</li>
|
<LI><A HREF = "angle_class2.html">angle_style class2</A> - COMPASS (class 2) angle
|
||||||
<li><a class="reference internal" href="angle_cosine_periodic.html"><em>angle_style cosine/periodic</em></a> - DREIDING angle</li>
|
<LI><A HREF = "angle_cosine.html">angle_style cosine</A> - cosine angle potential
|
||||||
<li><a class="reference internal" href="angle_cosine_squared.html"><em>angle_style cosine/squared</em></a> - cosine squared angle potential</li>
|
<LI><A HREF = "angle_cosine_delta.html">angle_style cosine/delta</A> - difference of cosines angle potential
|
||||||
<li><a class="reference internal" href="angle_harmonic.html"><em>angle_style harmonic</em></a> - harmonic angle</li>
|
<LI><A HREF = "angle_cosine_periodic.html">angle_style cosine/periodic</A> - DREIDING angle
|
||||||
<li><a class="reference internal" href="angle_table.html"><em>angle_style table</em></a> - tabulated by angle</li>
|
<LI><A HREF = "angle_cosine_squared.html">angle_style cosine/squared</A> - cosine squared angle potential
|
||||||
</ul>
|
<LI><A HREF = "angle_harmonic.html">angle_style harmonic</A> - harmonic angle
|
||||||
</div>
|
<LI><A HREF = "angle_table.html">angle_style table</A> - tabulated by angle
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<HR>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Angle styles can only be set for atom_styles that allow angles to be
|
<P><B>Restrictions:</B>
|
||||||
defined.</p>
|
</P>
|
||||||
<p>Most angle styles are part of the MOLECULE package. They are only
|
<P>Angle styles can only be set for atom_styles that allow angles to be
|
||||||
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 on packages.
|
defined.
|
||||||
|
</P>
|
||||||
|
<P>Most angle styles are part of the MOLECULE package. They are only
|
||||||
|
enabled if LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
The doc pages for individual bond potentials tell if it is part of a
|
The doc pages for individual bond potentials tell if it is part of a
|
||||||
package.</p>
|
package.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><B>Related commands:</B>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a></p>
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="default">
|
<P><B>Default:</B>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>angle_style none
|
<PRE>angle_style none
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,206 +1,91 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>angle_style table command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>angle_style table command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>angle_style table/omp command
|
||||||
<li>angle_style table command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>angle_style table style N
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<UL><LI>style = <I>linear</I> or <I>spline</I> = method of interpolation
|
||||||
|
<LI>N = use N values in table
|
||||||
</li>
|
</UL>
|
||||||
</ul>
|
<P><B>Examples:</B>
|
||||||
<hr/>
|
</P>
|
||||||
|
<PRE>angle_style table linear 1000
|
||||||
</div>
|
angle_coeff 3 file.table ENTRY1
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</PRE>
|
||||||
<div itemprop="articleBody">
|
<P><B>Description:</B>
|
||||||
|
</P>
|
||||||
<div class="section" id="angle-style-table-command">
|
<P>Style <I>table</I> creates interpolation tables of length <I>N</I> from angle
|
||||||
<span id="index-0"></span><h1>angle_style table command<a class="headerlink" href="#angle-style-table-command" title="Permalink to this headline">¶</a></h1>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="angle-style-table-omp-command">
|
|
||||||
<h1>angle_style table/omp command<a class="headerlink" href="#angle-style-table-omp-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>angle_style table style N
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style = <em>linear</em> or <em>spline</em> = method of interpolation</li>
|
|
||||||
<li>N = use N values in table</li>
|
|
||||||
</ul>
|
|
||||||
</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>angle_style table linear 1000
|
|
||||||
angle_coeff 3 file.table ENTRY1
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Style <em>table</em> creates interpolation tables of length <em>N</em> from angle
|
|
||||||
potential and derivative values listed in a file(s) as a function of
|
potential and derivative values listed in a file(s) as a function of
|
||||||
angle The files are read by the <a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a>
|
angle The files are read by the <A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
command.</p>
|
command.
|
||||||
<p>The interpolation tables are created by fitting cubic splines to the
|
</P>
|
||||||
|
<P>The interpolation tables are created by fitting cubic splines to the
|
||||||
file values and interpolating energy and derivative values at each of
|
file values and interpolating energy and derivative values at each of
|
||||||
<em>N</em> angles. During a simulation, these tables are used to interpolate
|
<I>N</I> angles. During a simulation, these tables are used to interpolate
|
||||||
energy and force values on individual atoms as needed. The
|
energy and force values on individual atoms as needed. The
|
||||||
interpolation is done in one of 2 styles: <em>linear</em> or <em>spline</em>.</p>
|
interpolation is done in one of 2 styles: <I>linear</I> or <I>spline</I>.
|
||||||
<p>For the <em>linear</em> style, the angle is used to find 2 surrounding table
|
</P>
|
||||||
|
<P>For the <I>linear</I> style, the angle is used to find 2 surrounding table
|
||||||
values from which an energy or its derivative is computed by linear
|
values from which an energy or its derivative is computed by linear
|
||||||
interpolation.</p>
|
interpolation.
|
||||||
<p>For the <em>spline</em> style, a cubic spline coefficients are computed and
|
</P>
|
||||||
stored at each of the <em>N</em> values in the table. The angle is used to
|
<P>For the <I>spline</I> style, a cubic spline coefficients are computed and
|
||||||
|
stored at each of the <I>N</I> values in the table. The angle is used to
|
||||||
find the appropriate set of coefficients which are used to evaluate a
|
find the appropriate set of coefficients which are used to evaluate a
|
||||||
cubic polynomial which computes the energy or derivative.</p>
|
cubic polynomial which computes the energy or derivative.
|
||||||
<p>The following coefficients must be defined for each angle type via the
|
</P>
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command as in the example above.</p>
|
<P>The following coefficients must be defined for each angle type via the
|
||||||
<ul class="simple">
|
<A HREF = "angle_coeff.html">angle_coeff</A> command as in the example above.
|
||||||
<li>filename</li>
|
</P>
|
||||||
<li>keyword</li>
|
<UL><LI>filename
|
||||||
</ul>
|
<LI>keyword
|
||||||
<p>The filename specifies a file containing tabulated energy and
|
</UL>
|
||||||
|
<P>The filename specifies a file containing tabulated energy and
|
||||||
derivative values. The keyword specifies a section of the file. The
|
derivative values. The keyword specifies a section of the file. The
|
||||||
format of this file is described below.</p>
|
format of this file is described below.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The format of a tabulated file is as follows (without the
|
<HR>
|
||||||
parenthesized comments):</p>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c"># Angle potential for harmonic (one or more comment or blank lines)</span>
|
<P>The format of a tabulated file is as follows (without the
|
||||||
</pre></div>
|
parenthesized comments):
|
||||||
</div>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>HAM (keyword is the first text on line)
|
<PRE># Angle potential for harmonic (one or more comment or blank lines)
|
||||||
|
</PRE>
|
||||||
|
<PRE>HAM (keyword is the first text on line)
|
||||||
N 181 FP 0 0 EQ 90.0 (N, FP, EQ parameters)
|
N 181 FP 0 0 EQ 90.0 (N, FP, EQ parameters)
|
||||||
(blank line)
|
(blank line)
|
||||||
N 181 FP 0 0 (N, FP parameters)
|
N 181 FP 0 0 (N, FP parameters)
|
||||||
1 0.0 200.5 2.5 (index, angle, energy, derivative)
|
1 0.0 200.5 2.5 (index, angle, energy, derivative)
|
||||||
2 1.0 198.0 2.5
|
2 1.0 198.0 2.5
|
||||||
...
|
...
|
||||||
181 180.0 0.0 0.0
|
181 180.0 0.0 0.0
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>A section begins with a non-blank line whose 1st character is not a
|
||||||
<p>A section begins with a non-blank line whose 1st character is not a
|
"#"; blank lines or lines starting with "#" can be used as comments
|
||||||
“#”; blank lines or lines starting with “#” can be used as comments
|
|
||||||
between sections. The first line begins with a keyword which
|
between sections. The first line begins with a keyword which
|
||||||
identifies the section. The line can contain additional text, but the
|
identifies the section. The line can contain additional text, but the
|
||||||
initial text must match the argument specified in the
|
initial text must match the argument specified in the
|
||||||
<a class="reference internal" href="angle_coeff.html"><em>angle_coeff</em></a> command. The next line lists (in any
|
<A HREF = "angle_coeff.html">angle_coeff</A> command. The next line lists (in any
|
||||||
order) one or more parameters for the table. Each parameter is a
|
order) one or more parameters for the table. Each parameter is a
|
||||||
keyword followed by one or more numeric values.</p>
|
keyword followed by one or more numeric values.
|
||||||
<p>The parameter “N” is required and its value is the number of table
|
</P>
|
||||||
entries that follow. Note that this may be different than the <em>N</em>
|
<P>The parameter "N" is required and its value is the number of table
|
||||||
specified in the <a class="reference internal" href="angle_style.html"><em>angle_style table</em></a> command. Let
|
entries that follow. Note that this may be different than the <I>N</I>
|
||||||
Ntable = <em>N</em> in the angle_style command, and Nfile = “N” in the
|
specified in the <A HREF = "angle_style.html">angle_style table</A> command. Let
|
||||||
|
Ntable = <I>N</I> in the angle_style command, and Nfile = "N" in the
|
||||||
tabulated file. What LAMMPS does is a preliminary interpolation by
|
tabulated file. What LAMMPS does is a preliminary interpolation by
|
||||||
creating splines using the Nfile tabulated values as nodal points. It
|
creating splines using the Nfile tabulated values as nodal points. It
|
||||||
uses these to interpolate as needed to generate energy and derivative
|
uses these to interpolate as needed to generate energy and derivative
|
||||||
@ -209,17 +94,21 @@ Ntable are then used as described above, when computing energy and
|
|||||||
force for individual angles and their atoms. This means that if you
|
force for individual angles and their atoms. This means that if you
|
||||||
want the interpolation tables of length Ntable to match exactly what
|
want the interpolation tables of length Ntable to match exactly what
|
||||||
is in the tabulated file (with effectively no preliminary
|
is in the tabulated file (with effectively no preliminary
|
||||||
interpolation), you should set Ntable = Nfile.</p>
|
interpolation), you should set Ntable = Nfile.
|
||||||
<p>The “FP” parameter is optional. If used, it is followed by two values
|
</P>
|
||||||
|
<P>The "FP" parameter is optional. If used, it is followed by two values
|
||||||
fplo and fphi, which are the 2nd derivatives at the innermost and
|
fplo and fphi, which are the 2nd derivatives at the innermost and
|
||||||
outermost angle settings. These values are needed by the spline
|
outermost angle settings. These values are needed by the spline
|
||||||
construction routines. If not specified by the “FP” parameter, they
|
construction routines. If not specified by the "FP" parameter, they
|
||||||
are estimated (less accurately) by the first two and last two
|
are estimated (less accurately) by the first two and last two
|
||||||
derivative values in the table.</p>
|
derivative values in the table.
|
||||||
<p>The “EQ” parameter is also optional. If used, it is followed by a the
|
</P>
|
||||||
equilibrium angle value, which is used, for example, by the <a class="reference internal" href="fix_shake.html"><em>fix shake</em></a> command. If not used, the equilibrium angle is
|
<P>The "EQ" parameter is also optional. If used, it is followed by a the
|
||||||
set to 180.0.</p>
|
equilibrium angle value, which is used, for example, by the <A HREF = "fix_shake.html">fix
|
||||||
<p>Following a blank line, the next N lines list the tabulated values.
|
shake</A> command. If not used, the equilibrium angle is
|
||||||
|
set to 180.0.
|
||||||
|
</P>
|
||||||
|
<P>Following a blank line, the next N lines list the tabulated values.
|
||||||
On each line, the 1st value is the index from 1 to N, the 2nd value is
|
On each line, the 1st value is the index from 1 to N, the 2nd value is
|
||||||
the angle value (in degrees), the 3rd value is the energy (in energy
|
the angle value (in degrees), the 3rd value is the energy (in energy
|
||||||
units), and the 4th is -dE/d(theta) (also in energy units). The 3rd
|
units), and the 4th is -dE/d(theta) (also in energy units). The 3rd
|
||||||
@ -228,100 +117,47 @@ angle. The last term is the derivative of the energy with respect to
|
|||||||
the angle (in degrees, not radians). Thus the units of the last term
|
the angle (in degrees, not radians). Thus the units of the last term
|
||||||
are still energy, not force. The angle values must increase from one
|
are still energy, not force. The angle values must increase from one
|
||||||
line to the next. The angle values must also begin with 0.0 and end
|
line to the next. The angle values must also begin with 0.0 and end
|
||||||
with 180.0, i.e. span the full range of possible angles.</p>
|
with 180.0, i.e. span the full range of possible angles.
|
||||||
<p>Note that one file can contain many sections, each with a tabulated
|
</P>
|
||||||
|
<P>Note that one file can contain many sections, each with a tabulated
|
||||||
potential. LAMMPS reads the file section by section until it finds
|
potential. LAMMPS reads the file section by section until it finds
|
||||||
one that matches the specified keyword.</p>
|
one that matches the specified keyword.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This angle style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="angle_coeff.html"><em>angle_coeff</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This angle style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "angle_coeff.html">angle_coeff</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,343 +1,179 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>atom_modify command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>atom_modify command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>atom_modify command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>atom_modify keyword values ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>one or more keyword/value pairs may be appended
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>keyword = <I>id</I> or <I>map</I> or <I>first</I> or <I>sort</I>
|
||||||
|
|
||||||
</li>
|
<PRE> <I>id</I> value = <I>yes</I> or <I>no</I>
|
||||||
</ul>
|
<I>map</I> value = <I>array</I> or <I>hash</I>
|
||||||
<hr/>
|
<I>first</I> value = group-ID = group whose atoms will appear first in internal atom lists
|
||||||
|
<I>sort</I> values = Nfreq binsize
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="atom-modify-command">
|
|
||||||
<span id="index-0"></span><h1>atom_modify command<a class="headerlink" href="#atom-modify-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>atom_modify keyword values ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>one or more keyword/value pairs may be appended</li>
|
|
||||||
<li>keyword = <em>id</em> or <em>map</em> or <em>first</em> or <em>sort</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>id</em> value = <em>yes</em> or <em>no</em>
|
|
||||||
<em>map</em> value = <em>array</em> or <em>hash</em>
|
|
||||||
<em>first</em> value = group-ID = group whose atoms will appear first in internal atom lists
|
|
||||||
<em>sort</em> values = Nfreq binsize
|
|
||||||
Nfreq = sort atoms spatially every this many time steps
|
Nfreq = sort atoms spatially every this many time steps
|
||||||
binsize = bin size for spatial sorting (distance units)
|
binsize = bin size for spatial sorting (distance units)
|
||||||
</pre>
|
</PRE>
|
||||||
</div>
|
|
||||||
<div class="section" id="examples">
|
</UL>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<P><B>Examples:</B>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>atom_modify map hash
|
</P>
|
||||||
|
<PRE>atom_modify map hash
|
||||||
atom_modify map array sort 10000 2.0
|
atom_modify map array sort 10000 2.0
|
||||||
atom_modify first colloid
|
atom_modify first colloid
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Modify certain attributes of atoms defined and stored within LAMMPS,
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
in addition to what is specified by the <A HREF = "atom_style.html">atom_style</A>
|
||||||
<p>Modify certain attributes of atoms defined and stored within LAMMPS,
|
command. The <I>id</I> and <I>map</I> keywords must be specified before a
|
||||||
in addition to what is specified by the <a class="reference internal" href="atom_style.html"><em>atom_style</em></a>
|
simulation box is defined; other keywords can be specified any time.
|
||||||
command. The <em>id</em> and <em>map</em> keywords must be specified before a
|
</P>
|
||||||
simulation box is defined; other keywords can be specified any time.</p>
|
<P>The <I>id</I> keyword determines whether non-zero atom IDs can be assigned
|
||||||
<p>The <em>id</em> keyword determines whether non-zero atom IDs can be assigned
|
to each atom. If the value is <I>yes</I>, which is the default, IDs are
|
||||||
to each atom. If the value is <em>yes</em>, which is the default, IDs are
|
assigned, whether you use the <A HREF = "create_atoms.html">create atoms</A> or
|
||||||
assigned, whether you use the <a class="reference internal" href="create_atoms.html"><em>create atoms</em></a> or
|
<A HREF = "read_data.html">read_data</A> or <A HREF = "read_restart.html">read_restart</A>
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>
|
commands to initialize atoms. If the value is <I>no</I> the IDs for all
|
||||||
commands to initialize atoms. If the value is <em>no</em> the IDs for all
|
atoms are assumed to be 0.
|
||||||
atoms are assumed to be 0.</p>
|
</P>
|
||||||
<p>If atom IDs are used, they must all be positive integers. They should
|
<P>If atom IDs are used, they must all be positive integers. They should
|
||||||
also be unique, though LAMMPS does not check for this. Typically they
|
also be unique, though LAMMPS does not check for this. Typically they
|
||||||
should also be consecutively numbered (from 1 to Natoms), though this
|
should also be consecutively numbered (from 1 to Natoms), though this
|
||||||
is not required. Molecular <a class="reference internal" href="atom_style.html"><em>atom styles</em></a> are those
|
is not required. Molecular <A HREF = "atom_style.html">atom styles</A> are those
|
||||||
that store bond topology information (styles bond, angle, molecular,
|
that store bond topology information (styles bond, angle, molecular,
|
||||||
full). These styles require atom IDs since the IDs are used to encode
|
full). These styles require atom IDs since the IDs are used to encode
|
||||||
the topology. Some other LAMMPS commands also require the use of atom
|
the topology. Some other LAMMPS commands also require the use of atom
|
||||||
IDs. E.g. some many-body pair styles use them to avoid double
|
IDs. E.g. some many-body pair styles use them to avoid double
|
||||||
computation of the I-J interaction between two atoms.</p>
|
computation of the I-J interaction between two atoms.
|
||||||
<p>The only reason not to use atom IDs is if you are running an atomic
|
</P>
|
||||||
|
<P>The only reason not to use atom IDs is if you are running an atomic
|
||||||
simulation so large that IDs cannot be uniquely assigned. For a
|
simulation so large that IDs cannot be uniquely assigned. For a
|
||||||
default LAMMPS build this limit is 2^31 or about 2 billion atoms.
|
default LAMMPS build this limit is 2^31 or about 2 billion atoms.
|
||||||
However, even in this case, you can use 64-bit atom IDs, allowing 2^63
|
However, even in this case, you can use 64-bit atom IDs, allowing 2^63
|
||||||
or about 9e18 atoms, if you build LAMMPS with the - DLAMMPS_BIGBIG
|
or about 9e18 atoms, if you build LAMMPS with the - DLAMMPS_BIGBIG
|
||||||
switch. This is described in <a class="reference internal" href="Section_start.html#start-2"><span>Section 2.2</span></a>
|
switch. This is described in <A HREF = "Section_start.html#start_2">Section 2.2</A>
|
||||||
of the manual. If atom IDs are not used, they must be specified as 0
|
of the manual. If atom IDs are not used, they must be specified as 0
|
||||||
for all atoms, e.g. in a data or restart file.</p>
|
for all atoms, e.g. in a data or restart file.
|
||||||
<p>The <em>map</em> keyword determines how atom ID lookup is done for molecular
|
</P>
|
||||||
|
<P>The <I>map</I> keyword determines how atom ID lookup is done for molecular
|
||||||
atom styles. Lookups are performed by bond (angle, etc) routines in
|
atom styles. Lookups are performed by bond (angle, etc) routines in
|
||||||
LAMMPS to find the local atom index associated with a global atom ID.</p>
|
LAMMPS to find the local atom index associated with a global atom ID.
|
||||||
<p>When the <em>array</em> value is used, each processor stores a lookup table
|
</P>
|
||||||
|
<P>When the <I>array</I> value is used, each processor stores a lookup table
|
||||||
of length N, where N is the largest atom ID in the system. This is a
|
of length N, where N is the largest atom ID in the system. This is a
|
||||||
fast, simple method for many simulations, but requires too much memory
|
fast, simple method for many simulations, but requires too much memory
|
||||||
for large simulations. The <em>hash</em> value uses a hash table to perform
|
for large simulations. The <I>hash</I> value uses a hash table to perform
|
||||||
the lookups. This can be slightly slower than the <em>array</em> method, but
|
the lookups. This can be slightly slower than the <I>array</I> method, but
|
||||||
its memory cost is proportional to the number of atoms owned by a
|
its memory cost is proportional to the number of atoms owned by a
|
||||||
processor, i.e. N/P when N is the total number of atoms in the system
|
processor, i.e. N/P when N is the total number of atoms in the system
|
||||||
and P is the number of processors.</p>
|
and P is the number of processors.
|
||||||
<p>When this setting is not specified in your input script, LAMMPS
|
</P>
|
||||||
|
<P>When this setting is not specified in your input script, LAMMPS
|
||||||
creates a map, if one is needed, as an array or hash. See the
|
creates a map, if one is needed, as an array or hash. See the
|
||||||
discussion of default values below for how LAMMPS chooses which kind
|
discussion of default values below for how LAMMPS chooses which kind
|
||||||
of map to build. Note that atomic systems do not normally need to
|
of map to build. Note that atomic systems do not normally need to
|
||||||
create a map. However, even in this case some LAMMPS commands will
|
create a map. However, even in this case some LAMMPS commands will
|
||||||
create a map to find atoms (and then destroy it), or require a
|
create a map to find atoms (and then destroy it), or require a
|
||||||
permanent map. An example of the former is the <a class="reference internal" href="velocity.html"><em>velocity loop all</em></a> command, which uses a map when looping over all
|
permanent map. An example of the former is the <A HREF = "velocity.html">velocity loop
|
||||||
|
all</A> command, which uses a map when looping over all
|
||||||
atoms and insuring the same velocity values are assigned to an atom
|
atoms and insuring the same velocity values are assigned to an atom
|
||||||
ID, no matter which processor owns it.</p>
|
ID, no matter which processor owns it.
|
||||||
<p>The <em>first</em> keyword allows a <a class="reference internal" href="group.html"><em>group</em></a> to be specified whose
|
</P>
|
||||||
atoms will be maintained as the first atoms in each processor’s list
|
<P>The <I>first</I> keyword allows a <A HREF = "group.html">group</A> to be specified whose
|
||||||
|
atoms will be maintained as the first atoms in each processor's list
|
||||||
of owned atoms. This in only useful when the specified group is a
|
of owned atoms. This in only useful when the specified group is a
|
||||||
small fraction of all the atoms, and there are other operations LAMMPS
|
small fraction of all the atoms, and there are other operations LAMMPS
|
||||||
is performing that will be sped-up significantly by being able to loop
|
is performing that will be sped-up significantly by being able to loop
|
||||||
over the smaller set of atoms. Otherwise the reordering required by
|
over the smaller set of atoms. Otherwise the reordering required by
|
||||||
this option will be a net slow-down. The <a class="reference internal" href="neigh_modify.html"><em>neigh_modify include</em></a> and <a class="reference internal" href="comm_modify.html"><em>comm_modify group</em></a>
|
this option will be a net slow-down. The <A HREF = "neigh_modify.html">neigh_modify
|
||||||
|
include</A> and <A HREF = "comm_modify.html">comm_modify group</A>
|
||||||
commands are two examples of commands that require this setting to
|
commands are two examples of commands that require this setting to
|
||||||
work efficiently. Several <a class="reference internal" href="fix.html"><em>fixes</em></a>, most notably time
|
work efficiently. Several <A HREF = "fix.html">fixes</A>, most notably time
|
||||||
integration fixes like <a class="reference internal" href="fix_nve.html"><em>fix nve</em></a>, also take advantage of
|
integration fixes like <A HREF = "fix_nve.html">fix nve</A>, also take advantage of
|
||||||
this setting if the group they operate on is the group specified by
|
this setting if the group they operate on is the group specified by
|
||||||
this command. Note that specifying “all” as the group-ID effectively
|
this command. Note that specifying "all" as the group-ID effectively
|
||||||
turns off the <em>first</em> option.</p>
|
turns off the <I>first</I> option.
|
||||||
<p>It is OK to use the <em>first</em> keyword with a group that has not yet been
|
</P>
|
||||||
|
<P>It is OK to use the <I>first</I> keyword with a group that has not yet been
|
||||||
defined, e.g. to use the atom_modify first command at the beginning of
|
defined, e.g. to use the atom_modify first command at the beginning of
|
||||||
your input script. LAMMPS does not use the group until a simullation
|
your input script. LAMMPS does not use the group until a simullation
|
||||||
is run.</p>
|
is run.
|
||||||
<p>The <em>sort</em> keyword turns on a spatial sorting or reordering of atoms
|
</P>
|
||||||
within each processor’s sub-domain every <em>Nfreq</em> timesteps. If
|
<P>The <I>sort</I> keyword turns on a spatial sorting or reordering of atoms
|
||||||
<em>Nfreq</em> is set to 0, then sorting is turned off. Sorting can improve
|
within each processor's sub-domain every <I>Nfreq</I> timesteps. If
|
||||||
|
<I>Nfreq</I> is set to 0, then sorting is turned off. Sorting can improve
|
||||||
cache performance and thus speed-up a LAMMPS simulation, as discussed
|
cache performance and thus speed-up a LAMMPS simulation, as discussed
|
||||||
in a paper by <a class="reference internal" href="#meloni"><span>(Meloni)</span></a>. Its efficacy depends on the problem
|
in a paper by <A HREF = "#Meloni">(Meloni)</A>. Its efficacy depends on the problem
|
||||||
size (atoms/processor), how quickly the system becomes disordered, and
|
size (atoms/processor), how quickly the system becomes disordered, and
|
||||||
various other factors. As a general rule, sorting is typically more
|
various other factors. As a general rule, sorting is typically more
|
||||||
effective at speeding up simulations of liquids as opposed to solids.
|
effective at speeding up simulations of liquids as opposed to solids.
|
||||||
In tests we have done, the speed-up can range from zero to 3-4x.</p>
|
In tests we have done, the speed-up can range from zero to 3-4x.
|
||||||
<p>Reordering is peformed every <em>Nfreq</em> timesteps during a dynamics run
|
</P>
|
||||||
|
<P>Reordering is peformed every <I>Nfreq</I> timesteps during a dynamics run
|
||||||
or iterations during a minimization. More precisely, reordering
|
or iterations during a minimization. More precisely, reordering
|
||||||
occurs at the first reneighboring that occurs after the target
|
occurs at the first reneighboring that occurs after the target
|
||||||
timestep. The reordering is performed locally by each processor,
|
timestep. The reordering is performed locally by each processor,
|
||||||
using bins of the specified <em>binsize</em>. If <em>binsize</em> is set to 0.0,
|
using bins of the specified <I>binsize</I>. If <I>binsize</I> is set to 0.0,
|
||||||
then a binsize equal to half the <a class="reference internal" href="neighbor.html"><em>neighbor</em></a> cutoff
|
then a binsize equal to half the <A HREF = "neighbor.html">neighbor</A> cutoff
|
||||||
distance (force cutoff plus skin distance) is used, which is a
|
distance (force cutoff plus skin distance) is used, which is a
|
||||||
reasonable value. After the atoms have been binned, they are
|
reasonable value. After the atoms have been binned, they are
|
||||||
reordered so that atoms in the same bin are adjacent to each other in
|
reordered so that atoms in the same bin are adjacent to each other in
|
||||||
the processor’s 1d list of atoms.</p>
|
the processor's 1d list of atoms.
|
||||||
<p>The goal of this procedure is for atoms to put atoms close to each
|
</P>
|
||||||
other in the processor’s one-dimensional list of atoms that are also
|
<P>The goal of this procedure is for atoms to put atoms close to each
|
||||||
|
other in the processor's one-dimensional list of atoms that are also
|
||||||
near to each other spatially. This can improve cache performance when
|
near to each other spatially. This can improve cache performance when
|
||||||
pairwise intereractions and neighbor lists are computed. Note that if
|
pairwise intereractions and neighbor lists are computed. Note that if
|
||||||
bins are too small, there will be few atoms/bin. Likewise if bins are
|
bins are too small, there will be few atoms/bin. Likewise if bins are
|
||||||
too large, there will be many atoms/bin. In both cases, the goal of
|
too large, there will be many atoms/bin. In both cases, the goal of
|
||||||
cache locality will be undermined.</p>
|
cache locality will be undermined.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: Running a simulation with sorting on versus off should
|
||||||
<p class="last">Running a simulation with sorting on versus off should
|
|
||||||
not change the simulation results in a statistical sense. However, a
|
not change the simulation results in a statistical sense. However, a
|
||||||
different ordering will induce round-off differences, which will lead
|
different ordering will induce round-off differences, which will lead
|
||||||
to diverging trajectories over time when comparing two simluations.
|
to diverging trajectories over time when comparing two simluations.
|
||||||
Various commands, particularly those which use random numbers
|
Various commands, particularly those which use random numbers
|
||||||
(e.g. <a class="reference internal" href="velocity.html"><em>velocity create</em></a>, and <a class="reference internal" href="fix_langevin.html"><em>fix langevin</em></a>), may generate (statistically identical)
|
(e.g. <A HREF = "velocity.html">velocity create</A>, and <A HREF = "fix_langevin.html">fix
|
||||||
|
langevin</A>), may generate (statistically identical)
|
||||||
results which depend on the order in which atoms are processed. The
|
results which depend on the order in which atoms are processed. The
|
||||||
order of atoms in a <a class="reference internal" href="dump.html"><em>dump</em></a> file will also typically change
|
order of atoms in a <A HREF = "dump.html">dump</A> file will also typically change
|
||||||
if sorting is enabled.</p>
|
if sorting is enabled.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P><B>Restrictions:</B>
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P>The <I>first</I> and <I>sort</I> options cannot be used together. Since sorting
|
||||||
<p>The <em>first</em> and <em>sort</em> options cannot be used together. Since sorting
|
is on by default, it will be turned off if the <I>first</I> keyword is
|
||||||
is on by default, it will be turned off if the <em>first</em> keyword is
|
used with a group-ID that is not "all".
|
||||||
used with a group-ID that is not “all”.</p>
|
</P>
|
||||||
<p><strong>Related commands:</strong> none</p>
|
<P><B>Related commands:</B> none
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="default">
|
<P><B>Default:</B>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>By default, <em>id</em> is yes. By default, atomic systems (no bond topology
|
<P>By default, <I>id</I> is yes. By default, atomic systems (no bond topology
|
||||||
info) do not use a map. For molecular systems (with bond topology
|
info) do not use a map. For molecular systems (with bond topology
|
||||||
info), a map is used. The default map style is array if no atom ID is
|
info), a map is used. The default map style is array if no atom ID is
|
||||||
larger than 1 million, otherwise the default is hash. By default, a
|
larger than 1 million, otherwise the default is hash. By default, a
|
||||||
“first” group is not defined. By default, sorting is enabled with a
|
"first" group is not defined. By default, sorting is enabled with a
|
||||||
frequency of 1000 and a binsize of 0.0, which means the neighbor
|
frequency of 1000 and a binsize of 0.0, which means the neighbor
|
||||||
cutoff will be used to set the bin size.</p>
|
cutoff will be used to set the bin size.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p id="meloni"><strong>(Meloni)</strong> Meloni, Rosati and Colombo, J Chem Phys, 126, 121102 (2007).</p>
|
<HR>
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<A NAME = "Meloni"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Meloni)</B> Meloni, Rosati and Colombo, J Chem Phys, 126, 121102 (2007).
|
||||||
</div>
|
</P>
|
||||||
<footer>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,472 +1,268 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>atom_style command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>atom_style command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>atom_style command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>atom_style style args
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>style = <I>angle</I> or <I>atomic</I> or <I>body</I> or <I>bond</I> or <I>charge</I> or <I>dipole</I> or <I>electron</I> or <I>ellipsoid</I> or <I>full</I> or <I>line</I> or <I>meso</I> or <I>molecular</I> or <I>peri</I> or <I>sphere</I> or <I>tri</I> or <I>template</I> or <I>hybrid</I>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE> args = none for any style except <I>body</I> and <I>hybrid</I>
|
||||||
|
<I>body</I> args = bstyle bstyle-args
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="atom-style-command">
|
|
||||||
<span id="index-0"></span><h1>atom_style command<a class="headerlink" href="#atom-style-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>atom_style style args
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style = <em>angle</em> or <em>atomic</em> or <em>body</em> or <em>bond</em> or <em>charge</em> or <em>dipole</em> or <em>electron</em> or <em>ellipsoid</em> or <em>full</em> or <em>line</em> or <em>meso</em> or <em>molecular</em> or <em>peri</em> or <em>sphere</em> or <em>tri</em> or <em>template</em> or <em>hybrid</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
args = none for any style except <em>body</em> and <em>hybrid</em>
|
|
||||||
<em>body</em> args = bstyle bstyle-args
|
|
||||||
bstyle = style of body particles
|
bstyle = style of body particles
|
||||||
bstyle-args = additional arguments specific to the bstyle
|
bstyle-args = additional arguments specific to the bstyle
|
||||||
see the <a class="reference internal" href="body.html"><em>body</em></a> doc page for details
|
see the <A HREF = "body.html">body</A> doc page for details
|
||||||
<em>template</em> args = template-ID
|
<I>template</I> args = template-ID
|
||||||
template-ID = ID of molecule template specified in a separate <a class="reference internal" href="molecule.html"><em>molecule</em></a> command
|
template-ID = ID of molecule template specified in a separate <A HREF = "molecule.html">molecule</A> command
|
||||||
<em>hybrid</em> args = list of one or more sub-styles, each with their args
|
<I>hybrid</I> args = list of one or more sub-styles, each with their args
|
||||||
</pre>
|
</PRE>
|
||||||
<ul class="simple">
|
<LI>accelerated styles (with same args) = <I>angle/cuda</I> or <I>angle/kk</I> or <I>atomic/cuda</I> or <I>atomic/kk</I> or <I>bond/kk</I> or <I>charge/cuda</I> or <I>charge/kk</I> or <I>full/cuda</I> or <I>full/kk</I> or <I>molecular/kk</I>
|
||||||
<li>accelerated styles (with same args) = <em>angle/cuda</em> or <em>angle/kk</em> or <em>atomic/cuda</em> or <em>atomic/kk</em> or <em>bond/kk</em> or <em>charge/cuda</em> or <em>charge/kk</em> or <em>full/cuda</em> or <em>full/kk</em> or <em>molecular/kk</em></li>
|
|
||||||
</ul>
|
|
||||||
</div>
|
</UL>
|
||||||
<div class="section" id="examples">
|
<P><B>Examples:</B>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>atom_style atomic
|
<PRE>atom_style atomic
|
||||||
atom_style bond
|
atom_style bond
|
||||||
atom_style full
|
atom_style full
|
||||||
atom_style full/cuda
|
atom_style full/cuda
|
||||||
atom_style body nparticle 2 10
|
atom_style body nparticle 2 10
|
||||||
atom_style hybrid charge bond
|
atom_style hybrid charge bond
|
||||||
atom_style hybrid charge body nparticle 2 5
|
atom_style hybrid charge body nparticle 2 5
|
||||||
atom_style template myMols
|
atom_style template myMols
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Define what style of atoms to use in a simulation. This determines
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define what style of atoms to use in a simulation. This determines
|
|
||||||
what attributes are associated with the atoms. This command must be
|
what attributes are associated with the atoms. This command must be
|
||||||
used before a simulation is setup via a <a class="reference internal" href="read_data.html"><em>read_data</em></a>,
|
used before a simulation is setup via a <A HREF = "read_data.html">read_data</A>,
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a>, or <a class="reference internal" href="create_box.html"><em>create_box</em></a>
|
<A HREF = "read_restart.html">read_restart</A>, or <A HREF = "create_box.html">create_box</A>
|
||||||
command.</p>
|
command.
|
||||||
<p>Once a style is assigned, it cannot be changed, so use a style general
|
</P>
|
||||||
enough to encompass all attributes. E.g. with style <em>bond</em>, angular
|
<P>Once a style is assigned, it cannot be changed, so use a style general
|
||||||
|
enough to encompass all attributes. E.g. with style <I>bond</I>, angular
|
||||||
terms cannot be used or added later to the model. It is OK to use a
|
terms cannot be used or added later to the model. It is OK to use a
|
||||||
style more general than needed, though it may be slightly inefficient.</p>
|
style more general than needed, though it may be slightly inefficient.
|
||||||
<p>The choice of style affects what quantities are stored by each atom,
|
</P>
|
||||||
|
<P>The choice of style affects what quantities are stored by each atom,
|
||||||
what quantities are communicated between processors to enable forces
|
what quantities are communicated between processors to enable forces
|
||||||
to be computed, and what quantities are listed in the data file read
|
to be computed, and what quantities are listed in the data file read
|
||||||
by the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command.</p>
|
by the <A HREF = "read_data.html">read_data</A> command.
|
||||||
<p>These are the additional attributes of each style and the typical
|
</P>
|
||||||
|
<P>These are the additional attributes of each style and the typical
|
||||||
kinds of physical systems they are used to model. All styles store
|
kinds of physical systems they are used to model. All styles store
|
||||||
coordinates, velocities, atom IDs and types. See the
|
coordinates, velocities, atom IDs and types. See the
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a>, <a class="reference internal" href="create_atoms.html"><em>create_atoms</em></a>, and
|
<A HREF = "read_data.html">read_data</A>, <A HREF = "create_atoms.html">create_atoms</A>, and
|
||||||
<a class="reference internal" href="set.html"><em>set</em></a> commands for info on how to set these various
|
<A HREF = "set.html">set</A> commands for info on how to set these various
|
||||||
quantities.</p>
|
quantities.
|
||||||
<table border="1" class="docutils">
|
</P>
|
||||||
<colgroup>
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
<col width="13%" />
|
<TR><TD ><I>angle</I> </TD><TD > bonds and angles </TD><TD > bead-spring polymers with stiffness </TD></TR>
|
||||||
<col width="50%" />
|
<TR><TD ><I>atomic</I> </TD><TD > only the default values </TD><TD > coarse-grain liquids, solids, metals </TD></TR>
|
||||||
<col width="36%" />
|
<TR><TD ><I>body</I> </TD><TD > mass, inertia moments, quaternion, angular momentum </TD><TD > arbitrary bodies </TD></TR>
|
||||||
</colgroup>
|
<TR><TD ><I>bond</I> </TD><TD > bonds </TD><TD > bead-spring polymers </TD></TR>
|
||||||
<tbody valign="top">
|
<TR><TD ><I>charge</I> </TD><TD > charge </TD><TD > atomic system with charges </TD></TR>
|
||||||
<tr class="row-odd"><td><em>angle</em></td>
|
<TR><TD ><I>dipole</I> </TD><TD > charge and dipole moment </TD><TD > system with dipolar particles </TD></TR>
|
||||||
<td>bonds and angles</td>
|
<TR><TD ><I>electron</I> </TD><TD > charge and spin and eradius </TD><TD > electronic force field </TD></TR>
|
||||||
<td>bead-spring polymers with stiffness</td>
|
<TR><TD ><I>ellipsoid</I> </TD><TD > shape, quaternion, angular momentum </TD><TD > aspherical particles </TD></TR>
|
||||||
</tr>
|
<TR><TD ><I>full</I> </TD><TD > molecular + charge </TD><TD > bio-molecules </TD></TR>
|
||||||
<tr class="row-even"><td><em>atomic</em></td>
|
<TR><TD ><I>line</I> </TD><TD > end points, angular velocity </TD><TD > rigid bodies </TD></TR>
|
||||||
<td>only the default values</td>
|
<TR><TD ><I>meso</I> </TD><TD > rho, e, cv </TD><TD > SPH particles </TD></TR>
|
||||||
<td>coarse-grain liquids, solids, metals</td>
|
<TR><TD ><I>molecular</I> </TD><TD > bonds, angles, dihedrals, impropers </TD><TD > uncharged molecules </TD></TR>
|
||||||
</tr>
|
<TR><TD ><I>peri</I> </TD><TD > mass, volume </TD><TD > mesocopic Peridynamic models </TD></TR>
|
||||||
<tr class="row-odd"><td><em>body</em></td>
|
<TR><TD ><I>sphere</I> </TD><TD > diameter, mass, angular velocity </TD><TD > granular models </TD></TR>
|
||||||
<td>mass, inertia moments, quaternion, angular momentum</td>
|
<TR><TD ><I>template</I> </TD><TD > template index, template atom </TD><TD > small molecules with fixed topology </TD></TR>
|
||||||
<td>arbitrary bodies</td>
|
<TR><TD ><I>tri</I> </TD><TD > corner points, angular momentum </TD><TD > rigid bodies </TD></TR>
|
||||||
</tr>
|
<TR><TD ><I>wavepacket</I> </TD><TD > charge, spin, eradius, etag, cs_re, cs_im </TD><TD > AWPMD
|
||||||
<tr class="row-even"><td><em>bond</em></td>
|
</TD></TR></TABLE></DIV>
|
||||||
<td>bonds</td>
|
|
||||||
<td>bead-spring polymers</td>
|
<P>IMPORTANT NOTE: It is possible to add some attributes, such as a
|
||||||
</tr>
|
molecule ID, to atom styles that do not have them via the <A HREF = "fix_property_atom.html">fix
|
||||||
<tr class="row-odd"><td><em>charge</em></td>
|
property/atom</A> command. This command also
|
||||||
<td>charge</td>
|
|
||||||
<td>atomic system with charges</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><em>dipole</em></td>
|
|
||||||
<td>charge and dipole moment</td>
|
|
||||||
<td>system with dipolar particles</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><em>electron</em></td>
|
|
||||||
<td>charge and spin and eradius</td>
|
|
||||||
<td>electronic force field</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><em>ellipsoid</em></td>
|
|
||||||
<td>shape, quaternion, angular momentum</td>
|
|
||||||
<td>aspherical particles</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><em>full</em></td>
|
|
||||||
<td>molecular + charge</td>
|
|
||||||
<td>bio-molecules</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><em>line</em></td>
|
|
||||||
<td>end points, angular velocity</td>
|
|
||||||
<td>rigid bodies</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><em>meso</em></td>
|
|
||||||
<td>rho, e, cv</td>
|
|
||||||
<td>SPH particles</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><em>molecular</em></td>
|
|
||||||
<td>bonds, angles, dihedrals, impropers</td>
|
|
||||||
<td>uncharged molecules</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><em>peri</em></td>
|
|
||||||
<td>mass, volume</td>
|
|
||||||
<td>mesocopic Peridynamic models</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><em>sphere</em></td>
|
|
||||||
<td>diameter, mass, angular velocity</td>
|
|
||||||
<td>granular models</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><em>template</em></td>
|
|
||||||
<td>template index, template atom</td>
|
|
||||||
<td>small molecules with fixed topology</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><em>tri</em></td>
|
|
||||||
<td>corner points, angular momentum</td>
|
|
||||||
<td>rigid bodies</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><em>wavepacket</em></td>
|
|
||||||
<td>charge, spin, eradius, etag, cs_re, cs_im</td>
|
|
||||||
<td>AWPMD</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<div class="admonition warning">
|
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">It is possible to add some attributes, such as a
|
|
||||||
molecule ID, to atom styles that do not have them via the <a class="reference internal" href="fix_property_atom.html"><em>fix property/atom</em></a> command. This command also
|
|
||||||
allows new custom attributes consisting of extra integer or
|
allows new custom attributes consisting of extra integer or
|
||||||
floating-point values to be added to atoms. See the <a class="reference internal" href="fix_property_atom.html"><em>fix property/atom</em></a> doc page for examples of cases
|
floating-point values to be added to atoms. See the <A HREF = "fix_property_atom.html">fix
|
||||||
|
property/atom</A> doc page for examples of cases
|
||||||
where this is useful and details on how to initialize, access, and
|
where this is useful and details on how to initialize, access, and
|
||||||
output the custom values.</p>
|
output the custom values.
|
||||||
</div>
|
</P>
|
||||||
<p>All of the above styles define point particles, except the <em>sphere</em>,
|
<P>All of the above styles define point particles, except the <I>sphere</I>,
|
||||||
<em>ellipsoid</em>, <em>electron</em>, <em>peri</em>, <em>wavepacket</em>, <em>line</em>, <em>tri</em>, and
|
<I>ellipsoid</I>, <I>electron</I>, <I>peri</I>, <I>wavepacket</I>, <I>line</I>, <I>tri</I>, and
|
||||||
<em>body</em> styles, which define finite-size particles. See <a class="reference internal" href="Section_howto.html#howto-14"><span>Section_howto 14</span></a> for an overview of using finite-size
|
<I>body</I> styles, which define finite-size particles. See <A HREF = "Section_howto.html#howto_14">Section_howto
|
||||||
particle models with LAMMPS.</p>
|
14</A> for an overview of using finite-size
|
||||||
<p>All of the point-particle styles assign mass to particles on a
|
particle models with LAMMPS.
|
||||||
per-type basis, using the <a class="reference internal" href="mass.html"><em>mass</em></a> command, The finite-size
|
</P>
|
||||||
|
<P>All of the point-particle styles assign mass to particles on a
|
||||||
|
per-type basis, using the <A HREF = "mass.html">mass</A> command, The finite-size
|
||||||
particle styles assign mass to individual particles on a per-particle
|
particle styles assign mass to individual particles on a per-particle
|
||||||
basis.</p>
|
basis.
|
||||||
<p>For the <em>sphere</em> style, the particles are spheres and each stores a
|
</P>
|
||||||
per-particle diameter and mass. If the diameter > 0.0, the particle
|
<P>For the <I>sphere</I> style, the particles are spheres and each stores a
|
||||||
|
per-particle diameter and mass. If the diameter > 0.0, the particle
|
||||||
is a finite-size sphere. If the diameter = 0.0, it is a point
|
is a finite-size sphere. If the diameter = 0.0, it is a point
|
||||||
particle.</p>
|
particle.
|
||||||
<p>For the <em>ellipsoid</em> style, the particles are ellipsoids and each
|
</P>
|
||||||
|
<P>For the <I>ellipsoid</I> style, the particles are ellipsoids and each
|
||||||
stores a flag which indicates whether it is a finite-size ellipsoid or
|
stores a flag which indicates whether it is a finite-size ellipsoid or
|
||||||
a point particle. If it is an ellipsoid, it also stores a shape
|
a point particle. If it is an ellipsoid, it also stores a shape
|
||||||
vector with the 3 diamters of the ellipsoid and a quaternion 4-vector
|
vector with the 3 diamters of the ellipsoid and a quaternion 4-vector
|
||||||
with its orientation.</p>
|
with its orientation.
|
||||||
<p>For the <em>electron</em> style, the particles representing electrons are 3d
|
</P>
|
||||||
|
<P>For the <I>electron</I> style, the particles representing electrons are 3d
|
||||||
Gaussians with a specified position and bandwidth or uncertainty in
|
Gaussians with a specified position and bandwidth or uncertainty in
|
||||||
position, which is represented by the eradius = electron size.</p>
|
position, which is represented by the eradius = electron size.
|
||||||
<p>For the <em>peri</em> style, the particles are spherical and each stores a
|
</P>
|
||||||
per-particle mass and volume.</p>
|
<P>For the <I>peri</I> style, the particles are spherical and each stores a
|
||||||
<p>The <em>meso</em> style is for smoothed particle hydrodynamics (SPH)
|
per-particle mass and volume.
|
||||||
|
</P>
|
||||||
|
<P>The <I>meso</I> style is for smoothed particle hydrodynamics (SPH)
|
||||||
particles which store a density (rho), energy (e), and heat capacity
|
particles which store a density (rho), energy (e), and heat capacity
|
||||||
(cv).</p>
|
(cv).
|
||||||
<p>The <em>wavepacket</em> style is similar to <em>electron</em>, but the electrons may
|
</P>
|
||||||
|
<P>The <I>wavepacket</I> style is similar to <I>electron</I>, but the electrons may
|
||||||
consist of several Gaussian wave packets, summed up with coefficients
|
consist of several Gaussian wave packets, summed up with coefficients
|
||||||
cs= (cs_re,cs_im). Each of the wave packets is treated as a separate
|
cs= (cs_re,cs_im). Each of the wave packets is treated as a separate
|
||||||
particle in LAMMPS, wave packets belonging to the same electron must
|
particle in LAMMPS, wave packets belonging to the same electron must
|
||||||
have identical <em>etag</em> values.</p>
|
have identical <I>etag</I> values.
|
||||||
<p>For the <em>line</em> style, the particles are idealized line segments and
|
</P>
|
||||||
|
<P>For the <I>line</I> style, the particles are idealized line segments and
|
||||||
each stores a per-particle mass and length and orientation (i.e. the
|
each stores a per-particle mass and length and orientation (i.e. the
|
||||||
end points of the line segment).</p>
|
end points of the line segment).
|
||||||
<p>For the <em>tri</em> style, the particles are planar triangles and each
|
</P>
|
||||||
|
<P>For the <I>tri</I> style, the particles are planar triangles and each
|
||||||
stores a per-particle mass and size and orientation (i.e. the corner
|
stores a per-particle mass and size and orientation (i.e. the corner
|
||||||
points of the triangle).</p>
|
points of the triangle).
|
||||||
<p>The <em>template</em> style allows molecular topolgy (bonds,angles,etc) to be
|
</P>
|
||||||
defined via a molecule template using the <a class="reference external" href="molecule.txt">molecule</a>
|
<P>The <I>template</I> style allows molecular topolgy (bonds,angles,etc) to be
|
||||||
|
defined via a molecule template using the <A HREF = "molecule.txt">molecule</A>
|
||||||
command. The template stores one or more molecules with a single copy
|
command. The template stores one or more molecules with a single copy
|
||||||
of the topology info (bonds,angles,etc) of each. Individual atoms
|
of the topology info (bonds,angles,etc) of each. Individual atoms
|
||||||
only store a template index and template atom to identify which
|
only store a template index and template atom to identify which
|
||||||
molecule and which atom-within-the-molecule they represent. Using the
|
molecule and which atom-within-the-molecule they represent. Using the
|
||||||
<em>template</em> style instead of the <em>bond</em>, <em>angle</em>, <em>molecular</em> styles
|
<I>template</I> style instead of the <I>bond</I>, <I>angle</I>, <I>molecular</I> styles
|
||||||
can save memory for systems comprised of a large number of small
|
can save memory for systems comprised of a large number of small
|
||||||
molecules, all of a single type (or small number of types). See the
|
molecules, all of a single type (or small number of types). See the
|
||||||
paper by Grime and Voth, in <a class="reference internal" href="#grime"><span>(Grime)</span></a>, for examples of how this
|
paper by Grime and Voth, in <A HREF = "#Grime">(Grime)</A>, for examples of how this
|
||||||
can be advantageous for large-scale coarse-grained systems.</p>
|
can be advantageous for large-scale coarse-grained systems.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: When using the <I>template</I> style with a <A HREF = "molecule.html">molecule
|
||||||
<p class="last">When using the <em>template</em> style with a <a class="reference internal" href="molecule.html"><em>molecule template</em></a> that contains multiple molecules, you should
|
template</A> that contains multiple molecules, you should
|
||||||
insure the atom types, bond types, angle_types, etc in all the
|
insure the atom types, bond types, angle_types, etc in all the
|
||||||
molecules are consistent. E.g. if one molecule represents H2O and
|
molecules are consistent. E.g. if one molecule represents H2O and
|
||||||
another CO2, then you probably do not want each molecule file to
|
another CO2, then you probably do not want each molecule file to
|
||||||
define 2 atom types and a single bond type, because they will conflict
|
define 2 atom types and a single bond type, because they will conflict
|
||||||
with each other when a mixture system of H2O and CO2 molecules is
|
with each other when a mixture system of H2O and CO2 molecules is
|
||||||
defined, e.g. by the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command. Rather the
|
defined, e.g. by the <A HREF = "read_data.html">read_data</A> command. Rather the
|
||||||
H2O molecule should define atom types 1 and 2, and bond type 1. And
|
H2O molecule should define atom types 1 and 2, and bond type 1. And
|
||||||
the CO2 molecule should define atom types 3 and 4 (or atom types 3 and
|
the CO2 molecule should define atom types 3 and 4 (or atom types 3 and
|
||||||
2 if a single oxygen type is desired), and bond type 2.</p>
|
2 if a single oxygen type is desired), and bond type 2.
|
||||||
</div>
|
</P>
|
||||||
<p>For the <em>body</em> style, the particles are arbitrary bodies with internal
|
<P>For the <I>body</I> style, the particles are arbitrary bodies with internal
|
||||||
attributes defined by the “style” of the bodies, which is specified by
|
attributes defined by the "style" of the bodies, which is specified by
|
||||||
the <em>bstyle</em> argument. Body particles can represent complex entities,
|
the <I>bstyle</I> argument. Body particles can represent complex entities,
|
||||||
such as surface meshes of discrete points, collections of
|
such as surface meshes of discrete points, collections of
|
||||||
sub-particles, deformable objects, etc.</p>
|
sub-particles, deformable objects, etc.
|
||||||
<p>The <a class="reference internal" href="body.html"><em>body</em></a> doc page descibes the body styles LAMMPS
|
</P>
|
||||||
|
<P>The <A HREF = "body.html">body</A> doc page descibes the body styles LAMMPS
|
||||||
currently supports, and provides more details as to the kind of body
|
currently supports, and provides more details as to the kind of body
|
||||||
particles they represent. For all styles, each body particle stores
|
particles they represent. For all styles, each body particle stores
|
||||||
moments of inertia and a quaternion 4-vector, so that its orientation
|
moments of inertia and a quaternion 4-vector, so that its orientation
|
||||||
and position can be time integrated due to forces and torques.</p>
|
and position can be time integrated due to forces and torques.
|
||||||
<p>Note that there may be additional arguments required along with the
|
</P>
|
||||||
<em>bstyle</em> specification, in the atom_style body command. These
|
<P>Note that there may be additional arguments required along with the
|
||||||
arguments are described in the <a class="reference internal" href="body.html"><em>body</em></a> doc page.</p>
|
<I>bstyle</I> specification, in the atom_style body command. These
|
||||||
<hr class="docutils" />
|
arguments are described in the <A HREF = "body.html">body</A> doc page.
|
||||||
<p>Typically, simulations require only a single (non-hybrid) atom style.
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Typically, simulations require only a single (non-hybrid) atom style.
|
||||||
If some atoms in the simulation do not have all the properties defined
|
If some atoms in the simulation do not have all the properties defined
|
||||||
by a particular style, use the simplest style that defines all the
|
by a particular style, use the simplest style that defines all the
|
||||||
needed properties by any atom. For example, if some atoms in a
|
needed properties by any atom. For example, if some atoms in a
|
||||||
simulation are charged, but others are not, use the <em>charge</em> style.
|
simulation are charged, but others are not, use the <I>charge</I> style.
|
||||||
If some atoms have bonds, but others do not, use the <em>bond</em> style.</p>
|
If some atoms have bonds, but others do not, use the <I>bond</I> style.
|
||||||
<p>The only scenario where the <em>hybrid</em> style is needed is if there is no
|
</P>
|
||||||
|
<P>The only scenario where the <I>hybrid</I> style is needed is if there is no
|
||||||
single style which defines all needed properties of all atoms. For
|
single style which defines all needed properties of all atoms. For
|
||||||
example, if you want dipolar particles which will rotate due to
|
example, if you want dipolar particles which will rotate due to
|
||||||
torque, you would need to use “atom_style hybrid sphere dipole”. When
|
torque, you would need to use "atom_style hybrid sphere dipole". When
|
||||||
a hybrid style is used, atoms store and communicate the union of all
|
a hybrid style is used, atoms store and communicate the union of all
|
||||||
quantities implied by the individual styles.</p>
|
quantities implied by the individual styles.
|
||||||
<p>When using the <em>hybrid</em> style, you cannot combine the <em>template</em> style
|
</P>
|
||||||
|
<P>When using the <I>hybrid</I> style, you cannot combine the <I>template</I> style
|
||||||
with another molecular style that stores bond,angle,etc info on a
|
with another molecular style that stores bond,angle,etc info on a
|
||||||
per-atom basis.</p>
|
per-atom basis.
|
||||||
<p>LAMMPS can be extended with new atom styles as well as new body
|
</P>
|
||||||
styles; see <a class="reference internal" href="Section_modify.html"><em>this section</em></a>.</p>
|
<P>LAMMPS can be extended with new atom styles as well as new body
|
||||||
<hr class="docutils" />
|
styles; see <A HREF = "Section_modify.html">this section</A>.
|
||||||
<p>Styles with a <em>cuda</em> or <em>kk</em> suffix are functionally the same as the
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I> or <I>kk</I> suffix are functionally the same as the
|
||||||
corresponding style without the suffix. They have been optimized to
|
corresponding style without the suffix. They have been optimized to
|
||||||
run faster, depending on your available hardware, as discussed in
|
run faster, depending on your available hardware, as discussed in
|
||||||
<a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual. The
|
<A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual. The
|
||||||
accelerated styles take the same arguments and should produce the same
|
accelerated styles take the same arguments and should produce the same
|
||||||
results, except for round-off and precision issues.</p>
|
results, except for round-off and precision issues.
|
||||||
<p>Note that other acceleration packages in LAMMPS, specifically the GPU,
|
</P>
|
||||||
|
<P>Note that other acceleration packages in LAMMPS, specifically the GPU,
|
||||||
USER-INTEL, USER-OMP, and OPT packages do not use accelerated atom
|
USER-INTEL, USER-OMP, and OPT packages do not use accelerated atom
|
||||||
styles.</p>
|
styles.
|
||||||
<p>The accelerated styles are part of the USER-CUDA and KOKKOS packages
|
</P>
|
||||||
|
<P>The accelerated styles are part of the USER-CUDA and KOKKOS packages
|
||||||
respectively. They are only enabled if LAMMPS was built with those
|
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>Making LAMMPS</span></a> section
|
packages. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A> section
|
||||||
for more info.</p>
|
for more info.
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
</P>
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This command cannot be used after the simulation box is defined by a
|
</P>
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> or <a class="reference internal" href="create_box.html"><em>create_box</em></a> command.</p>
|
<P><B>Restrictions:</B>
|
||||||
<p>The <em>angle</em>, <em>bond</em>, <em>full</em>, <em>molecular</em>, and <em>template</em> styles are
|
</P>
|
||||||
part of the MOLECULE package. The <em>line</em> and <em>tri</em> styles are part
|
<P>This command cannot be used after the simulation box is defined by a
|
||||||
of the ASPHERE pacakge. The <em>body</em> style is part of the BODY package.
|
<A HREF = "read_data.html">read_data</A> or <A HREF = "create_box.html">create_box</A> command.
|
||||||
The <em>dipole</em> style is part of the DIPOLE package. The <em>peri</em> style is
|
</P>
|
||||||
part of the PERI package for Peridynamics. The <em>electron</em> style is
|
<P>The <I>angle</I>, <I>bond</I>, <I>full</I>, <I>molecular</I>, and <I>template</I> styles are
|
||||||
part of the USER-EFF package for <a class="reference internal" href="pair_eff.html"><em>electronic force fields</em></a>. The <em>meso</em> style is part of the USER-SPH
|
part of the MOLECULE package. The <I>line</I> and <I>tri</I> styles are part
|
||||||
package for smoothed particle hydrodyanmics (SPH). See <a class="reference external" href="USER/sph/SPH_LAMMPS_userguide.pdf">this PDF guide</a> to using SPH in LAMMPS. The
|
of the ASPHERE pacakge. The <I>body</I> style is part of the BODY package.
|
||||||
<em>wavepacket</em> style is part of the USER-AWPMD package for the
|
The <I>dipole</I> style is part of the DIPOLE package. The <I>peri</I> style is
|
||||||
<a class="reference internal" href="pair_awpmd.html"><em>antisymmetrized wave packet MD method</em></a>. They are
|
part of the PERI package for Peridynamics. The <I>electron</I> style 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>
|
part of the USER-EFF package for <A HREF = "pair_eff.html">electronic force
|
||||||
</div>
|
fields</A>. The <I>meso</I> style is part of the USER-SPH
|
||||||
<div class="section" id="related-commands">
|
package for smoothed particle hydrodyanmics (SPH). See <A HREF = "USER/sph/SPH_LAMMPS_userguide.pdf">this PDF
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
guide</A> to using SPH in LAMMPS. The
|
||||||
<p><a class="reference internal" href="read_data.html"><em>read_data</em></a>, <a class="reference internal" href="pair_style.html"><em>pair_style</em></a></p>
|
<I>wavepacket</I> style is part of the USER-AWPMD package for the
|
||||||
</div>
|
<A HREF = "pair_awpmd.html">antisymmetrized wave packet MD method</A>. They are
|
||||||
<div class="section" id="default">
|
only enabled if LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
LAMMPS</A> section for more info.
|
||||||
<p>atom_style atomic</p>
|
</P>
|
||||||
<hr class="docutils" />
|
<P><B>Related commands:</B>
|
||||||
<p id="grime"><strong>(Grime)</strong> Grime and Voth, to appear in J Chem Theory & Computation
|
</P>
|
||||||
(2014).</p>
|
<P><A HREF = "read_data.html">read_data</A>, <A HREF = "pair_style.html">pair_style</A>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B>
|
||||||
|
</P>
|
||||||
|
<P>atom_style atomic
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<A NAME = "Grime"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Grime)</B> Grime and Voth, to appear in J Chem Theory & Computation
|
||||||
</div>
|
(2014).
|
||||||
<footer>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
599
doc/balance.html
599
doc/balance.html
@ -1,246 +1,130 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>balance command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>balance command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>balance command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>balance thresh style args ... keyword value ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>thresh = imbalance threshhold that must be exceeded to perform a re-balance
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>one style/arg pair can be used (or multiple for <I>x</I>,<I>y</I>,<I>z</I>)
|
||||||
|
|
||||||
</li>
|
<LI>style = <I>x</I> or <I>y</I> or <I>z</I> or <I>shift</I> or <I>rcb</I>
|
||||||
</ul>
|
|
||||||
<hr/>
|
<PRE> <I>x</I> args = <I>uniform</I> or Px-1 numbers between 0 and 1
|
||||||
|
<I>uniform</I> = evenly spaced cuts between processors in x dimension
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="balance-command">
|
|
||||||
<span id="index-0"></span><h1>balance command<a class="headerlink" href="#balance-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>balance thresh style args ... keyword value ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>thresh = imbalance threshhold that must be exceeded to perform a re-balance</li>
|
|
||||||
<li>one style/arg pair can be used (or multiple for <em>x</em>,*y*,*z*)</li>
|
|
||||||
<li>style = <em>x</em> or <em>y</em> or <em>z</em> or <em>shift</em> or <em>rcb</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>x</em> args = <em>uniform</em> or Px-1 numbers between 0 and 1
|
|
||||||
<em>uniform</em> = evenly spaced cuts between processors in x dimension
|
|
||||||
numbers = Px-1 ascending values between 0 and 1, Px - # of processors in x dimension
|
numbers = Px-1 ascending values between 0 and 1, Px - # of processors in x dimension
|
||||||
<em>x</em> can be specified together with <em>y</em> or <em>z</em>
|
<I>x</I> can be specified together with <I>y</I> or <I>z</I>
|
||||||
<em>y</em> args = <em>uniform</em> or Py-1 numbers between 0 and 1
|
<I>y</I> args = <I>uniform</I> or Py-1 numbers between 0 and 1
|
||||||
<em>uniform</em> = evenly spaced cuts between processors in y dimension
|
<I>uniform</I> = evenly spaced cuts between processors in y dimension
|
||||||
numbers = Py-1 ascending values between 0 and 1, Py - # of processors in y dimension
|
numbers = Py-1 ascending values between 0 and 1, Py - # of processors in y dimension
|
||||||
<em>y</em> can be specified together with <em>x</em> or <em>z</em>
|
<I>y</I> can be specified together with <I>x</I> or <I>z</I>
|
||||||
<em>z</em> args = <em>uniform</em> or Pz-1 numbers between 0 and 1
|
<I>z</I> args = <I>uniform</I> or Pz-1 numbers between 0 and 1
|
||||||
<em>uniform</em> = evenly spaced cuts between processors in z dimension
|
<I>uniform</I> = evenly spaced cuts between processors in z dimension
|
||||||
numbers = Pz-1 ascending values between 0 and 1, Pz - # of processors in z dimension
|
numbers = Pz-1 ascending values between 0 and 1, Pz - # of processors in z dimension
|
||||||
<em>z</em> can be specified together with <em>x</em> or <em>y</em>
|
<I>z</I> can be specified together with <I>x</I> or <I>y</I>
|
||||||
<em>shift</em> args = dimstr Niter stopthresh
|
<I>shift</I> args = dimstr Niter stopthresh
|
||||||
dimstr = sequence of letters containing "x" or "y" or "z", each not more than once
|
dimstr = sequence of letters containing "x" or "y" or "z", each not more than once
|
||||||
Niter = # of times to iterate within each dimension of dimstr sequence
|
Niter = # of times to iterate within each dimension of dimstr sequence
|
||||||
stopthresh = stop balancing when this imbalance threshhold is reached
|
stopthresh = stop balancing when this imbalance threshhold is reached
|
||||||
<em>rcb</em> args = none
|
<I>rcb</I> args = none
|
||||||
</pre>
|
</PRE>
|
||||||
<ul class="simple">
|
<LI>zero or more keyword/value pairs may be appended
|
||||||
<li>zero or more keyword/value pairs may be appended</li>
|
|
||||||
<li>keyword = <em>out</em></li>
|
<LI>keyword = <I>out</I>
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
<PRE> <I>out</I> value = filename
|
||||||
<em>out</em> value = filename
|
filename = write each processor's sub-domain to a file
|
||||||
filename = write each processor's sub-domain to a file
|
</PRE>
|
||||||
</pre>
|
|
||||||
</div>
|
</UL>
|
||||||
<div class="section" id="examples">
|
<P><B>Examples:</B>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>balance 0.9 x uniform y 0.4 0.5 0.6
|
<PRE>balance 0.9 x uniform y 0.4 0.5 0.6
|
||||||
balance 1.2 shift xz 5 1.1
|
balance 1.2 shift xz 5 1.1
|
||||||
balance 1.0 shift xz 5 1.1
|
balance 1.0 shift xz 5 1.1
|
||||||
balance 1.1 rcb
|
balance 1.1 rcb
|
||||||
balance 1.0 shift x 20 1.0 out tmp.balance
|
balance 1.0 shift x 20 1.0 out tmp.balance
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>This command adjusts the size and shape of processor sub-domains
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>This command adjusts the size and shape of processor sub-domains
|
|
||||||
within the simulation box, to attempt to balance the number of
|
within the simulation box, to attempt to balance the number of
|
||||||
particles and thus the computational cost (load) evenly across
|
particles and thus the computational cost (load) evenly across
|
||||||
processors. The load balancing is “static” in the sense that this
|
processors. The load balancing is "static" in the sense that this
|
||||||
command performs the balancing once, before or between simulations.
|
command performs the balancing once, before or between simulations.
|
||||||
The processor sub-domains will then remain static during the
|
The processor sub-domains will then remain static during the
|
||||||
subsequent run. To perform “dynamic” balancing, see the <a class="reference internal" href="fix_balance.html"><em>fix balance</em></a> command, which can adjust processor
|
subsequent run. To perform "dynamic" balancing, see the <A HREF = "fix_balance.html">fix
|
||||||
sub-domain sizes and shapes on-the-fly during a <a class="reference internal" href="run.html"><em>run</em></a>.</p>
|
balance</A> command, which can adjust processor
|
||||||
<p>Load-balancing is typically only useful if the particles in the
|
sub-domain sizes and shapes on-the-fly during a <A HREF = "run.html">run</A>.
|
||||||
|
</P>
|
||||||
|
<P>Load-balancing is typically only useful if the particles in the
|
||||||
simulation box have a spatially-varying density distribution. E.g. a
|
simulation box have a spatially-varying density distribution. E.g. a
|
||||||
model of a vapor/liquid interface, or a solid with an irregular-shaped
|
model of a vapor/liquid interface, or a solid with an irregular-shaped
|
||||||
geometry containing void regions. In this case, the LAMMPS default of
|
geometry containing void regions. In this case, the LAMMPS default of
|
||||||
dividing the simulation box volume into a regular-spaced grid of 3d
|
dividing the simulation box volume into a regular-spaced grid of 3d
|
||||||
bricks, with one equal-volume sub-domain per procesor, may assign very
|
bricks, with one equal-volume sub-domain per procesor, may assign very
|
||||||
different numbers of particles per processor. This can lead to poor
|
different numbers of particles per processor. This can lead to poor
|
||||||
performance when the simulation is run in parallel.</p>
|
performance when the simulation is run in parallel.
|
||||||
<p>Note that the <a class="reference internal" href="processors.html"><em>processors</em></a> command allows some control
|
</P>
|
||||||
|
<P>Note that the <A HREF = "processors.html">processors</A> command allows some control
|
||||||
over how the box volume is split across processors. Specifically, for
|
over how the box volume is split across processors. Specifically, for
|
||||||
a Px by Py by Pz grid of processors, it allows choice of Px, Py, and
|
a Px by Py by Pz grid of processors, it allows choice of Px, Py, and
|
||||||
Pz, subject to the constraint that Px * Py * Pz = P, the total number
|
Pz, subject to the constraint that Px * Py * Pz = P, the total number
|
||||||
of processors. This is sufficient to achieve good load-balance for
|
of processors. This is sufficient to achieve good load-balance for
|
||||||
some problems on some processor counts. However, all the processor
|
some problems on some processor counts. However, all the processor
|
||||||
sub-domains will still have the same shape and same volume.</p>
|
sub-domains will still have the same shape and same volume.
|
||||||
<p>The requested load-balancing operation is only performed if the
|
</P>
|
||||||
current “imbalance factor” in particles owned by each processor
|
<P>The requested load-balancing operation is only performed if the
|
||||||
exceeds the specified <em>thresh</em> parameter. The imbalance factor is
|
current "imbalance factor" in particles owned by each processor
|
||||||
|
exceeds the specified <I>thresh</I> parameter. The imbalance factor is
|
||||||
defined as the maximum number of particles owned by any processor,
|
defined as the maximum number of particles owned by any processor,
|
||||||
divided by the average number of particles per processor. Thus an
|
divided by the average number of particles per processor. Thus an
|
||||||
imbalance factor of 1.0 is perfect balance.</p>
|
imbalance factor of 1.0 is perfect balance.
|
||||||
<p>As an example, for 10000 particles running on 10 processors, if the
|
</P>
|
||||||
|
<P>As an example, for 10000 particles running on 10 processors, if the
|
||||||
most heavily loaded processor has 1200 particles, then the factor is
|
most heavily loaded processor has 1200 particles, then the factor is
|
||||||
1.2, meaning there is a 20% imbalance. Note that a re-balance can be
|
1.2, meaning there is a 20% imbalance. Note that a re-balance can be
|
||||||
forced even if the current balance is perfect (1.0) be specifying a
|
forced even if the current balance is perfect (1.0) be specifying a
|
||||||
<em>thresh</em> < 1.0.</p>
|
<I>thresh</I> < 1.0.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: Balancing is performed even if the imbalance factor
|
||||||
<p class="last">Balancing is performed even if the imbalance factor
|
does not exceed the <I>thresh</I> parameter if a "grid" style is specified
|
||||||
does not exceed the <em>thresh</em> parameter if a “grid” style is specified
|
when the current partitioning is "tiled". The meaning of "grid" vs
|
||||||
when the current partitioning is “tiled”. The meaning of “grid” vs
|
"tiled" is explained below. This is to allow forcing of the
|
||||||
“tiled” is explained below. This is to allow forcing of the
|
partitioning to "grid" so that the <A HREF = "comm_style.html">comm_style brick</A>
|
||||||
partitioning to “grid” so that the <a class="reference internal" href="comm_style.html"><em>comm_style brick</em></a>
|
command can then be used to replace a current <A HREF = "comm_style.html">comm_style
|
||||||
command can then be used to replace a current <a class="reference internal" href="comm_style.html"><em>comm_style tiled</em></a> setting.</p>
|
tiled</A> setting.
|
||||||
</div>
|
</P>
|
||||||
<p>When the balance command completes, it prints statistics about the
|
<P>When the balance command completes, it prints statistics about the
|
||||||
result, including the change in the imbalance factor and the change in
|
result, including the change in the imbalance factor and the change in
|
||||||
the maximum number of particles on any processor. For “grid” methods
|
the maximum number of particles on any processor. For "grid" methods
|
||||||
(defined below) that create a logical 3d grid of processors, the
|
(defined below) that create a logical 3d grid of processors, the
|
||||||
positions of all cutting planes in each of the 3 dimensions (as
|
positions of all cutting planes in each of the 3 dimensions (as
|
||||||
fractions of the box length) are also printed.</p>
|
fractions of the box length) are also printed.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: This command attempts to minimize the imbalance
|
||||||
<p class="last">This command attempts to minimize the imbalance
|
|
||||||
factor, as defined above. But depending on the method a perfect
|
factor, as defined above. But depending on the method a perfect
|
||||||
balance (1.0) may not be achieved. For example, “grid” methods
|
balance (1.0) may not be achieved. For example, "grid" methods
|
||||||
(defined below) that create a logical 3d grid cannot achieve perfect
|
(defined below) that create a logical 3d grid cannot achieve perfect
|
||||||
balance for many irregular distributions of particles. Likewise, if a
|
balance for many irregular distributions of particles. Likewise, if a
|
||||||
portion of the system is a perfect lattice, e.g. the intiial system is
|
portion of the system is a perfect lattice, e.g. the intiial system is
|
||||||
generated by the <a class="reference internal" href="create_atoms.html"><em>create_atoms</em></a> command, then “grid”
|
generated by the <A HREF = "create_atoms.html">create_atoms</A> command, then "grid"
|
||||||
methods may be unable to achieve exact balance. This is because
|
methods may be unable to achieve exact balance. This is because
|
||||||
entire lattice planes will be owned or not owned by a single
|
entire lattice planes will be owned or not owned by a single
|
||||||
processor.</p>
|
processor.
|
||||||
</div>
|
</P>
|
||||||
<div class="admonition warning">
|
<P>IMPORTANT NOTE: The imbalance factor is also an estimate of the
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">The imbalance factor is also an estimate of the
|
|
||||||
maximum speed-up you can hope to achieve by running a perfectly
|
maximum speed-up you can hope to achieve by running a perfectly
|
||||||
balanced simulation versus an imbalanced one. In the example above,
|
balanced simulation versus an imbalanced one. In the example above,
|
||||||
the 10000 particle simulation could run up to 20% faster if it were
|
the 10000 particle simulation could run up to 20% faster if it were
|
||||||
@ -248,117 +132,105 @@ perfectly balanced, versus when imbalanced. However, computational
|
|||||||
cost is not strictly proportional to particle count, and changing the
|
cost is not strictly proportional to particle count, and changing the
|
||||||
relative size and shape of processor sub-domains may lead to
|
relative size and shape of processor sub-domains may lead to
|
||||||
additional computational and communication overheads, e.g. in the PPPM
|
additional computational and communication overheads, e.g. in the PPPM
|
||||||
solver used via the <a class="reference internal" href="kspace_style.html"><em>kspace_style</em></a> command. Thus
|
solver used via the <A HREF = "kspace_style.html">kspace_style</A> command. Thus
|
||||||
you should benchmark the run times of a simulation before and after
|
you should benchmark the run times of a simulation before and after
|
||||||
balancing.</p>
|
balancing.
|
||||||
</div>
|
</P>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
<p>The method used to perform a load balance is specified by one of the
|
|
||||||
listed styles (or more in the case of <em>x</em>,*y*,*z*), which are
|
<P>The method used to perform a load balance is specified by one of the
|
||||||
described in detail below. There are 2 kinds of styles.</p>
|
listed styles (or more in the case of <I>x</I>,<I>y</I>,<I>z</I>), which are
|
||||||
<p>The <em>x</em>, <em>y</em>, <em>z</em>, and <em>shift</em> styles are “grid” methods which produce
|
described in detail below. There are 2 kinds of styles.
|
||||||
|
</P>
|
||||||
|
<P>The <I>x</I>, <I>y</I>, <I>z</I>, and <I>shift</I> styles are "grid" methods which produce
|
||||||
a logical 3d grid of processors. They operate by changing the cutting
|
a logical 3d grid of processors. They operate by changing the cutting
|
||||||
planes (or lines) between processors in 3d (or 2d), to adjust the
|
planes (or lines) between processors in 3d (or 2d), to adjust the
|
||||||
volume (area in 2d) assigned to each processor, as in the following 2d
|
volume (area in 2d) assigned to each processor, as in the following 2d
|
||||||
diagram where processor sub-domains are shown and atoms are colored by
|
diagram where processor sub-domains are shown and atoms are colored by
|
||||||
the processor that owns them. The leftmost diagram is the default
|
the processor that owns them. The leftmost diagram is the default
|
||||||
partitioning of the simulation box across processors (one sub-box for
|
partitioning of the simulation box across processors (one sub-box for
|
||||||
each of 16 processors); the middle diagram is after a “grid” method
|
each of 16 processors); the middle diagram is after a "grid" method
|
||||||
has been applied.</p>
|
has been applied.
|
||||||
<a data-lightbox="group-default"
|
</P>
|
||||||
href="_images/balance_uniform.jpg"
|
<CENTER><A HREF = "JPG/balance_uniform.jpg"><IMG SRC = "JPG/balance_uniform_small.jpg"></A><A HREF = "JPG/balance_nonuniform.jpg"><IMG SRC = "JPG/balance_nonuniform_small.jpg"></A><A HREF = "JPG/balance_rcb.jpg"><IMG SRC = "JPG/balance_rcb_small.jpg"></A>
|
||||||
class=""
|
</CENTER>
|
||||||
title=""
|
<P>The <I>rcb</I> style is a "tiling" method which does not produce a logical
|
||||||
data-title=""
|
|
||||||
><img src="_images/balance_uniform.jpg"
|
|
||||||
class="align-center"
|
|
||||||
width="25%"
|
|
||||||
height="auto"
|
|
||||||
alt=""/>
|
|
||||||
</a><a data-lightbox="group-default"
|
|
||||||
href="_images/balance_nonuniform.jpg"
|
|
||||||
class=""
|
|
||||||
title=""
|
|
||||||
data-title=""
|
|
||||||
><img src="_images/balance_nonuniform.jpg"
|
|
||||||
class="align-center"
|
|
||||||
width="25%"
|
|
||||||
height="auto"
|
|
||||||
alt=""/>
|
|
||||||
</a><a data-lightbox="group-default"
|
|
||||||
href="_images/balance_rcb.jpg"
|
|
||||||
class=""
|
|
||||||
title=""
|
|
||||||
data-title=""
|
|
||||||
><img src="_images/balance_rcb.jpg"
|
|
||||||
class="align-center"
|
|
||||||
width="25%"
|
|
||||||
height="auto"
|
|
||||||
alt=""/>
|
|
||||||
</a><p>The <em>rcb</em> style is a “tiling” method which does not produce a logical
|
|
||||||
3d grid of processors. Rather it tiles the simulation domain with
|
3d grid of processors. Rather it tiles the simulation domain with
|
||||||
rectangular sub-boxes of varying size and shape in an irregular
|
rectangular sub-boxes of varying size and shape in an irregular
|
||||||
fashion so as to have equal numbers of particles in each sub-box, as
|
fashion so as to have equal numbers of particles in each sub-box, as
|
||||||
in the rightmost diagram above.</p>
|
in the rightmost diagram above.
|
||||||
<p>The “grid” methods can be used with either of the
|
</P>
|
||||||
<a class="reference internal" href="comm_style.html"><em>comm_style</em></a> command options, <em>brick</em> or <em>tiled</em>. The
|
<P>The "grid" methods can be used with either of the
|
||||||
“tiling” methods can only be used with <a class="reference internal" href="comm_style.html"><em>comm_style tiled</em></a>. Note that it can be useful to use a “grid”
|
<A HREF = "comm_style.html">comm_style</A> command options, <I>brick</I> or <I>tiled</I>. The
|
||||||
method with <a class="reference internal" href="comm_style.html"><em>comm_style tiled</em></a> to return the domain
|
"tiling" methods can only be used with <A HREF = "comm_style.html">comm_style
|
||||||
partitioning to a logical 3d grid of processors so that “comm_style
|
tiled</A>. Note that it can be useful to use a "grid"
|
||||||
brick” can afterwords be specified for subsequent <a class="reference internal" href="run.html"><em>run</em></a>
|
method with <A HREF = "comm_style.html">comm_style tiled</A> to return the domain
|
||||||
commands.</p>
|
partitioning to a logical 3d grid of processors so that "comm_style
|
||||||
<p>When a “grid” method is specified, the current domain partitioning can
|
brick" can afterwords be specified for subsequent <A HREF = "run.html">run</A>
|
||||||
|
commands.
|
||||||
|
</P>
|
||||||
|
<P>When a "grid" method is specified, the current domain partitioning can
|
||||||
be either a logical 3d grid or a tiled partitioning. In the former
|
be either a logical 3d grid or a tiled partitioning. In the former
|
||||||
case, the current logical 3d grid is used as a starting point and
|
case, the current logical 3d grid is used as a starting point and
|
||||||
changes are made to improve the imbalance factor. In the latter case,
|
changes are made to improve the imbalance factor. In the latter case,
|
||||||
the tiled partitioning is discarded and a logical 3d grid is created
|
the tiled partitioning is discarded and a logical 3d grid is created
|
||||||
with uniform spacing in all dimensions. This becomes the starting
|
with uniform spacing in all dimensions. This becomes the starting
|
||||||
point for the balancing operation.</p>
|
point for the balancing operation.
|
||||||
<p>When a “tiling” method is specified, the current domain partitioning
|
</P>
|
||||||
(“grid” or “tiled”) is ignored, and a new partitioning is computed
|
<P>When a "tiling" method is specified, the current domain partitioning
|
||||||
from scratch.</p>
|
("grid" or "tiled") is ignored, and a new partitioning is computed
|
||||||
<hr class="docutils" />
|
from scratch.
|
||||||
<p>The <em>x</em>, <em>y</em>, and <em>z</em> styles invoke a “grid” method for balancing, as
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>The <I>x</I>, <I>y</I>, and <I>z</I> styles invoke a "grid" method for balancing, as
|
||||||
described above. Note that any or all of these 3 styles can be
|
described above. Note that any or all of these 3 styles can be
|
||||||
specified together, one after the other, but they cannot be used with
|
specified together, one after the other, but they cannot be used with
|
||||||
any other style. This style adjusts the position of cutting planes
|
any other style. This style adjusts the position of cutting planes
|
||||||
between processor sub-domains in specific dimensions. Only the
|
between processor sub-domains in specific dimensions. Only the
|
||||||
specified dimensions are altered.</p>
|
specified dimensions are altered.
|
||||||
<p>The <em>uniform</em> argument spaces the planes evenly, as in the left
|
</P>
|
||||||
diagrams above. The <em>numeric</em> argument requires listing Ps-1 numbers
|
<P>The <I>uniform</I> argument spaces the planes evenly, as in the left
|
||||||
|
diagrams above. The <I>numeric</I> argument requires listing Ps-1 numbers
|
||||||
that specify the position of the cutting planes. This requires
|
that specify the position of the cutting planes. This requires
|
||||||
knowing Ps = Px or Py or Pz = the number of processors assigned by
|
knowing Ps = Px or Py or Pz = the number of processors assigned by
|
||||||
LAMMPS to the relevant dimension. This assignment is made (and the
|
LAMMPS to the relevant dimension. This assignment is made (and the
|
||||||
Px, Py, Pz values printed out) when the simulation box is created by
|
Px, Py, Pz values printed out) when the simulation box is created by
|
||||||
the “create_box” or “read_data” or “read_restart” command and is
|
the "create_box" or "read_data" or "read_restart" command and is
|
||||||
influenced by the settings of the <a class="reference internal" href="processors.html"><em>processors</em></a>
|
influenced by the settings of the <A HREF = "processors.html">processors</A>
|
||||||
command.</p>
|
command.
|
||||||
<p>Each of the numeric values must be between 0 and 1, and they must be
|
</P>
|
||||||
|
<P>Each of the numeric values must be between 0 and 1, and they must be
|
||||||
listed in ascending order. They represent the fractional position of
|
listed in ascending order. They represent the fractional position of
|
||||||
the cutting place. The left (or lower) edge of the box is 0.0, and
|
the cutting place. The left (or lower) edge of the box is 0.0, and
|
||||||
the right (or upper) edge is 1.0. Neither of these values is
|
the right (or upper) edge is 1.0. Neither of these values is
|
||||||
specified. Only the interior Ps-1 positions are specified. Thus is
|
specified. Only the interior Ps-1 positions are specified. Thus is
|
||||||
there are 2 procesors in the x dimension, you specify a single value
|
there are 2 procesors in the x dimension, you specify a single value
|
||||||
such as 0.75, which would make the left processor’s sub-domain 3x
|
such as 0.75, which would make the left processor's sub-domain 3x
|
||||||
larger than the right processor’s sub-domain.</p>
|
larger than the right processor's sub-domain.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The <em>shift</em> style invokes a “grid” method for balancing, as
|
<HR>
|
||||||
|
|
||||||
|
<P>The <I>shift</I> style invokes a "grid" method for balancing, as
|
||||||
described above. It changes the positions of cutting planes between
|
described above. It changes the positions of cutting planes between
|
||||||
processors in an iterative fashion, seeking to reduce the imbalance
|
processors in an iterative fashion, seeking to reduce the imbalance
|
||||||
factor, similar to how the <a class="reference internal" href="fix_balance.html"><em>fix balance shift</em></a>
|
factor, similar to how the <A HREF = "fix_balance.html">fix balance shift</A>
|
||||||
command operates.</p>
|
command operates.
|
||||||
<p>The <em>dimstr</em> argument is a string of characters, each of which must be
|
</P>
|
||||||
an “x” or “y” or “z”. Eacn character can appear zero or one time,
|
<P>The <I>dimstr</I> argument is a string of characters, each of which must be
|
||||||
|
an "x" or "y" or "z". Eacn character can appear zero or one time,
|
||||||
since there is no advantage to balancing on a dimension more than
|
since there is no advantage to balancing on a dimension more than
|
||||||
once. You should normally only list dimensions where you expect there
|
once. You should normally only list dimensions where you expect there
|
||||||
to be a density variation in the particles.</p>
|
to be a density variation in the particles.
|
||||||
<p>Balancing proceeds by adjusting the cutting planes in each of the
|
</P>
|
||||||
dimensions listed in <em>dimstr</em>, one dimension at a time. For a single
|
<P>Balancing proceeds by adjusting the cutting planes in each of the
|
||||||
|
dimensions listed in <I>dimstr</I>, one dimension at a time. For a single
|
||||||
dimension, the balancing operation (described below) is iterated on up
|
dimension, the balancing operation (described below) is iterated on up
|
||||||
to <em>Niter</em> times. After each dimension finishes, the imbalance factor
|
to <I>Niter</I> times. After each dimension finishes, the imbalance factor
|
||||||
is re-computed, and the balancing operation halts if the <em>stopthresh</em>
|
is re-computed, and the balancing operation halts if the <I>stopthresh</I>
|
||||||
criterion is met.</p>
|
criterion is met.
|
||||||
<p>A rebalance operation in a single dimension is performed using a
|
</P>
|
||||||
|
<P>A rebalance operation in a single dimension is performed using a
|
||||||
recursive multisectioning algorithm, where the position of each
|
recursive multisectioning algorithm, where the position of each
|
||||||
cutting plane (line in 2d) in the dimension is adjusted independently.
|
cutting plane (line in 2d) in the dimension is adjusted independently.
|
||||||
This is similar to a recursive bisectioning for a single value, except
|
This is similar to a recursive bisectioning for a single value, except
|
||||||
@ -370,31 +242,33 @@ the cut is adjusted to be halfway between a low and high bound. The
|
|||||||
low and high bounds are adjusted on each iteration, using new count
|
low and high bounds are adjusted on each iteration, using new count
|
||||||
information, so that they become closer together over time. Thus as
|
information, so that they become closer together over time. Thus as
|
||||||
the recustion progresses, the count of particles on either side of the
|
the recustion progresses, the count of particles on either side of the
|
||||||
plane gets closer to the target value.</p>
|
plane gets closer to the target value.
|
||||||
<p>Once the rebalancing is complete and final processor sub-domains
|
</P>
|
||||||
|
<P>Once the rebalancing is complete and final processor sub-domains
|
||||||
assigned, particles are migrated to their new owning processor, and
|
assigned, particles are migrated to their new owning processor, and
|
||||||
the balance procedure ends.</p>
|
the balance procedure ends.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: At each rebalance operation, the bisectioning for each
|
||||||
<p class="last">At each rebalance operation, the bisectioning for each
|
|
||||||
cutting plane (line in 2d) typcially starts with low and high bounds
|
cutting plane (line in 2d) typcially starts with low and high bounds
|
||||||
separated by the extent of a processor’s sub-domain in one dimension.
|
separated by the extent of a processor's sub-domain in one dimension.
|
||||||
The size of this bracketing region shrinks by 1/2 every iteration.
|
The size of this bracketing region shrinks by 1/2 every iteration.
|
||||||
Thus if <em>Niter</em> is specified as 10, the cutting plane will typically
|
Thus if <I>Niter</I> is specified as 10, the cutting plane will typically
|
||||||
be positioned to 1 part in 1000 accuracy (relative to the perfect
|
be positioned to 1 part in 1000 accuracy (relative to the perfect
|
||||||
target position). For <em>Niter</em> = 20, it will be accurate to 1 part in
|
target position). For <I>Niter</I> = 20, it will be accurate to 1 part in
|
||||||
a million. Thus there is no need ot set <em>Niter</em> to a large value.
|
a million. Thus there is no need ot set <I>Niter</I> to a large value.
|
||||||
LAMMPS will check if the threshold accuracy is reached (in a
|
LAMMPS will check if the threshold accuracy is reached (in a
|
||||||
dimension) is less iterations than <em>Niter</em> and exit early. However,
|
dimension) is less iterations than <I>Niter</I> and exit early. However,
|
||||||
<em>Niter</em> should also not be set too small, since it will take roughly
|
<I>Niter</I> should also not be set too small, since it will take roughly
|
||||||
the same number of iterations to converge even if the cutting plane is
|
the same number of iterations to converge even if the cutting plane is
|
||||||
initially close to the target value.</p>
|
initially close to the target value.
|
||||||
</div>
|
</P>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
<p>The <em>rcb</em> style invokes a “tiled” method for balancing, as described
|
|
||||||
|
<P>The <I>rcb</I> style invokes a "tiled" method for balancing, as described
|
||||||
above. It performs a recursive coordinate bisectioning (RCB) of the
|
above. It performs a recursive coordinate bisectioning (RCB) of the
|
||||||
simulation domain. The basic idea is as follows.</p>
|
simulation domain. The basic idea is as follows.
|
||||||
<p>The simulation domain is cut into 2 boxes by an axis-aligned cut in
|
</P>
|
||||||
|
<P>The simulation domain is cut into 2 boxes by an axis-aligned cut in
|
||||||
the longest dimension, leaving one new box on either side of the cut.
|
the longest dimension, leaving one new box on either side of the cut.
|
||||||
All the processors are also partitioned into 2 groups, half assigned
|
All the processors are also partitioned into 2 groups, half assigned
|
||||||
to the box on the lower side of the cut, and half to the box on the
|
to the box on the lower side of the cut, and half to the box on the
|
||||||
@ -405,23 +279,27 @@ box should own for load balance to be perfect. This also makes load
|
|||||||
balance for the upper box perfect. The positioning is done
|
balance for the upper box perfect. The positioning is done
|
||||||
iteratively, by a bisectioning method. Note that counting atoms on
|
iteratively, by a bisectioning method. Note that counting atoms on
|
||||||
either side of the cut requires communication between all processors
|
either side of the cut requires communication between all processors
|
||||||
at each iteration.</p>
|
at each iteration.
|
||||||
<p>That is the procedure for the first cut. Subsequent cuts are made
|
</P>
|
||||||
|
<P>That is the procedure for the first cut. Subsequent cuts are made
|
||||||
recursively, in exactly the same manner. The subset of processors
|
recursively, in exactly the same manner. The subset of processors
|
||||||
assigned to each box make a new cut in the longest dimension of that
|
assigned to each box make a new cut in the longest dimension of that
|
||||||
box, splitting the box, the subset of processsors, and the atoms in
|
box, splitting the box, the subset of processsors, and the atoms in
|
||||||
the box in two. The recursion continues until every processor is
|
the box in two. The recursion continues until every processor is
|
||||||
assigned a sub-box of the entire simulation domain, and owns the atoms
|
assigned a sub-box of the entire simulation domain, and owns the atoms
|
||||||
in that sub-box.</p>
|
in that sub-box.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The <em>out</em> keyword writes a text file to the specified <em>filename</em> with
|
<HR>
|
||||||
|
|
||||||
|
<P>The <I>out</I> keyword writes a text file to the specified <I>filename</I> with
|
||||||
the results of the balancing operation. The file contains the bounds
|
the results of the balancing operation. The file contains the bounds
|
||||||
of the sub-domain for each processor after the balancing operation
|
of the sub-domain for each processor after the balancing operation
|
||||||
completes. The format of the file is compatible with the
|
completes. The format of the file is compatible with the
|
||||||
<a class="reference external" href="pizza">Pizza.py</a> <em>mdump</em> tool which has support for manipulating and
|
<A HREF = "pizza">Pizza.py</A> <I>mdump</I> tool which has support for manipulating and
|
||||||
visualizing mesh files. An example is shown here for a balancing by 4
|
visualizing mesh files. An example is shown here for a balancing by 4
|
||||||
processors for a 2d problem:</p>
|
processors for a 2d problem:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>ITEM: TIMESTEP
|
</P>
|
||||||
|
<PRE>ITEM: TIMESTEP
|
||||||
0
|
0
|
||||||
ITEM: NUMBER OF NODES
|
ITEM: NUMBER OF NODES
|
||||||
16
|
16
|
||||||
@ -454,90 +332,29 @@ ITEM: SQUARES
|
|||||||
1 1 1 2 3 4
|
1 1 1 2 3 4
|
||||||
2 1 5 6 7 8
|
2 1 5 6 7 8
|
||||||
3 1 9 10 11 12
|
3 1 9 10 11 12
|
||||||
4 1 13 14 15 16
|
4 1 13 14 15 16
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>The coordinates of all the vertices are listed in the NODES section, 5
|
||||||
<p>The coordinates of all the vertices are listed in the NODES section, 5
|
|
||||||
per processor. Note that the 4 sub-domains share vertices, so there
|
per processor. Note that the 4 sub-domains share vertices, so there
|
||||||
will be duplicate nodes in the list.</p>
|
will be duplicate nodes in the list.
|
||||||
<p>The “SQUARES” section lists the node IDs of the 4 vertices in a
|
</P>
|
||||||
rectangle for each processor (1 to 4).</p>
|
<P>The "SQUARES" section lists the node IDs of the 4 vertices in a
|
||||||
<p>For a 3d problem, the syntax is similar with 8 vertices listed for
|
rectangle for each processor (1 to 4).
|
||||||
each processor, instead of 4, and “SQUARES” replaced by “CUBES”.</p>
|
</P>
|
||||||
</div>
|
<P>For a 3d problem, the syntax is similar with 8 vertices listed for
|
||||||
<hr class="docutils" />
|
each processor, instead of 4, and "SQUARES" replaced by "CUBES".
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<HR>
|
||||||
<p>For 2d simulations, the <em>z</em> style cannot be used. Nor can a “z”
|
|
||||||
appear in <em>dimstr</em> for the <em>shift</em> style.</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="processors.html"><em>processors</em></a>, <a class="reference internal" href="fix_balance.html"><em>fix balance</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>For 2d simulations, the <I>z</I> style cannot be used. Nor can a "z"
|
||||||
<footer>
|
appear in <I>dimstr</I> for the <I>shift</I> style.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
<hr/>
|
</P>
|
||||||
|
<P><A HREF = "processors.html">processors</A>, <A HREF = "fix_balance.html">fix balance</A>
|
||||||
<div role="contentinfo">
|
</P>
|
||||||
<p>
|
<P><B>Default:</B> none
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
</HTML>
|
||||||
</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>
|
|
||||||
|
|||||||
394
doc/body.html
394
doc/body.html
@ -1,252 +1,138 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>Body particles — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>Body particles
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Overview:</B>
|
||||||
<li>Body particles</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P>This doc page is not about a LAMMPS input script command, but about
|
||||||
|
|
||||||
|
|
||||||
<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="body-particles">
|
|
||||||
<h1>Body particles<a class="headerlink" href="#body-particles" title="Permalink to this headline">¶</a></h1>
|
|
||||||
<p><strong>Overview:</strong></p>
|
|
||||||
<p>This doc page is not about a LAMMPS input script command, but about
|
|
||||||
body particles, which are generalized finite-size particles.
|
body particles, which are generalized finite-size particles.
|
||||||
Individual body particles can represent complex entities, such as
|
Individual body particles can represent complex entities, such as
|
||||||
surface meshes of discrete points, collections of sub-particles,
|
surface meshes of discrete points, collections of sub-particles,
|
||||||
deformable objects, etc. Note that other kinds of finite-size
|
deformable objects, etc. Note that other kinds of finite-size
|
||||||
spherical and aspherical particles are also supported by LAMMPS, such
|
spherical and aspherical particles are also supported by LAMMPS, such
|
||||||
as spheres, ellipsoids, line segments, and triangles, but they are
|
as spheres, ellipsoids, line segments, and triangles, but they are
|
||||||
simpler entities that body particles. See <a class="reference internal" href="Section_howto.html#howto-14"><span>Section_howto 14</span></a> for a general overview of all these
|
simpler entities that body particles. See <A HREF = "Section_howto.html#howto_14">Section_howto
|
||||||
particle types.</p>
|
14</A> for a general overview of all these
|
||||||
<p>Body particles are used via the <a class="reference internal" href="atom_style.html"><em>atom_style body</em></a>
|
particle types.
|
||||||
|
</P>
|
||||||
|
<P>Body particles are used via the <A HREF = "atom_style.html">atom_style body</A>
|
||||||
command. It takes a body style as an argument. The current body
|
command. It takes a body style as an argument. The current body
|
||||||
styles supported by LAMMPS are as follows. The name in the first
|
styles supported by LAMMPS are as follows. The name in the first
|
||||||
column is used as the <em>bstyle</em> argument for the <a class="reference internal" href="atom_style.html"><em>atom_style body</em></a> command.</p>
|
column is used as the <I>bstyle</I> argument for the <A HREF = "atom_style.html">atom_style
|
||||||
<table border="1" class="docutils">
|
body</A> command.
|
||||||
<colgroup>
|
</P>
|
||||||
<col width="28%" />
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
<col width="72%" />
|
<TR><TD ><I>nparticle</I> </TD><TD > rigid body with N sub-particles
|
||||||
</colgroup>
|
</TD></TR></TABLE></DIV>
|
||||||
<tbody valign="top">
|
|
||||||
<tr class="row-odd"><td><em>nparticle</em></td>
|
<P>The body style determines what attributes are stored for each body and
|
||||||
<td>rigid body with N sub-particles</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>The body style determines what attributes are stored for each body and
|
|
||||||
thus how they can be used to compute pairwise body/body or
|
thus how they can be used to compute pairwise body/body or
|
||||||
bond/non-body (point particle) interactions. More details of each
|
bond/non-body (point particle) interactions. More details of each
|
||||||
style are described below.</p>
|
style are described below.
|
||||||
<p>We hope to add more styles in the future. See <a class="reference internal" href="Section_modify.html#mod-12"><span>Section_modify 12</span></a> for details on how to add a new body
|
</P>
|
||||||
style to the code.</p>
|
<P>We hope to add more styles in the future. See <A HREF = "Section_modify.html#mod_12">Section_modify
|
||||||
<hr class="docutils" />
|
12</A> for details on how to add a new body
|
||||||
<p><strong>When to use body particles:</strong></p>
|
style to the code.
|
||||||
<p>You should not use body particles to model a rigid body made of
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P><B>When to use body particles:</B>
|
||||||
|
</P>
|
||||||
|
<P>You should not use body particles to model a rigid body made of
|
||||||
simpler particles (e.g. point, sphere, ellipsoid, line segment,
|
simpler particles (e.g. point, sphere, ellipsoid, line segment,
|
||||||
triangular particles), if the interaction between pairs of rigid
|
triangular particles), if the interaction between pairs of rigid
|
||||||
bodies is just the summation of pairwise interactions between the
|
bodies is just the summation of pairwise interactions between the
|
||||||
simpler particles. LAMMPS already supports this kind of model via the
|
simpler particles. LAMMPS already supports this kind of model via the
|
||||||
<a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a> command. Any of the numerous pair styles
|
<A HREF = "fix_rigid.html">fix rigid</A> command. Any of the numerous pair styles
|
||||||
that compute interactions between simpler particles can be used. The
|
that compute interactions between simpler particles can be used. The
|
||||||
<a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a> command time integrates the motion of the
|
<A HREF = "fix_rigid.html">fix rigid</A> command time integrates the motion of the
|
||||||
rigid bodies. All of the standard LAMMPS commands for thermostatting,
|
rigid bodies. All of the standard LAMMPS commands for thermostatting,
|
||||||
adding constraints, performing output, etc will operate as expected on
|
adding constraints, performing output, etc will operate as expected on
|
||||||
the simple particles.</p>
|
the simple particles.
|
||||||
<p>By contrast, when body particles are used, LAMMPS treats an entire
|
</P>
|
||||||
|
<P>By contrast, when body particles are used, LAMMPS treats an entire
|
||||||
body as a single particle for purposes of computing pairwise
|
body as a single particle for purposes of computing pairwise
|
||||||
interactions, building neighbor lists, migrating particles between
|
interactions, building neighbor lists, migrating particles between
|
||||||
processors, outputting particles to a dump file, etc. This means that
|
processors, outputting particles to a dump file, etc. This means that
|
||||||
interactions between pairs of bodies or between a body and non-body
|
interactions between pairs of bodies or between a body and non-body
|
||||||
(point) particle need to be encoded in an appropriate pair style. If
|
(point) particle need to be encoded in an appropriate pair style. If
|
||||||
such a pair style were to mimic the <a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a> model,
|
such a pair style were to mimic the <A HREF = "fix_rigid.html">fix rigid</A> model,
|
||||||
it would need to loop over the entire collection of interactions
|
it would need to loop over the entire collection of interactions
|
||||||
between pairs of simple particles within the two bodies, each time a
|
between pairs of simple particles within the two bodies, each time a
|
||||||
single body/body interaction was computed.</p>
|
single body/body interaction was computed.
|
||||||
<p>Thus it only makes sense to use body particles and develop such a pair
|
</P>
|
||||||
|
<P>Thus it only makes sense to use body particles and develop such a pair
|
||||||
style, when particle/particle interactions are more complex than what
|
style, when particle/particle interactions are more complex than what
|
||||||
the <a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a> command can already calculate. For
|
the <A HREF = "fix_rigid.html">fix rigid</A> command can already calculate. For
|
||||||
example, if particles have one or more of the following attributes:</p>
|
example, if particles have one or more of the following attributes:
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>represented by a surface mesh</li>
|
<UL><LI>represented by a surface mesh
|
||||||
<li>represented by a collection of geometric entities (e.g. planes + spheres)</li>
|
<LI>represented by a collection of geometric entities (e.g. planes + spheres)
|
||||||
<li>deformable</li>
|
<LI>deformable
|
||||||
<li>internal stress that induces fragmentation</li>
|
<LI>internal stress that induces fragmentation
|
||||||
</ul>
|
</UL>
|
||||||
<p>then the interaction between pairs of particles is likely to be more
|
<P>then the interaction between pairs of particles is likely to be more
|
||||||
complex than the summation of simple sub-particle interactions. An
|
complex than the summation of simple sub-particle interactions. An
|
||||||
example is contact or frictional forces between particles with planar
|
example is contact or frictional forces between particles with planar
|
||||||
sufaces that inter-penetrate.</p>
|
sufaces that inter-penetrate.
|
||||||
<p>These are additional LAMMPS commands that can be used with body
|
</P>
|
||||||
particles of different styles</p>
|
<P>These are additional LAMMPS commands that can be used with body
|
||||||
<table border="1" class="docutils">
|
particles of different styles
|
||||||
<colgroup>
|
</P>
|
||||||
<col width="48%" />
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
<col width="52%" />
|
<TR><TD ><A HREF = "fix_nve_body.html">fix nve/body</A> </TD><TD > integrate motion of a body particle</TD></TR>
|
||||||
</colgroup>
|
<TR><TD ><A HREF = "compute_body_local.html">compute body/local</A> </TD><TD > store sub-particle attributes of a body particle</TD></TR>
|
||||||
<tbody valign="top">
|
<TR><TD ><A HREF = "dump.html">dump local</A> </TD><TD > output sub-particle attributes of a body particle
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="fix_nve_body.html"><em>fix nve/body</em></a></td>
|
</TD></TR></TABLE></DIV>
|
||||||
<td>integrate motion of a body particle</td>
|
|
||||||
</tr>
|
<P>The pair styles defined for use with specific body styles are listed
|
||||||
<tr class="row-even"><td><a class="reference internal" href="compute_body_local.html"><em>compute body/local</em></a></td>
|
in the sections below.
|
||||||
<td>store sub-particle attributes of a body particle</td>
|
</P>
|
||||||
</tr>
|
<HR>
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="dump.html"><em>dump local</em></a></td>
|
|
||||||
<td>output sub-particle attributes of a body particle</td>
|
<P><B>Specifics of body style nparticle:</B>
|
||||||
</tr>
|
</P>
|
||||||
</tbody>
|
<P>The <I>nparticle</I> body style represents body particles as a rigid body
|
||||||
</table>
|
|
||||||
<p>The pair styles defined for use with specific body styles are listed
|
|
||||||
in the sections below.</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p><strong>Specifics of body style nparticle:</strong></p>
|
|
||||||
<p>The <em>nparticle</em> body style represents body particles as a rigid body
|
|
||||||
with a variable number N of sub-particles. It is provided as a
|
with a variable number N of sub-particles. It is provided as a
|
||||||
vanillia, prototypical example of a body particle, although as
|
vanillia, prototypical example of a body particle, although as
|
||||||
mentioned above, the <a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a> command already
|
mentioned above, the <A HREF = "fix_rigid.html">fix rigid</A> command already
|
||||||
duplicates its functionality.</p>
|
duplicates its functionality.
|
||||||
<p>The atom_style body command for this body style takes two additional
|
</P>
|
||||||
arguments:</p>
|
<P>The atom_style body command for this body style takes two additional
|
||||||
<div class="highlight-python"><div class="highlight"><pre>atom_style body nparticle Nmin Nmax
|
arguments:
|
||||||
|
</P>
|
||||||
|
<PRE>atom_style body nparticle Nmin Nmax
|
||||||
Nmin = minimum # of sub-particles in any body in the system
|
Nmin = minimum # of sub-particles in any body in the system
|
||||||
Nmax = maximum # of sub-particles in any body in the system
|
Nmax = maximum # of sub-particles in any body in the system
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>The Nmin and Nmax arguments are used to bound the size of data
|
||||||
<p>The Nmin and Nmax arguments are used to bound the size of data
|
structures used internally by each particle.
|
||||||
structures used internally by each particle.</p>
|
</P>
|
||||||
<p>When the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command reads a data file for this
|
<P>When the <A HREF = "read_data.html">read_data</A> command reads a data file for this
|
||||||
body style, the following information must be provided for each entry
|
body style, the following information must be provided for each entry
|
||||||
in the <em>Bodies</em> section of the data file:</p>
|
in the <I>Bodies</I> section of the data file:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>atom-ID 1 M
|
</P>
|
||||||
|
<PRE>atom-ID 1 M
|
||||||
N
|
N
|
||||||
ixx iyy izz ixy ixz iyz x1 y1 z1 ...
|
ixx iyy izz ixy ixz iyz x1 y1 z1 ...
|
||||||
...
|
...
|
||||||
... xN yN zN
|
... xN yN zN
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>N is the number of sub-particles in the body particle. M = 6 + 3*N.
|
||||||
<p>N is the number of sub-particles in the body particle. M = 6 + 3*N.
|
|
||||||
The integer line has a single value N. The floating point line(s)
|
The integer line has a single value N. The floating point line(s)
|
||||||
list 6 moments of inertia followed by the coordinates of the N
|
list 6 moments of inertia followed by the coordinates of the N
|
||||||
sub-particles (x1 to zN) as 3N values on as many lines as required.
|
sub-particles (x1 to zN) as 3N values on as many lines as required.
|
||||||
Note that this in not N lines, but 10 values per line; see the
|
Note that this in not N lines, but 10 values per line; see the
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command for details. The 6 moments of
|
<A HREF = "read_data.html">read_data</A> command for details. The 6 moments of
|
||||||
inertia (ixx,iyy,izz,ixy,ixz,iyz) should be the values consistent with
|
inertia (ixx,iyy,izz,ixy,ixz,iyz) should be the values consistent with
|
||||||
the current orientation of the rigid body around its center of mass.
|
the current orientation of the rigid body around its center of mass.
|
||||||
The values are with respect to the simulation box XYZ axes, not with
|
The values are with respect to the simulation box XYZ axes, not with
|
||||||
@ -254,84 +140,24 @@ respect to the prinicpal axes of the rigid body itself. LAMMPS
|
|||||||
performs the latter calculation internally. The coordinates of each
|
performs the latter calculation internally. The coordinates of each
|
||||||
sub-particle are specified as its x,y,z displacement from the
|
sub-particle are specified as its x,y,z displacement from the
|
||||||
center-of-mass of the body particle. The center-of-mass position of
|
center-of-mass of the body particle. The center-of-mass position of
|
||||||
the particle is specified by the x,y,z values in the <em>Atoms</em> section
|
the particle is specified by the x,y,z values in the <I>Atoms</I> section
|
||||||
of the data file.</p>
|
of the data file.
|
||||||
<p>The <a class="reference internal" href="pair_body.html"><em>pair_style body</em></a> command can be used with this
|
</P>
|
||||||
body style to compute body/body and body/non-body interactions.</p>
|
<P>The <A HREF = "pair_body.html">pair_style body</A> command can be used with this
|
||||||
<p>For output purposes via the <a class="reference internal" href="compute_body_local.html"><em>compute body/local</em></a> and <a class="reference internal" href="dump.html"><em>dump local</em></a>
|
body style to compute body/body and body/non-body interactions.
|
||||||
|
</P>
|
||||||
|
<P>For output purposes via the <A HREF = "compute_body_local.html">compute
|
||||||
|
body/local</A> and <A HREF = "dump.html">dump local</A>
|
||||||
commands, this body style produces one datum for each of the N
|
commands, this body style produces one datum for each of the N
|
||||||
sub-particles in a body particle. The datum has 3 values:</p>
|
sub-particles in a body particle. The datum has 3 values:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>1 = x position of sub-particle
|
</P>
|
||||||
|
<PRE>1 = x position of sub-particle
|
||||||
2 = y position of sub-particle
|
2 = y position of sub-particle
|
||||||
3 = z position of sub-particle
|
3 = z position of sub-particle
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>These values are the current position of the sub-particle within the
|
||||||
<p>These values are the current position of the sub-particle within the
|
|
||||||
simulation domain, not a displacement from the center-of-mass (COM) of
|
simulation domain, not a displacement from the center-of-mass (COM) of
|
||||||
the body particle itself. These values are calculated using the
|
the body particle itself. These values are calculated using the
|
||||||
current COM and orientiation of the body particle.</p>
|
current COM and orientiation of the body particle.
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,256 +1,88 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style class2 command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style class2 command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style class2/omp command
|
||||||
<li>bond_style class2 command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style class2
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style class2
|
||||||
</ul>
|
bond_coeff 1 1.0 100.0 80.0 80.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>class2</I> bond style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/bond_class2.jpg">
|
||||||
<div class="section" id="bond-style-class2-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>bond_style class2 command<a class="headerlink" href="#bond-style-class2-command" title="Permalink to this headline">¶</a></h1>
|
<P>where r0 is the equilibrium bond distance.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="bond-style-class2-omp-command">
|
<P>See <A HREF = "#Sun">(Sun)</A> for a description of the COMPASS class2 force field.
|
||||||
<h1>bond_style class2/omp command<a class="headerlink" href="#bond-style-class2-omp-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style class2
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
</pre></div>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<UL><LI>R0 (distance)
|
||||||
<div class="section" id="examples">
|
<LI>K2 (energy/distance^2)
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<LI>K3 (energy/distance^3)
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style class2
|
<LI>K4 (energy/distance^4)
|
||||||
bond_coeff 1 1.0 100.0 80.0 80.0
|
</UL>
|
||||||
</pre></div>
|
<HR>
|
||||||
</div>
|
|
||||||
</div>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>class2</em> bond style uses the potential</p>
|
|
||||||
<img alt="_images/bond_class2.jpg" class="align-center" src="_images/bond_class2.jpg" />
|
|
||||||
<p>where r0 is the equilibrium bond distance.</p>
|
|
||||||
<p>See <a class="reference internal" href="pair_modify.html#sun"><span>(Sun)</span></a> for a description of the COMPASS class2 force field.</p>
|
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>R0 (distance)</li>
|
|
||||||
<li>K2 (energy/distance^2)</li>
|
|
||||||
<li>K3 (energy/distance^3)</li>
|
|
||||||
<li>K4 (energy/distance^4)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the CLASS2
|
</P>
|
||||||
package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section
|
<HR>
|
||||||
for more info on packages.</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="sun"><strong>(Sun)</strong> Sun, J Phys Chem B 102, 7338-7364 (1998).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This bond style can only be used if LAMMPS was built with the CLASS2
|
||||||
|
package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A> section
|
||||||
|
for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
</div>
|
<A NAME = "Sun"></A>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Sun)</B> Sun, J Phys Chem B 102, 7338-7364 (1998).
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
</HTML>
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,276 +1,100 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_coeff command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_coeff command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>bond_coeff command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>bond_coeff N args
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>N = bond type (see asterisk form below)
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>args = coefficients for one or more bond types
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>bond_coeff 5 80.0 1.2
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="bond-coeff-command">
|
|
||||||
<span id="index-0"></span><h1>bond_coeff command<a class="headerlink" href="#bond-coeff-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>bond_coeff N args
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>N = bond type (see asterisk form below)</li>
|
|
||||||
<li>args = coefficients for one or more bond types</li>
|
|
||||||
</ul>
|
|
||||||
</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>bond_coeff 5 80.0 1.2
|
|
||||||
bond_coeff * 30.0 1.5 1.0 1.0
|
bond_coeff * 30.0 1.5 1.0 1.0
|
||||||
bond_coeff 1*4 30.0 1.5 1.0 1.0
|
bond_coeff 1*4 30.0 1.5 1.0 1.0
|
||||||
bond_coeff 1 harmonic 200.0 1.0
|
bond_coeff 1 harmonic 200.0 1.0
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Specify the bond force field coefficients for one or more bond types.
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Specify the bond force field coefficients for one or more bond types.
|
|
||||||
The number and meaning of the coefficients depends on the bond style.
|
The number and meaning of the coefficients depends on the bond style.
|
||||||
Bond coefficients can also be set in the data file read by the
|
Bond coefficients can also be set in the data file read by the
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command or in a restart file.</p>
|
<A HREF = "read_data.html">read_data</A> command or in a restart file.
|
||||||
<p>N can be specified in one of two ways. An explicit numeric value can
|
</P>
|
||||||
|
<P>N can be specified in one of two ways. An explicit numeric value can
|
||||||
be used, as in the 1st example above. Or a wild-card asterisk can be
|
be used, as in the 1st example above. Or a wild-card asterisk can be
|
||||||
used to set the coefficients for multiple bond types. This takes the
|
used to set the coefficients for multiple bond types. This takes the
|
||||||
form “*” or “<em>n” or “n</em>” or “m*n”. If N = the number of bond types,
|
form "*" or "*n" or "n*" or "m*n". If N = the number of bond types,
|
||||||
then an asterisk with no numeric values means all types from 1 to N. A
|
then an asterisk with no numeric values means all types from 1 to N. A
|
||||||
leading asterisk means all types from 1 to n (inclusive). A trailing
|
leading asterisk means all types from 1 to n (inclusive). A trailing
|
||||||
asterisk means all types from n to N (inclusive). A middle asterisk
|
asterisk means all types from n to N (inclusive). A middle asterisk
|
||||||
means all types from m to n (inclusive).</p>
|
means all types from m to n (inclusive).
|
||||||
<p>Note that using a bond_coeff command can override a previous setting
|
</P>
|
||||||
|
<P>Note that using a bond_coeff command can override a previous setting
|
||||||
for the same bond type. For example, these commands set the coeffs
|
for the same bond type. For example, these commands set the coeffs
|
||||||
for all bond types, then overwrite the coeffs for just bond type 2:</p>
|
for all bond types, then overwrite the coeffs for just bond type 2:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_coeff * 100.0 1.2
|
</P>
|
||||||
bond_coeff 2 200.0 1.2
|
<PRE>bond_coeff * 100.0 1.2
|
||||||
</pre></div>
|
bond_coeff 2 200.0 1.2
|
||||||
</div>
|
</PRE>
|
||||||
<p>A line in a data file that specifies bond coefficients uses the exact
|
<P>A line in a data file that specifies bond coefficients uses the exact
|
||||||
same format as the arguments of the bond_coeff command in an input
|
same format as the arguments of the bond_coeff command in an input
|
||||||
script, except that wild-card asterisks should not be used since
|
script, except that wild-card asterisks should not be used since
|
||||||
coefficients for all N types must be listed in the file. For example,
|
coefficients for all N types must be listed in the file. For example,
|
||||||
under the “Bond Coeffs” section of a data file, the line that
|
under the "Bond Coeffs" section of a data file, the line that
|
||||||
corresponds to the 1st example above would be listed as</p>
|
corresponds to the 1st example above would be listed as
|
||||||
<div class="highlight-python"><div class="highlight"><pre>5 80.0 1.2
|
</P>
|
||||||
</pre></div>
|
<PRE>5 80.0 1.2
|
||||||
</div>
|
</PRE>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
<p>Here is an alphabetic list of bond styles defined in LAMMPS. Click on
|
|
||||||
|
<P>Here is an alphabetic list of bond styles defined in LAMMPS. Click on
|
||||||
the style to display the formula it computes and coefficients
|
the style to display the formula it computes and coefficients
|
||||||
specified by the associated <a class="reference internal" href=""><em>bond_coeff</em></a> command.</p>
|
specified by the associated <A HREF = "bond_coeff.html">bond_coeff</A> command.
|
||||||
<p>Note that here are also additional bond styles submitted by users
|
</P>
|
||||||
|
<P>Note that here are also additional bond styles submitted by users
|
||||||
which are included in the LAMMPS distribution. The list of these with
|
which are included in the LAMMPS distribution. The list of these with
|
||||||
links to the individual styles are given in the bond section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
links to the individual styles are given in the bond section of <A HREF = "Section_commands.html#cmd_5">this
|
||||||
<ul class="simple">
|
page</A>.
|
||||||
<li><a class="reference internal" href="bond_none.html"><em>bond_style none</em></a> - turn off bonded interactions</li>
|
</P>
|
||||||
<li><a class="reference internal" href="bond_hybrid.html"><em>bond_style hybrid</em></a> - define multiple styles of bond interactions</li>
|
<UL><LI><A HREF = "bond_none.html">bond_style none</A> - turn off bonded interactions
|
||||||
<li><a class="reference internal" href="bond_class2.html"><em>bond_style class2</em></a> - COMPASS (class 2) bond</li>
|
<LI><A HREF = "bond_hybrid.html">bond_style hybrid</A> - define multiple styles of bond interactions
|
||||||
<li><a class="reference internal" href="bond_fene.html"><em>bond_style fene</em></a> - FENE (finite-extensible non-linear elastic) bond</li>
|
</UL>
|
||||||
<li><a class="reference internal" href="bond_fene_expand.html"><em>bond_style fene/expand</em></a> - FENE bonds with variable size particles</li>
|
<UL><LI><A HREF = "bond_class2.html">bond_style class2</A> - COMPASS (class 2) bond
|
||||||
<li><a class="reference internal" href="bond_harmonic.html"><em>bond_style harmonic</em></a> - harmonic bond</li>
|
<LI><A HREF = "bond_fene.html">bond_style fene</A> - FENE (finite-extensible non-linear elastic) bond
|
||||||
<li><a class="reference internal" href="bond_morse.html"><em>bond_style morse</em></a> - Morse bond</li>
|
<LI><A HREF = "bond_fene_expand.html">bond_style fene/expand</A> - FENE bonds with variable size particles
|
||||||
<li><a class="reference internal" href="bond_nonlinear.html"><em>bond_style nonlinear</em></a> - nonlinear bond</li>
|
<LI><A HREF = "bond_harmonic.html">bond_style harmonic</A> - harmonic bond
|
||||||
<li><a class="reference internal" href="bond_quartic.html"><em>bond_style quartic</em></a> - breakable quartic bond</li>
|
<LI><A HREF = "bond_morse.html">bond_style morse</A> - Morse bond
|
||||||
<li><a class="reference internal" href="bond_table.html"><em>bond_style table</em></a> - tabulated by bond length</li>
|
<LI><A HREF = "bond_nonlinear.html">bond_style nonlinear</A> - nonlinear bond
|
||||||
</ul>
|
<LI><A HREF = "bond_quartic.html">bond_style quartic</A> - breakable quartic bond
|
||||||
</div>
|
<LI><A HREF = "bond_table.html">bond_style table</A> - tabulated by bond length
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<HR>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>This command must come after the simulation box is defined by a
|
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a>, <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>, or
|
|
||||||
<a class="reference internal" href="create_box.html"><em>create_box</em></a> command.</p>
|
|
||||||
<p>A bond style must be defined before any bond coefficients are set,
|
|
||||||
either in the input script or in a data file.</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="bond_style.html"><em>bond_style</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This command must come after the simulation box is defined by a
|
||||||
<footer>
|
<A HREF = "read_data.html">read_data</A>, <A HREF = "read_restart.html">read_restart</A>, or
|
||||||
|
<A HREF = "create_box.html">create_box</A> command.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P>A bond style must be defined before any bond coefficients are set,
|
||||||
|
either in the input script or in a data file.
|
||||||
<div role="contentinfo">
|
</P>
|
||||||
<p>
|
<P><B>Related commands:</B>
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
<P><A HREF = "bond_style.html">bond_style</A>
|
||||||
</div>
|
</P>
|
||||||
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>.
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
</footer>
|
</HTML>
|
||||||
|
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,264 +1,96 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style fene command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style fene command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style fene/kk command
|
||||||
<li>bond_style fene command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<H3>bond_style fene/omp command
|
||||||
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</P>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE>bond_style fene
|
||||||
|
</PRE>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>bond_style fene
|
||||||
|
bond_coeff 1 30.0 1.5 1.0 1.0
|
||||||
</div>
|
</PRE>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P><B>Description:</B>
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<P>The <I>fene</I> bond style uses the potential
|
||||||
<div class="section" id="bond-style-fene-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>bond_style fene command<a class="headerlink" href="#bond-style-fene-command" title="Permalink to this headline">¶</a></h1>
|
<CENTER><IMG SRC = "Eqs/bond_fene.jpg">
|
||||||
</div>
|
</CENTER>
|
||||||
<div class="section" id="bond-style-fene-kk-command">
|
<P>to define a finite extensible nonlinear elastic (FENE) potential
|
||||||
<h1>bond_style fene/kk command<a class="headerlink" href="#bond-style-fene-kk-command" title="Permalink to this headline">¶</a></h1>
|
<A HREF = "#Kremer">(Kremer)</A>, used for bead-spring polymer models. The first
|
||||||
</div>
|
|
||||||
<div class="section" id="bond-style-fene-omp-command">
|
|
||||||
<h1>bond_style fene/omp command<a class="headerlink" href="#bond-style-fene-omp-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>bond_style fene
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>bond_style fene
|
|
||||||
bond_coeff 1 30.0 1.5 1.0 1.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>fene</em> bond style uses the potential</p>
|
|
||||||
<img alt="_images/bond_fene.jpg" class="align-center" src="_images/bond_fene.jpg" />
|
|
||||||
<p>to define a finite extensible nonlinear elastic (FENE) potential
|
|
||||||
<a class="reference internal" href="special_bonds.html#kremer"><span>(Kremer)</span></a>, used for bead-spring polymer models. The first
|
|
||||||
term is attractive, the 2nd Lennard-Jones term is repulsive. The
|
term is attractive, the 2nd Lennard-Jones term is repulsive. The
|
||||||
first term extends to R0, the maximum extent of the bond. The 2nd
|
first term extends to R0, the maximum extent of the bond. The 2nd
|
||||||
term is cutoff at 2^(1/6) sigma, the minimum of the LJ potential.</p>
|
term is cutoff at 2^(1/6) sigma, the minimum of the LJ potential.
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
</P>
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command as in the example above, or in
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<ul class="simple">
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>K (energy/distance^2)</li>
|
</P>
|
||||||
<li>R0 (distance)</li>
|
<UL><LI>K (energy/distance^2)
|
||||||
<li>epsilon (energy)</li>
|
<LI>R0 (distance)
|
||||||
<li>sigma (distance)</li>
|
<LI>epsilon (energy)
|
||||||
</ul>
|
<LI>sigma (distance)
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
<p>You typically should specify <a class="reference external" href="special_bonds.html"">special_bonds fene</a>
|
|
||||||
or <a class="reference internal" href="special_bonds.html"><em>special_bonds lj/coul 0 1 1</em></a> to use this bond
|
|
||||||
style. LAMMPS will issue a warning it that’s not the case.</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="kremer"><strong>(Kremer)</strong> Kremer, Grest, J Chem Phys, 92, 5057 (1990).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P>You typically should specify <A HREF = "special_bonds.html"">special_bonds fene</A>
|
||||||
|
or <A HREF = "special_bonds.html">special_bonds lj/coul 0 1 1</A> to use this bond
|
||||||
|
style. LAMMPS will issue a warning it that's not the case.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
</div>
|
<A NAME = "Kremer"></A>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Kremer)</B> Kremer, Grest, J Chem Phys, 92, 5057 (1990).
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
</HTML>
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,265 +1,99 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style fene/expand command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style fene/expand command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style fene/expand/omp command
|
||||||
<li>bond_style fene/expand command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style fene/expand
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style fene/expand
|
||||||
</ul>
|
bond_coeff 1 30.0 1.5 1.0 1.0 0.5
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>fene/expand</I> bond style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/bond_fene_expand.jpg">
|
||||||
<div class="section" id="bond-style-fene-expand-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>bond_style fene/expand command<a class="headerlink" href="#bond-style-fene-expand-command" title="Permalink to this headline">¶</a></h1>
|
<P>to define a finite extensible nonlinear elastic (FENE) potential
|
||||||
</div>
|
<A HREF = "#Kremer">(Kremer)</A>, used for bead-spring polymer models. The first
|
||||||
<div class="section" id="bond-style-fene-expand-omp-command">
|
term is attractive, the 2nd Lennard-Jones term is repulsive.
|
||||||
<h1>bond_style fene/expand/omp command<a class="headerlink" href="#bond-style-fene-expand-omp-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<P>The <I>fene/expand</I> bond style is similar to <I>fene</I> except that an extra
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
shift factor of delta (positive or negative) is added to <I>r</I> to
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style fene/expand
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>bond_style fene/expand
|
|
||||||
bond_coeff 1 30.0 1.5 1.0 1.0 0.5
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>fene/expand</em> bond style uses the potential</p>
|
|
||||||
<img alt="_images/bond_fene_expand.jpg" class="align-center" src="_images/bond_fene_expand.jpg" />
|
|
||||||
<p>to define a finite extensible nonlinear elastic (FENE) potential
|
|
||||||
<a class="reference internal" href="special_bonds.html#kremer"><span>(Kremer)</span></a>, used for bead-spring polymer models. The first
|
|
||||||
term is attractive, the 2nd Lennard-Jones term is repulsive.</p>
|
|
||||||
<p>The <em>fene/expand</em> bond style is similar to <em>fene</em> except that an extra
|
|
||||||
shift factor of delta (positive or negative) is added to <em>r</em> to
|
|
||||||
effectively change the bead size of the bonded atoms. The first term
|
effectively change the bead size of the bonded atoms. The first term
|
||||||
now extends to R0 + delta and the 2nd term is cutoff at 2^(1/6) sigma
|
now extends to R0 + delta and the 2nd term is cutoff at 2^(1/6) sigma
|
||||||
+ delta.</p>
|
+ delta.
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
</P>
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command as in the example above, or in
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<ul class="simple">
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>K (energy/distance^2)</li>
|
</P>
|
||||||
<li>R0 (distance)</li>
|
<UL><LI>K (energy/distance^2)
|
||||||
<li>epsilon (energy)</li>
|
<LI>R0 (distance)
|
||||||
<li>sigma (distance)</li>
|
<LI>epsilon (energy)
|
||||||
<li>delta (distance)</li>
|
<LI>sigma (distance)
|
||||||
</ul>
|
<LI>delta (distance)
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
<p>You typically should specify <a class="reference external" href="special_bonds.html"">special_bonds fene</a>
|
|
||||||
or <a class="reference internal" href="special_bonds.html"><em>special_bonds lj/coul 0 1 1</em></a> to use this bond
|
|
||||||
style. LAMMPS will issue a warning it that’s not the case.</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="kremer"><strong>(Kremer)</strong> Kremer, Grest, J Chem Phys, 92, 5057 (1990).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P>You typically should specify <A HREF = "special_bonds.html"">special_bonds fene</A>
|
||||||
|
or <A HREF = "special_bonds.html">special_bonds lj/coul 0 1 1</A> to use this bond
|
||||||
|
style. LAMMPS will issue a warning it that's not the case.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
</div>
|
<A NAME = "Kremer"></A>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Kremer)</B> Kremer, Grest, J Chem Phys, 92, 5057 (1990).
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
</HTML>
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,254 +1,81 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style harmonic command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style harmonic command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style harmonic/kk command
|
||||||
<li>bond_style harmonic command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<H3>bond_style harmonic/omp command
|
||||||
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</P>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE>bond_style harmonic
|
||||||
|
</PRE>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>bond_style harmonic
|
||||||
|
bond_coeff 5 80.0 1.2
|
||||||
</div>
|
</PRE>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P><B>Description:</B>
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<P>The <I>harmonic</I> bond style uses the potential
|
||||||
<div class="section" id="bond-style-harmonic-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>bond_style harmonic command<a class="headerlink" href="#bond-style-harmonic-command" title="Permalink to this headline">¶</a></h1>
|
<CENTER><IMG SRC = "Eqs/bond_harmonic.jpg">
|
||||||
</div>
|
</CENTER>
|
||||||
<div class="section" id="bond-style-harmonic-kk-command">
|
<P>where r0 is the equilibrium bond distance. Note that the usual 1/2
|
||||||
<h1>bond_style harmonic/kk command<a class="headerlink" href="#bond-style-harmonic-kk-command" title="Permalink to this headline">¶</a></h1>
|
factor is included in K.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="bond-style-harmonic-omp-command">
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
<h1>bond_style harmonic/omp command<a class="headerlink" href="#bond-style-harmonic-omp-command" title="Permalink to this headline">¶</a></h1>
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
<div class="section" id="syntax">
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style harmonic
|
</P>
|
||||||
</pre></div>
|
<UL><LI>K (energy/distance^2)
|
||||||
</div>
|
<LI>r0 (distance)
|
||||||
</div>
|
</UL>
|
||||||
<div class="section" id="examples">
|
<HR>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style harmonic
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
bond_coeff 5 80.0 1.2
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>harmonic</em> bond style uses the potential</p>
|
|
||||||
<img alt="_images/bond_harmonic.jpg" class="align-center" src="_images/bond_harmonic.jpg" />
|
|
||||||
<p>where r0 is the equilibrium bond distance. Note that the usual 1/2
|
|
||||||
factor is included in K.</p>
|
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>K (energy/distance^2)</li>
|
|
||||||
<li>r0 (distance)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,256 +1,85 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style harmonic/shift command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style harmonic/shift command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style harmonic/shift/omp command
|
||||||
<li>bond_style harmonic/shift command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style harmonic/shift
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style harmonic/shift
|
||||||
</ul>
|
bond_coeff 5 10.0 0.5 1.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>harmonic/shift</I> bond style is a shifted harmonic bond that uses
|
||||||
<div itemprop="articleBody">
|
the potential
|
||||||
|
</P>
|
||||||
<div class="section" id="bond-style-harmonic-shift-command">
|
<CENTER><IMG SRC = "Eqs/bond_harmonic_shift.jpg">
|
||||||
<span id="index-0"></span><h1>bond_style harmonic/shift command<a class="headerlink" href="#bond-style-harmonic-shift-command" title="Permalink to this headline">¶</a></h1>
|
</CENTER>
|
||||||
</div>
|
<P>where r0 is the equilibrium bond distance, and rc the critical distance.
|
||||||
<div class="section" id="bond-style-harmonic-shift-omp-command">
|
|
||||||
<h1>bond_style harmonic/shift/omp command<a class="headerlink" href="#bond-style-harmonic-shift-omp-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>bond_style harmonic/shift
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>bond_style harmonic/shift
|
|
||||||
bond_coeff 5 10.0 0.5 1.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>harmonic/shift</em> bond style is a shifted harmonic bond that uses
|
|
||||||
the potential</p>
|
|
||||||
<img alt="_images/bond_harmonic_shift.jpg" class="align-center" src="_images/bond_harmonic_shift.jpg" />
|
|
||||||
<p>where r0 is the equilibrium bond distance, and rc the critical distance.
|
|
||||||
The potential is -Umin at r0 and zero at rc. The spring constant is
|
The potential is -Umin at r0 and zero at rc. The spring constant is
|
||||||
k = Umin / [ 2 (r0-rc)^2].</p>
|
k = Umin / [ 2 (r0-rc)^2].
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
</P>
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command as in the example above, or in
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<ul class="simple">
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>Umin (energy)</li>
|
</P>
|
||||||
<li>r0 (distance)</li>
|
<UL><LI>Umin (energy)
|
||||||
<li>rc (distance)</li>
|
</UL>
|
||||||
</ul>
|
<UL><LI>r0 (distance)
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<UL><LI>rc (distance)
|
||||||
|
</UL>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
USER-MISC package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a>
|
<HR>
|
||||||
section for more info on packages.</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a>,
|
|
||||||
<a class="reference internal" href="bond_harmonic.html"><em>bond_harmonic</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
USER-MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
||||||
|
section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>,
|
||||||
<p>
|
<A HREF = "bond_harmonic.html">bond_harmonic</A>
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
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>.
|
</HTML>
|
||||||
|
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,257 +1,84 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style harmonic/shift/cut command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style harmonic/shift/cut command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style harmonic/shift/cut/omp command
|
||||||
<li>bond_style harmonic/shift/cut command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style harmonic/shift/cut
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style harmonic/shift/cut
|
||||||
</ul>
|
bond_coeff 5 10.0 0.5 1.0
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>harmonic/shift/cut</I> bond style is a shifted harmonic bond that
|
||||||
<div itemprop="articleBody">
|
uses the potential
|
||||||
|
</P>
|
||||||
<div class="section" id="bond-style-harmonic-shift-cut-command">
|
<CENTER><IMG SRC = "Eqs/bond_harmonic_shift_cut.jpg">
|
||||||
<span id="index-0"></span><h1>bond_style harmonic/shift/cut command<a class="headerlink" href="#bond-style-harmonic-shift-cut-command" title="Permalink to this headline">¶</a></h1>
|
</CENTER>
|
||||||
</div>
|
<P>where r0 is the equilibrium bond distance, and rc the critical distance.
|
||||||
<div class="section" id="bond-style-harmonic-shift-cut-omp-command">
|
The bond potential is zero for distances r > rc. The potential is -Umin
|
||||||
<h1>bond_style harmonic/shift/cut/omp command<a class="headerlink" href="#bond-style-harmonic-shift-cut-omp-command" title="Permalink to this headline">¶</a></h1>
|
at r0 and zero at rc. The spring constant is k = Umin / [ 2 (r0-rc)^2].
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style harmonic/shift/cut
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
</pre></div>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
</div>
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="examples">
|
<UL><LI>Umin (energy)
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<LI>r0 (distance)
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style harmonic/shift/cut
|
<LI>rc (distance)
|
||||||
bond_coeff 5 10.0 0.5 1.0
|
</UL>
|
||||||
</pre></div>
|
<HR>
|
||||||
</div>
|
|
||||||
</div>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>harmonic/shift/cut</em> bond style is a shifted harmonic bond that
|
|
||||||
uses the potential</p>
|
|
||||||
<img alt="_images/bond_harmonic_shift_cut.jpg" class="align-center" src="_images/bond_harmonic_shift_cut.jpg" />
|
|
||||||
<p>where r0 is the equilibrium bond distance, and rc the critical distance.
|
|
||||||
The bond potential is zero for distances r > rc. The potential is -Umin
|
|
||||||
at r0 and zero at rc. The spring constant is k = Umin / [ 2 (r0-rc)^2].</p>
|
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>Umin (energy)</li>
|
|
||||||
<li>r0 (distance)</li>
|
|
||||||
<li>rc (distance)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
USER-MISC package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a>
|
<HR>
|
||||||
section for more info on packages.</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a>,
|
|
||||||
<a class="reference internal" href="bond_harmonic.html"><em>bond_harmonic</em></a>,
|
|
||||||
<code class="xref doc docutils literal"><span class="pre">bond_harmonicshift</span></code></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
USER-MISC package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A>
|
||||||
|
section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>,
|
||||||
<p>
|
<A HREF = "bond_harmonic.html">bond_harmonic</A>,
|
||||||
© Copyright .
|
<A HREF = "bond_harmonicshift.html">bond_harmonicshift</A>
|
||||||
</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
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>.
|
</P>
|
||||||
|
</HTML>
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,257 +1,79 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style hybrid command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style hybrid command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>bond_style hybrid command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>bond_style hybrid style1 style2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>style1,style2 = list of one or more bond styles
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</UL>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style hybrid harmonic fene
|
||||||
</ul>
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="bond-style-hybrid-command">
|
|
||||||
<span id="index-0"></span><h1>bond_style hybrid command<a class="headerlink" href="#bond-style-hybrid-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>bond_style hybrid style1 style2 ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style1,style2 = list of one or more bond styles</li>
|
|
||||||
</ul>
|
|
||||||
</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>bond_style hybrid harmonic fene
|
|
||||||
bond_coeff 1 harmonic 80.0 1.2
|
bond_coeff 1 harmonic 80.0 1.2
|
||||||
bond_coeff 2* fene 30.0 1.5 1.0 1.0
|
bond_coeff 2* fene 30.0 1.5 1.0 1.0
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>The <I>hybrid</I> style enables the use of multiple bond styles in one
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>hybrid</em> style enables the use of multiple bond styles in one
|
|
||||||
simulation. A bond style is assigned to each bond type. For example,
|
simulation. A bond style is assigned to each bond type. For example,
|
||||||
bonds in a polymer flow (of bond type 1) could be computed with a
|
bonds in a polymer flow (of bond type 1) could be computed with a
|
||||||
<em>fene</em> potential and bonds in the wall boundary (of bond type 2) could
|
<I>fene</I> potential and bonds in the wall boundary (of bond type 2) could
|
||||||
be computed with a <em>harmonic</em> potential. The assignment of bond type
|
be computed with a <I>harmonic</I> potential. The assignment of bond type
|
||||||
to style is made via the <a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command or in
|
to style is made via the <A HREF = "bond_coeff.html">bond_coeff</A> command or in
|
||||||
the data file.</p>
|
the data file.
|
||||||
<p>In the bond_coeff commands, the name of a bond style must be added
|
</P>
|
||||||
|
<P>In the bond_coeff commands, the name of a bond style must be added
|
||||||
after the bond type, with the remaining coefficients being those
|
after the bond type, with the remaining coefficients being those
|
||||||
appropriate to that style. In the example above, the 2 bond_coeff
|
appropriate to that style. In the example above, the 2 bond_coeff
|
||||||
commands set bonds of bond type 1 to be computed with a <em>harmonic</em>
|
commands set bonds of bond type 1 to be computed with a <I>harmonic</I>
|
||||||
potential with coefficients 80.0, 1.2 for K, r0. All other bond types
|
potential with coefficients 80.0, 1.2 for K, r0. All other bond types
|
||||||
(2-N) are computed with a <em>fene</em> potential with coefficients 30.0,
|
(2-N) are computed with a <I>fene</I> potential with coefficients 30.0,
|
||||||
1.5, 1.0, 1.0 for K, R0, epsilon, sigma.</p>
|
1.5, 1.0, 1.0 for K, R0, epsilon, sigma.
|
||||||
<p>If bond coefficients are specified in the data file read via the
|
</P>
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command, then the same rule applies.
|
<P>If bond coefficients are specified in the data file read via the
|
||||||
E.g. “harmonic” or “fene” must be added after the bond type, for each
|
<A HREF = "read_data.html">read_data</A> command, then the same rule applies.
|
||||||
line in the “Bond Coeffs” section, e.g.</p>
|
E.g. "harmonic" or "fene" must be added after the bond type, for each
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Bond Coeffs
|
line in the "Bond Coeffs" section, e.g.
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>Bond Coeffs
|
||||||
<div class="highlight-python"><div class="highlight"><pre>1 harmonic 80.0 1.2
|
</PRE>
|
||||||
|
<PRE>1 harmonic 80.0 1.2
|
||||||
2 fene 30.0 1.5 1.0 1.0
|
2 fene 30.0 1.5 1.0 1.0
|
||||||
...
|
...
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>A bond style of <I>none</I> with no additional coefficients can be used in
|
||||||
<p>A bond style of <em>none</em> with no additional coefficients can be used in
|
|
||||||
place of a bond style, either in a input script bond_coeff command or
|
place of a bond style, either in a input script bond_coeff command or
|
||||||
in the data file, if you desire to turn off interactions for specific
|
in the data file, if you desire to turn off interactions for specific
|
||||||
bond types.</p>
|
bond types.
|
||||||
</div>
|
</P>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
<div class="section" id="restrictions">
|
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>This bond 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>Making LAMMPS</span></a> section for more info on packages.</p>
|
|
||||||
<p>Unlike other bond styles, the hybrid bond style does not store bond
|
|
||||||
coefficient info for individual sub-styles in a <a class="reference internal" href="restart.html"><em>binary restart files</em></a>. Thus when retarting a simulation from a restart
|
|
||||||
file, you need to re-specify bond_coeff commands.</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P>Unlike other bond styles, the hybrid bond style does not store bond
|
||||||
|
coefficient info for individual sub-styles in a <A HREF = "restart.html">binary restart
|
||||||
<div role="contentinfo">
|
files</A>. Thus when retarting a simulation from a restart
|
||||||
<p>
|
file, you need to re-specify bond_coeff commands.
|
||||||
© Copyright .
|
</P>
|
||||||
</p>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
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>.
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
|
</P>
|
||||||
</footer>
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,252 +1,80 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style morse command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style morse command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style morse/omp command
|
||||||
<li>bond_style morse command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style morse
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style morse
|
||||||
</ul>
|
bond_coeff 5 1.0 2.0 1.2
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>morse</I> bond style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/bond_morse.jpg">
|
||||||
<div class="section" id="bond-style-morse-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>bond_style morse command<a class="headerlink" href="#bond-style-morse-command" title="Permalink to this headline">¶</a></h1>
|
<P>where r0 is the equilibrium bond distance, alpha is a stiffness
|
||||||
</div>
|
parameter, and D determines the depth of the potential well.
|
||||||
<div class="section" id="bond-style-morse-omp-command">
|
</P>
|
||||||
<h1>bond_style morse/omp command<a class="headerlink" href="#bond-style-morse-omp-command" title="Permalink to this headline">¶</a></h1>
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
<div class="section" id="syntax">
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style morse
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<UL><LI>D (energy)
|
||||||
</div>
|
<LI>alpha (inverse distance)
|
||||||
<div class="section" id="examples">
|
<LI>r0 (distance)
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
</UL>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style morse
|
<HR>
|
||||||
bond_coeff 5 1.0 2.0 1.2
|
|
||||||
</pre></div>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>morse</em> bond style uses the potential</p>
|
|
||||||
<img alt="_images/bond_morse.jpg" class="align-center" src="_images/bond_morse.jpg" />
|
|
||||||
<p>where r0 is the equilibrium bond distance, alpha is a stiffness
|
|
||||||
parameter, and D determines the depth of the potential well.</p>
|
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>D (energy)</li>
|
|
||||||
<li>alpha (inverse distance)</li>
|
|
||||||
<li>r0 (distance)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,218 +1,34 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style none command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style none command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>bond_style none command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>bond_style none
|
||||||
|
</PRE>
|
||||||
|
<P><B>Examples:</B>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</P>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE>bond_style none
|
||||||
|
</PRE>
|
||||||
</li>
|
<P><B>Description:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<P>Using a bond style of none means bond forces are not computed, even if
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="bond-style-none-command">
|
|
||||||
<span id="index-0"></span><h1>bond_style none command<a class="headerlink" href="#bond-style-none-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>bond_style none
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>bond_style none
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Using a bond style of none means bond forces are not computed, even if
|
|
||||||
pairs of bonded atoms were listed in the data file read by the
|
pairs of bonded atoms were listed in the data file read by the
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command.</p>
|
<A HREF = "read_data.html">read_data</A> command.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B> none
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Related commands:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
<p><strong>Related commands:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,254 +1,86 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style nonlinear command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style nonlinear command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style nonlinear/omp command
|
||||||
<li>bond_style nonlinear command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style nonlinear
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style nonlinear
|
||||||
</ul>
|
bond_coeff 2 100.0 1.1 1.4
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>nonlinear</I> bond style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/bond_nonlinear.jpg">
|
||||||
<div class="section" id="bond-style-nonlinear-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>bond_style nonlinear command<a class="headerlink" href="#bond-style-nonlinear-command" title="Permalink to this headline">¶</a></h1>
|
<P>to define an anharmonic spring <A HREF = "#Rector">(Rector)</A> of equilibrium
|
||||||
</div>
|
length r0 and maximum extension lamda.
|
||||||
<div class="section" id="bond-style-nonlinear-omp-command">
|
</P>
|
||||||
<h1>bond_style nonlinear/omp command<a class="headerlink" href="#bond-style-nonlinear-omp-command" title="Permalink to this headline">¶</a></h1>
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
<div class="section" id="syntax">
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style nonlinear
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<UL><LI>epsilon (energy)
|
||||||
</div>
|
<LI>r0 (distance)
|
||||||
<div class="section" id="examples">
|
<LI>lamda (distance)
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
</UL>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>bond_style nonlinear
|
<HR>
|
||||||
bond_coeff 2 100.0 1.1 1.4
|
|
||||||
</pre></div>
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>nonlinear</em> bond style uses the potential</p>
|
|
||||||
<img alt="_images/bond_nonlinear.jpg" class="align-center" src="_images/bond_nonlinear.jpg" />
|
|
||||||
<p>to define an anharmonic spring <a class="reference internal" href="#rector"><span>(Rector)</span></a> of equilibrium
|
|
||||||
length r0 and maximum extension lamda.</p>
|
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></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"><em>read_data</em></a>
|
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>epsilon (energy)</li>
|
|
||||||
<li>r0 (distance)</li>
|
|
||||||
<li>lamda (distance)</li>
|
|
||||||
</ul>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p>Styles with a <em>cuda</em>, <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.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="rector"><strong>(Rector)</strong> Rector, Van Swol, Henderson, Molecular Physics, 82, 1009 (1994).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
</div>
|
<A NAME = "Rector"></A>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Rector)</B> Rector, Van Swol, Henderson, Molecular Physics, 82, 1009 (1994).
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
</HTML>
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,286 +1,119 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style quartic command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style quartic command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style quartic/omp command
|
||||||
<li>bond_style quartic command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style quartic
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>bond_style quartic
|
||||||
</ul>
|
bond_coeff 2 1200 -0.55 0.25 1.3 34.6878
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>The <I>quartic</I> bond style uses the potential
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/bond_quartic.jpg">
|
||||||
<div class="section" id="bond-style-quartic-command">
|
</CENTER>
|
||||||
<span id="index-0"></span><h1>bond_style quartic command<a class="headerlink" href="#bond-style-quartic-command" title="Permalink to this headline">¶</a></h1>
|
<P>to define a bond that can be broken as the simulation proceeds (e.g.
|
||||||
</div>
|
|
||||||
<div class="section" id="bond-style-quartic-omp-command">
|
|
||||||
<h1>bond_style quartic/omp command<a class="headerlink" href="#bond-style-quartic-omp-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>bond_style quartic
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>bond_style quartic
|
|
||||||
bond_coeff 2 1200 -0.55 0.25 1.3 34.6878
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The <em>quartic</em> bond style uses the potential</p>
|
|
||||||
<img alt="_images/bond_quartic.jpg" class="align-center" src="_images/bond_quartic.jpg" />
|
|
||||||
<p>to define a bond that can be broken as the simulation proceeds (e.g.
|
|
||||||
due to a polymer being stretched). The sigma and epsilon used in the
|
due to a polymer being stretched). The sigma and epsilon used in the
|
||||||
LJ portion of the formula are both set equal to 1.0 by LAMMPS.</p>
|
LJ portion of the formula are both set equal to 1.0 by LAMMPS.
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
</P>
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command as in the example above, or in
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
the data file or restart files read by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above, or in
|
||||||
or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands:</p>
|
the data file or restart files read by the <A HREF = "read_data.html">read_data</A>
|
||||||
<ul class="simple">
|
or <A HREF = "read_restart.html">read_restart</A> commands:
|
||||||
<li>K (energy/distance^4)</li>
|
</P>
|
||||||
<li>B1 (distance)</li>
|
<UL><LI>K (energy/distance^4)
|
||||||
<li>B2 (distance)</li>
|
<LI>B1 (distance)
|
||||||
<li>Rc (distance)</li>
|
<LI>B2 (distance)
|
||||||
<li>U0 (energy)</li>
|
<LI>Rc (distance)
|
||||||
</ul>
|
<LI>U0 (energy)
|
||||||
<p>This potential was constructed to mimic the FENE bond potential for
|
</UL>
|
||||||
|
<P>This potential was constructed to mimic the FENE bond potential for
|
||||||
coarse-grained polymer chains. When monomers with sigma = epsilon =
|
coarse-grained polymer chains. When monomers with sigma = epsilon =
|
||||||
1.0 are used, the following choice of parameters gives a quartic
|
1.0 are used, the following choice of parameters gives a quartic
|
||||||
potential that looks nearly like the FENE potential: K = 1200, B1 =
|
potential that looks nearly like the FENE potential: K = 1200, B1 =
|
||||||
-0.55, B2 = 0.25, Rc = 1.3, and U0 = 34.6878. Different parameters
|
-0.55, B2 = 0.25, Rc = 1.3, and U0 = 34.6878. Different parameters
|
||||||
can be specified using the <a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command, but
|
can be specified using the <A HREF = "bond_coeff.html">bond_coeff</A> command, but
|
||||||
you will need to choose them carefully so they form a suitable bond
|
you will need to choose them carefully so they form a suitable bond
|
||||||
potential.</p>
|
potential.
|
||||||
<p>Rc is the cutoff length at which the bond potential goes smoothly to a
|
</P>
|
||||||
local maximum. If a bond length ever becomes > Rc, LAMMPS “breaks”
|
<P>Rc is the cutoff length at which the bond potential goes smoothly to a
|
||||||
|
local maximum. If a bond length ever becomes > Rc, LAMMPS "breaks"
|
||||||
the bond, which means two things. First, the bond potential is turned
|
the bond, which means two things. First, the bond potential is turned
|
||||||
off by setting its type to 0, and is no longer computed. Second, a
|
off by setting its type to 0, and is no longer computed. Second, a
|
||||||
pairwise interaction between the two atoms is turned on, since they
|
pairwise interaction between the two atoms is turned on, since they
|
||||||
are no longer bonded.</p>
|
are no longer bonded.
|
||||||
<p>LAMMPS does the second task via a computational sleight-of-hand. It
|
</P>
|
||||||
|
<P>LAMMPS does the second task via a computational sleight-of-hand. It
|
||||||
subtracts the pairwise interaction as part of the bond computation.
|
subtracts the pairwise interaction as part of the bond computation.
|
||||||
When the bond breaks, the subtraction stops. For this to work, the
|
When the bond breaks, the subtraction stops. For this to work, the
|
||||||
pairwise interaction must always be computed by the
|
pairwise interaction must always be computed by the
|
||||||
<a class="reference internal" href="pair_style.html"><em>pair_style</em></a> command, whether the bond is broken or
|
<A HREF = "pair_style.html">pair_style</A> command, whether the bond is broken or
|
||||||
not. This means that <a class="reference internal" href="special_bonds.html"><em>special_bonds</em></a> must be set
|
not. This means that <A HREF = "special_bonds.html">special_bonds</A> must be set
|
||||||
to 1,1,1, as indicated as a restriction below.</p>
|
to 1,1,1, as indicated as a restriction below.
|
||||||
<p>Note that when bonds are dumped to a file via the <a class="reference internal" href="dump.html"><em>dump local</em></a> command, bonds with type 0 are not included. The
|
</P>
|
||||||
<a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a> command can also be used to query the
|
<P>Note that when bonds are dumped to a file via the <A HREF = "dump.html">dump
|
||||||
status of broken bonds or permanently delete them, e.g.:</p>
|
local</A> command, bonds with type 0 are not included. The
|
||||||
<div class="highlight-python"><div class="highlight"><pre>delete_bonds all stats
|
<A HREF = "delete_bonds.html">delete_bonds</A> command can also be used to query the
|
||||||
delete_bonds all bond 0 remove
|
status of broken bonds or permanently delete them, e.g.:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>delete_bonds all stats
|
||||||
<hr class="docutils" />
|
delete_bonds all bond 0 remove
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
</PRE>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
<p>The <em>quartic</em> style requires that <a class="reference internal" href="special_bonds.html"><em>special_bonds</em></a>
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
|
<P>The <I>quartic</I> style requires that <A HREF = "special_bonds.html">special_bonds</A>
|
||||||
parameters be set to 1,1,1. Three- and four-body interactions (angle,
|
parameters be set to 1,1,1. Three- and four-body interactions (angle,
|
||||||
dihedral, etc) cannot be used with <em>quartic</em> bonds.</p>
|
dihedral, etc) cannot be used with <I>quartic</I> bonds.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><B>Related commands:</B>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,285 +1,109 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>bond_style command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>bond_style style args
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>style = <I>none</I> or <I>hybrid</I> or <I>class2</I> or <I>fene</I> or <I>fene/expand</I> or <I>harmonic</I> or <I>morse</I> or <I>nonlinear</I> or <I>quartic</I>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</UL>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE> args = none for any style except <I>hybrid</I>
|
||||||
|
<I>hybrid</I> args = list of one or more styles
|
||||||
</li>
|
</PRE>
|
||||||
</ul>
|
<P><B>Examples:</B>
|
||||||
<hr/>
|
</P>
|
||||||
|
<PRE>bond_style harmonic
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="bond-style-command">
|
|
||||||
<span id="index-0"></span><h1>bond_style command<a class="headerlink" href="#bond-style-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>bond_style style args
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style = <em>none</em> or <em>hybrid</em> or <em>class2</em> or <em>fene</em> or <em>fene/expand</em> or <em>harmonic</em> or <em>morse</em> or <em>nonlinear</em> or <em>quartic</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
args = none for any style except <em>hybrid</em>
|
|
||||||
<em>hybrid</em> args = list of one or more styles
|
|
||||||
</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>bond_style harmonic
|
|
||||||
bond_style fene
|
bond_style fene
|
||||||
bond_style hybrid harmonic fene
|
bond_style hybrid harmonic fene
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Set the formula(s) LAMMPS uses to compute bond interactions between
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Set the formula(s) LAMMPS uses to compute bond interactions between
|
|
||||||
pairs of atoms. In LAMMPS, a bond differs from a pairwise
|
pairs of atoms. In LAMMPS, a bond differs from a pairwise
|
||||||
interaction, which are set via the <a class="reference internal" href="pair_style.html"><em>pair_style</em></a>
|
interaction, which are set via the <A HREF = "pair_style.html">pair_style</A>
|
||||||
command. Bonds are defined between specified pairs of atoms and
|
command. Bonds are defined between specified pairs of atoms and
|
||||||
remain in force for the duration of the simulation (unless the bond
|
remain in force for the duration of the simulation (unless the bond
|
||||||
breaks which is possible in some bond potentials). The list of bonded
|
breaks which is possible in some bond potentials). The list of bonded
|
||||||
atoms is read in by a <a class="reference internal" href="read_data.html"><em>read_data</em></a> or
|
atoms is read in by a <A HREF = "read_data.html">read_data</A> or
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a> command from a data or restart file.
|
<A HREF = "read_restart.html">read_restart</A> command from a data or restart file.
|
||||||
By contrast, pair potentials are typically defined between all pairs
|
By contrast, pair potentials are typically defined between all pairs
|
||||||
of atoms within a cutoff distance and the set of active interactions
|
of atoms within a cutoff distance and the set of active interactions
|
||||||
changes over time.</p>
|
changes over time.
|
||||||
<p>Hybrid models where bonds are computed using different bond potentials
|
</P>
|
||||||
can be setup using the <em>hybrid</em> bond style.</p>
|
<P>Hybrid models where bonds are computed using different bond potentials
|
||||||
<p>The coefficients associated with a bond style can be specified in a
|
can be setup using the <I>hybrid</I> bond style.
|
||||||
data or restart file or via the <a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command.</p>
|
</P>
|
||||||
<p>All bond potentials store their coefficient data in binary restart
|
<P>The coefficients associated with a bond style can be specified in a
|
||||||
files which means bond_style and <a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> commands
|
data or restart file or via the <A HREF = "bond_coeff.html">bond_coeff</A> command.
|
||||||
|
</P>
|
||||||
|
<P>All bond potentials store their coefficient data in binary restart
|
||||||
|
files which means bond_style and <A HREF = "bond_coeff.html">bond_coeff</A> commands
|
||||||
do not need to be re-specified in an input script that restarts a
|
do not need to be re-specified in an input script that restarts a
|
||||||
simulation. See the <a class="reference internal" href="read_restart.html"><em>read_restart</em></a> command for
|
simulation. See the <A HREF = "read_restart.html">read_restart</A> command for
|
||||||
details on how to do this. The one exception is that bond_style
|
details on how to do this. The one exception is that bond_style
|
||||||
<em>hybrid</em> only stores the list of sub-styles in the restart file; bond
|
<I>hybrid</I> only stores the list of sub-styles in the restart file; bond
|
||||||
coefficients need to be re-specified.</p>
|
coefficients need to be re-specified.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: When both a bond and pair style is defined, the
|
||||||
<p class="last">When both a bond and pair style is defined, the
|
<A HREF = "special_bonds.html">special_bonds</A> command often needs to be used to
|
||||||
<a class="reference internal" href="special_bonds.html"><em>special_bonds</em></a> command often needs to be used to
|
|
||||||
turn off (or weight) the pairwise interaction that would otherwise
|
turn off (or weight) the pairwise interaction that would otherwise
|
||||||
exist between 2 bonded atoms.</p>
|
exist between 2 bonded atoms.
|
||||||
</div>
|
</P>
|
||||||
<p>In the formulas listed for each bond style, <em>r</em> is the distance
|
<P>In the formulas listed for each bond style, <I>r</I> is the distance
|
||||||
between the 2 atoms in the bond.</p>
|
between the 2 atoms in the bond.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>Here is an alphabetic list of bond styles defined in LAMMPS. Click on
|
<HR>
|
||||||
|
|
||||||
|
<P>Here is an alphabetic list of bond styles defined in LAMMPS. Click on
|
||||||
the style to display the formula it computes and coefficients
|
the style to display the formula it computes and coefficients
|
||||||
specified by the associated <a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command.</p>
|
specified by the associated <A HREF = "bond_coeff.html">bond_coeff</A> command.
|
||||||
<p>Note that there are also additional bond styles submitted by users
|
</P>
|
||||||
|
<P>Note that there are also additional bond styles submitted by users
|
||||||
which are included in the LAMMPS distribution. The list of these with
|
which are included in the LAMMPS distribution. The list of these with
|
||||||
links to the individual styles are given in the bond section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
links to the individual styles are given in the bond section of <A HREF = "Section_commands.html#cmd_5">this
|
||||||
<ul class="simple">
|
page</A>.
|
||||||
<li><a class="reference internal" href="bond_none.html"><em>bond_style none</em></a> - turn off bonded interactions</li>
|
</P>
|
||||||
<li><a class="reference internal" href="bond_hybrid.html"><em>bond_style hybrid</em></a> - define multiple styles of bond interactions</li>
|
<UL><LI><A HREF = "bond_none.html">bond_style none</A> - turn off bonded interactions
|
||||||
<li><a class="reference internal" href="bond_class2.html"><em>bond_style class2</em></a> - COMPASS (class 2) bond</li>
|
<LI><A HREF = "bond_hybrid.html">bond_style hybrid</A> - define multiple styles of bond interactions
|
||||||
<li><a class="reference internal" href="bond_fene.html"><em>bond_style fene</em></a> - FENE (finite-extensible non-linear elastic) bond</li>
|
</UL>
|
||||||
<li><a class="reference internal" href="bond_fene_expand.html"><em>bond_style fene/expand</em></a> - FENE bonds with variable size particles</li>
|
<UL><LI><A HREF = "bond_class2.html">bond_style class2</A> - COMPASS (class 2) bond
|
||||||
<li><a class="reference internal" href="bond_harmonic.html"><em>bond_style harmonic</em></a> - harmonic bond</li>
|
<LI><A HREF = "bond_fene.html">bond_style fene</A> - FENE (finite-extensible non-linear elastic) bond
|
||||||
<li><a class="reference internal" href="bond_morse.html"><em>bond_style morse</em></a> - Morse bond</li>
|
<LI><A HREF = "bond_fene_expand.html">bond_style fene/expand</A> - FENE bonds with variable size particles
|
||||||
<li><a class="reference internal" href="bond_nonlinear.html"><em>bond_style nonlinear</em></a> - nonlinear bond</li>
|
<LI><A HREF = "bond_harmonic.html">bond_style harmonic</A> - harmonic bond
|
||||||
<li><a class="reference internal" href="bond_quartic.html"><em>bond_style quartic</em></a> - breakable quartic bond</li>
|
<LI><A HREF = "bond_morse.html">bond_style morse</A> - Morse bond
|
||||||
<li><a class="reference internal" href="bond_table.html"><em>bond_style table</em></a> - tabulated by bond length</li>
|
<LI><A HREF = "bond_nonlinear.html">bond_style nonlinear</A> - nonlinear bond
|
||||||
</ul>
|
<LI><A HREF = "bond_quartic.html">bond_style quartic</A> - breakable quartic bond
|
||||||
</div>
|
<LI><A HREF = "bond_table.html">bond_style table</A> - tabulated by bond length
|
||||||
<hr class="docutils" />
|
</UL>
|
||||||
<div class="section" id="restrictions">
|
<HR>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Bond styles can only be set for atom styles that allow bonds to be
|
<P><B>Restrictions:</B>
|
||||||
defined.</p>
|
</P>
|
||||||
<p>Most bond styles are part of the MOLECULE package. They are only
|
<P>Bond styles can only be set for atom styles that allow bonds to be
|
||||||
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 on packages.
|
defined.
|
||||||
|
</P>
|
||||||
|
<P>Most bond styles are part of the MOLECULE package. They are only
|
||||||
|
enabled if LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
The doc pages for individual bond potentials tell if it is part of a
|
The doc pages for individual bond potentials tell if it is part of a
|
||||||
package.</p>
|
package.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><B>Related commands:</B>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="default">
|
<P><B>Default:</B>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>bond_style none</p>
|
<P>bond_style none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,205 +1,90 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>bond_style table command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>bond_style table command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<H3>bond_style table/omp command
|
||||||
<li>bond_style table command</li>
|
</H3>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<P><B>Syntax:</B>
|
||||||
|
</P>
|
||||||
|
<PRE>bond_style table style N
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</PRE>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<UL><LI>style = <I>linear</I> or <I>spline</I> = method of interpolation
|
||||||
|
<LI>N = use N values in table
|
||||||
</li>
|
</UL>
|
||||||
</ul>
|
<P><B>Examples:</B>
|
||||||
<hr/>
|
</P>
|
||||||
|
<PRE>bond_style table linear 1000
|
||||||
</div>
|
bond_coeff 1 file.table ENTRY1
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</PRE>
|
||||||
<div itemprop="articleBody">
|
<P><B>Description:</B>
|
||||||
|
</P>
|
||||||
<div class="section" id="bond-style-table-command">
|
<P>Style <I>table</I> creates interpolation tables of length <I>N</I> from bond
|
||||||
<span id="index-0"></span><h1>bond_style table command<a class="headerlink" href="#bond-style-table-command" title="Permalink to this headline">¶</a></h1>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="bond-style-table-omp-command">
|
|
||||||
<h1>bond_style table/omp command<a class="headerlink" href="#bond-style-table-omp-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>bond_style table style N
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style = <em>linear</em> or <em>spline</em> = method of interpolation</li>
|
|
||||||
<li>N = use N values in table</li>
|
|
||||||
</ul>
|
|
||||||
</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>bond_style table linear 1000
|
|
||||||
bond_coeff 1 file.table ENTRY1
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Style <em>table</em> creates interpolation tables of length <em>N</em> from bond
|
|
||||||
potential and force values listed in a file(s) as a function of bond
|
potential and force values listed in a file(s) as a function of bond
|
||||||
length. The files are read by the <a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a>
|
length. The files are read by the <A HREF = "bond_coeff.html">bond_coeff</A>
|
||||||
command.</p>
|
command.
|
||||||
<p>The interpolation tables are created by fitting cubic splines to the
|
</P>
|
||||||
file values and interpolating energy and force values at each of <em>N</em>
|
<P>The interpolation tables are created by fitting cubic splines to the
|
||||||
|
file values and interpolating energy and force values at each of <I>N</I>
|
||||||
distances. During a simulation, these tables are used to interpolate
|
distances. During a simulation, these tables are used to interpolate
|
||||||
energy and force values as needed. The interpolation is done in one
|
energy and force values as needed. The interpolation is done in one
|
||||||
of 2 styles: <em>linear</em> or <em>spline</em>.</p>
|
of 2 styles: <I>linear</I> or <I>spline</I>.
|
||||||
<p>For the <em>linear</em> style, the bond length is used to find 2 surrounding
|
</P>
|
||||||
|
<P>For the <I>linear</I> style, the bond length is used to find 2 surrounding
|
||||||
table values from which an energy or force is computed by linear
|
table values from which an energy or force is computed by linear
|
||||||
interpolation.</p>
|
interpolation.
|
||||||
<p>For the <em>spline</em> style, a cubic spline coefficients are computed and
|
</P>
|
||||||
stored at each of the <em>N</em> values in the table. The bond length is
|
<P>For the <I>spline</I> style, a cubic spline coefficients are computed and
|
||||||
|
stored at each of the <I>N</I> values in the table. The bond length is
|
||||||
used to find the appropriate set of coefficients which are used to
|
used to find the appropriate set of coefficients which are used to
|
||||||
evaluate a cubic polynomial which computes the energy or force.</p>
|
evaluate a cubic polynomial which computes the energy or force.
|
||||||
<p>The following coefficients must be defined for each bond type via the
|
</P>
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command as in the example above.</p>
|
<P>The following coefficients must be defined for each bond type via the
|
||||||
<ul class="simple">
|
<A HREF = "bond_coeff.html">bond_coeff</A> command as in the example above.
|
||||||
<li>filename</li>
|
</P>
|
||||||
<li>keyword</li>
|
<UL><LI>filename
|
||||||
</ul>
|
<LI>keyword
|
||||||
<p>The filename specifies a file containing tabulated energy and force
|
</UL>
|
||||||
|
<P>The filename specifies a file containing tabulated energy and force
|
||||||
values. The keyword specifies a section of the file. The format of
|
values. The keyword specifies a section of the file. The format of
|
||||||
this file is described below.</p>
|
this file is described below.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The format of a tabulated file is as follows (without the
|
<HR>
|
||||||
parenthesized comments):</p>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c"># Bond potential for harmonic (one or more comment or blank lines)</span>
|
<P>The format of a tabulated file is as follows (without the
|
||||||
</pre></div>
|
parenthesized comments):
|
||||||
</div>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>HAM (keyword is the first text on line)
|
<PRE># Bond potential for harmonic (one or more comment or blank lines)
|
||||||
|
</PRE>
|
||||||
|
<PRE>HAM (keyword is the first text on line)
|
||||||
N 101 FP 0 0 EQ 0.5 (N, FP, EQ parameters)
|
N 101 FP 0 0 EQ 0.5 (N, FP, EQ parameters)
|
||||||
(blank line)
|
(blank line)
|
||||||
1 0.00 338.0000 1352.0000 (index, bond-length, energy, force)
|
1 0.00 338.0000 1352.0000 (index, bond-length, energy, force)
|
||||||
2 0.01 324.6152 1324.9600
|
2 0.01 324.6152 1324.9600
|
||||||
...
|
...
|
||||||
101 1.00 338.0000 -1352.0000
|
101 1.00 338.0000 -1352.0000
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>A section begins with a non-blank line whose 1st character is not a
|
||||||
<p>A section begins with a non-blank line whose 1st character is not a
|
"#"; blank lines or lines starting with "#" can be used as comments
|
||||||
“#”; blank lines or lines starting with “#” can be used as comments
|
|
||||||
between sections. The first line begins with a keyword which
|
between sections. The first line begins with a keyword which
|
||||||
identifies the section. The line can contain additional text, but the
|
identifies the section. The line can contain additional text, but the
|
||||||
initial text must match the argument specified in the
|
initial text must match the argument specified in the
|
||||||
<a class="reference internal" href="bond_coeff.html"><em>bond_coeff</em></a> command. The next line lists (in any
|
<A HREF = "bond_coeff.html">bond_coeff</A> command. The next line lists (in any
|
||||||
order) one or more parameters for the table. Each parameter is a
|
order) one or more parameters for the table. Each parameter is a
|
||||||
keyword followed by one or more numeric values.</p>
|
keyword followed by one or more numeric values.
|
||||||
<p>The parameter “N” is required and its value is the number of table
|
</P>
|
||||||
entries that follow. Note that this may be different than the <em>N</em>
|
<P>The parameter "N" is required and its value is the number of table
|
||||||
specified in the <a class="reference internal" href="bond_style.html"><em>bond_style table</em></a> command. Let
|
entries that follow. Note that this may be different than the <I>N</I>
|
||||||
Ntable = <em>N</em> in the bond_style command, and Nfile = “N” in the
|
specified in the <A HREF = "bond_style.html">bond_style table</A> command. Let
|
||||||
|
Ntable = <I>N</I> in the bond_style command, and Nfile = "N" in the
|
||||||
tabulated file. What LAMMPS does is a preliminary interpolation by
|
tabulated file. What LAMMPS does is a preliminary interpolation by
|
||||||
creating splines using the Nfile tabulated values as nodal points. It
|
creating splines using the Nfile tabulated values as nodal points. It
|
||||||
uses these to interpolate as needed to generate energy and force
|
uses these to interpolate as needed to generate energy and force
|
||||||
@ -208,117 +93,68 @@ Ntable are then used as described above, when computing energy and
|
|||||||
force for individual bond lengths. This means that if you want the
|
force for individual bond lengths. This means that if you want the
|
||||||
interpolation tables of length Ntable to match exactly what is in the
|
interpolation tables of length Ntable to match exactly what is in the
|
||||||
tabulated file (with effectively no preliminary interpolation), you
|
tabulated file (with effectively no preliminary interpolation), you
|
||||||
should set Ntable = Nfile.</p>
|
should set Ntable = Nfile.
|
||||||
<p>The “FP” parameter is optional. If used, it is followed by two values
|
</P>
|
||||||
|
<P>The "FP" parameter is optional. If used, it is followed by two values
|
||||||
fplo and fphi, which are the derivatives of the force at the innermost
|
fplo and fphi, which are the derivatives of the force at the innermost
|
||||||
and outermost bond lengths. These values are needed by the spline
|
and outermost bond lengths. These values are needed by the spline
|
||||||
construction routines. If not specified by the “FP” parameter, they
|
construction routines. If not specified by the "FP" parameter, they
|
||||||
are estimated (less accurately) by the first two and last two force
|
are estimated (less accurately) by the first two and last two force
|
||||||
values in the table.</p>
|
values in the table.
|
||||||
<p>The “EQ” parameter is also optional. If used, it is followed by a the
|
</P>
|
||||||
equilibrium bond length, which is used, for example, by the <a class="reference internal" href="fix_shake.html"><em>fix shake</em></a> command. If not used, the equilibrium bond
|
<P>The "EQ" parameter is also optional. If used, it is followed by a the
|
||||||
length is set to 0.0.</p>
|
equilibrium bond length, which is used, for example, by the <A HREF = "fix_shake.html">fix
|
||||||
<p>Following a blank line, the next N lines list the tabulated values.
|
shake</A> command. If not used, the equilibrium bond
|
||||||
|
length is set to 0.0.
|
||||||
|
</P>
|
||||||
|
<P>Following a blank line, the next N lines list the tabulated values.
|
||||||
On each line, the 1st value is the index from 1 to N, the 2nd value is
|
On each line, the 1st value is the index from 1 to N, the 2nd value is
|
||||||
the bond length r (in distance units), the 3rd value is the energy (in
|
the bond length r (in distance units), the 3rd value is the energy (in
|
||||||
energy units), and the 4th is the force (in force units). The bond
|
energy units), and the 4th is the force (in force units). The bond
|
||||||
lengths must range from a LO value to a HI value, and increase from
|
lengths must range from a LO value to a HI value, and increase from
|
||||||
one line to the next. If the actual bond length is ever smaller than
|
one line to the next. If the actual bond length is ever smaller than
|
||||||
the LO value or larger than the HI value, then the bond energy and
|
the LO value or larger than the HI value, then the bond energy and
|
||||||
force is evaluated as if the bond were the LO or HI length.</p>
|
force is evaluated as if the bond were the LO or HI length.
|
||||||
<p>Note that one file can contain many sections, each with a tabulated
|
</P>
|
||||||
|
<P>Note that one file can contain many sections, each with a tabulated
|
||||||
potential. LAMMPS reads the file section by section until it finds
|
potential. LAMMPS reads the file section by section until it finds
|
||||||
one that matches the specified keyword.</p>
|
one that matches the specified keyword.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>Styles with a <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, or <em>opt</em> suffix are
|
<HR>
|
||||||
|
|
||||||
|
<P>Styles with a <I>cuda</I>, <I>gpu</I>, <I>intel</I>, <I>kk</I>, <I>omp</I>, or <I>opt</I> suffix are
|
||||||
functionally the same as the corresponding style without the suffix.
|
functionally the same as the corresponding style without the suffix.
|
||||||
They have been optimized to run faster, depending on your available
|
They have been optimized to run faster, depending on your available
|
||||||
hardware, as discussed in <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a>
|
hardware, as discussed in <A HREF = "Section_accelerate.html">Section_accelerate</A>
|
||||||
of the manual. The accelerated styles take the same arguments and
|
of the manual. The accelerated styles take the same arguments and
|
||||||
should produce the same results, except for round-off and precision
|
should produce the same results, except for round-off and precision
|
||||||
issues.</p>
|
issues.
|
||||||
<p>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
</P>
|
||||||
|
<P>These accelerated styles are part of the USER-CUDA, GPU, USER-INTEL,
|
||||||
KOKKOS, USER-OMP and OPT packages, respectively. They are only
|
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>Making LAMMPS</span></a> section for more info.</p>
|
enabled if LAMMPS was built with those packages. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>You can specify the accelerated styles explicitly in your input script
|
LAMMPS</A> section for more info.
|
||||||
by including their suffix, or you can use the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a> when you invoke LAMMPS, or you can
|
</P>
|
||||||
use the <a class="reference internal" href="suffix.html"><em>suffix</em></a> command in your input script.</p>
|
<P>You can specify the accelerated styles explicitly in your input script
|
||||||
<p>See <a class="reference internal" href="Section_accelerate.html"><em>Section_accelerate</em></a> of the manual for
|
by including their suffix, or you can use the <A HREF = "Section_start.html#start_7">-suffix command-line
|
||||||
more instructions on how to use the accelerated styles effectively.</p>
|
switch</A> when you invoke LAMMPS, or you can
|
||||||
</div>
|
use the <A HREF = "suffix.html">suffix</A> command in your input script.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>See <A HREF = "Section_accelerate.html">Section_accelerate</A> of the manual for
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
more instructions on how to use the accelerated styles effectively.
|
||||||
<p>This bond style can only be used if LAMMPS was built with the
|
</P>
|
||||||
MOLECULE package (which it is by default). See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section for more info on packages.</p>
|
<HR>
|
||||||
</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="bond_coeff.html"><em>bond_coeff</em></a>, <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a></p>
|
|
||||||
<p><strong>Default:</strong> none</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<P><B>Restrictions:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P>This bond style can only be used if LAMMPS was built with the
|
||||||
<footer>
|
MOLECULE package (which it is by default). See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info on packages.
|
||||||
|
</P>
|
||||||
<hr/>
|
<P><B>Related commands:</B>
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
<P><A HREF = "bond_coeff.html">bond_coeff</A>, <A HREF = "delete_bonds.html">delete_bonds</A>
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<P><B>Default:</B> none
|
||||||
</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
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>
|
|
||||||
|
|||||||
@ -1,282 +1,106 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>boundary command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>boundary command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>boundary command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>boundary x y z
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>x,y,z = <I>p</I> or <I>s</I> or <I>f</I> or <I>m</I>, one or two letters
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE> <I>p</I> is periodic
|
||||||
|
<I>f</I> is non-periodic and fixed
|
||||||
</li>
|
<I>s</I> is non-periodic and shrink-wrapped
|
||||||
</ul>
|
<I>m</I> is non-periodic and shrink-wrapped with a minimum value
|
||||||
<hr/>
|
</PRE>
|
||||||
|
|
||||||
</div>
|
</UL>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P><B>Examples:</B>
|
||||||
<div itemprop="articleBody">
|
</P>
|
||||||
|
<PRE>boundary p p f
|
||||||
<div class="section" id="boundary-command">
|
|
||||||
<span id="index-0"></span><h1>boundary command<a class="headerlink" href="#boundary-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>boundary x y z
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>x,y,z = <em>p</em> or <em>s</em> or <em>f</em> or <em>m</em>, one or two letters</li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>p</em> is periodic
|
|
||||||
<em>f</em> is non-periodic and fixed
|
|
||||||
<em>s</em> is non-periodic and shrink-wrapped
|
|
||||||
<em>m</em> is non-periodic and shrink-wrapped with a minimum value
|
|
||||||
</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>boundary p p f
|
|
||||||
boundary p fs p
|
boundary p fs p
|
||||||
boundary s f fm
|
boundary s f fm
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Set the style of boundaries for the global simulation box in each
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Set the style of boundaries for the global simulation box in each
|
|
||||||
dimension. A single letter assigns the same style to both the lower
|
dimension. A single letter assigns the same style to both the lower
|
||||||
and upper face of the box. Two letters assigns the first style to the
|
and upper face of the box. Two letters assigns the first style to the
|
||||||
lower face and the second style to the upper face. The initial size
|
lower face and the second style to the upper face. The initial size
|
||||||
of the simulation box is set by the <a class="reference internal" href="read_data.html"><em>read_data</em></a>,
|
of the simulation box is set by the <A HREF = "read_data.html">read_data</A>,
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a>, or <a class="reference internal" href="create_box.html"><em>create_box</em></a>
|
<A HREF = "read_restart.html">read_restart</A>, or <A HREF = "create_box.html">create_box</A>
|
||||||
commands.</p>
|
commands.
|
||||||
<p>The style <em>p</em> means the box is periodic, so that particles interact
|
</P>
|
||||||
|
<P>The style <I>p</I> means the box is periodic, so that particles interact
|
||||||
across the boundary, and they can exit one end of the box and re-enter
|
across the boundary, and they can exit one end of the box and re-enter
|
||||||
the other end. A periodic dimension can change in size due to
|
the other end. A periodic dimension can change in size due to
|
||||||
constant pressure boundary conditions or box deformation (see the <a class="reference internal" href="fix_nh.html"><em>fix npt</em></a> and <a class="reference internal" href="fix_deform.html"><em>fix deform</em></a> commands). The <em>p</em>
|
constant pressure boundary conditions or box deformation (see the <A HREF = "fix_nh.html">fix
|
||||||
style must be applied to both faces of a dimension.</p>
|
npt</A> and <A HREF = "fix_deform.html">fix deform</A> commands). The <I>p</I>
|
||||||
<p>The styles <em>f</em>, <em>s</em>, and <em>m</em> mean the box is non-periodic, so that
|
style must be applied to both faces of a dimension.
|
||||||
|
</P>
|
||||||
|
<P>The styles <I>f</I>, <I>s</I>, and <I>m</I> mean the box is non-periodic, so that
|
||||||
particles do not interact across the boundary and do not move from one
|
particles do not interact across the boundary and do not move from one
|
||||||
side of the box to the other.</p>
|
side of the box to the other.
|
||||||
<p>For style <em>f</em>, the position of the face is fixed. If an atom moves
|
</P>
|
||||||
|
<P>For style <I>f</I>, the position of the face is fixed. If an atom moves
|
||||||
outside the face it will be deleted on the next timestep that
|
outside the face it will be deleted on the next timestep that
|
||||||
reneighboring occurs. This will typically generate an error unless
|
reneighboring occurs. This will typically generate an error unless
|
||||||
you have set the <a class="reference internal" href="thermo_modify.html"><em>thermo_modify lost</em></a> option to
|
you have set the <A HREF = "thermo_modify.html">thermo_modify lost</A> option to
|
||||||
allow for lost atoms.</p>
|
allow for lost atoms.
|
||||||
<p>For style <em>s</em>, the position of the face is set so as to encompass the
|
</P>
|
||||||
|
<P>For style <I>s</I>, the position of the face is set so as to encompass the
|
||||||
atoms in that dimension (shrink-wrapping), no matter how far they
|
atoms in that dimension (shrink-wrapping), no matter how far they
|
||||||
move.</p>
|
move.
|
||||||
<p>For style <em>m</em>, shrink-wrapping occurs, but is bounded by the value
|
</P>
|
||||||
|
<P>For style <I>m</I>, shrink-wrapping occurs, but is bounded by the value
|
||||||
specified in the data or restart file or set by the
|
specified in the data or restart file or set by the
|
||||||
<a class="reference internal" href="create_box.html"><em>create_box</em></a> command. For example, if the upper z
|
<A HREF = "create_box.html">create_box</A> command. For example, if the upper z
|
||||||
face has a value of 50.0 in the data file, the face will always be
|
face has a value of 50.0 in the data file, the face will always be
|
||||||
positioned at 50.0 or above, even if the maximum z-extent of all the
|
positioned at 50.0 or above, even if the maximum z-extent of all the
|
||||||
atoms becomes less than 50.0. This can be useful if you start a
|
atoms becomes less than 50.0. This can be useful if you start a
|
||||||
simulation with an empty box or if you wish to leave room on one side
|
simulation with an empty box or if you wish to leave room on one side
|
||||||
of the box, e.g. for atoms to evaporate from a surface.</p>
|
of the box, e.g. for atoms to evaporate from a surface.
|
||||||
<p>For triclinic (non-orthogonal) simulation boxes, if the 2nd dimension
|
</P>
|
||||||
|
<P>For triclinic (non-orthogonal) simulation boxes, if the 2nd dimension
|
||||||
of a tilt factor (e.g. y for xy) is periodic, then the periodicity is
|
of a tilt factor (e.g. y for xy) is periodic, then the periodicity is
|
||||||
enforced with the tilt factor offset. If the 1st dimension is
|
enforced with the tilt factor offset. If the 1st dimension is
|
||||||
shrink-wrapped, then the shrink wrapping is applied to the tilted box
|
shrink-wrapped, then the shrink wrapping is applied to the tilted box
|
||||||
face, to encompass the atoms. E.g. for a positive xy tilt, the xlo
|
face, to encompass the atoms. E.g. for a positive xy tilt, the xlo
|
||||||
and xhi faces of the box are planes tilting in the +y direction as y
|
and xhi faces of the box are planes tilting in the +y direction as y
|
||||||
increases. These tilted planes are shrink-wrapped around the atoms to
|
increases. These tilted planes are shrink-wrapped around the atoms to
|
||||||
determine the x extent of the box.</p>
|
determine the x extent of the box.
|
||||||
<p>See <a class="reference internal" href="Section_howto.html#howto-12"><span>Section_howto 12</span></a> of the doc pages
|
</P>
|
||||||
|
<P>See <A HREF = "Section_howto.html#howto_12">Section_howto 12</A> of the doc pages
|
||||||
for a geometric description of triclinic boxes, as defined by LAMMPS,
|
for a geometric description of triclinic boxes, as defined by LAMMPS,
|
||||||
and how to transform these parameters to and from other commonly used
|
and how to transform these parameters to and from other commonly used
|
||||||
triclinic representations.</p>
|
triclinic representations.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>This command cannot be used after the simulation box is defined by a
|
<P>This command cannot be used after the simulation box is defined by a
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> or <a class="reference internal" href="create_box.html"><em>create_box</em></a> command or
|
<A HREF = "read_data.html">read_data</A> or <A HREF = "create_box.html">create_box</A> command or
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a> command. See the
|
<A HREF = "read_restart.html">read_restart</A> command. See the
|
||||||
<a class="reference internal" href="change_box.html"><em>change_box</em></a> command for how to change the simulation
|
<A HREF = "change_box.html">change_box</A> command for how to change the simulation
|
||||||
box boundaries after it has been defined.</p>
|
box boundaries after it has been defined.
|
||||||
<p>For 2d simulations, the z dimension must be periodic.</p>
|
</P>
|
||||||
</div>
|
<P>For 2d simulations, the z dimension must be periodic.
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><B>Related commands:</B>
|
||||||
<p>See the <a class="reference internal" href="thermo_modify.html"><em>thermo_modify</em></a> command for a discussion
|
</P>
|
||||||
of lost atoms.</p>
|
<P>See the <A HREF = "thermo_modify.html">thermo_modify</A> command for a discussion
|
||||||
</div>
|
of lost atoms.
|
||||||
<div class="section" id="default">
|
</P>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
<P><B>Default:</B>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>boundary p p p
|
</P>
|
||||||
</pre></div>
|
<PRE>boundary p p p
|
||||||
</div>
|
</PRE>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
299
doc/box.html
299
doc/box.html
@ -1,246 +1,69 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>box command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>box command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>box command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>box keyword value ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>one or more keyword/value pairs may be appended
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>keyword = <I>tilt</I>
|
||||||
|
|
||||||
</li>
|
<PRE> <I>tilt</I> value = <I>small</I> or <I>large</I>
|
||||||
</ul>
|
</PRE>
|
||||||
<hr/>
|
|
||||||
|
</UL>
|
||||||
</div>
|
<P><B>Examples:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<PRE>box tilt large
|
||||||
|
box tilt small
|
||||||
<div class="section" id="box-command">
|
</PRE>
|
||||||
<span id="index-0"></span><h1>box command<a class="headerlink" href="#box-command" title="Permalink to this headline">¶</a></h1>
|
<P><B>Description:</B>
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<P>Set attributes of the simulation box.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>box keyword value ...
|
</P>
|
||||||
</pre></div>
|
<P>For triclinic (non-orthogonal) simulation boxes, the <I>tilt</I> keyword
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>one or more keyword/value pairs may be appended</li>
|
|
||||||
<li>keyword = <em>tilt</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>tilt</em> value = <em>small</em> or <em>large</em>
|
|
||||||
</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>box tilt large
|
|
||||||
box tilt small
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Set attributes of the simulation box.</p>
|
|
||||||
<p>For triclinic (non-orthogonal) simulation boxes, the <em>tilt</em> keyword
|
|
||||||
allows simulation domains to be created with arbitrary tilt factors,
|
allows simulation domains to be created with arbitrary tilt factors,
|
||||||
e.g. via the <a class="reference internal" href="create_box.html"><em>create_box</em></a> or
|
e.g. via the <A HREF = "create_box.html">create_box</A> or
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> commands. Tilt factors determine how
|
<A HREF = "read_data.html">read_data</A> commands. Tilt factors determine how
|
||||||
skewed the triclinic box is; see <a class="reference internal" href="Section_howto.html#howto-12"><span>this section</span></a> of the manual for a discussion of
|
skewed the triclinic box is; see <A HREF = "Section_howto.html#howto_12">this
|
||||||
triclinic boxes in LAMMPS.</p>
|
section</A> of the manual for a discussion of
|
||||||
<p>LAMMPS normally requires that no tilt factor can skew the box more
|
triclinic boxes in LAMMPS.
|
||||||
|
</P>
|
||||||
|
<P>LAMMPS normally requires that no tilt factor can skew the box more
|
||||||
than half the distance of the parallel box length, which is the 1st
|
than half the distance of the parallel box length, which is the 1st
|
||||||
dimension in the tilt factor (x for xz). If <em>tilt</em> is set to
|
dimension in the tilt factor (x for xz). If <I>tilt</I> is set to
|
||||||
<em>small</em>, which is the default, then an error will be
|
<I>small</I>, which is the default, then an error will be
|
||||||
generated if a box is created which exceeds this limit. If <em>tilt</em>
|
generated if a box is created which exceeds this limit. If <I>tilt</I>
|
||||||
is set to <em>large</em>, then no limit is enforced. You can create
|
is set to <I>large</I>, then no limit is enforced. You can create
|
||||||
a box with any tilt factors you wish.</p>
|
a box with any tilt factors you wish.
|
||||||
<p>Note that if a simulation box has a large tilt factor, LAMMPS will run
|
</P>
|
||||||
|
<P>Note that if a simulation box has a large tilt factor, LAMMPS will run
|
||||||
less efficiently, due to the large volume of communication needed to
|
less efficiently, due to the large volume of communication needed to
|
||||||
acquire ghost atoms around a processor’s irregular-shaped sub-domain.
|
acquire ghost atoms around a processor's irregular-shaped sub-domain.
|
||||||
For extreme values of tilt, LAMMPS may also lose atoms and generate an
|
For extreme values of tilt, LAMMPS may also lose atoms and generate an
|
||||||
error.</p>
|
error.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>This command cannot be used after the simulation box is defined by a
|
<P>This command cannot be used after the simulation box is defined by a
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> or <a class="reference internal" href="create_box.html"><em>create_box</em></a> command or
|
<A HREF = "read_data.html">read_data</A> or <A HREF = "create_box.html">create_box</A> command or
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a> command.</p>
|
<A HREF = "read_restart.html">read_restart</A> command.
|
||||||
<p><strong>Related commands:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B> none
|
||||||
<div class="section" id="default">
|
</P>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
<P><B>Default:</B>
|
||||||
<p>The default value is tilt = small.</p>
|
</P>
|
||||||
</div>
|
<P>The default value is tilt = small.
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,188 +1,69 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>change_box command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>change_box command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>change_box command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>change_box group-ID parameter args ... keyword args ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>group-ID = ID of group of atoms to (optionally) displace
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>one or more parameter/arg pairs may be appended
|
||||||
|
|
||||||
</li>
|
<PRE>parameter = <I>x</I> or <I>y</I> or <I>z</I> or <I>xy</I> or <I>xz</I> or <I>yz</I> or <I>boundary</I> or <I>ortho</I> or <I>triclinic</I> or <I>set</I> or <I>remap</I>
|
||||||
</ul>
|
<I>x</I>, <I>y</I>, <I>z</I> args = style value(s)
|
||||||
<hr/>
|
style = <I>final</I> or <I>delta</I> or <I>scale</I> or <I>volume</I>
|
||||||
|
<I>final</I> values = lo hi
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="change-box-command">
|
|
||||||
<span id="index-0"></span><h1>change_box command<a class="headerlink" href="#change-box-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>change_box group-ID parameter args ... keyword args ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>group-ID = ID of group of atoms to (optionally) displace</li>
|
|
||||||
<li>one or more parameter/arg pairs may be appended</li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
parameter = <em>x</em> or <em>y</em> or <em>z</em> or <em>xy</em> or <em>xz</em> or <em>yz</em> or <em>boundary</em> or <em>ortho</em> or <em>triclinic</em> or <em>set</em> or <em>remap</em>
|
|
||||||
<em>x</em>, <em>y</em>, <em>z</em> args = style value(s)
|
|
||||||
style = <em>final</em> or <em>delta</em> or <em>scale</em> or <em>volume</em>
|
|
||||||
<em>final</em> values = lo hi
|
|
||||||
lo hi = box boundaries after displacement (distance units)
|
lo hi = box boundaries after displacement (distance units)
|
||||||
<em>delta</em> values = dlo dhi
|
<I>delta</I> values = dlo dhi
|
||||||
dlo dhi = change in box boundaries after displacement (distance units)
|
dlo dhi = change in box boundaries after displacement (distance units)
|
||||||
<em>scale</em> values = factor
|
<I>scale</I> values = factor
|
||||||
factor = multiplicative factor for change in box length after displacement
|
factor = multiplicative factor for change in box length after displacement
|
||||||
<em>volume</em> value = none = adjust this dim to preserve volume of system
|
<I>volume</I> value = none = adjust this dim to preserve volume of system
|
||||||
<em>xy</em>, <em>xz</em>, <em>yz</em> args = style value
|
<I>xy</I>, <I>xz</I>, <I>yz</I> args = style value
|
||||||
style = <em>final</em> or <em>delta</em>
|
style = <I>final</I> or <I>delta</I>
|
||||||
<em>final</em> value = tilt
|
<I>final</I> value = tilt
|
||||||
tilt = tilt factor after displacement (distance units)
|
tilt = tilt factor after displacement (distance units)
|
||||||
<em>delta</em> value = dtilt
|
<I>delta</I> value = dtilt
|
||||||
dtilt = change in tilt factor after displacement (distance units)
|
dtilt = change in tilt factor after displacement (distance units)
|
||||||
<em>boundary</em> args = x y z
|
<I>boundary</I> args = x y z
|
||||||
x,y,z = <em>p</em> or <em>s</em> or <em>f</em> or <em>m</em>, one or two letters
|
x,y,z = <I>p</I> or <I>s</I> or <I>f</I> or <I>m</I>, one or two letters
|
||||||
<em>p</em> is periodic
|
<I>p</I> is periodic
|
||||||
<em>f</em> is non-periodic and fixed
|
<I>f</I> is non-periodic and fixed
|
||||||
<em>s</em> is non-periodic and shrink-wrapped
|
<I>s</I> is non-periodic and shrink-wrapped
|
||||||
<em>m</em> is non-periodic and shrink-wrapped with a minimum value
|
<I>m</I> is non-periodic and shrink-wrapped with a minimum value
|
||||||
<em>ortho</em> args = none = change box to orthogonal
|
<I>ortho</I> args = none = change box to orthogonal
|
||||||
<em>triclinic</em> args = none = change box to triclinic
|
<I>triclinic</I> args = none = change box to triclinic
|
||||||
<em>set</em> args = none = store state of current box
|
<I>set</I> args = none = store state of current box
|
||||||
<em>remap</em> args = none = remap atom coords from last saved state to current box
|
<I>remap</I> args = none = remap atom coords from last saved state to current box
|
||||||
</pre>
|
</PRE>
|
||||||
<ul class="simple">
|
<LI>zero or more keyword/value pairs may be appended
|
||||||
<li>zero or more keyword/value pairs may be appended</li>
|
|
||||||
<li>keyword = <em>units</em></li>
|
<LI>keyword = <I>units</I>
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
<PRE> <I>units</I> value = <I>lattice</I> or <I>box</I>
|
||||||
<em>units</em> value = <em>lattice</em> or <em>box</em>
|
|
||||||
lattice = distances are defined in lattice units
|
lattice = distances are defined in lattice units
|
||||||
box = distances are defined in simulation box units
|
box = distances are defined in simulation box units
|
||||||
</pre>
|
</PRE>
|
||||||
</div>
|
|
||||||
<div class="section" id="examples">
|
</UL>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
<P><B>Examples:</B>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>change_box all xy final -2.0 z final 0.0 5.0 boundary p p f remap units box
|
</P>
|
||||||
change_box all x scale 1.1 y volume z volume remap
|
<PRE>change_box all xy final -2.0 z final 0.0 5.0 boundary p p f remap units box
|
||||||
</pre></div>
|
change_box all x scale 1.1 y volume z volume remap
|
||||||
</div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div class="section" id="description">
|
</P>
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
<P>Change the volume and/or shape and/or boundary conditions for the
|
||||||
<p>Change the volume and/or shape and/or boundary conditions for the
|
|
||||||
simulation box. Orthogonal simulation boxes have 3 adjustable size
|
simulation box. Orthogonal simulation boxes have 3 adjustable size
|
||||||
parameters (x,y,z). Triclinic (non-orthogonal) simulation boxes have
|
parameters (x,y,z). Triclinic (non-orthogonal) simulation boxes have
|
||||||
6 adjustable size/shape parameters (x,y,z,xy,xz,yz). Any or all of
|
6 adjustable size/shape parameters (x,y,z,xy,xz,yz). Any or all of
|
||||||
@ -190,59 +71,60 @@ them can be adjusted independently by this command. Thus it can be
|
|||||||
used to expand or contract a box, or to apply a shear strain to a
|
used to expand or contract a box, or to apply a shear strain to a
|
||||||
non-orthogonal box. It can also be used to change the boundary
|
non-orthogonal box. It can also be used to change the boundary
|
||||||
conditions for the simulation box, similar to the
|
conditions for the simulation box, similar to the
|
||||||
<a class="reference internal" href="boundary.html"><em>boundary</em></a> command.</p>
|
<A HREF = "boundary.html">boundary</A> command.
|
||||||
<p>The size and shape of the initial simulation box are specified by the
|
</P>
|
||||||
<a class="reference internal" href="create_box.html"><em>create_box</em></a> or <a class="reference internal" href="read_data.html"><em>read_data</em></a> or
|
<P>The size and shape of the initial simulation box are specified by the
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a> command used to setup the simulation.
|
<A HREF = "create_box.html">create_box</A> or <A HREF = "read_data.html">read_data</A> or
|
||||||
|
<A HREF = "read_restart.html">read_restart</A> command used to setup the simulation.
|
||||||
The size and shape may be altered by subsequent runs, e.g. by use of
|
The size and shape may be altered by subsequent runs, e.g. by use of
|
||||||
the <a class="reference internal" href="fix_nh.html"><em>fix npt</em></a> or <a class="reference internal" href="fix_deform.html"><em>fix deform</em></a> commands.
|
the <A HREF = "fix_nh.html">fix npt</A> or <A HREF = "fix_deform.html">fix deform</A> commands.
|
||||||
The <a class="reference internal" href="create_box.html"><em>create_box</em></a>, <a class="reference internal" href="read_data.html"><em>read data</em></a>, and
|
The <A HREF = "create_box.html">create_box</A>, <A HREF = "read_data.html">read data</A>, and
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a> commands also determine whether the
|
<A HREF = "read_restart.html">read_restart</A> commands also determine whether the
|
||||||
simulation box is orthogonal or triclinic and their doc pages explain
|
simulation box is orthogonal or triclinic and their doc pages explain
|
||||||
the meaning of the xy,xz,yz tilt factors.</p>
|
the meaning of the xy,xz,yz tilt factors.
|
||||||
<p>See <a class="reference internal" href="Section_howto.html#howto-12"><span>Section_howto 12</span></a> of the doc pages
|
</P>
|
||||||
|
<P>See <A HREF = "Section_howto.html#howto_12">Section_howto 12</A> of the doc pages
|
||||||
for a geometric description of triclinic boxes, as defined by LAMMPS,
|
for a geometric description of triclinic boxes, as defined by LAMMPS,
|
||||||
and how to transform these parameters to and from other commonly used
|
and how to transform these parameters to and from other commonly used
|
||||||
triclinic representations.</p>
|
triclinic representations.
|
||||||
<p>The keywords used in this command are applied sequentially to the
|
</P>
|
||||||
simulation box and the atoms in it, in the order specified.</p>
|
<P>The keywords used in this command are applied sequentially to the
|
||||||
<p>Before the sequence of keywords are invoked, the current box
|
simulation box and the atoms in it, in the order specified.
|
||||||
size/shape is stored, in case a <em>remap</em> keyword is used to map the
|
</P>
|
||||||
|
<P>Before the sequence of keywords are invoked, the current box
|
||||||
|
size/shape is stored, in case a <I>remap</I> keyword is used to map the
|
||||||
atom coordinates from a previously stored box size/shape to the
|
atom coordinates from a previously stored box size/shape to the
|
||||||
current one.</p>
|
current one.
|
||||||
<p>After all the keywords have been processed, any shrink-wrap boundary
|
</P>
|
||||||
conditions are invoked (see the <a class="reference internal" href="boundary.html"><em>boundary</em></a> command)
|
<P>After all the keywords have been processed, any shrink-wrap boundary
|
||||||
|
conditions are invoked (see the <A HREF = "boundary.html">boundary</A> command)
|
||||||
which may change simulation box boundaries, and atoms are migrated to
|
which may change simulation box boundaries, and atoms are migrated to
|
||||||
new owning processors.</p>
|
new owning processors.
|
||||||
<p>IMPORTANT_NOTE: This means that you cannot use the change_box command
|
</P>
|
||||||
|
<P>IMPORTANT_NOTE: This means that you cannot use the change_box command
|
||||||
to enlarge a shrink-wrapped box, e.g. to make room to insert more
|
to enlarge a shrink-wrapped box, e.g. to make room to insert more
|
||||||
atoms via the <a class="reference internal" href="create_atoms.html"><em>create_atoms</em></a> command, because the
|
atoms via the <A HREF = "create_atoms.html">create_atoms</A> command, because the
|
||||||
simulation box will be re-shrink-wrapped before the change_box command
|
simulation box will be re-shrink-wrapped before the change_box command
|
||||||
completes. Instead you could do something like this, assuming the
|
completes. Instead you could do something like this, assuming the
|
||||||
simulation box is non-periodic and atoms extend from 0 to 20 in all
|
simulation box is non-periodic and atoms extend from 0 to 20 in all
|
||||||
dimensions:</p>
|
dimensions:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>change_box all x final -10 20
|
</P>
|
||||||
create_atoms 1 single -5 5 5 # this will fail to insert an atom
|
<PRE>change_box all x final -10 20
|
||||||
</pre></div>
|
create_atoms 1 single -5 5 5 # this will fail to insert an atom
|
||||||
</div>
|
</PRE>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>change_box all x final -10 20 boundary f s s
|
<PRE>change_box all x final -10 20 boundary f s s
|
||||||
create_atoms 1 single -5 5 5
|
create_atoms 1 single -5 5 5
|
||||||
change_box boundary s s s # this will work
|
change_box boundary s s s # this will work
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>IMPORTANT NOTE: Unlike the earlier "displace_box" version of this
|
||||||
<div class="admonition warning">
|
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">Unlike the earlier “displace_box” version of this
|
|
||||||
command, atom remapping is NOT performed by default. This command
|
command, atom remapping is NOT performed by default. This command
|
||||||
allows remapping to be done in a more general way, exactly when you
|
allows remapping to be done in a more general way, exactly when you
|
||||||
specify it (zero or more times) in the sequence of transformations.
|
specify it (zero or more times) in the sequence of transformations.
|
||||||
Thus if you do not use the <em>remap</em> keyword, atom coordinates will not
|
Thus if you do not use the <I>remap</I> keyword, atom coordinates will not
|
||||||
be changed even if the box size/shape changes. If a uniformly
|
be changed even if the box size/shape changes. If a uniformly
|
||||||
strained state is desired, the <em>remap</em> keyword should be specified.</p>
|
strained state is desired, the <I>remap</I> keyword should be specified.
|
||||||
</div>
|
</P>
|
||||||
<div class="admonition warning">
|
<P>IMPORTANT NOTE: It is possible to lose atoms with this command.
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">It is possible to lose atoms with this command.
|
|
||||||
E.g. by changing the box without remapping the atoms, and having atoms
|
E.g. by changing the box without remapping the atoms, and having atoms
|
||||||
end up outside of non-periodic boundaries. It is also possible to
|
end up outside of non-periodic boundaries. It is also possible to
|
||||||
alter bonds between atoms straddling a boundary in bad ways. E.g. by
|
alter bonds between atoms straddling a boundary in bad ways. E.g. by
|
||||||
@ -250,95 +132,101 @@ converting a boundary from periodic to non-periodic. It is also
|
|||||||
possible when remapping atoms to put them (nearly) on top of each
|
possible when remapping atoms to put them (nearly) on top of each
|
||||||
other. E.g. by converting a boundary from non-periodic to periodic.
|
other. E.g. by converting a boundary from non-periodic to periodic.
|
||||||
All of these will typically lead to bad dynamics and/or generate error
|
All of these will typically lead to bad dynamics and/or generate error
|
||||||
messages.</p>
|
messages.
|
||||||
</div>
|
</P>
|
||||||
<div class="admonition warning">
|
<P>IMPORTANT NOTE: The simulation box size/shape can be changed by
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">The simulation box size/shape can be changed by
|
|
||||||
arbitrarily large amounts by this command. This is not a problem,
|
arbitrarily large amounts by this command. This is not a problem,
|
||||||
except that the mapping of processors to the simulation box is not
|
except that the mapping of processors to the simulation box is not
|
||||||
changed from its initial 3d configuration; see the
|
changed from its initial 3d configuration; see the
|
||||||
<a class="reference internal" href="processors.html"><em>processors</em></a> command. Thus, if the box size/shape
|
<A HREF = "processors.html">processors</A> command. Thus, if the box size/shape
|
||||||
changes dramatically, the mapping of processors to the simulation box
|
changes dramatically, the mapping of processors to the simulation box
|
||||||
may not end up as optimal as the initial mapping attempted to be.</p>
|
may not end up as optimal as the initial mapping attempted to be.
|
||||||
</div>
|
</P>
|
||||||
<div class="admonition warning">
|
<P>IMPORTANT NOTE: Because the keywords used in this command are applied
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">Because the keywords used in this command are applied
|
|
||||||
one at a time to the simulation box and the atoms in it, care must be
|
one at a time to the simulation box and the atoms in it, care must be
|
||||||
taken with triclinic cells to avoid exceeding the limits on skew after
|
taken with triclinic cells to avoid exceeding the limits on skew after
|
||||||
each transformation in the sequence. If skew is exceeded before the
|
each transformation in the sequence. If skew is exceeded before the
|
||||||
final transformation this can be avoided by changing the order of the
|
final transformation this can be avoided by changing the order of the
|
||||||
sequence, or breaking the transformation into two or more smaller
|
sequence, or breaking the transformation into two or more smaller
|
||||||
transformations. For more information on the allowed limits for box
|
transformations. For more information on the allowed limits for box
|
||||||
skew see the discussion on triclinic boxes on <a class="reference internal" href="Section_howto.html#howto-12"><span>this page</span></a>.</p>
|
skew see the discussion on triclinic boxes on <A HREF = "Section_howto.html#howto_12">this
|
||||||
</div>
|
page</A>.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>For the <em>x</em>, <em>y</em>, and <em>z</em> parameters, this is the meaning of their
|
<HR>
|
||||||
styles and values.</p>
|
|
||||||
<p>For style <em>final</em>, the final lo and hi box boundaries of a dimension
|
<P>For the <I>x</I>, <I>y</I>, and <I>z</I> parameters, this is the meaning of their
|
||||||
|
styles and values.
|
||||||
|
</P>
|
||||||
|
<P>For style <I>final</I>, the final lo and hi box boundaries of a dimension
|
||||||
are specified. The values can be in lattice or box distance units.
|
are specified. The values can be in lattice or box distance units.
|
||||||
See the discussion of the units keyword below.</p>
|
See the discussion of the units keyword below.
|
||||||
<p>For style <em>delta</em>, plus or minus changes in the lo/hi box boundaries
|
</P>
|
||||||
|
<P>For style <I>delta</I>, plus or minus changes in the lo/hi box boundaries
|
||||||
of a dimension are specified. The values can be in lattice or box
|
of a dimension are specified. The values can be in lattice or box
|
||||||
distance units. See the discussion of the units keyword below.</p>
|
distance units. See the discussion of the units keyword below.
|
||||||
<p>For style <em>scale</em>, a multiplicative factor to apply to the box length
|
</P>
|
||||||
|
<P>For style <I>scale</I>, a multiplicative factor to apply to the box length
|
||||||
of a dimension is specified. For example, if the initial box length
|
of a dimension is specified. For example, if the initial box length
|
||||||
is 10, and the factor is 1.1, then the final box length will be 11. A
|
is 10, and the factor is 1.1, then the final box length will be 11. A
|
||||||
factor less than 1.0 means compression.</p>
|
factor less than 1.0 means compression.
|
||||||
<p>The <em>volume</em> style changes the specified dimension in such a way that
|
</P>
|
||||||
|
<P>The <I>volume</I> style changes the specified dimension in such a way that
|
||||||
the overall box volume remains constant with respect to the operation
|
the overall box volume remains constant with respect to the operation
|
||||||
performed by the preceding keyword. The <em>volume</em> style can only be
|
performed by the preceding keyword. The <I>volume</I> style can only be
|
||||||
used following a keyword that changed the volume, which is any of the
|
used following a keyword that changed the volume, which is any of the
|
||||||
<em>x</em>, <em>y</em>, <em>z</em> keywords. If the preceding keyword “key” had a <em>volume</em>
|
<I>x</I>, <I>y</I>, <I>z</I> keywords. If the preceding keyword "key" had a <I>volume</I>
|
||||||
style, then both it and the current keyword apply to the keyword
|
style, then both it and the current keyword apply to the keyword
|
||||||
preceding “key”. I.e. this sequence of keywords is allowed:</p>
|
preceding "key". I.e. this sequence of keywords is allowed:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>change_box all x scale 1.1 y volume z volume
|
</P>
|
||||||
</pre></div>
|
<PRE>change_box all x scale 1.1 y volume z volume
|
||||||
</div>
|
</PRE>
|
||||||
<p>The <em>volume</em> style changes the associated dimension so that the
|
<P>The <I>volume</I> style changes the associated dimension so that the
|
||||||
overall box volume is unchanged relative to its value before the
|
overall box volume is unchanged relative to its value before the
|
||||||
preceding keyword was invoked.</p>
|
preceding keyword was invoked.
|
||||||
<p>If the following command is used, then the z box length will shrink by
|
</P>
|
||||||
the same 1.1 factor the x box length was increased by:</p>
|
<P>If the following command is used, then the z box length will shrink by
|
||||||
<div class="highlight-python"><div class="highlight"><pre>change_box all x scale 1.1 z volume
|
the same 1.1 factor the x box length was increased by:
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>change_box all x scale 1.1 z volume
|
||||||
<p>If the following command is used, then the y,z box lengths will each
|
</PRE>
|
||||||
|
<P>If the following command is used, then the y,z box lengths will each
|
||||||
shrink by sqrt(1.1) to keep the volume constant. In this case, the
|
shrink by sqrt(1.1) to keep the volume constant. In this case, the
|
||||||
y,z box lengths shrink so as to keep their relative aspect ratio
|
y,z box lengths shrink so as to keep their relative aspect ratio
|
||||||
constant:</p>
|
constant:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>change_box all"x scale 1.1 y volume z volume
|
</P>
|
||||||
</pre></div>
|
<PRE>change_box all"x scale 1.1 y volume z volume
|
||||||
</div>
|
</PRE>
|
||||||
<p>If the following command is used, then the final box will be a factor
|
<P>If the following command is used, then the final box will be a factor
|
||||||
of 10% larger in x and y, and a factor of 21% smaller in z, so as to
|
of 10% larger in x and y, and a factor of 21% smaller in z, so as to
|
||||||
keep the volume constant:</p>
|
keep the volume constant:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>change_box all x scale 1.1 z volume y scale 1.1 z volume
|
</P>
|
||||||
</pre></div>
|
<PRE>change_box all x scale 1.1 z volume y scale 1.1 z volume
|
||||||
</div>
|
</PRE>
|
||||||
<div class="admonition warning">
|
<P>IMPORTANT NOTE: For solids or liquids, when one dimension of the box
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">For solids or liquids, when one dimension of the box
|
|
||||||
is expanded, it may be physically undesirable to hold the other 2 box
|
is expanded, it may be physically undesirable to hold the other 2 box
|
||||||
lengths constant since that implies a density change. For solids,
|
lengths constant since that implies a density change. For solids,
|
||||||
adjusting the other dimensions via the <em>volume</em> style may make
|
adjusting the other dimensions via the <I>volume</I> style may make
|
||||||
physical sense (just as for a liquid), but may not be correct for
|
physical sense (just as for a liquid), but may not be correct for
|
||||||
materials and potentials whose Poisson ratio is not 0.5.</p>
|
materials and potentials whose Poisson ratio is not 0.5.
|
||||||
</div>
|
</P>
|
||||||
<p>For the <em>scale</em> and <em>volume</em> styles, the box length is expanded or
|
<P>For the <I>scale</I> and <I>volume</I> styles, the box length is expanded or
|
||||||
compressed around its mid point.</p>
|
compressed around its mid point.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>For the <em>xy</em>, <em>xz</em>, and <em>yz</em> parameters, this is the meaning of their
|
<HR>
|
||||||
|
|
||||||
|
<P>For the <I>xy</I>, <I>xz</I>, and <I>yz</I> parameters, this is the meaning of their
|
||||||
styles and values. Note that changing the tilt factors of a triclinic
|
styles and values. Note that changing the tilt factors of a triclinic
|
||||||
box does not change its volume.</p>
|
box does not change its volume.
|
||||||
<p>For style <em>final</em>, the final tilt factor is specified. The value
|
</P>
|
||||||
|
<P>For style <I>final</I>, the final tilt factor is specified. The value
|
||||||
can be in lattice or box distance units. See the discussion of the
|
can be in lattice or box distance units. See the discussion of the
|
||||||
units keyword below.</p>
|
units keyword below.
|
||||||
<p>For style <em>delta</em>, a plus or minus change in the tilt factor is
|
</P>
|
||||||
|
<P>For style <I>delta</I>, a plus or minus change in the tilt factor is
|
||||||
specified. The value can be in lattice or box distance units. See
|
specified. The value can be in lattice or box distance units. See
|
||||||
the discussion of the units keyword below.</p>
|
the discussion of the units keyword below.
|
||||||
<p>All of these styles change the xy, xz, yz tilt factors. In LAMMPS,
|
</P>
|
||||||
|
<P>All of these styles change the xy, xz, yz tilt factors. In LAMMPS,
|
||||||
tilt factors (xy,xz,yz) for triclinic boxes are required to be no more
|
tilt factors (xy,xz,yz) for triclinic boxes are required to be no more
|
||||||
than half the distance of the parallel box length. For example, if
|
than half the distance of the parallel box length. For example, if
|
||||||
xlo = 2 and xhi = 12, then the x box length is 10 and the xy tilt
|
xlo = 2 and xhi = 12, then the x box length is 10 and the xy tilt
|
||||||
@ -347,152 +235,108 @@ between -(xhi-xlo)/2 and +(yhi-ylo)/2. Note that this is not a
|
|||||||
limitation, since if the maximum tilt factor is 5 (as in this
|
limitation, since if the maximum tilt factor is 5 (as in this
|
||||||
example), then configurations with tilt = ..., -15, -5, 5, 15, 25,
|
example), then configurations with tilt = ..., -15, -5, 5, 15, 25,
|
||||||
... are all equivalent. Any tilt factor specified by this command
|
... are all equivalent. Any tilt factor specified by this command
|
||||||
must be within these limits.</p>
|
must be within these limits.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The <em>boundary</em> keyword takes arguments that have exactly the same
|
<HR>
|
||||||
meaning as they do for the <a class="reference internal" href="boundary.html"><em>boundary</em></a> command. In each
|
|
||||||
|
<P>The <I>boundary</I> keyword takes arguments that have exactly the same
|
||||||
|
meaning as they do for the <A HREF = "boundary.html">boundary</A> command. In each
|
||||||
dimension, a single letter assigns the same style to both the lower
|
dimension, a single letter assigns the same style to both the lower
|
||||||
and upper face of the box. Two letters assigns the first style to the
|
and upper face of the box. Two letters assigns the first style to the
|
||||||
lower face and the second style to the upper face.</p>
|
lower face and the second style to the upper face.
|
||||||
<p>The style <em>p</em> means the box is periodic; the other styles mean
|
</P>
|
||||||
non-periodic. For style <em>f</em>, the position of the face is fixed. For
|
<P>The style <I>p</I> means the box is periodic; the other styles mean
|
||||||
style <em>s</em>, the position of the face is set so as to encompass the
|
non-periodic. For style <I>f</I>, the position of the face is fixed. For
|
||||||
|
style <I>s</I>, the position of the face is set so as to encompass the
|
||||||
atoms in that dimension (shrink-wrapping), no matter how far they
|
atoms in that dimension (shrink-wrapping), no matter how far they
|
||||||
move. For style <em>m</em>, shrink-wrapping occurs, but is bounded by the
|
move. For style <I>m</I>, shrink-wrapping occurs, but is bounded by the
|
||||||
current box edge in that dimension, so that the box will become no
|
current box edge in that dimension, so that the box will become no
|
||||||
smaller. See the <a class="reference internal" href="boundary.html"><em>boundary</em></a> command for more
|
smaller. See the <A HREF = "boundary.html">boundary</A> command for more
|
||||||
explanation of these style options.</p>
|
explanation of these style options.
|
||||||
<p>Note that the “boundary” command itself can only be used before the
|
</P>
|
||||||
simulation box is defined via a <a class="reference internal" href="read_data.html"><em>read_data</em></a> or
|
<P>Note that the "boundary" command itself can only be used before the
|
||||||
<a class="reference internal" href="create_box.html"><em>create_box</em></a> or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>
|
simulation box is defined via a <A HREF = "read_data.html">read_data</A> or
|
||||||
|
<A HREF = "create_box.html">create_box</A> or <A HREF = "read_restart.html">read_restart</A>
|
||||||
command. This command allows the boundary conditions to be changed
|
command. This command allows the boundary conditions to be changed
|
||||||
later in your input script. Also note that the
|
later in your input script. Also note that the
|
||||||
<a class="reference internal" href="read_restart.html"><em>read_restart</em></a> will change boundary conditions to
|
<A HREF = "read_restart.html">read_restart</A> will change boundary conditions to
|
||||||
match what is stored in the restart file. So if you wish to change
|
match what is stored in the restart file. So if you wish to change
|
||||||
them, you should use the change_box command after the read_restart
|
them, you should use the change_box command after the read_restart
|
||||||
command.</p>
|
command.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The <em>ortho</em> and <em>triclinic</em> keywords convert the simulation box to be
|
<HR>
|
||||||
orthogonal or triclinic (non-orthongonal). See <a class="reference internal" href="Section_howto.html#howto-13"><span>this section</span></a> for a discussion of how non-orthongal
|
|
||||||
boxes are represented in LAMMPS.</p>
|
<P>The <I>ortho</I> and <I>triclinic</I> keywords convert the simulation box to be
|
||||||
<p>The simulation box is defined as either orthogonal or triclinic when
|
orthogonal or triclinic (non-orthongonal). See <A HREF = "Section_howto#howto_13">this
|
||||||
it is created via the <a class="reference internal" href="create_box.html"><em>create_box</em></a>,
|
section</A> for a discussion of how non-orthongal
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a>, or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>
|
boxes are represented in LAMMPS.
|
||||||
commands.</p>
|
</P>
|
||||||
<p>These keywords allow you to toggle the existing simulation box from
|
<P>The simulation box is defined as either orthogonal or triclinic when
|
||||||
|
it is created via the <A HREF = "create_box.html">create_box</A>,
|
||||||
|
<A HREF = "read_data.html">read_data</A>, or <A HREF = "read_restart.html">read_restart</A>
|
||||||
|
commands.
|
||||||
|
</P>
|
||||||
|
<P>These keywords allow you to toggle the existing simulation box from
|
||||||
orthogonal to triclinic and vice versa. For example, an initial
|
orthogonal to triclinic and vice versa. For example, an initial
|
||||||
equilibration simulation can be run in an orthogonal box, the box can
|
equilibration simulation can be run in an orthogonal box, the box can
|
||||||
be toggled to triclinic, and then a <a class="reference internal" href="Section_howto.html#howto-13"><span>non-equilibrium MD (NEMD) simulation</span></a> can be run with deformation
|
be toggled to triclinic, and then a <A HREF = "Section_howto.html#howto_13">non-equilibrium MD (NEMD)
|
||||||
via the <a class="reference internal" href="fix_deform.html"><em>fix deform</em></a> command.</p>
|
simulation</A> can be run with deformation
|
||||||
<p>If the simulation box is currently triclinic and has non-zero tilt in
|
via the <A HREF = "fix_deform.html">fix deform</A> command.
|
||||||
xy, yz, or xz, then it cannot be converted to an orthogonal box.</p>
|
</P>
|
||||||
<hr class="docutils" />
|
<P>If the simulation box is currently triclinic and has non-zero tilt in
|
||||||
<p>The <em>set</em> keyword saves the current box size/shape. This can be
|
xy, yz, or xz, then it cannot be converted to an orthogonal box.
|
||||||
useful if you wish to use the <em>remap</em> keyword more than once or if you
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>The <I>set</I> keyword saves the current box size/shape. This can be
|
||||||
|
useful if you wish to use the <I>remap</I> keyword more than once or if you
|
||||||
wish it to be applied to an intermediate box size/shape in a sequence
|
wish it to be applied to an intermediate box size/shape in a sequence
|
||||||
of keyword operations. Note that the box size/shape is saved before
|
of keyword operations. Note that the box size/shape is saved before
|
||||||
any of the keywords are processed, i.e. the box size/shape at the time
|
any of the keywords are processed, i.e. the box size/shape at the time
|
||||||
the create_box command is encountered in the input script.</p>
|
the create_box command is encountered in the input script.
|
||||||
<p>The <em>remap</em> keyword remaps atom coordinates from the last saved box
|
</P>
|
||||||
|
<P>The <I>remap</I> keyword remaps atom coordinates from the last saved box
|
||||||
size/shape to the current box state. For example, if you stretch the
|
size/shape to the current box state. For example, if you stretch the
|
||||||
box in the x dimension or tilt it in the xy plane via the <em>x</em> and <em>xy</em>
|
box in the x dimension or tilt it in the xy plane via the <I>x</I> and <I>xy</I>
|
||||||
keywords, then the <em>remap</em> commmand will dilate or tilt the atoms to
|
keywords, then the <I>remap</I> commmand will dilate or tilt the atoms to
|
||||||
conform to the new box size/shape, as if the atoms moved with the box
|
conform to the new box size/shape, as if the atoms moved with the box
|
||||||
as it deformed.</p>
|
as it deformed.
|
||||||
<p>Note that this operation is performed without regard to periodic
|
</P>
|
||||||
|
<P>Note that this operation is performed without regard to periodic
|
||||||
boundaries. Also, any shrink-wrapping of non-periodic boundaries (see
|
boundaries. Also, any shrink-wrapping of non-periodic boundaries (see
|
||||||
the <a class="reference internal" href="boundary.html"><em>boundary</em></a> command) occurs after all keywords,
|
the <A HREF = "boundary.html">boundary</A> command) occurs after all keywords,
|
||||||
including this one, have been processed.</p>
|
including this one, have been processed.
|
||||||
<p>Only atoms in the specified group are remapped.</p>
|
</P>
|
||||||
<hr class="docutils" />
|
<P>Only atoms in the specified group are remapped.
|
||||||
<p>The <em>units</em> keyword determines the meaning of the distance units used
|
</P>
|
||||||
to define various arguments. A <em>box</em> value selects standard distance
|
<HR>
|
||||||
units as defined by the <a class="reference internal" href="units.html"><em>units</em></a> command, e.g. Angstroms for
|
|
||||||
units = real or metal. A <em>lattice</em> value means the distance units are
|
<P>The <I>units</I> keyword determines the meaning of the distance units used
|
||||||
in lattice spacings. The <a class="reference internal" href="lattice.html"><em>lattice</em></a> command must have
|
to define various arguments. A <I>box</I> value selects standard distance
|
||||||
been previously used to define the lattice spacing.</p>
|
units as defined by the <A HREF = "units.html">units</A> command, e.g. Angstroms for
|
||||||
</div>
|
units = real or metal. A <I>lattice</I> value means the distance units are
|
||||||
<hr class="docutils" />
|
in lattice spacings. The <A HREF = "lattice.html">lattice</A> command must have
|
||||||
<div class="section" id="restrictions">
|
been previously used to define the lattice spacing.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>If you use the <em>ortho</em> or <em>triclinic</em> keywords, then at the point in
|
<HR>
|
||||||
the input script when this command is issued, no <a class="reference internal" href="dump.html"><em>dumps</em></a> can
|
|
||||||
be active, nor can a <a class="reference internal" href="fix_ave_spatial.html"><em>fix ave/spatial</em></a> or <a class="reference internal" href="fix_deform.html"><em>fix deform</em></a> be active. This is because these commands
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>If you use the <I>ortho</I> or <I>triclinic</I> keywords, then at the point in
|
||||||
|
the input script when this command is issued, no <A HREF = "dump.html">dumps</A> can
|
||||||
|
be active, nor can a <A HREF = "fix_ave_spatial.html">fix ave/spatial</A> or <A HREF = "fix_deform.html">fix
|
||||||
|
deform</A> be active. This is because these commands
|
||||||
test whether the simulation box is orthogonal when they are first
|
test whether the simulation box is orthogonal when they are first
|
||||||
issued. Note that these commands can be used in your script before a
|
issued. Note that these commands can be used in your script before a
|
||||||
change_box command is issued, so long as an <a class="reference internal" href="undump.html"><em>undump</em></a> or
|
change_box command is issued, so long as an <A HREF = "undump.html">undump</A> or
|
||||||
<a class="reference internal" href="unfix.html"><em>unfix</em></a> command is also used to turn them off.</p>
|
<A HREF = "unfix.html">unfix</A> command is also used to turn them off.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><B>Related commands:</B>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="fix_deform.html"><em>fix deform</em></a>, <a class="reference internal" href="boundary.html"><em>boundary</em></a></p>
|
<P><A HREF = "fix_deform.html">fix deform</A>, <A HREF = "boundary.html">boundary</A>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="default">
|
<P><B>Default:</B>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>The option default is units = lattice.</p>
|
<P>The option default is units = lattice.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
253
doc/clear.html
253
doc/clear.html
@ -1,226 +1,43 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>clear command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>clear command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>clear command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>clear
|
||||||
|
</PRE>
|
||||||
|
<P><B>Examples:</B>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</P>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<PRE>(commands for 1st simulation)
|
||||||
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="clear-command">
|
|
||||||
<span id="index-0"></span><h1>clear command<a class="headerlink" href="#clear-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><span class="n">clear</span>
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</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>(commands for 1st simulation)
|
|
||||||
clear
|
clear
|
||||||
(commands for 2nd simulation)
|
(commands for 2nd simulation)
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>This command deletes all atoms, restores all settings to their default
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>This command deletes all atoms, restores all settings to their default
|
|
||||||
values, and frees all memory allocated by LAMMPS. Once a clear
|
values, and frees all memory allocated by LAMMPS. Once a clear
|
||||||
command has been executed, it is almost as if LAMMPS were starting
|
command has been executed, it is almost as if LAMMPS were starting
|
||||||
over, with only the exceptions noted below. This command enables
|
over, with only the exceptions noted below. This command enables
|
||||||
multiple jobs to be run sequentially from one input script.</p>
|
multiple jobs to be run sequentially from one input script.
|
||||||
<p>These settings are not affected by a clear command: the working
|
</P>
|
||||||
directory (<a class="reference internal" href="shell.html"><em>shell</em></a> command), log file status
|
<P>These settings are not affected by a clear command: the working
|
||||||
(<a class="reference internal" href="log.html"><em>log</em></a> command), echo status (<a class="reference internal" href="echo.html"><em>echo</em></a> command), and
|
directory (<A HREF = "shell.html">shell</A> command), log file status
|
||||||
input script variables (<a class="reference internal" href="variable.html"><em>variable</em></a> command).</p>
|
(<A HREF = "log.html">log</A> command), echo status (<A HREF = "echo.html">echo</A> command), and
|
||||||
</div>
|
input script variables (<A HREF = "variable.html">variable</A> command).
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B> none
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<P><B>Related commands:</B> none
|
||||||
<p><strong>Related commands:</strong> none</p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,329 +1,151 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>comm_modify command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>comm_modify command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>comm_modify command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>comm_modify keyword value ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>zero or more keyword/value pairs may be appended
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>keyword = <I>mode</I> or <I>cutoff</I> or <I>group</I> or <I>vel</I>
|
||||||
|
|
||||||
</li>
|
<PRE> <I>mode</I> value = <I>single</I> or <I>multi</I> = communicate atoms within a single or multiple distances
|
||||||
</ul>
|
<I>cutoff</I> value = Rcut (distance units) = communicate atoms from this far away
|
||||||
<hr/>
|
<I>group</I> value = group-ID = only communicate atoms in the group
|
||||||
|
<I>vel</I> value = <I>yes</I> or <I>no</I> = do or do not communicate velocity info with ghost atoms
|
||||||
</div>
|
</PRE>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
<div class="section" id="comm-modify-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>comm_modify command<a class="headerlink" href="#comm-modify-command" title="Permalink to this headline">¶</a></h1>
|
<PRE>comm_modify mode multi
|
||||||
<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>comm_modify keyword value ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>zero or more keyword/value pairs may be appended</li>
|
|
||||||
<li>keyword = <em>mode</em> or <em>cutoff</em> or <em>group</em> or <em>vel</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>mode</em> value = <em>single</em> or <em>multi</em> = communicate atoms within a single or multiple distances
|
|
||||||
<em>cutoff</em> value = Rcut (distance units) = communicate atoms from this far away
|
|
||||||
<em>group</em> value = group-ID = only communicate atoms in the group
|
|
||||||
<em>vel</em> value = <em>yes</em> or <em>no</em> = do or do not communicate velocity info with ghost atoms
|
|
||||||
</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>comm_modify mode multi
|
|
||||||
comm_modify mode multi group solvent
|
comm_modify mode multi group solvent
|
||||||
comm_modify vel yes
|
comm_modify vel yes
|
||||||
comm_modify cutoff 5.0 vel yes
|
comm_modify cutoff 5.0 vel yes
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>This command sets parameters that affect the inter-processor
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>This command sets parameters that affect the inter-processor
|
|
||||||
communication of atom information that occurs each timestep as
|
communication of atom information that occurs each timestep as
|
||||||
coordinates and other properties are exchanged between neighboring
|
coordinates and other properties are exchanged between neighboring
|
||||||
processors and stored as properties of ghost atoms.</p>
|
processors and stored as properties of ghost atoms.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: These options apply to the currently defined comm
|
||||||
<p class="last">These options apply to the currently defined comm
|
style. When you specify a <A HREF = "comm_style.html">comm_style</A> command, all
|
||||||
style. When you specify a <a class="reference internal" href="comm_style.html"><em>comm_style</em></a> command, all
|
|
||||||
communication settings are restored to their default values, including
|
communication settings are restored to their default values, including
|
||||||
those previously reset by a comm_modify command. Thus if your input
|
those previously reset by a comm_modify command. Thus if your input
|
||||||
script specifies a comm_style command, you should use the comm_modify
|
script specifies a comm_style command, you should use the comm_modify
|
||||||
command after it.</p>
|
command after it.
|
||||||
</div>
|
</P>
|
||||||
<p>The <em>mode</em> keyword determines whether a single or multiple cutoff
|
<P>The <I>mode</I> keyword determines whether a single or multiple cutoff
|
||||||
distances are used to determine which atoms to communicate.</p>
|
distances are used to determine which atoms to communicate.
|
||||||
<p>The default mode is <em>single</em> which means each processor acquires
|
</P>
|
||||||
|
<P>The default mode is <I>single</I> which means each processor acquires
|
||||||
information for ghost atoms that are within a single distance from its
|
information for ghost atoms that are within a single distance from its
|
||||||
sub-domain. The distance is the maximum of the neighbor cutoff for
|
sub-domain. The distance is the maximum of the neighbor cutoff for
|
||||||
all atom type pairs.</p>
|
all atom type pairs.
|
||||||
<p>For many systems this is an efficient algorithm, but for systems with
|
</P>
|
||||||
widely varying cutoffs for different type pairs, the <em>multi</em> mode can
|
<P>For many systems this is an efficient algorithm, but for systems with
|
||||||
|
widely varying cutoffs for different type pairs, the <I>multi</I> mode can
|
||||||
be faster. In this case, each atom type is assigned its own distance
|
be faster. In this case, each atom type is assigned its own distance
|
||||||
cutoff for communication purposes, and fewer atoms will be
|
cutoff for communication purposes, and fewer atoms will be
|
||||||
communicated. See the <a class="reference internal" href="neighbor.html"><em>neighbor multi</em></a> command for a
|
communicated. See the <A HREF = "neighbor.html">neighbor multi</A> command for a
|
||||||
neighbor list construction option that may also be beneficial for
|
neighbor list construction option that may also be beneficial for
|
||||||
simulations of this kind.</p>
|
simulations of this kind.
|
||||||
<p>The <em>cutoff</em> keyword allows you to set a ghost cutoff distance, which
|
</P>
|
||||||
is the distance from the borders of a processor’s sub-domain at which
|
<P>The <I>cutoff</I> keyword allows you to set a ghost cutoff distance, which
|
||||||
|
is the distance from the borders of a processor's sub-domain at which
|
||||||
ghost atoms are acquired from other processors. By default the ghost
|
ghost atoms are acquired from other processors. By default the ghost
|
||||||
cutoff = neighbor cutoff = pairwise force cutoff + neighbor skin. See
|
cutoff = neighbor cutoff = pairwise force cutoff + neighbor skin. See
|
||||||
the <a class="reference internal" href="neighbor.html"><em>neighbor</em></a> command for more information about the
|
the <A HREF = "neighbor.html">neighbor</A> command for more information about the
|
||||||
skin distance. If the specified Rcut is greater than the neighbor
|
skin distance. If the specified Rcut is greater than the neighbor
|
||||||
cutoff, then extra ghost atoms will be acquired. If it is smaller,
|
cutoff, then extra ghost atoms will be acquired. If it is smaller,
|
||||||
the ghost cutoff is set to the neighbor cutoff.</p>
|
the ghost cutoff is set to the neighbor cutoff.
|
||||||
<p>These are simulation scenarios in which it may be useful or even
|
</P>
|
||||||
necessary to set a ghost cutoff > neighbor cutoff:</p>
|
<P>These are simulation scenarios in which it may be useful or even
|
||||||
<ul class="simple">
|
necessary to set a ghost cutoff > neighbor cutoff:
|
||||||
<li>a single polymer chain with bond interactions, but no pairwise interactions</li>
|
</P>
|
||||||
<li>bonded interactions (e.g. dihedrals) extend further than the pairwise cutoff</li>
|
<UL><LI>a single polymer chain with bond interactions, but no pairwise interactions
|
||||||
<li>ghost atoms beyond the pairwise cutoff are needed for some computation</li>
|
<LI>bonded interactions (e.g. dihedrals) extend further than the pairwise cutoff
|
||||||
</ul>
|
<LI>ghost atoms beyond the pairwise cutoff are needed for some computation
|
||||||
<p>In the first scenario, a pairwise potential is not defined. Thus the
|
</UL>
|
||||||
|
<P>In the first scenario, a pairwise potential is not defined. Thus the
|
||||||
pairwise neighbor cutoff will be 0.0. But ghost atoms are still
|
pairwise neighbor cutoff will be 0.0. But ghost atoms are still
|
||||||
needed for computing bond, angle, etc interactions between atoms on
|
needed for computing bond, angle, etc interactions between atoms on
|
||||||
different processors, or when the interaction straddles a periodic
|
different processors, or when the interaction straddles a periodic
|
||||||
boundary.</p>
|
boundary.
|
||||||
<p>The appropriate ghost cutoff depends on the <a class="reference internal" href="newton.html"><em>newton bond</em></a>
|
</P>
|
||||||
setting. For newton bond <em>off</em>, the distance needs to be the furthest
|
<P>The appropriate ghost cutoff depends on the <A HREF = "newton.html">newton bond</A>
|
||||||
|
setting. For newton bond <I>off</I>, the distance needs to be the furthest
|
||||||
distance between any two atoms in the bond, angle, etc. E.g. the
|
distance between any two atoms in the bond, angle, etc. E.g. the
|
||||||
distance between 1-4 atoms in a dihedral. For newton bond <em>on</em>, the
|
distance between 1-4 atoms in a dihedral. For newton bond <I>on</I>, the
|
||||||
distance between the central atom in the bond, angle, etc and any
|
distance between the central atom in the bond, angle, etc and any
|
||||||
other atom is sufficient. E.g. the distance between 2-4 atoms in a
|
other atom is sufficient. E.g. the distance between 2-4 atoms in a
|
||||||
dihedral.</p>
|
dihedral.
|
||||||
<p>In the second scenario, a pairwise potential is defined, but its
|
</P>
|
||||||
|
<P>In the second scenario, a pairwise potential is defined, but its
|
||||||
neighbor cutoff is not sufficiently long enough to enable bond, angle,
|
neighbor cutoff is not sufficiently long enough to enable bond, angle,
|
||||||
etc terms to be computed. As in the previous scenario, an appropriate
|
etc terms to be computed. As in the previous scenario, an appropriate
|
||||||
ghost cutoff should be set.</p>
|
ghost cutoff should be set.
|
||||||
<p>In the last scenario, a <a class="reference internal" href="fix.html"><em>fix</em></a> or <a class="reference internal" href="compute.html"><em>compute</em></a> or
|
</P>
|
||||||
<a class="reference internal" href="pair_style.html"><em>pairwise potential</em></a> needs to calculate with ghost
|
<P>In the last scenario, a <A HREF = "fix.html">fix</A> or <A HREF = "compute.html">compute</A> or
|
||||||
|
<A HREF = "pair_style.html">pairwise potential</A> needs to calculate with ghost
|
||||||
atoms beyond the normal pairwise cutoff for some computation it
|
atoms beyond the normal pairwise cutoff for some computation it
|
||||||
performs (e.g. locate neighbors of ghost atoms in a multibody pair
|
performs (e.g. locate neighbors of ghost atoms in a multibody pair
|
||||||
potential). Setting the ghost cutoff appropriately can insure it will
|
potential). Setting the ghost cutoff appropriately can insure it will
|
||||||
find the needed atoms.</p>
|
find the needed atoms.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: In these scenarios, if you do not set the ghost cutoff
|
||||||
<p class="last">In these scenarios, if you do not set the ghost cutoff
|
|
||||||
long enough, and if there is only one processor in a periodic
|
long enough, and if there is only one processor in a periodic
|
||||||
dimension (e.g. you are running in serial), then LAMMPS may “find” the
|
dimension (e.g. you are running in serial), then LAMMPS may "find" the
|
||||||
atom it is looking for (e.g. the partner atom in a bond), that is on
|
atom it is looking for (e.g. the partner atom in a bond), that is on
|
||||||
the far side of the simulation box, across a periodic boundary. This
|
the far side of the simulation box, across a periodic boundary. This
|
||||||
will typically lead to bad dynamics (i.e. the bond length is now the
|
will typically lead to bad dynamics (i.e. the bond length is now the
|
||||||
simulation box length). To detect if this is happening, see the
|
simulation box length). To detect if this is happening, see the
|
||||||
<a class="reference internal" href="neigh_modify.html"><em>neigh_modify cluster</em></a> command.</p>
|
<A HREF = "neigh_modify.html">neigh_modify cluster</A> command.
|
||||||
</div>
|
</P>
|
||||||
<p>The <em>group</em> keyword will limit communication to atoms in the specified
|
<P>The <I>group</I> keyword will limit communication to atoms in the specified
|
||||||
group. This can be useful for models where no ghost atoms are needed
|
group. This can be useful for models where no ghost atoms are needed
|
||||||
for some kinds of particles. All atoms (not just those in the
|
for some kinds of particles. All atoms (not just those in the
|
||||||
specified group) will still migrate to new processors as they move.
|
specified group) will still migrate to new processors as they move.
|
||||||
The group specified with this option must also be specified via the
|
The group specified with this option must also be specified via the
|
||||||
<a class="reference internal" href="atom_modify.html"><em>atom_modify first</em></a> command.</p>
|
<A HREF = "atom_modify.html">atom_modify first</A> command.
|
||||||
<p>The <em>vel</em> keyword enables velocity information to be communicated with
|
</P>
|
||||||
ghost particles. Depending on the <a class="reference internal" href="atom_style.html"><em>atom_style</em></a>,
|
<P>The <I>vel</I> keyword enables velocity information to be communicated with
|
||||||
|
ghost particles. Depending on the <A HREF = "atom_style.html">atom_style</A>,
|
||||||
velocity info includes the translational velocity, angular velocity,
|
velocity info includes the translational velocity, angular velocity,
|
||||||
and angular momentum of a particle. If the <em>vel</em> option is set to
|
and angular momentum of a particle. If the <I>vel</I> option is set to
|
||||||
<em>yes</em>, then ghost atoms store these quantities; if <em>no</em> then they do
|
<I>yes</I>, then ghost atoms store these quantities; if <I>no</I> then they do
|
||||||
not. The <em>yes</em> setting is needed by some pair styles which require
|
not. The <I>yes</I> setting is needed by some pair styles which require
|
||||||
the velocity state of both the I and J particles to compute a pairwise
|
the velocity state of both the I and J particles to compute a pairwise
|
||||||
I,J interaction.</p>
|
I,J interaction.
|
||||||
<p>Note that if the <a class="reference internal" href="fix_deform.html"><em>fix deform</em></a> command is being used
|
</P>
|
||||||
with its “remap v” option enabled, then the velocities for ghost atoms
|
<P>Note that if the <A HREF = "fix_deform.html">fix deform</A> command is being used
|
||||||
|
with its "remap v" option enabled, then the velocities for ghost atoms
|
||||||
(in the fix deform group) mirrored across a periodic boundary will
|
(in the fix deform group) mirrored across a periodic boundary will
|
||||||
also include components due to any velocity shift that occurs across
|
also include components due to any velocity shift that occurs across
|
||||||
that boundary (e.g. due to dilation or shear).</p>
|
that boundary (e.g. due to dilation or shear).
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B> none
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Related commands:</B>
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><A HREF = "comm_style.html">comm_style</A>, <A HREF = "neighbor.html">neighbor</A>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><B>Default:</B>
|
||||||
<p><a class="reference internal" href="comm_style.html"><em>comm_style</em></a>, <a class="reference internal" href="neighbor.html"><em>neighbor</em></a></p>
|
</P>
|
||||||
</div>
|
<P>The option defauls are mode = single, group = all, cutoff = 0.0, vel =
|
||||||
<div class="section" id="default">
|
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>The option defauls are mode = single, group = all, cutoff = 0.0, vel =
|
|
||||||
no. The cutoff default of 0.0 means that ghost cutoff = neighbor
|
no. The cutoff default of 0.0 means that ghost cutoff = neighbor
|
||||||
cutoff = pairwise force cutoff + neighbor skin.</p>
|
cutoff = pairwise force cutoff + neighbor skin.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,251 +1,68 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>comm_style command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>comm_style command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>comm_style command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>comm_style style
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>style = <I>brick</I> or <I>tiled</I>
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
</UL>
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</li>
|
<PRE>comm_style brick
|
||||||
</ul>
|
comm_style tiled
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>This command sets the style of inter-processor communication of atom
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="comm-style-command">
|
|
||||||
<span id="index-0"></span><h1>comm_style command<a class="headerlink" href="#comm-style-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>comm_style style
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>style = <em>brick</em> or <em>tiled</em></li>
|
|
||||||
</ul>
|
|
||||||
</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>comm_style brick
|
|
||||||
comm_style tiled
|
|
||||||
</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 command sets the style of inter-processor communication of atom
|
|
||||||
information that occurs each timestep as coordinates and other
|
information that occurs each timestep as coordinates and other
|
||||||
properties are exchanged between neighboring processors and stored as
|
properties are exchanged between neighboring processors and stored as
|
||||||
properties of ghost atoms.</p>
|
properties of ghost atoms.
|
||||||
<p>For the default <em>brick</em> style, the domain decomposition used by LAMMPS
|
</P>
|
||||||
|
<P>For the default <I>brick</I> style, the domain decomposition used by LAMMPS
|
||||||
to partition the simulation box must be a regular 3d grid of bricks,
|
to partition the simulation box must be a regular 3d grid of bricks,
|
||||||
one per processor. Each processor communicates with its 6 Cartesian
|
one per processor. Each processor communicates with its 6 Cartesian
|
||||||
neighbors in the grid to acquire information for nearby atoms.</p>
|
neighbors in the grid to acquire information for nearby atoms.
|
||||||
<p>For the <em>tiled</em> style, a more general domain decomposition can be
|
</P>
|
||||||
used, as triggered by the <a class="reference internal" href="balance.html"><em>balance</em></a> or <a class="reference internal" href="fix_balance.html"><em>fix balance</em></a> commands. The simulation box can be
|
<P>For the <I>tiled</I> style, a more general domain decomposition can be
|
||||||
partitioned into non-overlapping rectangular-shaped “tiles” or varying
|
used, as triggered by the <A HREF = "balance.html">balance</A> or <A HREF = "fix_balance.html">fix
|
||||||
|
balance</A> commands. The simulation box can be
|
||||||
|
partitioned into non-overlapping rectangular-shaped "tiles" or varying
|
||||||
sizes and shapes. Again there is one tile per processor. To acquire
|
sizes and shapes. Again there is one tile per processor. To acquire
|
||||||
information for nearby atoms, communication must now be done with a
|
information for nearby atoms, communication must now be done with a
|
||||||
more complex pattern of neighboring processors.</p>
|
more complex pattern of neighboring processors.
|
||||||
<p>Note that this command does not actually define a partitoining of the
|
</P>
|
||||||
|
<P>Note that this command does not actually define a partitoining of the
|
||||||
simulation box (a domain decomposition), rather it determines what
|
simulation box (a domain decomposition), rather it determines what
|
||||||
kinds of decompositions are allowed and the pattern of communication
|
kinds of decompositions are allowed and the pattern of communication
|
||||||
used to enable the decomposition. A decomposition is created when the
|
used to enable the decomposition. A decomposition is created when the
|
||||||
simulation box is first created, via the <a class="reference internal" href="create_box.html"><em>create_box</em></a>
|
simulation box is first created, via the <A HREF = "create_box.html">create_box</A>
|
||||||
or <a class="reference internal" href="read_data.html"><em>read_data</em></a> or <a class="reference internal" href="read_restart.html"><em>read_restart</em></a>
|
or <A HREF = "read_data.html">read_data</A> or <A HREF = "read_restart.html">read_restart</A>
|
||||||
commands. For both the <em>brick</em> and <em>tiled</em> styles, the initial
|
commands. For both the <I>brick</I> and <I>tiled</I> styles, the initial
|
||||||
decomposition will be the same, as described by
|
decomposition will be the same, as described by
|
||||||
<a class="reference internal" href="create_box.html"><em>create_box</em></a> and <a class="reference internal" href="processors.html"><em>processors</em></a>
|
<A HREF = "create_box.html">create_box</A> and <A HREF = "processors.html">processors</A>
|
||||||
commands. The decomposition can be changed via the
|
commands. The decomposition can be changed via the
|
||||||
<a class="reference internal" href="balance.html"><em>balance</em></a> or <a class="reference internal" href="fix_balance.html"><em>fix_balance</em></a> commands.</p>
|
<A HREF = "balance.html">balance</A> or <A HREF = "fix_balance.html">fix_balance</A> commands.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B> none
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Related commands:</B>
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><A HREF = "comm_modify.html">comm_modify</A>, <A HREF = "processors.html">processors</A>,
|
||||||
<div class="section" id="related-commands">
|
<A HREF = "balance.html">balance</A>, <A HREF = "fix_balance.html">fix balance</A>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="comm_modify.html"><em>comm_modify</em></a>, <a class="reference internal" href="processors.html"><em>processors</em></a>,
|
<P><B>Default:</B>
|
||||||
<a class="reference internal" href="balance.html"><em>balance</em></a>, <a class="reference internal" href="fix_balance.html"><em>fix balance</em></a></p>
|
</P>
|
||||||
</div>
|
<P>The default style is brick.
|
||||||
<div class="section" id="default">
|
</P>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
</HTML>
|
||||||
<p>The default style is brick.</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
598
doc/compute.html
598
doc/compute.html
@ -1,154 +1,34 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID style args
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID = user-assigned name for the computation
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>group-ID = ID of the group of atoms to perform the computation on
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>style = one of a list of possible style names (see below)
|
||||||
|
<LI>args = arguments used by a particular style
|
||||||
</li>
|
</UL>
|
||||||
</ul>
|
<P><B>Examples:</B>
|
||||||
<hr/>
|
</P>
|
||||||
|
<PRE>compute 1 all temp
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-command">
|
|
||||||
<span id="index-0"></span><h1>compute command<a class="headerlink" href="#compute-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>compute ID group-ID style args
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID = user-assigned name for the computation</li>
|
|
||||||
<li>group-ID = ID of the group of atoms to perform the computation on</li>
|
|
||||||
<li>style = one of a list of possible style names (see below)</li>
|
|
||||||
<li>args = arguments used by a particular style</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all temp
|
|
||||||
compute newtemp flow temp/partial 1 1 0
|
compute newtemp flow temp/partial 1 1 0
|
||||||
compute 3 all ke/atom
|
compute 3 all ke/atom
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Define a computation that will be performed on a group of atoms.
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that will be performed on a group of atoms.
|
|
||||||
Quantities calculated by a compute are instantaneous values, meaning
|
Quantities calculated by a compute are instantaneous values, meaning
|
||||||
they are calculated from information about atoms on the current
|
they are calculated from information about atoms on the current
|
||||||
timestep or iteration, though a compute may internally store some
|
timestep or iteration, though a compute may internally store some
|
||||||
@ -156,12 +36,15 @@ information about a previous state of the system. Defining a compute
|
|||||||
does not perform a computation. Instead computes are invoked by other
|
does not perform a computation. Instead computes are invoked by other
|
||||||
LAMMPS commands as needed, e.g. to calculate a temperature needed for
|
LAMMPS commands as needed, e.g. to calculate a temperature needed for
|
||||||
a thermostat fix or to generate thermodynamic or dump file output.
|
a thermostat fix or to generate thermodynamic or dump file output.
|
||||||
See this <a class="reference internal" href="Section_howto.html#howto-15"><span>howto section</span></a> for a summary of
|
See this <A HREF = "Section_howto.html#howto_15">howto section</A> for a summary of
|
||||||
various LAMMPS output options, many of which involve computes.</p>
|
various LAMMPS output options, many of which involve computes.
|
||||||
<p>The ID of a compute can only contain alphanumeric characters and
|
</P>
|
||||||
underscores.</p>
|
<P>The ID of a compute can only contain alphanumeric characters and
|
||||||
<hr class="docutils" />
|
underscores.
|
||||||
<p>Computes calculate one of three styles of quantities: global,
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Computes calculate one of three styles of quantities: global,
|
||||||
per-atom, or local. A global quantity is one or more system-wide
|
per-atom, or local. A global quantity is one or more system-wide
|
||||||
values, e.g. the temperature of the system. A per-atom quantity is
|
values, e.g. the temperature of the system. A per-atom quantity is
|
||||||
one or more values per atom, e.g. the kinetic energy of each atom.
|
one or more values per atom, e.g. the kinetic energy of each atom.
|
||||||
@ -169,260 +52,215 @@ Per-atom values are set to 0.0 for atoms not in the specified compute
|
|||||||
group. Local quantities are calculated by each processor based on the
|
group. Local quantities are calculated by each processor based on the
|
||||||
atoms it owns, but there may be zero or more per atom, e.g. a list of
|
atoms it owns, but there may be zero or more per atom, e.g. a list of
|
||||||
bond distances. Computes that produce per-atom quantities have the
|
bond distances. Computes that produce per-atom quantities have the
|
||||||
word “atom” in their style, e.g. <em>ke/atom</em>. Computes that produce
|
word "atom" in their style, e.g. <I>ke/atom</I>. Computes that produce
|
||||||
local quantities have the word “local” in their style,
|
local quantities have the word "local" in their style,
|
||||||
e.g. <em>bond/local</em>. Styles with neither “atom” or “local” in their
|
e.g. <I>bond/local</I>. Styles with neither "atom" or "local" in their
|
||||||
style produce global quantities.</p>
|
style produce global quantities.
|
||||||
<p>Note that a single compute produces either global or per-atom or local
|
</P>
|
||||||
quantities, but never more than one of these.</p>
|
<P>Note that a single compute produces either global or per-atom or local
|
||||||
<p>Global, per-atom, and local quantities each come in three kinds: a
|
quantities, but never more than one of these.
|
||||||
|
</P>
|
||||||
|
<P>Global, per-atom, and local quantities each come in three kinds: a
|
||||||
single scalar value, a vector of values, or a 2d array of values. The
|
single scalar value, a vector of values, or a 2d array of values. The
|
||||||
doc page for each compute describes the style and kind of values it
|
doc page for each compute describes the style and kind of values it
|
||||||
produces, e.g. a per-atom vector. Some computes produce more than one
|
produces, e.g. a per-atom vector. Some computes produce more than one
|
||||||
kind of a single style, e.g. a global scalar and a global vector.</p>
|
kind of a single style, e.g. a global scalar and a global vector.
|
||||||
<p>When a compute quantity is accessed, as in many of the output commands
|
</P>
|
||||||
|
<P>When a compute quantity is accessed, as in many of the output commands
|
||||||
discussed below, it can be referenced via the following bracket
|
discussed below, it can be referenced via the following bracket
|
||||||
notation, where ID is the ID of the compute:</p>
|
notation, where ID is the ID of the compute:
|
||||||
<table border="1" class="docutils">
|
</P>
|
||||||
<colgroup>
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
<col width="21%" />
|
<TR><TD >c_ID </TD><TD > entire scalar, vector, or array</TD></TR>
|
||||||
<col width="79%" />
|
<TR><TD >c_ID[I] </TD><TD > one element of vector, one column of array</TD></TR>
|
||||||
</colgroup>
|
<TR><TD >c_ID[I][J] </TD><TD > one element of array
|
||||||
<tbody valign="top">
|
</TD></TR></TABLE></DIV>
|
||||||
<tr class="row-odd"><td>c_ID</td>
|
|
||||||
<td>entire scalar, vector, or array</td>
|
<P>In other words, using one bracket reduces the dimension of the
|
||||||
</tr>
|
quantity once (vector -> scalar, array -> vector). Using two brackets
|
||||||
<tr class="row-even"><td>c_ID[I]</td>
|
reduces the dimension twice (array -> scalar). Thus a command that
|
||||||
<td>one element of vector, one column of array</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td>c_ID[I][J]</td>
|
|
||||||
<td>one element of array</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>In other words, using one bracket reduces the dimension of the
|
|
||||||
quantity once (vector -> scalar, array -> vector). Using two brackets
|
|
||||||
reduces the dimension twice (array -> scalar). Thus a command that
|
|
||||||
uses scalar compute values as input can also process elements of a
|
uses scalar compute values as input can also process elements of a
|
||||||
vector or array.</p>
|
vector or array.
|
||||||
<p>Note that commands and <a class="reference internal" href="variable.html"><em>variables</em></a> which use compute
|
</P>
|
||||||
|
<P>Note that commands and <A HREF = "variable.html">variables</A> which use compute
|
||||||
quantities typically do not allow for all kinds, e.g. a command may
|
quantities typically do not allow for all kinds, e.g. a command may
|
||||||
require a vector of values, not a scalar. This means there is no
|
require a vector of values, not a scalar. This means there is no
|
||||||
ambiguity about referring to a compute quantity as c_ID even if it
|
ambiguity about referring to a compute quantity as c_ID even if it
|
||||||
produces, for example, both a scalar and vector. The doc pages for
|
produces, for example, both a scalar and vector. The doc pages for
|
||||||
various commands explain the details.</p>
|
various commands explain the details.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>In LAMMPS, the values generated by a compute can be used in several
|
<HR>
|
||||||
ways:</p>
|
|
||||||
<ul class="simple">
|
<P>In LAMMPS, the values generated by a compute can be used in several
|
||||||
<li>The results of computes that calculate a global temperature or
|
ways:
|
||||||
|
</P>
|
||||||
|
<UL><LI>The results of computes that calculate a global temperature or
|
||||||
pressure can be used by fixes that do thermostatting or barostatting
|
pressure can be used by fixes that do thermostatting or barostatting
|
||||||
or when atom velocities are created.</li>
|
or when atom velocities are created.
|
||||||
<li>Global values can be output via the <a class="reference internal" href="thermo_style.html"><em>thermo_style custom</em></a> or <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a> command.
|
|
||||||
Or the values can be referenced in a <a class="reference internal" href="variable.html"><em>variable equal</em></a> or
|
<LI>Global values can be output via the <A HREF = "thermo_style.html">thermo_style
|
||||||
<a class="reference internal" href="variable.html"><em>variable atom</em></a> command.</li>
|
custom</A> or <A HREF = "fix_ave_time.html">fix ave/time</A> command.
|
||||||
<li>Per-atom values can be output via the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command
|
Or the values can be referenced in a <A HREF = "variable.html">variable equal</A> or
|
||||||
or the <a class="reference internal" href="fix_ave_spatial.html"><em>fix ave/spatial</em></a> command. Or they can be
|
<A HREF = "variable.html">variable atom</A> command.
|
||||||
time-averaged via the <a class="reference internal" href="fix_ave_atom.html"><em>fix ave/atom</em></a> command or
|
|
||||||
reduced by the <a class="reference internal" href="compute_reduce.html"><em>compute reduce</em></a> command. Or the
|
<LI>Per-atom values can be output via the <A HREF = "dump.html">dump custom</A> command
|
||||||
per-atom values can be referenced in an <a class="reference internal" href="variable.html"><em>atom-style variable</em></a>.</li>
|
or the <A HREF = "fix_ave_spatial.html">fix ave/spatial</A> command. Or they can be
|
||||||
<li>Local values can be reduced by the <a class="reference internal" href="compute_reduce.html"><em>compute reduce</em></a> command, or histogrammed by the <a class="reference internal" href="fix_ave_histo.html"><em>fix ave/histo</em></a> command, or output by the <a class="reference internal" href="dump.html"><em>dump local</em></a> command.</li>
|
time-averaged via the <A HREF = "fix_ave_atom.html">fix ave/atom</A> command or
|
||||||
</ul>
|
reduced by the <A HREF = "compute_reduce.html">compute reduce</A> command. Or the
|
||||||
<p>The results of computes that calculate global quantities can be either
|
per-atom values can be referenced in an <A HREF = "variable.html">atom-style
|
||||||
“intensive” or “extensive” values. Intensive means the value is
|
variable</A>.
|
||||||
|
|
||||||
|
<LI>Local values can be reduced by the <A HREF = "compute_reduce.html">compute
|
||||||
|
reduce</A> command, or histogrammed by the <A HREF = "fix_ave_histo.html">fix
|
||||||
|
ave/histo</A> command, or output by the <A HREF = "dump.html">dump
|
||||||
|
local</A> command.
|
||||||
|
</UL>
|
||||||
|
<P>The results of computes that calculate global quantities can be either
|
||||||
|
"intensive" or "extensive" values. Intensive means the value is
|
||||||
independent of the number of atoms in the simulation,
|
independent of the number of atoms in the simulation,
|
||||||
e.g. temperature. Extensive means the value scales with the number of
|
e.g. temperature. Extensive means the value scales with the number of
|
||||||
atoms in the simulation, e.g. total rotational kinetic energy.
|
atoms in the simulation, e.g. total rotational kinetic energy.
|
||||||
<a class="reference internal" href="thermo_style.html"><em>Thermodynamic output</em></a> will normalize extensive
|
<A HREF = "thermo_style.html">Thermodynamic output</A> will normalize extensive
|
||||||
values by the number of atoms in the system, depending on the
|
values by the number of atoms in the system, depending on the
|
||||||
“thermo_modify norm” setting. It will not normalize intensive values.
|
"thermo_modify norm" setting. It will not normalize intensive values.
|
||||||
If a compute value is accessed in another way, e.g. by a
|
If a compute value is accessed in another way, e.g. by a
|
||||||
<a class="reference internal" href="variable.html"><em>variable</em></a>, you may want to know whether it is an
|
<A HREF = "variable.html">variable</A>, you may want to know whether it is an
|
||||||
intensive or extensive value. See the doc page for individual
|
intensive or extensive value. See the doc page for individual
|
||||||
computes for further info.</p>
|
computes for further info.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>LAMMPS creates its own computes internally for thermodynamic output.
|
<HR>
|
||||||
Three computes are always created, named “thermo_temp”,
|
|
||||||
“thermo_press”, and “thermo_pe”, as if these commands had been invoked
|
<P>LAMMPS creates its own computes internally for thermodynamic output.
|
||||||
in the input script:</p>
|
Three computes are always created, named "thermo_temp",
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute thermo_temp all temp
|
"thermo_press", and "thermo_pe", as if these commands had been invoked
|
||||||
|
in the input script:
|
||||||
|
</P>
|
||||||
|
<PRE>compute thermo_temp all temp
|
||||||
compute thermo_press all pressure thermo_temp
|
compute thermo_press all pressure thermo_temp
|
||||||
compute thermo_pe all pe
|
compute thermo_pe all pe
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>Additional computes for other quantities are created if the thermo
|
||||||
<p>Additional computes for other quantities are created if the thermo
|
|
||||||
style requires it. See the documentation for the
|
style requires it. See the documentation for the
|
||||||
<a class="reference internal" href="thermo_style.html"><em>thermo_style</em></a> command.</p>
|
<A HREF = "thermo_style.html">thermo_style</A> command.
|
||||||
<p>Fixes that calculate temperature or pressure, i.e. for thermostatting
|
</P>
|
||||||
|
<P>Fixes that calculate temperature or pressure, i.e. for thermostatting
|
||||||
or barostatting, may also create computes. These are discussed in the
|
or barostatting, may also create computes. These are discussed in the
|
||||||
documentation for specific <a class="reference internal" href="fix.html"><em>fix</em></a> commands.</p>
|
documentation for specific <A HREF = "fix.html">fix</A> commands.
|
||||||
<p>In all these cases, the default computes LAMMPS creates can be
|
</P>
|
||||||
|
<P>In all these cases, the default computes LAMMPS creates can be
|
||||||
replaced by computes defined by the user in the input script, as
|
replaced by computes defined by the user in the input script, as
|
||||||
described by the <a class="reference internal" href="thermo_modify.html"><em>thermo_modify</em></a> and <a class="reference internal" href="fix_modify.html"><em>fix modify</em></a> commands.</p>
|
described by the <A HREF = "thermo_modify.html">thermo_modify</A> and <A HREF = "fix_modify.html">fix
|
||||||
<p>Properties of either a default or user-defined compute can be modified
|
modify</A> commands.
|
||||||
via the <a class="reference internal" href="compute_modify.html"><em>compute_modify</em></a> command.</p>
|
</P>
|
||||||
<p>Computes can be deleted with the <a class="reference internal" href="uncompute.html"><em>uncompute</em></a> command.</p>
|
<P>Properties of either a default or user-defined compute can be modified
|
||||||
<p>Code for new computes can be added to LAMMPS (see <a class="reference internal" href="Section_modify.html"><em>this section</em></a> of the manual) and the results of their
|
via the <A HREF = "compute_modify.html">compute_modify</A> command.
|
||||||
calculations accessed in the various ways described above.</p>
|
</P>
|
||||||
<hr class="docutils" />
|
<P>Computes can be deleted with the <A HREF = "uncompute.html">uncompute</A> command.
|
||||||
<p>Each compute style has its own doc page which describes its arguments
|
</P>
|
||||||
|
<P>Code for new computes can be added to LAMMPS (see <A HREF = "Section_modify.html">this
|
||||||
|
section</A> of the manual) and the results of their
|
||||||
|
calculations accessed in the various ways described above.
|
||||||
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>Each compute style has its own doc page which describes its arguments
|
||||||
and what it does. Here is an alphabetic list of compute styles
|
and what it does. Here is an alphabetic list of compute styles
|
||||||
available in LAMMPS. They are also given in more compact form in the
|
available in LAMMPS. They are also given in more compact form in the
|
||||||
compute section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
compute section of <A HREF = "Section_commands.html#cmd_5">this page</A>.
|
||||||
<p>There are also additional compute styles (not listed here) submitted
|
</P>
|
||||||
|
<P>There are also additional compute styles (not listed here) submitted
|
||||||
by users which are included in the LAMMPS distribution. The list of
|
by users which are included in the LAMMPS distribution. The list of
|
||||||
these with links to the individual styles are given in the compute
|
these with links to the individual styles are given in the compute
|
||||||
section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
section of <A HREF = "Section_commands.html#cmd_5">this page</A>.
|
||||||
<p>There are also additional accelerated compute styles (note listed
|
</P>
|
||||||
|
<P>There are also additional accelerated compute styles (note listed
|
||||||
here) included in the LAMMPS distribution for faster performance on
|
here) included in the LAMMPS distribution for faster performance on
|
||||||
CPUs and GPUs. The list of these with links to the individual styles
|
CPUs and GPUs. The list of these with links to the individual styles
|
||||||
are given in the compute section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
are given in the compute section of <A HREF = "Section_commands.html#cmd_5">this
|
||||||
<ul class="simple">
|
page</A>.
|
||||||
<li><a class="reference internal" href="compute_bond_local.html"><em>angle/local</em></a> - theta and energy of each angle</li>
|
</P>
|
||||||
<li><a class="reference internal" href="compute_body_local.html"><em>body/local</em></a> - attributes of body sub-particles</li>
|
<UL><LI><A HREF = "compute_bond_local.html">angle/local</A> - theta and energy of each angle
|
||||||
<li><a class="reference internal" href="compute_bond_local.html"><em>bond/local</em></a> - distance and energy of each bond</li>
|
<LI><A HREF = "compute_body_local.html">body/local</A> - attributes of body sub-particles
|
||||||
<li><a class="reference internal" href="compute_centro_atom.html"><em>centro/atom</em></a> - centro-symmetry parameter for each atom</li>
|
<LI><A HREF = "compute_bond_local.html">bond/local</A> - distance and energy of each bond
|
||||||
<li><a class="reference internal" href="compute_cluster_atom.html"><em>cluster/atom</em></a> - cluster ID for each atom</li>
|
<LI><A HREF = "compute_centro_atom.html">centro/atom</A> - centro-symmetry parameter for each atom
|
||||||
<li><a class="reference internal" href="compute_cna_atom.html"><em>cna/atom</em></a> - common neighbor analysis (CNA) for each atom</li>
|
<LI><A HREF = "compute_cluster_atom.html">cluster/atom</A> - cluster ID for each atom
|
||||||
<li><a class="reference internal" href="compute_com.html"><em>com</em></a> - center-of-mass of group of atoms</li>
|
<LI><A HREF = "compute_cna_atom.html">cna/atom</A> - common neighbor analysis (CNA) for each atom
|
||||||
<li><a class="reference internal" href="compute_com_chunk.html"><em>com/chunk</em></a> - center-of-mass for each chunk</li>
|
<LI><A HREF = "compute_com.html">com</A> - center-of-mass of group of atoms
|
||||||
<li><a class="reference internal" href="compute_contact_atom.html"><em>contact/atom</em></a> - contact count for each spherical particle</li>
|
<LI><A HREF = "compute_com_chunk.html">com/chunk</A> - center-of-mass for each chunk
|
||||||
<li><a class="reference internal" href="compute_coord_atom.html"><em>coord/atom</em></a> - coordination number for each atom</li>
|
<LI><A HREF = "compute_contact_atom.html">contact/atom</A> - contact count for each spherical particle
|
||||||
<li><a class="reference internal" href="compute_damage_atom.html"><em>damage/atom</em></a> - Peridynamic damage for each atom</li>
|
<LI><A HREF = "compute_coord_atom.html">coord/atom</A> - coordination number for each atom
|
||||||
<li><a class="reference internal" href="compute_dihedral_local.html"><em>dihedral/local</em></a> - angle of each dihedral</li>
|
<LI><A HREF = "compute_damage_atom.html">damage/atom</A> - Peridynamic damage for each atom
|
||||||
<li><a class="reference internal" href="compute_dilatation_atom.html"><em>dilatation/atom</em></a> - Peridynamic dilatation for each atom</li>
|
<LI><A HREF = "compute_dihedral_local.html">dihedral/local</A> - angle of each dihedral
|
||||||
<li><a class="reference internal" href="compute_displace_atom.html"><em>displace/atom</em></a> - displacement of each atom</li>
|
<LI><A HREF = "compute_dilatation_atom.html">dilatation/atom</A> - Peridynamic dilatation for each atom
|
||||||
<li><a class="reference internal" href="compute_erotate_asphere.html"><em>erotate/asphere</em></a> - rotational energy of aspherical particles</li>
|
<LI><A HREF = "compute_displace_atom.html">displace/atom</A> - displacement of each atom
|
||||||
<li><a class="reference internal" href="compute_erotate_rigid.html"><em>erotate/rigid</em></a> - rotational energy of rigid bodies</li>
|
<LI><A HREF = "compute_erotate_asphere.html">erotate/asphere</A> - rotational energy of aspherical particles
|
||||||
<li><a class="reference internal" href="compute_erotate_sphere.html"><em>erotate/sphere</em></a> - rotational energy of spherical particles</li>
|
<LI><A HREF = "compute_erotate_rigid.html">erotate/rigid</A> - rotational energy of rigid bodies
|
||||||
<li><a class="reference internal" href="compute_erotate_sphere.html"><em>erotate/sphere/atom</em></a> - rotational energy for each spherical particle</li>
|
<LI><A HREF = "compute_erotate_sphere.html">erotate/sphere</A> - rotational energy of spherical particles
|
||||||
<li><a class="reference internal" href="compute_event_displace.html"><em>event/displace</em></a> - detect event on atom displacement</li>
|
<LI><A HREF = "compute_erotate_sphere.html">erotate/sphere/atom</A> - rotational energy for each spherical particle
|
||||||
<li><a class="reference internal" href="compute_group_group.html"><em>group/group</em></a> - energy/force between two groups of atoms</li>
|
<LI><A HREF = "compute_event_displace.html">event/displace</A> - detect event on atom displacement
|
||||||
<li><a class="reference internal" href="compute_gyration.html"><em>gyration</em></a> - radius of gyration of group of atoms</li>
|
<LI><A HREF = "compute_group_group.html">group/group</A> - energy/force between two groups of atoms
|
||||||
<li><a class="reference internal" href="compute_gyration_chunk.html"><em>gyration/chunk</em></a> - radius of gyration for each chunk</li>
|
<LI><A HREF = "compute_gyration.html">gyration</A> - radius of gyration of group of atoms
|
||||||
<li><a class="reference internal" href="compute_heat_flux.html"><em>heat/flux</em></a> - heat flux through a group of atoms</li>
|
<LI><A HREF = "compute_gyration_chunk.html">gyration/chunk</A> - radius of gyration for each chunk
|
||||||
<li><a class="reference internal" href="compute_improper_local.html"><em>improper/local</em></a> - angle of each improper</li>
|
<LI><A HREF = "compute_heat_flux.html">heat/flux</A> - heat flux through a group of atoms
|
||||||
<li><a class="reference internal" href="compute_inertia_chunk.html"><em>inertia/chunk</em></a> - inertia tensor for each chunk</li>
|
<LI><A HREF = "compute_improper_local.html">improper/local</A> - angle of each improper
|
||||||
<li><a class="reference internal" href="compute_ke.html"><em>ke</em></a> - translational kinetic energy</li>
|
<LI><A HREF = "compute_inertia_chunk.html">inertia/chunk</A> - inertia tensor for each chunk
|
||||||
<li><a class="reference internal" href="compute_ke_atom.html"><em>ke/atom</em></a> - kinetic energy for each atom</li>
|
<LI><A HREF = "compute_ke.html">ke</A> - translational kinetic energy
|
||||||
<li><a class="reference internal" href="compute_ke_rigid.html"><em>ke/rigid</em></a> - translational kinetic energy of rigid bodies</li>
|
<LI><A HREF = "compute_ke_atom.html">ke/atom</A> - kinetic energy for each atom
|
||||||
<li><a class="reference internal" href="compute_msd.html"><em>msd</em></a> - mean-squared displacement of group of atoms</li>
|
<LI><A HREF = "compute_ke_rigid.html">ke/rigid</A> - translational kinetic energy of rigid bodies
|
||||||
<li><a class="reference internal" href="compute_msd_chunk.html"><em>msd/chunk</em></a> - mean-squared displacement for each chunk</li>
|
<LI><A HREF = "compute_msd.html">msd</A> - mean-squared displacement of group of atoms
|
||||||
<li><a class="reference internal" href="compute_msd_nongauss.html"><em>msd/nongauss</em></a> - MSD and non-Gaussian parameter of group of atoms</li>
|
<LI><A HREF = "compute_msd_chunk.html">msd/chunk</A> - mean-squared displacement for each chunk
|
||||||
<li><a class="reference internal" href="compute_pair.html"><em>pair</em></a> - values computed by a pair style</li>
|
<LI><A HREF = "compute_msd_nongauss.html">msd/nongauss</A> - MSD and non-Gaussian parameter of group of atoms
|
||||||
<li><a class="reference internal" href="compute_pair_local.html"><em>pair/local</em></a> - distance/energy/force of each pairwise interaction</li>
|
<LI><A HREF = "compute_pair.html">pair</A> - values computed by a pair style
|
||||||
<li><a class="reference internal" href="compute_pe.html"><em>pe</em></a> - potential energy</li>
|
<LI><A HREF = "compute_pair_local.html">pair/local</A> - distance/energy/force of each pairwise interaction
|
||||||
<li><a class="reference internal" href="compute_pe_atom.html"><em>pe/atom</em></a> - potential energy for each atom</li>
|
<LI><A HREF = "compute_pe.html">pe</A> - potential energy
|
||||||
<li><a class="reference internal" href="compute_plasticity_atom.html"><em>plasticity/atom</em></a> - Peridynamic plasticity for each atom</li>
|
<LI><A HREF = "compute_pe_atom.html">pe/atom</A> - potential energy for each atom
|
||||||
<li><a class="reference internal" href="compute_pressure.html"><em>pressure</em></a> - total pressure and pressure tensor</li>
|
<LI><A HREF = "compute_plasticity_atom.html">plasticity/atom</A> - Peridynamic plasticity for each atom
|
||||||
<li><a class="reference internal" href="compute_property_atom.html"><em>property/atom</em></a> - convert atom attributes to per-atom vectors/arrays</li>
|
<LI><A HREF = "compute_pressure.html">pressure</A> - total pressure and pressure tensor
|
||||||
<li><a class="reference internal" href="compute_property_local.html"><em>property/local</em></a> - convert local attributes to localvectors/arrays</li>
|
<LI><A HREF = "compute_property_atom.html">property/atom</A> - convert atom attributes to per-atom vectors/arrays
|
||||||
<li><a class="reference internal" href="compute_property_chunk.html"><em>property/chunk</em></a> - extract various per-chunk attributes</li>
|
<LI><A HREF = "compute_property_local.html">property/local</A> - convert local attributes to localvectors/arrays
|
||||||
<li><a class="reference internal" href="compute_rdf.html"><em>rdf</em></a> - radial distribution function g(r) histogram of group of atoms</li>
|
<LI><A HREF = "compute_property_chunk.html">property/chunk</A> - extract various per-chunk attributes
|
||||||
<li><a class="reference internal" href="compute_reduce.html"><em>reduce</em></a> - combine per-atom quantities into a single global value</li>
|
<LI><A HREF = "compute_rdf.html">rdf</A> - radial distribution function g(r) histogram of group of atoms
|
||||||
<li><a class="reference internal" href="compute_reduce.html"><em>reduce/region</em></a> - same as compute reduce, within a region</li>
|
<LI><A HREF = "compute_reduce.html">reduce</A> - combine per-atom quantities into a single global value
|
||||||
<li><a class="reference internal" href="compute_slice.html"><em>slice</em></a> - extract values from global vector or array</li>
|
<LI><A HREF = "compute_reduce.html">reduce/region</A> - same as compute reduce, within a region
|
||||||
<li><code class="xref doc docutils literal"><span class="pre">sna/atom</span></code> - calculate bispectrum coefficients for each atom</li>
|
<LI><A HREF = "compute_slice.html">slice</A> - extract values from global vector or array
|
||||||
<li><code class="xref doc docutils literal"><span class="pre">snad/atom</span></code> - derivative of bispectrum coefficients for each atom</li>
|
<LI><A HREF = "compute_sna.html">sna/atom</A> - calculate bispectrum coefficients for each atom
|
||||||
<li><code class="xref doc docutils literal"><span class="pre">snav/atom</span></code> - virial contribution from bispectrum coefficients for each atom</li>
|
<LI><A HREF = "compute_sna.html">snad/atom</A> - derivative of bispectrum coefficients for each atom
|
||||||
<li><a class="reference internal" href="compute_stress_atom.html"><em>stress/atom</em></a> - stress tensor for each atom</li>
|
<LI><A HREF = "compute_sna.html">snav/atom</A> - virial contribution from bispectrum coefficients for each atom
|
||||||
<li><a class="reference internal" href="compute_temp.html"><em>temp</em></a> - temperature of group of atoms</li>
|
<LI><A HREF = "compute_stress_atom.html">stress/atom</A> - stress tensor for each atom
|
||||||
<li><a class="reference internal" href="compute_temp_asphere.html"><em>temp/asphere</em></a> - temperature of aspherical particles</li>
|
<LI><A HREF = "compute_temp.html">temp</A> - temperature of group of atoms
|
||||||
<li><a class="reference internal" href="compute_temp_chunk.html"><em>temp/chunk</em></a> - temperature of each chunk</li>
|
<LI><A HREF = "compute_temp_asphere.html">temp/asphere</A> - temperature of aspherical particles
|
||||||
<li><a class="reference internal" href="compute_temp_com.html"><em>temp/com</em></a> - temperature after subtracting center-of-mass velocity</li>
|
<LI><A HREF = "compute_temp_chunk.html">temp/chunk</A> - temperature of each chunk
|
||||||
<li><a class="reference internal" href="compute_temp_deform.html"><em>temp/deform</em></a> - temperature excluding box deformation velocity</li>
|
<LI><A HREF = "compute_temp_com.html">temp/com</A> - temperature after subtracting center-of-mass velocity
|
||||||
<li><a class="reference internal" href="compute_temp_partial.html"><em>temp/partial</em></a> - temperature excluding one or more dimensions of velocity</li>
|
<LI><A HREF = "compute_temp_deform.html">temp/deform</A> - temperature excluding box deformation velocity
|
||||||
<li><a class="reference internal" href="compute_temp_profile.html"><em>temp/profile</em></a> - temperature excluding a binned velocity profile</li>
|
<LI><A HREF = "compute_temp_partial.html">temp/partial</A> - temperature excluding one or more dimensions of velocity
|
||||||
<li><a class="reference internal" href="compute_temp_ramp.html"><em>temp/ramp</em></a> - temperature excluding ramped velocity component</li>
|
<LI><A HREF = "compute_temp_profile.html">temp/profile</A> - temperature excluding a binned velocity profile
|
||||||
<li><a class="reference internal" href="compute_temp_region.html"><em>temp/region</em></a> - temperature of a region of atoms</li>
|
<LI><A HREF = "compute_temp_ramp.html">temp/ramp</A> - temperature excluding ramped velocity component
|
||||||
<li><a class="reference internal" href="compute_temp_sphere.html"><em>temp/sphere</em></a> - temperature of spherical particles</li>
|
<LI><A HREF = "compute_temp_region.html">temp/region</A> - temperature of a region of atoms
|
||||||
<li><a class="reference internal" href="compute_ti.html"><em>ti</em></a> - thermodyanmic integration free energy values</li>
|
<LI><A HREF = "compute_temp_sphere.html">temp/sphere</A> - temperature of spherical particles
|
||||||
<li><a class="reference internal" href="compute_torque_chunk.html"><em>torque/chunk</em></a> - torque applied on each chunk</li>
|
<LI><A HREF = "compute_ti.html">ti</A> - thermodyanmic integration free energy values
|
||||||
<li><a class="reference internal" href="compute_vacf.html"><em>vacf</em></a> - velocity-autocorrelation function of group of atoms</li>
|
<LI><A HREF = "compute_torque_chunk.html">torque/chunk</A> - torque applied on each chunk
|
||||||
<li><a class="reference internal" href="compute_vcm_chunk.html"><em>vcm/chunk</em></a> - velocity of center-of-mass for each chunk</li>
|
<LI><A HREF = "compute_vacf.html">vacf</A> - velocity-autocorrelation function of group of atoms
|
||||||
<li><a class="reference internal" href="compute_voronoi_atom.html"><em>voronoi/atom</em></a> - Voronoi volume and neighbors for each atom</li>
|
<LI><A HREF = "compute_vcm_chunk.html">vcm/chunk</A> - velocity of center-of-mass for each chunk
|
||||||
</ul>
|
<LI><A HREF = "compute_voronoi_atom.html">voronoi/atom</A> - Voronoi volume and neighbors for each atom
|
||||||
<p>There are also additional compute styles submitted by users which are
|
</UL>
|
||||||
|
<P>There are also additional compute styles submitted by users which are
|
||||||
included in the LAMMPS distribution. The list of these with links to
|
included in the LAMMPS distribution. The list of these with links to
|
||||||
the individual styles are given in the compute section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
the individual styles are given in the compute section of <A HREF = "Section_commands.html#cmd_5">this
|
||||||
<p>There are also additional accelerated compute styles included in the
|
page</A>.
|
||||||
|
</P>
|
||||||
|
<P>There are also additional accelerated compute styles included in the
|
||||||
LAMMPS distribution for faster performance on CPUs and GPUs. The list
|
LAMMPS distribution for faster performance on CPUs and GPUs. The list
|
||||||
of these with links to the individual styles are given in the pair
|
of these with links to the individual styles are given in the pair
|
||||||
section of <a class="reference internal" href="Section_commands.html#cmd-5"><span>this page</span></a>.</p>
|
section of <A HREF = "Section_commands.html#cmd_5">this page</A>.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B> none
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Related commands:</B>
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><A HREF = "uncompute.html">uncompute</A>, <A HREF = "compute_modify.html">compute_modify</A>, <A HREF = "fix_ave_atom.html">fix
|
||||||
<div class="section" id="related-commands">
|
ave/atom</A>, <A HREF = "fix_ave_spatial.html">fix ave/spatial</A>,
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<A HREF = "fix_ave_time.html">fix ave/time</A>, <A HREF = "fix_ave_histo.html">fix ave/histo</A>
|
||||||
<p><a class="reference internal" href="uncompute.html"><em>uncompute</em></a>, <a class="reference internal" href="compute_modify.html"><em>compute_modify</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_time.html"><em>fix ave/time</em></a>, <a class="reference internal" href="fix_ave_histo.html"><em>fix ave/histo</em></a></p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,252 +1,80 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute ackland/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute ackland/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute ackland/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID ackland/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>ackland/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all ackland/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Defines a computation that calculates the local lattice structure
|
||||||
<div itemprop="articleBody">
|
according to the formulation given in <A HREF = "#Ackland">(Ackland)</A>.
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-ackland-atom-command">
|
<P>In contrast to the <A HREF = "compute_centro_atom.html">centro-symmetry
|
||||||
<span id="index-0"></span><h1>compute ackland/atom command<a class="headerlink" href="#compute-ackland-atom-command" title="Permalink to this headline">¶</a></h1>
|
parameter</A> this method is stable against
|
||||||
<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>compute ID group-ID ackland/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>ackland/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all ackland/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Defines a computation that calculates the local lattice structure
|
|
||||||
according to the formulation given in <a class="reference internal" href="#ackland"><span>(Ackland)</span></a>.</p>
|
|
||||||
<p>In contrast to the <a class="reference internal" href="compute_centro_atom.html"><em>centro-symmetry parameter</em></a> this method is stable against
|
|
||||||
temperature boost, because it is based not on the distance between
|
temperature boost, because it is based not on the distance between
|
||||||
particles but the angles. Therefore statistical fluctuations are
|
particles but the angles. Therefore statistical fluctuations are
|
||||||
averaged out a little more. A comparison with the Common Neighbor
|
averaged out a little more. A comparison with the Common Neighbor
|
||||||
Analysis metric is made in the paper.</p>
|
Analysis metric is made in the paper.
|
||||||
<p>The result is a number which is mapped to the following different
|
</P>
|
||||||
lattice structures:</p>
|
<P>The result is a number which is mapped to the following different
|
||||||
<ul class="simple">
|
lattice structures:
|
||||||
<li>0 = UNKNOWN</li>
|
</P>
|
||||||
<li>1 = BCC</li>
|
<UL><LI>0 = UNKNOWN
|
||||||
<li>2 = FCC</li>
|
<LI>1 = BCC
|
||||||
<li>3 = HCP</li>
|
<LI>2 = FCC
|
||||||
<li>4 = ICO</li>
|
<LI>3 = HCP
|
||||||
</ul>
|
<LI>4 = ICO
|
||||||
<p>The neighbor list needed to compute this quantity is constructed each
|
</UL>
|
||||||
|
<P>The neighbor list needed to compute this quantity is constructed each
|
||||||
time the calculation is performed (i.e. each time a snapshot of atoms
|
time the calculation is performed (i.e. each time a snapshot of atoms
|
||||||
is dumped). Thus it can be inefficient to compute/dump this quantity
|
is dumped). Thus it can be inefficient to compute/dump this quantity
|
||||||
too frequently or to have multiple compute/dump commands, each of
|
too frequently or to have multiple compute/dump commands, each of
|
||||||
which computes this quantity.-</p>
|
which computes this quantity.-
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>This compute is part of the USER-MISC package. It is only enabled if
|
<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>
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p>The per-atom vector values will be unitless since they are the
|
LAMMPS</A> section for more info.
|
||||||
integers defined above.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values will be unitless since they are the
|
||||||
<div class="section" id="related-commands">
|
integers defined above.
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="compute_centro_atom.html"><em>compute centro/atom</em></a></p>
|
<P><B>Related commands:</B>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
<hr class="docutils" />
|
<P><A HREF = "compute_centro_atom.html">compute centro/atom</A>
|
||||||
<p id="ackland"><strong>(Ackland)</strong> Ackland, Jones, Phys Rev B, 73, 054104 (2006).</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<A NAME = "Ackland"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Ackland)</B> Ackland, Jones, Phys Rev B, 73, 054104 (2006).
|
||||||
</div>
|
</P>
|
||||||
<footer>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,260 +1,87 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute angle/local command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute angle/local command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute angle/local command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID angle/local input1 input2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>angle/local = style name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>one or more keywords may be appended
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>keyword = <I>theta</I> or <I>eng</I>
|
||||||
|
|
||||||
</div>
|
<PRE> <I>theta</I> = tabulate angles
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<I>eng</I> = tabulate angle energies
|
||||||
<div itemprop="articleBody">
|
</PRE>
|
||||||
|
|
||||||
<div class="section" id="compute-angle-local-command">
|
</UL>
|
||||||
<span id="index-0"></span><h1>compute angle/local command<a class="headerlink" href="#compute-angle-local-command" title="Permalink to this headline">¶</a></h1>
|
<P><B>Examples:</B>
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<PRE>compute 1 all angle/local theta
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID angle/local input1 input2 ...
|
compute 1 all angle/local eng theta
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
<P>Define a computation that calculates properties of individual angle
|
||||||
<li>angle/local = style name of this compute command</li>
|
|
||||||
<li>one or more keywords may be appended</li>
|
|
||||||
<li>keyword = <em>theta</em> or <em>eng</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>theta</em> = tabulate angles
|
|
||||||
<em>eng</em> = tabulate angle energies
|
|
||||||
</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>compute 1 all angle/local theta
|
|
||||||
compute 1 all angle/local eng theta
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates properties of individual angle
|
|
||||||
interactions. The number of datums generated, aggregated across all
|
interactions. The number of datums generated, aggregated across all
|
||||||
processors, equals the number of angles in the system, modified by the
|
processors, equals the number of angles in the system, modified by the
|
||||||
group parameter as explained below.</p>
|
group parameter as explained below.
|
||||||
<p>The local data stored by this command is generated by looping over all
|
</P>
|
||||||
|
<P>The local data stored by this command is generated by looping over all
|
||||||
the atoms owned on a processor and their angles. An angle will only
|
the atoms owned on a processor and their angles. An angle will only
|
||||||
be included if all 3 atoms in the angle are in the specified compute
|
be included if all 3 atoms in the angle are in the specified compute
|
||||||
group. Any angles that have been broken (see the
|
group. Any angles that have been broken (see the
|
||||||
<a class="reference internal" href="angle_style.html"><em>angle_style</em></a> command) by setting their angle type to
|
<A HREF = "angle_style.html">angle_style</A> command) by setting their angle type to
|
||||||
0 are not included. Angles that have been turned off (see the <a class="reference internal" href="fix_shake.html"><em>fix shake</em></a> or <a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a> commands) by
|
0 are not included. Angles that have been turned off (see the <A HREF = "fix_shake.html">fix
|
||||||
|
shake</A> or <A HREF = "delete_bonds.html">delete_bonds</A> commands) by
|
||||||
setting their angle type negative are written into the file, but their
|
setting their angle type negative are written into the file, but their
|
||||||
energy will be 0.0.</p>
|
energy will be 0.0.
|
||||||
<p>Note that as atoms migrate from processor to processor, there will be
|
</P>
|
||||||
|
<P>Note that as atoms migrate from processor to processor, there will be
|
||||||
no consistent ordering of the entries within the local vector or array
|
no consistent ordering of the entries within the local vector or array
|
||||||
from one timestep to the next. The only consistency that is
|
from one timestep to the next. The only consistency that is
|
||||||
guaranteed is that the ordering on a particular timestep will be the
|
guaranteed is that the ordering on a particular timestep will be the
|
||||||
same for local vectors or arrays generated by other compute commands.
|
same for local vectors or arrays generated by other compute commands.
|
||||||
For example, angle output from the <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a> command can be combined
|
For example, angle output from the <A HREF = "compute_property_local.html">compute
|
||||||
with data from this command and output by the <a class="reference internal" href="dump.html"><em>dump local</em></a>
|
property/local</A> command can be combined
|
||||||
command in a consistent way.</p>
|
with data from this command and output by the <A HREF = "dump.html">dump local</A>
|
||||||
<p><strong>Output info:</strong></p>
|
command in a consistent way.
|
||||||
<p>This compute calculates a local vector or local array depending on the
|
</P>
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a local vector or local array depending on the
|
||||||
number of keywords. The length of the vector or number of rows in the
|
number of keywords. The length of the vector or number of rows in the
|
||||||
array is the number of angles. If a single keyword is specified, a
|
array is the number of angles. If a single keyword is specified, a
|
||||||
local vector is produced. If two or more keywords are specified, a
|
local vector is produced. If two or more keywords are specified, a
|
||||||
local array is produced where the number of columns = the number of
|
local array is produced where the number of columns = the number of
|
||||||
keywords. The vector or array can be accessed by any command that
|
keywords. The vector or array can be accessed by any command that
|
||||||
uses local values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
uses local values from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>The output for <em>theta</em> will be in degrees. The output for <em>eng</em> will
|
options.
|
||||||
be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The output for <I>theta</I> will be in degrees. The output for <I>eng</I> will
|
||||||
<div class="section" id="restrictions">
|
be in energy <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "dump.html">dump local</A>, <A HREF = "compute_property_local.html">compute
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump local</em></a>, <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a></p>
|
property/local</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,270 +1,94 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute angmom/chunk command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute angmom/chunk command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute angmom/chunk command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID angmom/chunk chunkID
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>angmom/chunk = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>chunkID = ID of <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 fluid angmom/chunk molchunk
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that calculates the angular momemtum of multiple
|
||||||
|
chunks of atoms.
|
||||||
<div class="section" id="compute-angmom-chunk-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>compute angmom/chunk command<a class="headerlink" href="#compute-angmom-chunk-command" title="Permalink to this headline">¶</a></h1>
|
<P>In LAMMPS, chunks are collections of atoms defined by a <A HREF = "compute_chunk_atom.html">compute
|
||||||
<div class="section" id="syntax">
|
chunk/atom</A> command, which assigns each atom
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID angmom/chunk chunkID
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>angmom/chunk = style name of this compute command</li>
|
|
||||||
<li>chunkID = ID of <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 fluid angmom/chunk molchunk
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the angular momemtum of multiple
|
|
||||||
chunks of atoms.</p>
|
|
||||||
<p>In LAMMPS, chunks are collections of atoms defined by a <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command, which assigns each atom
|
|
||||||
to a single chunk (or no chunk). The ID for this command is specified
|
to a single chunk (or no chunk). The ID for this command is specified
|
||||||
as chunkID. For example, a single chunk could be the atoms in a
|
as chunkID. For example, a single chunk could be the atoms in a
|
||||||
molecule or atoms in a spatial bin. See the <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> doc page and “<a class="reference internal" href="Section_howto.html#howto-23"><span>Section_howto 23</span></a> for details of how chunks can be
|
molecule or atoms in a spatial bin. See the <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> doc page and "<A HREF = "Section_howto.html#howto_23">Section_howto
|
||||||
|
23</A> for details of how chunks can be
|
||||||
defined and examples of how they can be used to measure properties of
|
defined and examples of how they can be used to measure properties of
|
||||||
a system.</p>
|
a system.
|
||||||
<p>This compute calculates the 3 components of the angular momentum
|
</P>
|
||||||
|
<P>This compute calculates the 3 components of the angular momentum
|
||||||
vector for each chunk, due to the velocity/momentum of the individual
|
vector for each chunk, due to the velocity/momentum of the individual
|
||||||
atoms in the chunk around the center-of-mass of the chunk. The
|
atoms in the chunk around the center-of-mass of the chunk. The
|
||||||
calculation includes all effects due to atoms passing thru periodic
|
calculation includes all effects due to atoms passing thru periodic
|
||||||
boundaries.</p>
|
boundaries.
|
||||||
<p>Note that only atoms in the specified group contribute to the
|
</P>
|
||||||
calculation. The <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command
|
<P>Note that only atoms in the specified group contribute to the
|
||||||
|
calculation. The <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
defines its own group; atoms will have a chunk ID = 0 if they are not
|
defines its own group; atoms will have a chunk ID = 0 if they are not
|
||||||
in that group, signifying they are not assigned to a chunk, and will
|
in that group, signifying they are not assigned to a chunk, and will
|
||||||
thus also not contribute to this calculation. You can specify the
|
thus also not contribute to this calculation. You can specify the
|
||||||
“all” group for this command if you simply want to include atoms with
|
"all" group for this command if you simply want to include atoms with
|
||||||
non-zero chunk IDs.</p>
|
non-zero chunk IDs.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The coordinates of an atom contribute to the chunk's
|
||||||
<p class="last">The coordinates of an atom contribute to the chunk’s
|
angular momentum in "unwrapped" form, by using the image flags
|
||||||
angular momentum in “unwrapped” form, by using the image flags
|
associated with each atom. See the <A HREF = "dump.html">dump custom</A> command
|
||||||
associated with each atom. See the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command
|
for a discussion of "unwrapped" coordinates. See the Atoms section of
|
||||||
for a discussion of “unwrapped” coordinates. See the Atoms section of
|
the <A HREF = "read_data.html">read_data</A> command for a discussion of image flags
|
||||||
the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command for a discussion of image flags
|
|
||||||
and how they are set for each atom. You can reset the image flags
|
and how they are set for each atom. You can reset the image flags
|
||||||
(e.g. to 0) before invoking this compute by using the <a class="reference internal" href="set.html"><em>set image</em></a> command.</p>
|
(e.g. to 0) before invoking this compute by using the <A HREF = "set.html">set
|
||||||
</div>
|
image</A> command.
|
||||||
<p>The simplest way to output the results of the compute angmom/chunk
|
</P>
|
||||||
calculation to a file is to use the <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>
|
<P>The simplest way to output the results of the compute angmom/chunk
|
||||||
command, for example:</p>
|
calculation to a file is to use the <A HREF = "fix_ave_time.html">fix ave/time</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute cc1 all chunk/atom molecule
|
command, for example:
|
||||||
|
</P>
|
||||||
|
<PRE>compute cc1 all chunk/atom molecule
|
||||||
compute myChunk all angmom/chunk cc1
|
compute myChunk all angmom/chunk cc1
|
||||||
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Output info:</B>
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global array where the number of rows = the
|
<P>This compute calculates a global array where the number of rows = the
|
||||||
number of chunks <em>Nchunk</em> as calculated by the specified <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command. The number of columns =
|
number of chunks <I>Nchunk</I> as calculated by the specified <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> command. The number of columns =
|
||||||
3 for the 3 xyz components of the angular momentum for each chunk.
|
3 for the 3 xyz components of the angular momentum for each chunk.
|
||||||
These values can be accessed by any command that uses global array
|
These values can be accessed by any command that uses global array
|
||||||
values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
values from a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The array values are “intensive”. The array values will be in
|
options.
|
||||||
mass-velocity-distance <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The array values are "intensive". The array values will be in
|
||||||
<div class="section" id="restrictions">
|
mass-velocity-distance <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "variable.html">variable angmom() function</A>
|
||||||
<p><a class="reference internal" href="variable.html"><em>variable angmom() function</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,250 +1,82 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute basal/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute basal/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute basal/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID basal/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>basal/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all basal/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Defines a computation that calculates the hexagonal close-packed "c"
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-basal-atom-command">
|
|
||||||
<span id="index-0"></span><h1>compute basal/atom command<a class="headerlink" href="#compute-basal-atom-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>compute ID group-ID basal/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>basal/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all basal/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Defines a computation that calculates the hexagonal close-packed “c”
|
|
||||||
lattice vector for each atom in the group. It does this by
|
lattice vector for each atom in the group. It does this by
|
||||||
calculating the normal unit vector to the basal plane for each atom.
|
calculating the normal unit vector to the basal plane for each atom.
|
||||||
The results enable efficient identification and characterization of
|
The results enable efficient identification and characterization of
|
||||||
twins and grains in hexagonal close-packed structures.</p>
|
twins and grains in hexagonal close-packed structures.
|
||||||
<p>The output of the compute is thus the 3 components of a unit vector
|
</P>
|
||||||
|
<P>The output of the compute is thus the 3 components of a unit vector
|
||||||
associdate with each atom. The components are set to 0.0 for
|
associdate with each atom. The components are set to 0.0 for
|
||||||
atoms not in the group.</p>
|
atoms not in the group.
|
||||||
<p>Details of the calculation are given in <a class="reference internal" href="#barrett"><span>(Barrett)</span></a>.</p>
|
</P>
|
||||||
<p>The neighbor list needed to compute this quantity is constructed each
|
<P>Details of the calculation are given in <A HREF = "#Barrett">(Barrett)</A>.
|
||||||
|
</P>
|
||||||
|
<P>The neighbor list needed to compute this quantity is constructed each
|
||||||
time the calculation is performed (i.e. each time a snapshot of atoms
|
time the calculation is performed (i.e. each time a snapshot of atoms
|
||||||
is dumped). Thus it can be inefficient to compute/dump this quantity
|
is dumped). Thus it can be inefficient to compute/dump this quantity
|
||||||
too frequently or to have multiple compute/dump commands, each of
|
too frequently or to have multiple compute/dump commands, each of
|
||||||
which computes this quantity.</p>
|
which computes this quantity.
|
||||||
<p>An example input script that uses this compute is provided
|
</P>
|
||||||
in examples/USER/misc/basal.</p>
|
<P>An example input script that uses this compute is provided
|
||||||
<p><strong>Output info:</strong></p>
|
in examples/USER/misc/basal.
|
||||||
<p>This compute calculates a per-atom array with 3 columns, which can be
|
</P>
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom array with 3 columns, which can be
|
||||||
accessed by indices 1-3 by any command that uses per-atom values from
|
accessed by indices 1-3 by any command that uses per-atom values from
|
||||||
a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The per-atom vector values are unitless since the 3 columns represent
|
options.
|
||||||
components of a unit vector.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values are unitless since the 3 columns represent
|
||||||
<div class="section" id="restrictions">
|
components of a unit vector.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>This compute is part of the USER-MISC package. It is only enabled if
|
<P><B>Restrictions:</B>
|
||||||
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>
|
</P>
|
||||||
<p>The output of this compute will be meaningless unless the atoms are on
|
<P>This compute is part of the USER-MISC package. It is only enabled if
|
||||||
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
|
LAMMPS</A> section for more info.
|
||||||
|
</P>
|
||||||
|
<P>The output of this compute will be meaningless unless the atoms are on
|
||||||
(or near) hcp lattice sites, since the calculation assumes a
|
(or near) hcp lattice sites, since the calculation assumes a
|
||||||
well-defined basal plane.</p>
|
well-defined basal plane.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><B>Related commands:</B>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="compute_centro_atom.html"><em>compute centro/atom</em></a>, <a class="reference internal" href="compute_ackland_atom.html"><em>compute ackland/atom</em></a></p>
|
<P><A HREF = "compute_centro_atom.html">compute centro/atom</A>, <A HREF = "compute_ackland_atom.html">compute
|
||||||
<p><strong>Default:</strong> none</p>
|
ackland/atom</A>
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p id="barrett"><strong>(Barrett)</strong> Barrett, Tschopp, El Kadiri, Scripta Mat. 66, p.666 (2012).</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<HR>
|
||||||
|
|
||||||
|
<A NAME = "Barrett"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Barrett)</B> Barrett, Tschopp, El Kadiri, Scripta Mat. 66, p.666 (2012).
|
||||||
</div>
|
</P>
|
||||||
<footer>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,272 +1,99 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute body/local command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute body/local command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute body/local command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID body/local input1 input2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>body/local = style name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>one or more keywords may be appended
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>keyword = <I>type</I> or <I>integer</I>
|
||||||
|
|
||||||
</div>
|
<PRE> <I>type</I> = atom type of the body particle
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<I>integer</I> = 1,2,3,etc = index of fields defined by body style
|
||||||
<div itemprop="articleBody">
|
</PRE>
|
||||||
|
|
||||||
<div class="section" id="compute-body-local-command">
|
</UL>
|
||||||
<span id="index-0"></span><h1>compute body/local command<a class="headerlink" href="#compute-body-local-command" title="Permalink to this headline">¶</a></h1>
|
<P><B>Examples:</B>
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<PRE>compute 1 all body/local type 1 2 3
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID body/local input1 input2 ...
|
compute 1 all body/local 3 6
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
<P>Define a computation that calculates properties of individual body
|
||||||
<li>body/local = style name of this compute command</li>
|
|
||||||
<li>one or more keywords may be appended</li>
|
|
||||||
<li>keyword = <em>type</em> or <em>integer</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>type</em> = atom type of the body particle
|
|
||||||
<em>integer</em> = 1,2,3,etc = index of fields defined by body style
|
|
||||||
</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>compute 1 all body/local type 1 2 3
|
|
||||||
compute 1 all body/local 3 6
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates properties of individual body
|
|
||||||
sub-particles. The number of datums generated, aggregated across all
|
sub-particles. The number of datums generated, aggregated across all
|
||||||
processors, equals the number of body sub-particles plus the number of
|
processors, equals the number of body sub-particles plus the number of
|
||||||
non-body particles in the system, modified by the group parameter as
|
non-body particles in the system, modified by the group parameter as
|
||||||
explained below. See <a class="reference internal" href="Section_howto.html#howto-14"><span>Section_howto 14</span></a>
|
explained below. See <A HREF = "Section_howto.html#howto_14">Section_howto 14</A>
|
||||||
of the manual and the <a class="reference internal" href="body.html"><em>body</em></a> doc page for more details on
|
of the manual and the <A HREF = "body.html">body</A> doc page for more details on
|
||||||
using body particles.</p>
|
using body particles.
|
||||||
<p>The local data stored by this command is generated by looping over all
|
</P>
|
||||||
|
<P>The local data stored by this command is generated by looping over all
|
||||||
the atoms. An atom will only be included if it is in the group. If
|
the atoms. An atom will only be included if it is in the group. If
|
||||||
the atom is a body particle, then its N sub-particles will be looped
|
the atom is a body particle, then its N sub-particles will be looped
|
||||||
over, and it will contribute N datums to the count of datums. If it
|
over, and it will contribute N datums to the count of datums. If it
|
||||||
is not a body particle, it will contribute 1 datum.</p>
|
is not a body particle, it will contribute 1 datum.
|
||||||
<p>For both body particles and non-body particles, the <em>type</em> keyword
|
</P>
|
||||||
will store the type of the atom.</p>
|
<P>For both body particles and non-body particles, the <I>type</I> keyword
|
||||||
<p>The <em>integer</em> keywords mean different things for body and non-body
|
will store the type of the atom.
|
||||||
particles. If the atom is not a body particle, only its <em>x</em>, <em>y</em>, <em>z</em>
|
</P>
|
||||||
coordinates can be referenced, using the <em>integer</em> keywords 1,2,3.
|
<P>The <I>integer</I> keywords mean different things for body and non-body
|
||||||
|
particles. If the atom is not a body particle, only its <I>x</I>, <I>y</I>, <I>z</I>
|
||||||
|
coordinates can be referenced, using the <I>integer</I> keywords 1,2,3.
|
||||||
Note that this means that if you want to access more fields than this
|
Note that this means that if you want to access more fields than this
|
||||||
for body particles, then you cannot include non-body particles in the
|
for body particles, then you cannot include non-body particles in the
|
||||||
group.</p>
|
group.
|
||||||
<p>For a body particle, the <em>integer</em> keywords refer to fields calculated
|
</P>
|
||||||
|
<P>For a body particle, the <I>integer</I> keywords refer to fields calculated
|
||||||
by the body style for each sub-particle. The body style, as specified
|
by the body style for each sub-particle. The body style, as specified
|
||||||
by the <a class="reference internal" href="atom_style.html"><em>atom_style body</em></a>, determines how many fields
|
by the <A HREF = "atom_style.html">atom_style body</A>, determines how many fields
|
||||||
exist and what they are. See the <a class="reference internal" href="body.html"><em>body</em></a> doc page for
|
exist and what they are. See the <A HREF = "body.html">body</A> doc page for
|
||||||
details of the different styles.</p>
|
details of the different styles.
|
||||||
<p>Here is an example of how to output body information using the <a class="reference internal" href="dump.html"><em>dump local</em></a> command with this compute. If fields 1,2,3 for the
|
</P>
|
||||||
|
<P>Here is an example of how to output body information using the <A HREF = "dump.html">dump
|
||||||
|
local</A> command with this compute. If fields 1,2,3 for the
|
||||||
body sub-particles are x,y,z coordinates, then the dump file will be
|
body sub-particles are x,y,z coordinates, then the dump file will be
|
||||||
formatted similar to the output of a <a class="reference internal" href="dump.html"><em>dump atom or custom</em></a>
|
formatted similar to the output of a <A HREF = "dump.html">dump atom or custom</A>
|
||||||
command.</p>
|
command.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute 1 all body/local type 1 2 3
|
</P>
|
||||||
dump 1 all local 1000 tmp.dump index c_1[1] c_1[2] c_1[3] c_1[4]
|
<PRE>compute 1 all body/local type 1 2 3
|
||||||
</pre></div>
|
dump 1 all local 1000 tmp.dump index c_1[1] c_1[2] c_1[3] c_1[4]
|
||||||
</div>
|
</PRE>
|
||||||
<p><strong>Output info:</strong></p>
|
<P><B>Output info:</B>
|
||||||
<p>This compute calculates a local vector or local array depending on the
|
</P>
|
||||||
|
<P>This compute calculates a local vector or local array depending on the
|
||||||
number of keywords. The length of the vector or number of rows in the
|
number of keywords. The length of the vector or number of rows in the
|
||||||
array is the number of datums as described above. If a single keyword
|
array is the number of datums as described above. If a single keyword
|
||||||
is specified, a local vector is produced. If two or more keywords are
|
is specified, a local vector is produced. If two or more keywords are
|
||||||
specified, a local array is produced where the number of columns = the
|
specified, a local array is produced where the number of columns = the
|
||||||
number of keywords. The vector or array can be accessed by any
|
number of keywords. The vector or array can be accessed by any
|
||||||
command that uses local values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
command that uses local values from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>The <a class="reference internal" href="units.html"><em>units</em></a> for output values depend on the body style.</p>
|
options.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>The <A HREF = "units.html">units</A> for output values depend on the body style.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "dump.html">dump local</A>
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump local</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,268 +1,94 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute bond/local command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute bond/local command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute bond/local command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID bond/local input1 input2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>bond/local = style name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>one or more keywords may be appended
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>keyword = <I>dist</I> or <I>eng</I>
|
||||||
|
|
||||||
</div>
|
<PRE> <I>dist</I> = bond distance
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<I>eng</I> = bond energy
|
||||||
<div itemprop="articleBody">
|
<I>force</I> = bond force
|
||||||
|
</PRE>
|
||||||
<div class="section" id="compute-bond-local-command">
|
|
||||||
<span id="index-0"></span><h1>compute bond/local command<a class="headerlink" href="#compute-bond-local-command" title="Permalink to this headline">¶</a></h1>
|
</UL>
|
||||||
<div class="section" id="syntax">
|
<P><B>Examples:</B>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID bond/local input1 input2 ...
|
<PRE>compute 1 all bond/local eng
|
||||||
</pre></div>
|
compute 1 all bond/local dist eng force
|
||||||
</div>
|
</PRE>
|
||||||
<ul class="simple">
|
<P><B>Description:</B>
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
</P>
|
||||||
<li>bond/local = style name of this compute command</li>
|
<P>Define a computation that calculates properties of individual bond
|
||||||
<li>one or more keywords may be appended</li>
|
|
||||||
<li>keyword = <em>dist</em> or <em>eng</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>dist</em> = bond distance
|
|
||||||
<em>eng</em> = bond energy
|
|
||||||
<em>force</em> = bond force
|
|
||||||
</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>compute 1 all bond/local eng
|
|
||||||
compute 1 all bond/local dist eng force
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates properties of individual bond
|
|
||||||
interactions. The number of datums generated, aggregated across all
|
interactions. The number of datums generated, aggregated across all
|
||||||
processors, equals the number of bonds in the system, modified
|
processors, equals the number of bonds in the system, modified
|
||||||
by the group parameter as explained below.</p>
|
by the group parameter as explained below.
|
||||||
<p>The local data stored by this command is generated by looping over all
|
</P>
|
||||||
|
<P>The local data stored by this command is generated by looping over all
|
||||||
the atoms owned on a processor and their bonds. A bond will only be
|
the atoms owned on a processor and their bonds. A bond will only be
|
||||||
included if both atoms in the bond are in the specified compute group.
|
included if both atoms in the bond are in the specified compute group.
|
||||||
Any bonds that have been broken (see the <a class="reference internal" href="bond_style.html"><em>bond_style</em></a>
|
Any bonds that have been broken (see the <A HREF = "bond_style.html">bond_style</A>
|
||||||
command) by setting their bond type to 0 are not included. Bonds that
|
command) by setting their bond type to 0 are not included. Bonds that
|
||||||
have been turned off (see the <a class="reference internal" href="fix_shake.html"><em>fix shake</em></a> or
|
have been turned off (see the <A HREF = "fix_shake.html">fix shake</A> or
|
||||||
<a class="reference internal" href="delete_bonds.html"><em>delete_bonds</em></a> commands) by setting their bond type
|
<A HREF = "delete_bonds.html">delete_bonds</A> commands) by setting their bond type
|
||||||
negative are written into the file, but their energy will be 0.0.</p>
|
negative are written into the file, but their energy will be 0.0.
|
||||||
<p>Note that as atoms migrate from processor to processor, there will be
|
</P>
|
||||||
|
<P>Note that as atoms migrate from processor to processor, there will be
|
||||||
no consistent ordering of the entries within the local vector or array
|
no consistent ordering of the entries within the local vector or array
|
||||||
from one timestep to the next. The only consistency that is
|
from one timestep to the next. The only consistency that is
|
||||||
guaranteed is that the ordering on a particular timestep will be the
|
guaranteed is that the ordering on a particular timestep will be the
|
||||||
same for local vectors or arrays generated by other compute commands.
|
same for local vectors or arrays generated by other compute commands.
|
||||||
For example, bond output from the <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a> command can be combined
|
For example, bond output from the <A HREF = "compute_property_local.html">compute
|
||||||
with data from this command and output by the <a class="reference internal" href="dump.html"><em>dump local</em></a>
|
property/local</A> command can be combined
|
||||||
command in a consistent way.</p>
|
with data from this command and output by the <A HREF = "dump.html">dump local</A>
|
||||||
<p>Here is an example of how to do this:</p>
|
command in a consistent way.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute 1 all property/local batom1 batom2 btype
|
</P>
|
||||||
|
<P>Here is an example of how to do this:
|
||||||
|
</P>
|
||||||
|
<PRE>compute 1 all property/local batom1 batom2 btype
|
||||||
compute 2 all bond/local dist eng
|
compute 2 all bond/local dist eng
|
||||||
dump 1 all local 1000 tmp.dump index c_1[1] c_1[2] c_1[3] c_2[1] c_2[2]
|
dump 1 all local 1000 tmp.dump index c_1[1] c_1[2] c_1[3] c_2[1] c_2[2]
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Output info:</B>
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a local vector or local array depending on the
|
<P>This compute calculates a local vector or local array depending on the
|
||||||
number of keywords. The length of the vector or number of rows in the
|
number of keywords. The length of the vector or number of rows in the
|
||||||
array is the number of bonds. If a single keyword is specified, a
|
array is the number of bonds. If a single keyword is specified, a
|
||||||
local vector is produced. If two or more keywords are specified, a
|
local vector is produced. If two or more keywords are specified, a
|
||||||
local array is produced where the number of columns = the number of
|
local array is produced where the number of columns = the number of
|
||||||
keywords. The vector or array can be accessed by any command that
|
keywords. The vector or array can be accessed by any command that
|
||||||
uses local values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
uses local values from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>The output for <em>dist</em> will be in distance <a class="reference internal" href="units.html"><em>units</em></a>. The
|
options.
|
||||||
output for <em>eng</em> will be in energy <a class="reference internal" href="units.html"><em>units</em></a>. The output for
|
</P>
|
||||||
<em>force</em> will be in force <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
<P>The output for <I>dist</I> will be in distance <A HREF = "units.html">units</A>. The
|
||||||
</div>
|
output for <I>eng</I> will be in energy <A HREF = "units.html">units</A>. The output for
|
||||||
<div class="section" id="restrictions">
|
<I>force</I> will be in force <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "dump.html">dump local</A>, <A HREF = "compute_property_local.html">compute
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump local</em></a>, <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a></p>
|
property/local</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,297 +1,126 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute centro/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute centro/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute centro/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID centro/atom lattice
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>centro/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>lattice = <I>fcc</I> or <I>bcc</I> or N = # of neighbors per atom to include
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 all centro/atom fcc
|
||||||
|
</PRE>
|
||||||
</div>
|
<PRE>compute 1 all centro/atom 8
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</PRE>
|
||||||
<div itemprop="articleBody">
|
<P><B>Description:</B>
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-centro-atom-command">
|
<P>Define a computation that calculates the centro-symmetry parameter for
|
||||||
<span id="index-0"></span><h1>compute centro/atom command<a class="headerlink" href="#compute-centro-atom-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>compute ID group-ID centro/atom lattice
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>centro/atom = style name of this compute command</li>
|
|
||||||
<li>lattice = <em>fcc</em> or <em>bcc</em> or N = # of neighbors per atom to include</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all centro/atom fcc
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute 1 all centro/atom 8
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the centro-symmetry parameter for
|
|
||||||
each atom in the group. In solid-state systems the centro-symmetry
|
each atom in the group. In solid-state systems the centro-symmetry
|
||||||
parameter is a useful measure of the local lattice disorder around an
|
parameter is a useful measure of the local lattice disorder around an
|
||||||
atom and can be used to characterize whether the atom is part of a
|
atom and can be used to characterize whether the atom is part of a
|
||||||
perfect lattice, a local defect (e.g. a dislocation or stacking
|
perfect lattice, a local defect (e.g. a dislocation or stacking
|
||||||
fault), or at a surface.</p>
|
fault), or at a surface.
|
||||||
<p>The value of the centro-symmetry parameter will be 0.0 for atoms not
|
</P>
|
||||||
in the specified compute group.</p>
|
<P>The value of the centro-symmetry parameter will be 0.0 for atoms not
|
||||||
<p>This parameter is computed using the following formula from
|
in the specified compute group.
|
||||||
<a class="reference internal" href="#kelchner"><span>(Kelchner)</span></a></p>
|
</P>
|
||||||
<img alt="_images/centro_symmetry.jpg" class="align-center" src="_images/centro_symmetry.jpg" />
|
<P>This parameter is computed using the following formula from
|
||||||
<p>where the <em>N</em> nearest neighbors or each atom are identified and Ri and
|
<A HREF = "#Kelchner">(Kelchner)</A>
|
||||||
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/centro_symmetry.jpg">
|
||||||
|
</CENTER>
|
||||||
|
<P>where the <I>N</I> nearest neighbors or each atom are identified and Ri and
|
||||||
Ri+N/2 are vectors from the central atom to a particular pair of
|
Ri+N/2 are vectors from the central atom to a particular pair of
|
||||||
nearest neighbors. There are N*(N-1)/2 possible neighbor pairs that
|
nearest neighbors. There are N*(N-1)/2 possible neighbor pairs that
|
||||||
can contribute to this formula. The quantity in the sum is computed
|
can contribute to this formula. The quantity in the sum is computed
|
||||||
for each, and the N/2 smallest are used. This will typically be for
|
for each, and the N/2 smallest are used. This will typically be for
|
||||||
pairs of atoms in symmetrically opposite positions with respect to the
|
pairs of atoms in symmetrically opposite positions with respect to the
|
||||||
central atom; hence the i+N/2 notation.</p>
|
central atom; hence the i+N/2 notation.
|
||||||
<p><em>N</em> is an input parameter, which should be set to correspond to the
|
</P>
|
||||||
|
<P><I>N</I> is an input parameter, which should be set to correspond to the
|
||||||
number of nearest neighbors in the underlying lattice of atoms. If
|
number of nearest neighbors in the underlying lattice of atoms. If
|
||||||
the keyword <em>fcc</em> or <em>bcc</em> is used, <em>N</em> is set to 12 and 8
|
the keyword <I>fcc</I> or <I>bcc</I> is used, <I>N</I> is set to 12 and 8
|
||||||
respectively. More generally, <em>N</em> can be set to a positive, even
|
respectively. More generally, <I>N</I> can be set to a positive, even
|
||||||
integer.</p>
|
integer.
|
||||||
<p>For an atom on a lattice site, surrounded by atoms on a perfect
|
</P>
|
||||||
|
<P>For an atom on a lattice site, surrounded by atoms on a perfect
|
||||||
lattice, the centro-symmetry parameter will be 0. It will be near 0
|
lattice, the centro-symmetry parameter will be 0. It will be near 0
|
||||||
for small thermal perturbations of a perfect lattice. If a point
|
for small thermal perturbations of a perfect lattice. If a point
|
||||||
defect exists, the symmetry is broken, and the parameter will be a
|
defect exists, the symmetry is broken, and the parameter will be a
|
||||||
larger positive value. An atom at a surface will have a large
|
larger positive value. An atom at a surface will have a large
|
||||||
positive parameter. If the atom does not have <em>N</em> neighbors (within
|
positive parameter. If the atom does not have <I>N</I> neighbors (within
|
||||||
the potential cutoff), then its centro-symmetry parameter is set to
|
the potential cutoff), then its centro-symmetry parameter is set to
|
||||||
0.0.</p>
|
0.0.
|
||||||
<p>Only atoms within the cutoff of the pairwise neighbor list are
|
</P>
|
||||||
|
<P>Only atoms within the cutoff of the pairwise neighbor list are
|
||||||
considered as possible neighbors. Atoms not in the compute group are
|
considered as possible neighbors. Atoms not in the compute group are
|
||||||
included in the <em>N</em> neighbors used in this calculation.</p>
|
included in the <I>N</I> neighbors used in this calculation.
|
||||||
<p>The neighbor list needed to compute this quantity is constructed each
|
</P>
|
||||||
|
<P>The neighbor list needed to compute this quantity is constructed each
|
||||||
time the calculation is performed (e.g. each time a snapshot of atoms
|
time the calculation is performed (e.g. each time a snapshot of atoms
|
||||||
is dumped). Thus it can be inefficient to compute/dump this quantity
|
is dumped). Thus it can be inefficient to compute/dump this quantity
|
||||||
too frequently or to have multiple compute/dump commands, each with a
|
too frequently or to have multiple compute/dump commands, each with a
|
||||||
<em>centro/atom</em> style.</p>
|
<I>centro/atom</I> style.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The per-atom vector values are unitless values >= 0.0. Their
|
</P>
|
||||||
|
<P>The per-atom vector values are unitless values >= 0.0. Their
|
||||||
magnitude depends on the lattice style due to the number of
|
magnitude depends on the lattice style due to the number of
|
||||||
contibuting neighbor pairs in the summation in the formula above. And
|
contibuting neighbor pairs in the summation in the formula above. And
|
||||||
it depends on the local defects surrounding the central atom, as
|
it depends on the local defects surrounding the central atom, as
|
||||||
described above.</p>
|
described above.
|
||||||
<p>Here are typical centro-symmetry values, from a a nanoindentation
|
</P>
|
||||||
|
<P>Here are typical centro-symmetry values, from a a nanoindentation
|
||||||
simulation into gold (FCC). These were provided by Jon Zimmerman
|
simulation into gold (FCC). These were provided by Jon Zimmerman
|
||||||
(Sandia):</p>
|
(Sandia):
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Bulk lattice = 0
|
</P>
|
||||||
|
<PRE>Bulk lattice = 0
|
||||||
Dislocation core ~ 1.0 (0.5 to 1.25)
|
Dislocation core ~ 1.0 (0.5 to 1.25)
|
||||||
Stacking faults ~ 5.0 (4.0 to 6.0)
|
Stacking faults ~ 5.0 (4.0 to 6.0)
|
||||||
Free surface ~ 23.0
|
Free surface ~ 23.0
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>These values are *not* normalized by the square of the lattice
|
||||||
<p>These values are <em>not</em> normalized by the square of the lattice
|
parameter. If they were, normalized values would be:
|
||||||
parameter. If they were, normalized values would be:</p>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>Bulk lattice = 0
|
<PRE>Bulk lattice = 0
|
||||||
Dislocation core ~ 0.06 (0.03 to 0.075)
|
Dislocation core ~ 0.06 (0.03 to 0.075)
|
||||||
Stacking faults ~ 0.3 (0.24 to 0.36)
|
Stacking faults ~ 0.3 (0.24 to 0.36)
|
||||||
Free surface ~ 1.38
|
Free surface ~ 1.38
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>For BCC materials, the values for dislocation cores and free surfaces
|
||||||
<p>For BCC materials, the values for dislocation cores and free surfaces
|
|
||||||
would be somewhat different, due to their being only 8 neighbors instead
|
would be somewhat different, due to their being only 8 neighbors instead
|
||||||
of 12.</p>
|
of 12.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B> none
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Related commands:</B>
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><A HREF = "compute_cna_atom.html">compute cna/atom</A>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><B>Default:</B> none
|
||||||
<p><a class="reference internal" href="compute_cna_atom.html"><em>compute cna/atom</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<HR>
|
||||||
<hr class="docutils" />
|
|
||||||
<p id="kelchner"><strong>(Kelchner)</strong> Kelchner, Plimpton, Hamilton, Phys Rev B, 58, 11085 (1998).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<A NAME = "Kelchner"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Kelchner)</B> Kelchner, Plimpton, Hamilton, Phys Rev B, 58, 11085 (1998).
|
||||||
</div>
|
</P>
|
||||||
<footer>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@ -1,242 +1,62 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute cluster/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute cluster/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute cluster/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID cluster/atom cutoff
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>cluster/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>cutoff = distance within which to label atoms as part of same cluster (distance units)
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 all cluster/atom 1.0
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that assigns each atom a cluster ID.
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-cluster-atom-command">
|
<P>A cluster is defined as a set of atoms, each of which is within the
|
||||||
<span id="index-0"></span><h1>compute cluster/atom command<a class="headerlink" href="#compute-cluster-atom-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>compute ID group-ID cluster/atom cutoff
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>cluster/atom = style name of this compute command</li>
|
|
||||||
<li>cutoff = distance within which to label atoms as part of same cluster (distance units)</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all cluster/atom 1.0
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that assigns each atom a cluster ID.</p>
|
|
||||||
<p>A cluster is defined as a set of atoms, each of which is within the
|
|
||||||
cutoff distance from one or more other atoms in the cluster. If an
|
cutoff distance from one or more other atoms in the cluster. If an
|
||||||
atom has no neighbors within the cutoff distance, then it is a 1-atom
|
atom has no neighbors within the cutoff distance, then it is a 1-atom
|
||||||
cluster. The ID of every atom in the cluster will be the smallest
|
cluster. The ID of every atom in the cluster will be the smallest
|
||||||
atom ID of any atom in the cluster.</p>
|
atom ID of any atom in the cluster.
|
||||||
<p>Only atoms in the compute group are clustered and assigned cluster
|
</P>
|
||||||
IDs. Atoms not in the compute group are assigned a cluster ID = 0.</p>
|
<P>Only atoms in the compute group are clustered and assigned cluster
|
||||||
<p>The neighbor list needed to compute this quantity is constructed each
|
IDs. Atoms not in the compute group are assigned a cluster ID = 0.
|
||||||
|
</P>
|
||||||
|
<P>The neighbor list needed to compute this quantity is constructed each
|
||||||
time the calculation is performed (i.e. each time a snapshot of atoms
|
time the calculation is performed (i.e. each time a snapshot of atoms
|
||||||
is dumped). Thus it can be inefficient to compute/dump this quantity
|
is dumped). Thus it can be inefficient to compute/dump this quantity
|
||||||
too frequently or to have multiple compute/dump commands, each of a
|
too frequently or to have multiple compute/dump commands, each of a
|
||||||
<em>clsuter/atom</em> style.</p>
|
<I>clsuter/atom</I> style.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The per-atom vector values will be an ID > 0, as explained above.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values will be an ID > 0, as explained above.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B> none
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><A HREF = "compute_coord_atom.html">compute coord/atom</A>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="compute_coord_atom.html"><em>compute coord/atom</em></a></p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,272 +1,104 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute cna/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute cna/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute cna/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID cna/atom cutoff
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>cna/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>cutoff = cutoff distance for nearest neighbors (distance units)
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 all cna/atom 3.08
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that calculates the CNA (Common Neighbor
|
||||||
|
|
||||||
<div class="section" id="compute-cna-atom-command">
|
|
||||||
<span id="index-0"></span><h1>compute cna/atom command<a class="headerlink" href="#compute-cna-atom-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>compute ID group-ID cna/atom cutoff
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>cna/atom = style name of this compute command</li>
|
|
||||||
<li>cutoff = cutoff distance for nearest neighbors (distance units)</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all cna/atom 3.08
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the CNA (Common Neighbor
|
|
||||||
Analysis) pattern for each atom in the group. In solid-state systems
|
Analysis) pattern for each atom in the group. In solid-state systems
|
||||||
the CNA pattern is a useful measure of the local crystal structure
|
the CNA pattern is a useful measure of the local crystal structure
|
||||||
around an atom. The CNA methodology is described in <a class="reference internal" href="#faken"><span>(Faken)</span></a>
|
around an atom. The CNA methodology is described in <A HREF = "#Faken">(Faken)</A>
|
||||||
and <a class="reference internal" href="#tsuzuki"><span>(Tsuzuki)</span></a>.</p>
|
and <A HREF = "#Tsuzuki">(Tsuzuki)</A>.
|
||||||
<p>Currently, there are five kinds of CNA patterns LAMMPS recognizes:</p>
|
</P>
|
||||||
<ul class="simple">
|
<P>Currently, there are five kinds of CNA patterns LAMMPS recognizes:
|
||||||
<li>fcc = 1</li>
|
</P>
|
||||||
<li>hcp = 2</li>
|
<UL><LI>fcc = 1
|
||||||
<li>bcc = 3</li>
|
<LI>hcp = 2
|
||||||
<li>icosohedral = 4</li>
|
<LI>bcc = 3
|
||||||
<li>unknown = 5</li>
|
<LI>icosohedral = 4
|
||||||
</ul>
|
<LI>unknown = 5
|
||||||
<p>The value of the CNA pattern will be 0 for atoms not in the specified
|
</UL>
|
||||||
|
<P>The value of the CNA pattern will be 0 for atoms not in the specified
|
||||||
compute group. Note that normally a CNA calculation should only be
|
compute group. Note that normally a CNA calculation should only be
|
||||||
performed on mono-component systems.</p>
|
performed on mono-component systems.
|
||||||
<p>The CNA calculation can be sensitive to the specified cutoff value.
|
</P>
|
||||||
|
<P>The CNA calculation can be sensitive to the specified cutoff value.
|
||||||
You should insure the appropriate nearest neighbors of an atom are
|
You should insure the appropriate nearest neighbors of an atom are
|
||||||
found within the cutoff distance for the presumed crystal strucure.
|
found within the cutoff distance for the presumed crystal strucure.
|
||||||
E.g. 12 nearest neighbor for perfect FCC and HCP crystals, 14 nearest
|
E.g. 12 nearest neighbor for perfect FCC and HCP crystals, 14 nearest
|
||||||
neighbors for perfect BCC crystals. These formulas can be used to
|
neighbors for perfect BCC crystals. These formulas can be used to
|
||||||
obtain a good cutoff distance:</p>
|
obtain a good cutoff distance:
|
||||||
<img alt="_images/cna_cutoff1.jpg" class="align-center" src="_images/cna_cutoff1.jpg" />
|
</P>
|
||||||
<p>where a is the lattice constant for the crystal structure concerned
|
<CENTER><IMG SRC = "Eqs/cna_cutoff1.jpg">
|
||||||
|
</CENTER>
|
||||||
|
<P>where a is the lattice constant for the crystal structure concerned
|
||||||
and in the HCP case, x = (c/a) / 1.633, where 1.633 is the ideal c/a
|
and in the HCP case, x = (c/a) / 1.633, where 1.633 is the ideal c/a
|
||||||
for HCP crystals.</p>
|
for HCP crystals.
|
||||||
<p>Also note that since the CNA calculation in LAMMPS uses the neighbors
|
</P>
|
||||||
|
<P>Also note that since the CNA calculation in LAMMPS uses the neighbors
|
||||||
of an owned atom to find the nearest neighbors of a ghost atom, the
|
of an owned atom to find the nearest neighbors of a ghost atom, the
|
||||||
following relation should also be satisfied:</p>
|
following relation should also be satisfied:
|
||||||
<img alt="_images/cna_cutoff2.jpg" class="align-center" src="_images/cna_cutoff2.jpg" />
|
</P>
|
||||||
<p>where Rc is the cutoff distance of the potential, Rs is the skin
|
<CENTER><IMG SRC = "Eqs/cna_cutoff2.jpg">
|
||||||
distance as specified by the <a class="reference internal" href="neighbor.html"><em>neighbor</em></a> command, and
|
</CENTER>
|
||||||
|
<P>where Rc is the cutoff distance of the potential, Rs is the skin
|
||||||
|
distance as specified by the <A HREF = "neighbor.html">neighbor</A> command, and
|
||||||
cutoff is the argument used with the compute cna/atom command. LAMMPS
|
cutoff is the argument used with the compute cna/atom command. LAMMPS
|
||||||
will issue a warning if this is not the case.</p>
|
will issue a warning if this is not the case.
|
||||||
<p>The neighbor list needed to compute this quantity is constructed each
|
</P>
|
||||||
|
<P>The neighbor list needed to compute this quantity is constructed each
|
||||||
time the calculation is performed (e.g. each time a snapshot of atoms
|
time the calculation is performed (e.g. each time a snapshot of atoms
|
||||||
is dumped). Thus it can be inefficient to compute/dump this quantity
|
is dumped). Thus it can be inefficient to compute/dump this quantity
|
||||||
too frequently or to have multiple compute/dump commands, each with a
|
too frequently or to have multiple compute/dump commands, each with a
|
||||||
<em>cna/atom</em> style.</p>
|
<I>cna/atom</I> style.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The per-atom vector values will be a number from 0 to 5, as explained
|
</P>
|
||||||
above.</p>
|
<P>The per-atom vector values will be a number from 0 to 5, as explained
|
||||||
</div>
|
above.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B> none
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><A HREF = "compute_centro_atom.html">compute centro/atom</A>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="compute_centro_atom.html"><em>compute centro/atom</em></a></p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
<hr class="docutils" />
|
<HR>
|
||||||
<p id="faken"><strong>(Faken)</strong> Faken, Jonsson, Comput Mater Sci, 2, 279 (1994).</p>
|
|
||||||
<p id="tsuzuki"><strong>(Tsuzuki)</strong> Tsuzuki, Branicio, Rino, Comput Phys Comm, 177, 518 (2007).</p>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<A NAME = "Faken"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Faken)</B> Faken, Jonsson, Comput Mater Sci, 2, 279 (1994).
|
||||||
</div>
|
</P>
|
||||||
<footer>
|
<A NAME = "Tsuzuki"></A>
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Tsuzuki)</B> Tsuzuki, Branicio, Rino, Comput Phys Comm, 177, 518 (2007).
|
||||||
|
</P>
|
||||||
<div role="contentinfo">
|
</HTML>
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,244 +1,62 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute com command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute com command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute com command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID com
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>com = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all com
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the center-of-mass of the group
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-com-command">
|
|
||||||
<span id="index-0"></span><h1>compute com command<a class="headerlink" href="#compute-com-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>compute ID group-ID com
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>com = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all com
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the center-of-mass of the group
|
|
||||||
of atoms, including all effects due to atoms passing thru periodic
|
of atoms, including all effects due to atoms passing thru periodic
|
||||||
boundaries.</p>
|
boundaries.
|
||||||
<p>A vector of three quantites is calculated by this compute, which
|
</P>
|
||||||
are the x,y,z coordinates of the center of mass.</p>
|
<P>A vector of three quantites is calculated by this compute, which
|
||||||
<div class="admonition warning">
|
are the x,y,z coordinates of the center of mass.
|
||||||
<p class="first admonition-title">Warning</p>
|
</P>
|
||||||
<p class="last">The coordinates of an atom contribute to the
|
<P>IMPORTANT NOTE: The coordinates of an atom contribute to the
|
||||||
center-of-mass in “unwrapped” form, by using the image flags
|
center-of-mass in "unwrapped" form, by using the image flags
|
||||||
associated with each atom. See the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command
|
associated with each atom. See the <A HREF = "dump.html">dump custom</A> command
|
||||||
for a discussion of “unwrapped” coordinates. See the Atoms section of
|
for a discussion of "unwrapped" coordinates. See the Atoms section of
|
||||||
the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command for a discussion of image flags
|
the <A HREF = "read_data.html">read_data</A> command for a discussion of image flags
|
||||||
and how they are set for each atom. You can reset the image flags
|
and how they are set for each atom. You can reset the image flags
|
||||||
(e.g. to 0) before invoking this compute by using the <a class="reference internal" href="set.html"><em>set image</em></a> command.</p>
|
(e.g. to 0) before invoking this compute by using the <A HREF = "set.html">set
|
||||||
</div>
|
image</A> command.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global vector of length 3, which can be
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global vector of length 3, which can be
|
||||||
accessed by indices 1-3 by any command that uses global vector values
|
accessed by indices 1-3 by any command that uses global vector values
|
||||||
from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>The vector values are “intensive”. The vector values will be in
|
options.
|
||||||
distance <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The vector values are "intensive". The vector values will be in
|
||||||
<div class="section" id="restrictions">
|
distance <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "compute_com_chunk.html">compute com/chunk</A>
|
||||||
<p><a class="reference internal" href="compute_com_chunk.html"><em>compute com/chunk</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,268 +1,92 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute com/chunk command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute com/chunk command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute com/chunk command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID com/chunk chunkID
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>com/chunk = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>chunkID = ID of <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 fluid com/chunk molchunk
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that calculates the center-of-mass for multiple
|
||||||
|
chunks of atoms.
|
||||||
<div class="section" id="compute-com-chunk-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>compute com/chunk command<a class="headerlink" href="#compute-com-chunk-command" title="Permalink to this headline">¶</a></h1>
|
<P>In LAMMPS, chunks are collections of atoms defined by a <A HREF = "compute_chunk_atom.html">compute
|
||||||
<div class="section" id="syntax">
|
chunk/atom</A> command, which assigns each atom
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID com/chunk chunkID
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>com/chunk = style name of this compute command</li>
|
|
||||||
<li>chunkID = ID of <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 fluid com/chunk molchunk
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the center-of-mass for multiple
|
|
||||||
chunks of atoms.</p>
|
|
||||||
<p>In LAMMPS, chunks are collections of atoms defined by a <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command, which assigns each atom
|
|
||||||
to a single chunk (or no chunk). The ID for this command is specified
|
to a single chunk (or no chunk). The ID for this command is specified
|
||||||
as chunkID. For example, a single chunk could be the atoms in a
|
as chunkID. For example, a single chunk could be the atoms in a
|
||||||
molecule or atoms in a spatial bin. See the <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> doc page and “<a class="reference internal" href="Section_howto.html#howto-23"><span>Section_howto 23</span></a> for details of how chunks can be
|
molecule or atoms in a spatial bin. See the <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> doc page and "<A HREF = "Section_howto.html#howto_23">Section_howto
|
||||||
|
23</A> for details of how chunks can be
|
||||||
defined and examples of how they can be used to measure properties of
|
defined and examples of how they can be used to measure properties of
|
||||||
a system.</p>
|
a system.
|
||||||
<p>This compute calculates the x,y,z coordinates of the center-of-mass
|
</P>
|
||||||
|
<P>This compute calculates the x,y,z coordinates of the center-of-mass
|
||||||
for each chunk, which includes all effects due to atoms passing thru
|
for each chunk, which includes all effects due to atoms passing thru
|
||||||
periodic boundaries.</p>
|
periodic boundaries.
|
||||||
<p>Note that only atoms in the specified group contribute to the
|
</P>
|
||||||
calculation. The <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command
|
<P>Note that only atoms in the specified group contribute to the
|
||||||
|
calculation. The <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
defines its own group; atoms will have a chunk ID = 0 if they are not
|
defines its own group; atoms will have a chunk ID = 0 if they are not
|
||||||
in that group, signifying they are not assigned to a chunk, and will
|
in that group, signifying they are not assigned to a chunk, and will
|
||||||
thus also not contribute to this calculation. You can specify the
|
thus also not contribute to this calculation. You can specify the
|
||||||
“all” group for this command if you simply want to include atoms with
|
"all" group for this command if you simply want to include atoms with
|
||||||
non-zero chunk IDs.</p>
|
non-zero chunk IDs.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The coordinates of an atom contribute to the chunk's
|
||||||
<p class="last">The coordinates of an atom contribute to the chunk’s
|
center-of-mass in "unwrapped" form, by using the image flags
|
||||||
center-of-mass in “unwrapped” form, by using the image flags
|
associated with each atom. See the <A HREF = "dump.html">dump custom</A> command
|
||||||
associated with each atom. See the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command
|
for a discussion of "unwrapped" coordinates. See the Atoms section of
|
||||||
for a discussion of “unwrapped” coordinates. See the Atoms section of
|
the <A HREF = "read_data.html">read_data</A> command for a discussion of image flags
|
||||||
the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command for a discussion of image flags
|
|
||||||
and how they are set for each atom. You can reset the image flags
|
and how they are set for each atom. You can reset the image flags
|
||||||
(e.g. to 0) before invoking this compute by using the <a class="reference internal" href="set.html"><em>set image</em></a> command.</p>
|
(e.g. to 0) before invoking this compute by using the <A HREF = "set.html">set
|
||||||
</div>
|
image</A> command.
|
||||||
<p>The simplest way to output the results of the compute com/chunk
|
</P>
|
||||||
calculation to a file is to use the <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>
|
<P>The simplest way to output the results of the compute com/chunk
|
||||||
command, for example:</p>
|
calculation to a file is to use the <A HREF = "fix_ave_time.html">fix ave/time</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute cc1 all chunk/atom molecule
|
command, for example:
|
||||||
|
</P>
|
||||||
|
<PRE>compute cc1 all chunk/atom molecule
|
||||||
compute myChunk all com/chunk cc1
|
compute myChunk all com/chunk cc1
|
||||||
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Output info:</B>
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global array where the number of rows = the
|
<P>This compute calculates a global array where the number of rows = the
|
||||||
number of chunks <em>Nchunk</em> as calculated by the specified <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command. The number of columns =
|
number of chunks <I>Nchunk</I> as calculated by the specified <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> command. The number of columns =
|
||||||
3 for the x,y,z center-of-mass coordinates of each chunk. These
|
3 for the x,y,z center-of-mass coordinates of each chunk. These
|
||||||
values can be accessed by any command that uses global array values
|
values can be accessed by any command that uses global array values
|
||||||
from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
from a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The array values are “intensive”. The array values will be in
|
options.
|
||||||
distance <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The array values are "intensive". The array values will be in
|
||||||
<div class="section" id="restrictions">
|
distance <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "compute_com.html">compute com</A>
|
||||||
<p><a class="reference internal" href="compute_com.html"><em>compute com</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,237 +1,59 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute contact/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute contact/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute contact/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID contact/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>contact/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all contact/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the number of contacts
|
||||||
<div itemprop="articleBody">
|
for each atom in a group.
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-contact-atom-command">
|
<P>The contact number is defined for finite-size spherical particles as
|
||||||
<span id="index-0"></span><h1>compute contact/atom command<a class="headerlink" href="#compute-contact-atom-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>compute ID group-ID contact/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>contact/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all contact/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the number of contacts
|
|
||||||
for each atom in a group.</p>
|
|
||||||
<p>The contact number is defined for finite-size spherical particles as
|
|
||||||
the number of neighbor atoms which overlap the central particle,
|
the number of neighbor atoms which overlap the central particle,
|
||||||
meaning that their distance of separation is less than or equal to the
|
meaning that their distance of separation is less than or equal to the
|
||||||
sum of the radii of the two particles.</p>
|
sum of the radii of the two particles.
|
||||||
<p>The value of the contact number will be 0.0 for atoms not in the
|
</P>
|
||||||
specified compute group.</p>
|
<P>The value of the contact number will be 0.0 for atoms not in the
|
||||||
<p><strong>Output info:</strong></p>
|
specified compute group.
|
||||||
<p>This compute calculates a per-atom vector, whose values can be
|
</P>
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, whose values can be
|
||||||
accessed by any command that uses per-atom values from a compute as
|
accessed by any command that uses per-atom values from a compute as
|
||||||
input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an
|
input. See <A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an
|
||||||
overview of LAMMPS output options.</p>
|
overview of LAMMPS output options.
|
||||||
<p>The per-atom vector values will be a number >= 0.0, as explained
|
</P>
|
||||||
above.</p>
|
<P>The per-atom vector values will be a number >= 0.0, as explained
|
||||||
</div>
|
above.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute requires that atoms store a radius as defined by the
|
</P>
|
||||||
<a class="reference internal" href="atom_style.html"><em>atom_style sphere</em></a> command.</p>
|
<P>This compute requires that atoms store a radius as defined by the
|
||||||
</div>
|
<A HREF = "atom_style.html">atom_style sphere</A> command.
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><B>Related commands:</B>
|
||||||
<p><a class="reference internal" href="compute_coord_atom.html"><em>compute coord/atom</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><A HREF = "compute_coord_atom.html">compute coord/atom</A>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
</HTML>
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,276 +1,97 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute coord/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute coord/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute coord/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID coord/atom cutoff type1 type2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>coord/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>cutoff = distance within which to count coordination neighbors (distance units)
|
||||||
|
<LI>typeN = atom type for Nth coordination count (see asterisk form below)
|
||||||
</li>
|
</UL>
|
||||||
</ul>
|
<P><B>Examples:</B>
|
||||||
<hr/>
|
</P>
|
||||||
|
<PRE>compute 1 all coord/atom 2.0
|
||||||
</div>
|
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-coord-atom-command">
|
|
||||||
<span id="index-0"></span><h1>compute coord/atom command<a class="headerlink" href="#compute-coord-atom-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>compute ID group-ID coord/atom cutoff type1 type2 ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>coord/atom = style name of this compute command</li>
|
|
||||||
<li>cutoff = distance within which to count coordination neighbors (distance units)</li>
|
|
||||||
<li>typeN = atom type for Nth coordination count (see asterisk form below)</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all coord/atom 2.0
|
|
||||||
compute 1 all coord/atom 6.0 1 2
|
compute 1 all coord/atom 6.0 1 2
|
||||||
compute 1 all coord/atom 6.0 2*4 5*8 *
|
compute 1 all coord/atom 6.0 2*4 5*8 *
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Define a computation that calculates one or more coordination numbers
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
for each atom in a group.
|
||||||
<p>Define a computation that calculates one or more coordination numbers
|
</P>
|
||||||
for each atom in a group.</p>
|
<P>A coordination number is defined as the number of neighbor atoms with
|
||||||
<p>A coordination number is defined as the number of neighbor atoms with
|
|
||||||
specified atom type(s) that are within the specified cutoff distance
|
specified atom type(s) that are within the specified cutoff distance
|
||||||
from the central atom. Atoms not in the group are included in a
|
from the central atom. Atoms not in the group are included in a
|
||||||
coordination number of atoms in the group.</p>
|
coordination number of atoms in the group.
|
||||||
<p>The <em>typeN</em> keywords allow you to specify which atom types contribute
|
</P>
|
||||||
|
<P>The <I>typeN</I> keywords allow you to specify which atom types contribute
|
||||||
to each coordination number. One coordination number is computed for
|
to each coordination number. One coordination number is computed for
|
||||||
each of the <em>typeN</em> keywords listed. If no <em>typeN</em> keywords are
|
each of the <I>typeN</I> keywords listed. If no <I>typeN</I> keywords are
|
||||||
listed, a single coordination number is calculated, which includes
|
listed, a single coordination number is calculated, which includes
|
||||||
atoms of all types (same as the “*” format, see below).</p>
|
atoms of all types (same as the "*" format, see below).
|
||||||
<p>The <em>typeN</em> keywords can be specified in one of two ways. An explicit
|
</P>
|
||||||
|
<P>The <I>typeN</I> keywords can be specified in one of two ways. An explicit
|
||||||
numeric value can be used, as in the 2nd example above. Or a
|
numeric value can be used, as in the 2nd example above. Or a
|
||||||
wild-card asterisk can be used to specify a range of atom types. This
|
wild-card asterisk can be used to specify a range of atom types. This
|
||||||
takes the form “*” or “<em>n” or “n</em>” or “m*n”. If N = the number of
|
takes the form "*" or "*n" or "n*" or "m*n". If N = the number of
|
||||||
atom types, then an asterisk with no numeric values means all types
|
atom types, then an asterisk with no numeric values means all types
|
||||||
from 1 to N. A leading asterisk means all types from 1 to n
|
from 1 to N. A leading asterisk means all types from 1 to n
|
||||||
(inclusive). A trailing asterisk means all types from n to N
|
(inclusive). A trailing asterisk means all types from n to N
|
||||||
(inclusive). A middle asterisk means all types from m to n
|
(inclusive). A middle asterisk means all types from m to n
|
||||||
(inclusive).</p>
|
(inclusive).
|
||||||
<p>The value of all coordination numbers will be 0.0 for atoms not in the
|
</P>
|
||||||
specified compute group.</p>
|
<P>The value of all coordination numbers will be 0.0 for atoms not in the
|
||||||
<p>The neighbor list needed to compute this quantity is constructed each
|
specified compute group.
|
||||||
|
</P>
|
||||||
|
<P>The neighbor list needed to compute this quantity is constructed each
|
||||||
time the calculation is performed (i.e. each time a snapshot of atoms
|
time the calculation is performed (i.e. each time a snapshot of atoms
|
||||||
is dumped). Thus it can be inefficient to compute/dump this quantity
|
is dumped). Thus it can be inefficient to compute/dump this quantity
|
||||||
too frequently.</p>
|
too frequently.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: If you have a bonded system, then the settings of
|
||||||
<p class="last">If you have a bonded system, then the settings of
|
<A HREF = "special_bonds.html">special_bonds</A> command can remove pairwise
|
||||||
<a class="reference internal" href="special_bonds.html"><em>special_bonds</em></a> command can remove pairwise
|
|
||||||
interactions between atoms in the same bond, angle, or dihedral. This
|
interactions between atoms in the same bond, angle, or dihedral. This
|
||||||
is the default setting for the <a class="reference internal" href="special_bonds.html"><em>special_bonds</em></a>
|
is the default setting for the <A HREF = "special_bonds.html">special_bonds</A>
|
||||||
command, and means those pairwise interactions do not appear in the
|
command, and means those pairwise interactions do not appear in the
|
||||||
neighbor list. Because this fix uses the neighbor list, it also means
|
neighbor list. Because this fix uses the neighbor list, it also means
|
||||||
those pairs will not be included in the coordination count. One way
|
those pairs will not be included in the coordination count. One way
|
||||||
to get around this, is to write a dump file, and use the
|
to get around this, is to write a dump file, and use the
|
||||||
<a class="reference internal" href="rerun.html"><em>rerun</em></a> command to compute the coordination for snapshots
|
<A HREF = "rerun.html">rerun</A> command to compute the coordination for snapshots
|
||||||
in the dump file. The rerun script can use a
|
in the dump file. The rerun script can use a
|
||||||
<a class="reference internal" href="special_bonds.html"><em>special_bonds</em></a> command that includes all pairs in
|
<A HREF = "special_bonds.html">special_bonds</A> command that includes all pairs in
|
||||||
the neighbor list.</p>
|
the neighbor list.
|
||||||
</div>
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<P><B>Output info:</B>
|
||||||
<p>If single <em>type1</em> keyword is specified (or if none are specified),
|
</P>
|
||||||
this compute calculates a per-atom vector. If multiple <em>typeN</em>
|
<P>If single <I>type1</I> keyword is specified (or if none are specified),
|
||||||
|
this compute calculates a per-atom vector. If multiple <I>typeN</I>
|
||||||
keywords are specified, this compute calculates a per-atom array, with
|
keywords are specified, this compute calculates a per-atom array, with
|
||||||
N columns. These values can be accessed by any command that uses
|
N columns. These values can be accessed by any command that uses
|
||||||
per-atom values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
per-atom values from a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The per-atom vector or array values will be a number >= 0.0, as
|
options.
|
||||||
explained above.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector or array values will be a number >= 0.0, as
|
||||||
<div class="section" id="restrictions">
|
explained above.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "compute_cluster_atom.html">compute cluster/atom</A>
|
||||||
<p><a class="reference internal" href="compute_cluster_atom.html"><em>compute cluster/atom</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,240 +1,68 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute damage/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute damage/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute damage/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID damage/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>damage/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all damage/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the per-atom damage for each atom
|
||||||
<div itemprop="articleBody">
|
in a group. This is a quantity relevant for <A HREF = "pair_peri.html">Peridynamics
|
||||||
|
models</A>. See <A HREF = "PDF/PDLammps_overview.pdf">this document</A>
|
||||||
<div class="section" id="compute-damage-atom-command">
|
for an overview of LAMMPS commands for Peridynamics modeling.
|
||||||
<span id="index-0"></span><h1>compute damage/atom command<a class="headerlink" href="#compute-damage-atom-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<P>The "damage" of a Peridymaics particles is based on the bond breakage
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID damage/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>damage/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all damage/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the per-atom damage for each atom
|
|
||||||
in a group. This is a quantity relevant for <a class="reference internal" href="pair_peri.html"><em>Peridynamics models</em></a>. See <a class="reference external" href="PDF/PDLammps_overview.pdf">this document</a>
|
|
||||||
for an overview of LAMMPS commands for Peridynamics modeling.</p>
|
|
||||||
<p>The “damage” of a Peridymaics particles is based on the bond breakage
|
|
||||||
between the particle and its neighbors. If all the bonds are broken
|
between the particle and its neighbors. If all the bonds are broken
|
||||||
the particle is considered to be fully damaged.</p>
|
the particle is considered to be fully damaged.
|
||||||
<p>See the <a class="reference external" href="http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf">PDLAMMPS user guide</a> for a formal
|
</P>
|
||||||
definition of “damage” and more details about Peridynamics as it is
|
<P>See the <A HREF = "http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf">PDLAMMPS user
|
||||||
implemented in LAMMPS.</p>
|
guide</A> for a formal
|
||||||
<p>This command can be used with all the Peridynamic pair styles.</p>
|
definition of "damage" and more details about Peridynamics as it is
|
||||||
<p>The damage value will be 0.0 for atoms not in the specified compute
|
implemented in LAMMPS.
|
||||||
group.</p>
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<P>This command can be used with all the Peridynamic pair styles.
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
</P>
|
||||||
|
<P>The damage value will be 0.0 for atoms not in the specified compute
|
||||||
|
group.
|
||||||
|
</P>
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The per-atom vector values are unitlesss numbers (damage) >= 0.0.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values are unitlesss numbers (damage) >= 0.0.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute is part of the PERI package. It is only enabled if
|
</P>
|
||||||
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>
|
<P>This compute is part of the PERI package. It is only enabled if
|
||||||
</div>
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<div class="section" id="related-commands">
|
LAMMPS</A> section for more info.
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><code class="xref doc docutils literal"><span class="pre">compute</span> <span class="pre">dilatation</span></code>, <code class="xref doc docutils literal"><span class="pre">compute</span> <span class="pre">plasticity</span></code></p>
|
<P><B>Related commands:</B>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><A HREF = "compute_dilatation.html">compute dilatation</A>, <A HREF = "compute_plasticity.html">compute
|
||||||
</div>
|
plasticity</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,253 +1,79 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute dihedral/local command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute dihedral/local command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute dihedral/local command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID dihedral/local input1 input2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>dihedral/local = style name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>one or more keywords may be appended
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>keyword = <I>phi</I>
|
||||||
|
|
||||||
</div>
|
<PRE> <I>phi</I> = tabulate dihedral angles
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</PRE>
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
</UL>
|
||||||
<div class="section" id="compute-dihedral-local-command">
|
<P><B>Examples:</B>
|
||||||
<span id="index-0"></span><h1>compute dihedral/local command<a class="headerlink" href="#compute-dihedral-local-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<PRE>compute 1 all dihedral/local phi
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
</PRE>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID dihedral/local input1 input2 ...
|
<P><B>Description:</B>
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<P>Define a computation that calculates properties of individual dihedral
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>dihedral/local = style name of this compute command</li>
|
|
||||||
<li>one or more keywords may be appended</li>
|
|
||||||
<li>keyword = <em>phi</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>phi</em> = tabulate dihedral angles
|
|
||||||
</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>compute 1 all dihedral/local phi
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates properties of individual dihedral
|
|
||||||
interactions. The number of datums generated, aggregated across all
|
interactions. The number of datums generated, aggregated across all
|
||||||
processors, equals the number of angles in the system, modified by the
|
processors, equals the number of angles in the system, modified by the
|
||||||
group parameter as explained below.</p>
|
group parameter as explained below.
|
||||||
<p>The local data stored by this command is generated by looping over all
|
</P>
|
||||||
|
<P>The local data stored by this command is generated by looping over all
|
||||||
the atoms owned on a processor and their dihedrals. A dihedral will
|
the atoms owned on a processor and their dihedrals. A dihedral will
|
||||||
only be included if all 4 atoms in the dihedral are in the specified
|
only be included if all 4 atoms in the dihedral are in the specified
|
||||||
compute group.</p>
|
compute group.
|
||||||
<p>Note that as atoms migrate from processor to processor, there will be
|
</P>
|
||||||
|
<P>Note that as atoms migrate from processor to processor, there will be
|
||||||
no consistent ordering of the entries within the local vector or array
|
no consistent ordering of the entries within the local vector or array
|
||||||
from one timestep to the next. The only consistency that is
|
from one timestep to the next. The only consistency that is
|
||||||
guaranteed is that the ordering on a particular timestep will be the
|
guaranteed is that the ordering on a particular timestep will be the
|
||||||
same for local vectors or arrays generated by other compute commands.
|
same for local vectors or arrays generated by other compute commands.
|
||||||
For example, dihedral output from the <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a> command can be combined
|
For example, dihedral output from the <A HREF = "compute_property_local.html">compute
|
||||||
with data from this command and output by the <a class="reference internal" href="dump.html"><em>dump local</em></a>
|
property/local</A> command can be combined
|
||||||
command in a consistent way.</p>
|
with data from this command and output by the <A HREF = "dump.html">dump local</A>
|
||||||
<p><strong>Output info:</strong></p>
|
command in a consistent way.
|
||||||
<p>This compute calculates a local vector or local array depending on the
|
</P>
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a local vector or local array depending on the
|
||||||
number of keywords. The length of the vector or number of rows in the
|
number of keywords. The length of the vector or number of rows in the
|
||||||
array is the number of dihedrals. If a single keyword is specified, a
|
array is the number of dihedrals. If a single keyword is specified, a
|
||||||
local vector is produced. If two or more keywords are specified, a
|
local vector is produced. If two or more keywords are specified, a
|
||||||
local array is produced where the number of columns = the number of
|
local array is produced where the number of columns = the number of
|
||||||
keywords. The vector or array can be accessed by any command that
|
keywords. The vector or array can be accessed by any command that
|
||||||
uses local values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
uses local values from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>The output for <em>phi</em> will be in degrees.</p>
|
options.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>The output for <I>phi</I> will be in degrees.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "dump.html">dump local</A>, <A HREF = "compute_property_local.html">compute
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump local</em></a>, <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a></p>
|
property/local</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,242 +1,71 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute dilatation/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute dilatation/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute dilatation/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID dilatation/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in compute command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>dilation/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all dilatation/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the per-atom dilatation for each
|
||||||
<div itemprop="articleBody">
|
atom in a group. This is a quantity relevant for <A HREF = "pair_peri.html">Peridynamics
|
||||||
|
models</A>. See <A HREF = "PDF/PDLammps_overview.pdf">this document</A>
|
||||||
<div class="section" id="compute-dilatation-atom-command">
|
for an overview of LAMMPS commands for Peridynamics modeling.
|
||||||
<span id="index-0"></span><h1>compute dilatation/atom command<a class="headerlink" href="#compute-dilatation-atom-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<P>For small deformation, dilatation of is the measure of the volumetric
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
strain.
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID dilatation/atom
|
</P>
|
||||||
</pre></div>
|
<P>The dilatation "theta" for each peridynamic particle I is calculated
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in compute command</li>
|
|
||||||
<li>dilation/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all dilatation/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the per-atom dilatation for each
|
|
||||||
atom in a group. This is a quantity relevant for <a class="reference internal" href="pair_peri.html"><em>Peridynamics models</em></a>. See <a class="reference external" href="PDF/PDLammps_overview.pdf">this document</a>
|
|
||||||
for an overview of LAMMPS commands for Peridynamics modeling.</p>
|
|
||||||
<p>For small deformation, dilatation of is the measure of the volumetric
|
|
||||||
strain.</p>
|
|
||||||
<p>The dilatation “theta” for each peridynamic particle I is calculated
|
|
||||||
as a sum over its neighbors with unbroken bonds, where the
|
as a sum over its neighbors with unbroken bonds, where the
|
||||||
contribution of the IJ pair is a function of the change in bond length
|
contribution of the IJ pair is a function of the change in bond length
|
||||||
(versus the initial length in the reference state), the volume
|
(versus the initial length in the reference state), the volume
|
||||||
fraction of the particles and an influence function. See the
|
fraction of the particles and an influence function. See the
|
||||||
<a class="reference external" href="http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf">PDLAMMPS user guide</a> for a formal
|
<A HREF = "http://www.sandia.gov/~mlparks/papers/PDLAMMPS.pdf">PDLAMMPS user
|
||||||
definition of dilatation.</p>
|
guide</A> for a formal
|
||||||
<p>This command can only be used with a subset of the Peridynamic <a class="reference internal" href="pair_peri.html"><em>pair styles</em></a>: peri/lps, peri/ves and peri/eps.</p>
|
definition of dilatation.
|
||||||
<p>The dilatation value will be 0.0 for atoms not in the specified
|
</P>
|
||||||
compute group.</p>
|
<P>This command can only be used with a subset of the Peridynamic <A HREF = "pair_peri.html">pair
|
||||||
<p><strong>Output info:</strong></p>
|
styles</A>: peri/lps, peri/ves and peri/eps.
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
</P>
|
||||||
|
<P>The dilatation value will be 0.0 for atoms not in the specified
|
||||||
|
compute group.
|
||||||
|
</P>
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
Section_howto 15 for an overview of LAMMPS output options.</p>
|
Section_howto 15 for an overview of LAMMPS output options.
|
||||||
<p>The per-atom vector values are unitlesss numbers (theta) >= 0.0.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values are unitlesss numbers (theta) >= 0.0.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute is part of the PERI package. It is only enabled if
|
</P>
|
||||||
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>
|
<P>This compute is part of the PERI package. It is only enabled if
|
||||||
</div>
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<div class="section" id="related-commands">
|
LAMMPS</A> section for more info.
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><code class="xref doc docutils literal"><span class="pre">compute</span> <span class="pre">damage</span></code>, <code class="xref doc docutils literal"><span class="pre">compute</span> <span class="pre">plasticity</span></code></p>
|
<P><B>Related commands:</B>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><A HREF = "compute_damage.html">compute damage</A>, <A HREF = "compute_plasticity.html">compute
|
||||||
</div>
|
plasticity</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,256 +1,74 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute displace/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute displace/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute displace/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID displace/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>displace/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all displace/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the current displacement of each
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-displace-atom-command">
|
|
||||||
<span id="index-0"></span><h1>compute displace/atom command<a class="headerlink" href="#compute-displace-atom-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>compute ID group-ID displace/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>displace/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all displace/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the current displacement of each
|
|
||||||
atom in the group from its original coordinates, including all effects
|
atom in the group from its original coordinates, including all effects
|
||||||
due to atoms passing thru periodic boundaries.</p>
|
due to atoms passing thru periodic boundaries.
|
||||||
<p>A vector of four quantites per atom is calculated by this compute.
|
</P>
|
||||||
|
<P>A vector of four quantites per atom is calculated by this compute.
|
||||||
The first 3 elements of the vector are the dx,dy,dz displacements.
|
The first 3 elements of the vector are the dx,dy,dz displacements.
|
||||||
The 4th component is the total displacement, i.e. sqrt(dx*dx + dy*dy +
|
The 4th component is the total displacement, i.e. sqrt(dx*dx + dy*dy +
|
||||||
dz*dz).</p>
|
dz*dz).
|
||||||
<p>The displacement of an atom is from its original position at the time
|
</P>
|
||||||
|
<P>The displacement of an atom is from its original position at the time
|
||||||
the compute command was issued. The value of the displacement will be
|
the compute command was issued. The value of the displacement will be
|
||||||
0.0 for atoms not in the specified compute group.</p>
|
0.0 for atoms not in the specified compute group.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: Initial coordinates are stored in "unwrapped" form, by
|
||||||
<p class="last">Initial coordinates are stored in “unwrapped” form, by
|
using the image flags associated with each atom. See the <A HREF = "dump.html">dump
|
||||||
using the image flags associated with each atom. See the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command for a discussion of “unwrapped” coordinates.
|
custom</A> command for a discussion of "unwrapped" coordinates.
|
||||||
See the Atoms section of the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command for a
|
See the Atoms section of the <A HREF = "read_data.html">read_data</A> command for a
|
||||||
discussion of image flags and how they are set for each atom. You can
|
discussion of image flags and how they are set for each atom. You can
|
||||||
reset the image flags (e.g. to 0) before invoking this compute by
|
reset the image flags (e.g. to 0) before invoking this compute by
|
||||||
using the <a class="reference internal" href="set.html"><em>set image</em></a> command.</p>
|
using the <A HREF = "set.html">set image</A> command.
|
||||||
</div>
|
</P>
|
||||||
<div class="admonition warning">
|
<P>IMPORTANT NOTE: If you want the quantities calculated by this compute
|
||||||
<p class="first admonition-title">Warning</p>
|
to be continuous when running from a <A HREF = "read_restart.html">restart file</A>,
|
||||||
<p class="last">If you want the quantities calculated by this compute
|
|
||||||
to be continuous when running from a <a class="reference internal" href="read_restart.html"><em>restart file</em></a>,
|
|
||||||
then you should use the same ID for this compute, as in the original
|
then you should use the same ID for this compute, as in the original
|
||||||
run. This is so that the fix this compute creates to store per-atom
|
run. This is so that the fix this compute creates to store per-atom
|
||||||
quantities will also have the same ID, and thus be initialized
|
quantities will also have the same ID, and thus be initialized
|
||||||
correctly with time=0 atom coordinates from the restart file.</p>
|
correctly with time=0 atom coordinates from the restart file.
|
||||||
</div>
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<P><B>Output info:</B>
|
||||||
<p>This compute calculates a per-atom array with 4 columns, which can be
|
</P>
|
||||||
|
<P>This compute calculates a per-atom array with 4 columns, which can be
|
||||||
accessed by indices 1-4 by any command that uses per-atom values from
|
accessed by indices 1-4 by any command that uses per-atom values from
|
||||||
a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The per-atom array values will be in distance <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
options.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>The per-atom array values will be in distance <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "compute_msd.html">compute msd</A>, <A HREF = "dump.html">dump custom</A>, <A HREF = "fix_store_state.html">fix
|
||||||
<p><a class="reference internal" href="compute_msd.html"><em>compute msd</em></a>, <a class="reference internal" href="dump.html"><em>dump custom</em></a>, <a class="reference internal" href="fix_store_state.html"><em>fix store/state</em></a></p>
|
store/state</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,250 +1,75 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute erotate/asphere command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute erotate/asphere command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute erotate/asphere command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID erotate/asphere
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>erotate/asphere = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all erotate/asphere
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the rotational kinetic energy of
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-erotate-asphere-command">
|
|
||||||
<span id="index-0"></span><h1>compute erotate/asphere command<a class="headerlink" href="#compute-erotate-asphere-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>compute ID group-ID erotate/asphere
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>erotate/asphere = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all erotate/asphere
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the rotational kinetic energy of
|
|
||||||
a group of aspherical particles. The aspherical particles can be
|
a group of aspherical particles. The aspherical particles can be
|
||||||
ellipsoids, or line segments, or triangles. See the
|
ellipsoids, or line segments, or triangles. See the
|
||||||
<a class="reference internal" href="atom_style.html"><em>atom_style</em></a> and <a class="reference internal" href="read_data.html"><em>read_data</em></a> commands
|
<A HREF = "atom_style.html">atom_style</A> and <A HREF = "read_data.html">read_data</A> commands
|
||||||
for descriptions of these options.</p>
|
for descriptions of these options.
|
||||||
<p>For all 3 types of particles, the rotational kinetic energy is
|
</P>
|
||||||
|
<P>For all 3 types of particles, the rotational kinetic energy is
|
||||||
computed as 1/2 I w^2, where I is the inertia tensor for the
|
computed as 1/2 I w^2, where I is the inertia tensor for the
|
||||||
aspherical particle and w is its angular velocity, which is computed
|
aspherical particle and w is its angular velocity, which is computed
|
||||||
from its angular momentum if needed.</p>
|
from its angular momentum if needed.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: For <A HREF = "dimension.html">2d models</A>, ellipsoidal particles
|
||||||
<p class="last">For <a class="reference internal" href="dimension.html"><em>2d models</em></a>, ellipsoidal particles
|
|
||||||
are treated as ellipsoids, not ellipses, meaning their moments of
|
are treated as ellipsoids, not ellipses, meaning their moments of
|
||||||
inertia will be the same as in 3d.</p>
|
inertia will be the same as in 3d.
|
||||||
</div>
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<P><B>Output info:</B>
|
||||||
<p>This compute calculates a global scalar (the KE). This value can be
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the KE). This value can be
|
||||||
used by any command that uses a global scalar value from a compute as
|
used by any command that uses a global scalar value from a compute as
|
||||||
input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an
|
input. See <A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an
|
||||||
overview of LAMMPS output options.</p>
|
overview of LAMMPS output options.
|
||||||
<p>The scalar value calculated by this compute is “extensive”. The
|
</P>
|
||||||
scalar value will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
<P>The scalar value calculated by this compute is "extensive". The
|
||||||
</div>
|
scalar value will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute requires that ellipsoidal particles atoms store a shape
|
</P>
|
||||||
|
<P>This compute requires that ellipsoidal particles atoms store a shape
|
||||||
and quaternion orientation and angular momentum as defined by the
|
and quaternion orientation and angular momentum as defined by the
|
||||||
<a class="reference internal" href="atom_style.html"><em>atom_style ellipsoid</em></a> command.</p>
|
<A HREF = "atom_style.html">atom_style ellipsoid</A> command.
|
||||||
<p>This compute requires that line segment particles atoms store a length
|
</P>
|
||||||
and orientation and angular velocity as defined by the <a class="reference internal" href="atom_style.html"><em>atom_style line</em></a> command.</p>
|
<P>This compute requires that line segment particles atoms store a length
|
||||||
<p>This compute requires that triangular particles atoms store a size and
|
and orientation and angular velocity as defined by the <A HREF = "atom_style.html">atom_style
|
||||||
|
line</A> command.
|
||||||
|
</P>
|
||||||
|
<P>This compute requires that triangular particles atoms store a size and
|
||||||
shape and quaternion orientation and angular momentum as defined by
|
shape and quaternion orientation and angular momentum as defined by
|
||||||
the <a class="reference internal" href="atom_style.html"><em>atom_style tri</em></a> command.</p>
|
the <A HREF = "atom_style.html">atom_style tri</A> command.
|
||||||
<p>All particles in the group must be finite-size. They cannot be point
|
</P>
|
||||||
particles.</p>
|
<P>All particles in the group must be finite-size. They cannot be point
|
||||||
<p><strong>Related commands:</strong> none</p>
|
particles.
|
||||||
<p><a class="reference internal" href="compute_erotate_sphere.html"><em>compute erotate/sphere</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Related commands:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P><A HREF = "compute_erotate_sphere.html">compute erotate/sphere</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,242 +1,66 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute erotate/rigid command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute erotate/rigid command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute erotate/rigid command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID erotate/rigid fix-ID
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>erotate/rigid = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>fix-ID = ID of rigid body fix
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 all erotate/rigid myRigid
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that calculates the rotational kinetic energy of
|
||||||
|
a collection of rigid bodies, as defined by one of the <A HREF = "fix_rigid.html">fix
|
||||||
<div class="section" id="compute-erotate-rigid-command">
|
rigid</A> command variants.
|
||||||
<span id="index-0"></span><h1>compute erotate/rigid command<a class="headerlink" href="#compute-erotate-rigid-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<P>The rotational energy of each rigid body is computed as 1/2 I Wbody^2,
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID erotate/rigid fix-ID
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>erotate/rigid = style name of this compute command</li>
|
|
||||||
<li>fix-ID = ID of rigid body fix</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all erotate/rigid myRigid
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the rotational kinetic energy of
|
|
||||||
a collection of rigid bodies, as defined by one of the <a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a> command variants.</p>
|
|
||||||
<p>The rotational energy of each rigid body is computed as 1/2 I Wbody^2,
|
|
||||||
where I is the inertia tensor for the rigid body, and Wbody is its
|
where I is the inertia tensor for the rigid body, and Wbody is its
|
||||||
angular velocity vector. Both I and Wbody are in the frame of
|
angular velocity vector. Both I and Wbody are in the frame of
|
||||||
reference of the rigid body, i.e. I is diagonalized.</p>
|
reference of the rigid body, i.e. I is diagonalized.
|
||||||
<p>The <em>fix-ID</em> should be the ID of one of the <a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a>
|
</P>
|
||||||
|
<P>The <I>fix-ID</I> should be the ID of one of the <A HREF = "fix_rigid.html">fix rigid</A>
|
||||||
commands which defines the rigid bodies. The group specified in the
|
commands which defines the rigid bodies. The group specified in the
|
||||||
compute command is ignored. The rotational energy of all the rigid
|
compute command is ignored. The rotational energy of all the rigid
|
||||||
bodies defined by the fix rigid command in included in the
|
bodies defined by the fix rigid command in included in the
|
||||||
calculation.</p>
|
calculation.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global scalar (the summed rotational energy
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the summed rotational energy
|
||||||
of all the rigid bodies). This value can be used by any command that
|
of all the rigid bodies). This value can be used by any command that
|
||||||
uses a global scalar value from a compute as input. See
|
uses a global scalar value from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The scalar value calculated by this compute is “extensive”. The
|
</P>
|
||||||
scalar value will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
<P>The scalar value calculated by this compute is "extensive". The
|
||||||
</div>
|
scalar value will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute is part of the RIGID package. It is only enabled if
|
</P>
|
||||||
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>
|
<P>This compute is part of the RIGID package. It is only enabled if
|
||||||
</div>
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<div class="section" id="related-commands">
|
LAMMPS</A> section for more info.
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><code class="xref doc docutils literal"><span class="pre">compute</span> <span class="pre">ke/rigid</span></code></p>
|
<P><B>Related commands:</B>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><A HREF = "compute_erotate_ke_rigid.html">compute ke/rigid</A>
|
||||||
</div>
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,242 +1,62 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute erotate/sphere command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute erotate/sphere command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute erotate/sphere command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID erotate/sphere
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>erotate/sphere = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all erotate/sphere
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the rotational kinetic energy of
|
||||||
<div itemprop="articleBody">
|
a group of spherical particles.
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-erotate-sphere-command">
|
<P>The rotational energy is computed as 1/2 I w^2, where I is the moment
|
||||||
<span id="index-0"></span><h1>compute erotate/sphere command<a class="headerlink" href="#compute-erotate-sphere-command" title="Permalink to this headline">¶</a></h1>
|
of inertia for a sphere and w is the particle's angular velocity.
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<P>IMPORTANT NOTE: For <A HREF = "dimension.html">2d models</A>, particles are treated
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID erotate/sphere
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>erotate/sphere = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all erotate/sphere
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the rotational kinetic energy of
|
|
||||||
a group of spherical particles.</p>
|
|
||||||
<p>The rotational energy is computed as 1/2 I w^2, where I is the moment
|
|
||||||
of inertia for a sphere and w is the particle’s angular velocity.</p>
|
|
||||||
<div class="admonition warning">
|
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">For <a class="reference internal" href="dimension.html"><em>2d models</em></a>, particles are treated
|
|
||||||
as spheres, not disks, meaning their moment of inertia will be the
|
as spheres, not disks, meaning their moment of inertia will be the
|
||||||
same as in 3d.</p>
|
same as in 3d.
|
||||||
</div>
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<P><B>Output info:</B>
|
||||||
<p>This compute calculates a global scalar (the KE). This value can be
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the KE). This value can be
|
||||||
used by any command that uses a global scalar value from a compute as
|
used by any command that uses a global scalar value from a compute as
|
||||||
input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an
|
input. See <A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an
|
||||||
overview of LAMMPS output options.</p>
|
overview of LAMMPS output options.
|
||||||
<p>The scalar value calculated by this compute is “extensive”. The
|
</P>
|
||||||
scalar value will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
<P>The scalar value calculated by this compute is "extensive". The
|
||||||
</div>
|
scalar value will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute requires that atoms store a radius and angular velocity
|
</P>
|
||||||
(omega) as defined by the <a class="reference internal" href="atom_style.html"><em>atom_style sphere</em></a> command.</p>
|
<P>This compute requires that atoms store a radius and angular velocity
|
||||||
<p>All particles in the group must be finite-size spheres or point
|
(omega) as defined by the <A HREF = "atom_style.html">atom_style sphere</A> command.
|
||||||
|
</P>
|
||||||
|
<P>All particles in the group must be finite-size spheres or point
|
||||||
particles. They cannot be aspherical. Point particles will not
|
particles. They cannot be aspherical. Point particles will not
|
||||||
contribute to the rotational energy.</p>
|
contribute to the rotational energy.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><B>Related commands:</B>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="compute_erotate_asphere.html"><em>compute erotate/asphere</em></a></p>
|
<P><A HREF = "compute_erotate_asphere.html">compute erotate/asphere</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,241 +1,58 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute erotate/sphere/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute erotate/sphere/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute erotate/sphere/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID erotate/sphere/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>erotate/sphere/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all erotate/sphere/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the rotational kinetic energy for
|
||||||
<div itemprop="articleBody">
|
each particle in a group.
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-erotate-sphere-atom-command">
|
<P>The rotational energy is computed as 1/2 I w^2, where I is the moment
|
||||||
<span id="index-0"></span><h1>compute erotate/sphere/atom command<a class="headerlink" href="#compute-erotate-sphere-atom-command" title="Permalink to this headline">¶</a></h1>
|
of inertia for a sphere and w is the particle's angular velocity.
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<P>IMPORTANT NOTE: For <A HREF = "dimension.html">2d models</A>, particles are treated
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID erotate/sphere/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>erotate/sphere/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all erotate/sphere/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the rotational kinetic energy for
|
|
||||||
each particle in a group.</p>
|
|
||||||
<p>The rotational energy is computed as 1/2 I w^2, where I is the moment
|
|
||||||
of inertia for a sphere and w is the particle’s angular velocity.</p>
|
|
||||||
<div class="admonition warning">
|
|
||||||
<p class="first admonition-title">Warning</p>
|
|
||||||
<p class="last">For <a class="reference internal" href="dimension.html"><em>2d models</em></a>, particles are treated
|
|
||||||
as spheres, not disks, meaning their moment of inertia will be the
|
as spheres, not disks, meaning their moment of inertia will be the
|
||||||
same as in 3d.</p>
|
same as in 3d.
|
||||||
</div>
|
</P>
|
||||||
<p>The value of the rotational kinetic energy will be 0.0 for atoms not
|
<P>The value of the rotational kinetic energy will be 0.0 for atoms not
|
||||||
in the specified compute group or for point particles with a radius =
|
in the specified compute group or for point particles with a radius =
|
||||||
0.0.</p>
|
0.0.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The per-atom vector values will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B> none
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><A HREF = "dump.html">dump custom</A>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump custom</em></a></p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,248 +1,67 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute event/displace command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute event/displace command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute event/displace command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID event/displace threshold
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>event/displace = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>threshold = minimum distance anyparticle must move to trigger an event (distance units)
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 all event/displace 0.5
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that flags an "event" if any particle in the
|
||||||
|
|
||||||
<div class="section" id="compute-event-displace-command">
|
|
||||||
<span id="index-0"></span><h1>compute event/displace command<a class="headerlink" href="#compute-event-displace-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>compute ID group-ID event/displace threshold
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>event/displace = style name of this compute command</li>
|
|
||||||
<li>threshold = minimum distance anyparticle must move to trigger an event (distance units)</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all event/displace 0.5
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that flags an “event” if any particle in the
|
|
||||||
group has moved a distance greater than the specified threshold
|
group has moved a distance greater than the specified threshold
|
||||||
distance when compared to a previously stored reference state
|
distance when compared to a previously stored reference state
|
||||||
(i.e. the previous event). This compute is typically used in
|
(i.e. the previous event). This compute is typically used in
|
||||||
conjunction with the <a class="reference internal" href="prd.html"><em>prd</em></a> and <a class="reference internal" href="tad.html"><em>tad</em></a> commands,
|
conjunction with the <A HREF = "prd.html">prd</A> and <A HREF = "tad.html">tad</A> commands,
|
||||||
to detect if a transition
|
to detect if a transition
|
||||||
to a new minimum energy basin has occurred.</p>
|
to a new minimum energy basin has occurred.
|
||||||
<p>This value calculated by the compute is equal to 0 if no particle has
|
</P>
|
||||||
|
<P>This value calculated by the compute is equal to 0 if no particle has
|
||||||
moved far enough, and equal to 1 if one or more particles have moved
|
moved far enough, and equal to 1 if one or more particles have moved
|
||||||
further than the threshold distance.</p>
|
further than the threshold distance.
|
||||||
<div class="admonition note">
|
</P>
|
||||||
<p class="first admonition-title">Note</p>
|
<P>NOTE: If the system is undergoing significant center-of-mass motion,
|
||||||
<p class="last">If the system is undergoing significant center-of-mass motion,
|
due to thermal motion, an external force, or an initial net momentum,
|
||||||
due to thermal motion, an external force, or an initial net momentum,
|
|
||||||
then this compute will not be able to distinguish that motion from
|
then this compute will not be able to distinguish that motion from
|
||||||
local atom displacements and may generate “false postives.”</p>
|
local atom displacements and may generate "false postives."
|
||||||
</div>
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<P><B>Output info:</B>
|
||||||
<p>This compute calculates a global scalar (the flag). This value can be
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the flag). This value can be
|
||||||
used by any command that uses a global scalar value from a compute as
|
used by any command that uses a global scalar value from a compute as
|
||||||
input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an
|
input. See <A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an
|
||||||
overview of LAMMPS output options.</p>
|
overview of LAMMPS output options.
|
||||||
<p>The scalar value calculated by this compute is “intensive”. The
|
</P>
|
||||||
scalar value will be a 0 or 1 as explained above.</p>
|
<P>The scalar value calculated by this compute is "intensive". The
|
||||||
</div>
|
scalar value will be a 0 or 1 as explained above.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This command can only be used if LAMMPS was built with the REPLICA
|
</P>
|
||||||
package. See the <a class="reference internal" href="Section_start.html#start-3"><span>Making LAMMPS</span></a> section
|
<P>This command can only be used if LAMMPS was built with the REPLICA
|
||||||
for more info on packages.</p>
|
package. See the <A HREF = "Section_start.html#start_3">Making LAMMPS</A> section
|
||||||
</div>
|
for more info on packages.
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><B>Related commands:</B>
|
||||||
<p><a class="reference internal" href="prd.html"><em>prd</em></a>, <a class="reference internal" href="tad.html"><em>tad</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><A HREF = "prd.html">prd</A>, <A HREF = "tad.html">tad</A>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
|
</HTML>
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,447 +1,279 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute fep command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute fep command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute fep command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID fep temp attribute args ... keyword value ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in the <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>fep = name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>temp = external temperature (as specified for constant-temperature run)
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>one or more attributes with args may be appended
|
||||||
|
|
||||||
</div>
|
<LI>attribute = <I>pair</I> or <I>atom</I>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
<PRE> <I>pair</I> args = pstyle pparam I J v_delta
|
||||||
|
|
||||||
<div class="section" id="compute-fep-command">
|
|
||||||
<span id="index-0"></span><h1>compute fep command<a class="headerlink" href="#compute-fep-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>compute ID group-ID fep temp attribute args ... keyword value ...
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in the <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>fep = name of this compute command</li>
|
|
||||||
<li>temp = external temperature (as specified for constant-temperature run)</li>
|
|
||||||
<li>one or more attributes with args may be appended</li>
|
|
||||||
<li>attribute = <em>pair</em> or <em>atom</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>pair</em> args = pstyle pparam I J v_delta
|
|
||||||
pstyle = pair style name, e.g. lj/cut
|
pstyle = pair style name, e.g. lj/cut
|
||||||
pparam = parameter to perturb
|
pparam = parameter to perturb
|
||||||
I,J = type pair(s) to set parameter for
|
I,J = type pair(s) to set parameter for
|
||||||
v_delta = variable with perturbation to apply (in the units of the parameter)
|
v_delta = variable with perturbation to apply (in the units of the parameter)
|
||||||
<em>atom</em> args = aparam I v_delta
|
<I>atom</I> args = aparam I v_delta
|
||||||
aparam = parameter to perturb
|
aparam = parameter to perturb
|
||||||
I = type to set parameter for
|
I = type to set parameter for
|
||||||
v_delta = variable with perturbation to apply (in the units of the parameter)
|
v_delta = variable with perturbation to apply (in the units of the parameter)
|
||||||
</pre>
|
</PRE>
|
||||||
<ul class="simple">
|
<LI>zero or more keyword/value pairs may be appended
|
||||||
<li>zero or more keyword/value pairs may be appended</li>
|
|
||||||
<li>keyword = <em>tail</em> or <em>volume</em></li>
|
<LI>keyword = <I>tail</I> or <I>volume</I>
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
<PRE> <I>tail</I> value = <I>no</I> or <I>yes</I>
|
||||||
<em>tail</em> value = <em>no</em> or <em>yes</em>
|
<I>no</I> = ignore tail correction to pair energies (usually small in fep)
|
||||||
<em>no</em> = ignore tail correction to pair energies (usually small in fep)
|
<I>yes</I> = include tail correction to pair energies
|
||||||
<em>yes</em> = include tail correction to pair energies
|
<I>volume</I> value = <I>no</I> or <I>yes</I>
|
||||||
<em>volume</em> value = <em>no</em> or <em>yes</em>
|
<I>no</I> = ignore volume changes (e.g. in <I>NVE</I> or <I>NVT</I> trajectories)
|
||||||
<em>no</em> = ignore volume changes (e.g. in <em>NVE</em> or <em>NVT</em> trajectories)
|
<I>yes</I> = include volume changes (e.g. in <I>NpT</I> trajectories)
|
||||||
<em>yes</em> = include volume changes (e.g. in <em>NpT</em> trajectories)
|
</PRE>
|
||||||
</pre>
|
|
||||||
</div>
|
</UL>
|
||||||
<div class="section" id="examples">
|
<P><B>Examples:</B>
|
||||||
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute 1 all fep 298 pair lj/cut epsilon 1 * v_delta pair lj/cut sigma 1 * v_delta volume yes
|
<PRE>compute 1 all fep 298 pair lj/cut epsilon 1 * v_delta pair lj/cut sigma 1 * v_delta volume yes
|
||||||
compute 1 all fep 300 atom charge 2 v_delta
|
compute 1 all fep 300 atom charge 2 v_delta
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Apply a perturbation to parameters of the interaction potential and
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Apply a perturbation to parameters of the interaction potential and
|
|
||||||
recalculate the pair potential energy without changing the atomic
|
recalculate the pair potential energy without changing the atomic
|
||||||
coordinates from those of the reference, unperturbed system. This
|
coordinates from those of the reference, unperturbed system. This
|
||||||
compute can be used to calculate free energy differences using several
|
compute can be used to calculate free energy differences using several
|
||||||
methods, such as free-energy perturbation (FEP), finite-difference
|
methods, such as free-energy perturbation (FEP), finite-difference
|
||||||
thermodynamic integration (FDTI) or Bennet’s acceptance ratio method
|
thermodynamic integration (FDTI) or Bennet's acceptance ratio method
|
||||||
(BAR).</p>
|
(BAR).
|
||||||
<p>The potential energy of the system is decomposed in three terms: a
|
</P>
|
||||||
|
<P>The potential energy of the system is decomposed in three terms: a
|
||||||
background term corresponding to interaction sites whose parameters
|
background term corresponding to interaction sites whose parameters
|
||||||
remain constant, a reference term <a href="#id1"><span class="problematic" id="id2">*</span></a>U*<sub>0</sub> corresponding to the
|
remain constant, a reference term <I>U</I><sub>0</sub> corresponding to the
|
||||||
initial interactions of the atoms that will undergo perturbation, and
|
initial interactions of the atoms that will undergo perturbation, and
|
||||||
a term <a href="#id3"><span class="problematic" id="id4">*</span></a>U*<sub>1</sub> corresponding to the final interactions of
|
a term <I>U</I><sub>1</sub> corresponding to the final interactions of
|
||||||
these atoms:</p>
|
these atoms:
|
||||||
<img alt="_images/compute_fep_u.jpg" class="align-center" src="_images/compute_fep_u.jpg" />
|
</P>
|
||||||
<p>A coupling parameter &lambda; varying from 0 to 1 connects the
|
<CENTER><IMG SRC = "Eqs/compute_fep_u.jpg">
|
||||||
reference and perturbed systems:</p>
|
</CENTER>
|
||||||
<img alt="_images/compute_fep_lambda.jpg" class="align-center" src="_images/compute_fep_lambda.jpg" />
|
<P>A coupling parameter λ varying from 0 to 1 connects the
|
||||||
<p>It is possible but not necessary that the coupling parameter (or a
|
reference and perturbed systems:
|
||||||
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/compute_fep_lambda.jpg">
|
||||||
|
</CENTER>
|
||||||
|
<P>It is possible but not necessary that the coupling parameter (or a
|
||||||
function thereof) appears as a multiplication factor of the potential
|
function thereof) appears as a multiplication factor of the potential
|
||||||
energy. Therefore, this compute can apply perturbations to interaction
|
energy. Therefore, this compute can apply perturbations to interaction
|
||||||
parameters that are not directly proportional to the potential energy
|
parameters that are not directly proportional to the potential energy
|
||||||
(e.g. &sigma; in Lennard-Jones potentials).</p>
|
(e.g. σ in Lennard-Jones potentials).
|
||||||
<p>This command can be combined with <a class="reference internal" href="fix_adapt.html"><em>fix adapt</em></a> to
|
</P>
|
||||||
|
<P>This command can be combined with <A HREF = "fix_adapt.html">fix adapt</A> to
|
||||||
perform multistage free-energy perturbation calculations along
|
perform multistage free-energy perturbation calculations along
|
||||||
stepwise alchemical transformations during a simulation run:</p>
|
stepwise alchemical transformations during a simulation run:
|
||||||
<img alt="_images/compute_fep_fep.jpg" class="align-center" src="_images/compute_fep_fep.jpg" />
|
</P>
|
||||||
<p>This compute is suitable for the finite-difference thermodynamic
|
<CENTER><IMG SRC = "Eqs/compute_fep_fep.jpg">
|
||||||
integration (FDTI) method <a class="reference internal" href="#mezei"><span>(Mezei)</span></a>, which is based on an
|
</CENTER>
|
||||||
|
<P>This compute is suitable for the finite-difference thermodynamic
|
||||||
|
integration (FDTI) method <A HREF = "#Mezei">(Mezei)</A>, which is based on an
|
||||||
evaluation of the numerical derivative of the free energy by a
|
evaluation of the numerical derivative of the free energy by a
|
||||||
perturbation method using a very small &delta;:</p>
|
perturbation method using a very small δ:
|
||||||
<img alt="_images/compute_fep_fdti.jpg" class="align-center" src="_images/compute_fep_fdti.jpg" />
|
</P>
|
||||||
<p>where <a href="#id5"><span class="problematic" id="id6">*</span></a>w*<sub>i</sub> are weights of a numerical quadrature. The <a class="reference internal" href="fix_adapt.html"><em>fix adapt</em></a> command can be used to define the stages of
|
<CENTER><IMG SRC = "Eqs/compute_fep_fdti.jpg">
|
||||||
&lambda; at which the derivative is calculated and averaged.</p>
|
</CENTER>
|
||||||
<p>The compute fep calculates the exponential Boltzmann term and also the
|
<P>where <I>w</I><sub>i</sub> are weights of a numerical quadrature. The <A HREF = "fix_adapt.html">fix
|
||||||
potential energy difference <a href="#id7"><span class="problematic" id="id8">*</span></a>U*<sub>1</sub>-<a href="#id9"><span class="problematic" id="id10">*</span></a>U*<sub>0</sub>. By
|
adapt</A> command can be used to define the stages of
|
||||||
choosing a very small perturbation &delta; the thermodynamic
|
λ at which the derivative is calculated and averaged.
|
||||||
|
</P>
|
||||||
|
<P>The compute fep calculates the exponential Boltzmann term and also the
|
||||||
|
potential energy difference <I>U</I><sub>1</sub>-<I>U</I><sub>0</sub>. By
|
||||||
|
choosing a very small perturbation δ the thermodynamic
|
||||||
integration method can be implemented using a numerical evaluation of
|
integration method can be implemented using a numerical evaluation of
|
||||||
the derivative of the potential energy with respect to &lambda;:</p>
|
the derivative of the potential energy with respect to λ:
|
||||||
<img alt="_images/compute_fep_ti.jpg" class="align-center" src="_images/compute_fep_ti.jpg" />
|
</P>
|
||||||
<p>Another technique to calculate free energy differences is the
|
<CENTER><IMG SRC = "Eqs/compute_fep_ti.jpg">
|
||||||
acceptance ratio method <a class="reference internal" href="#bennet"><span>(Bennet)</span></a>, which can be implemented
|
</CENTER>
|
||||||
by calculating the potential energy differences with &delta; = 1.0 on
|
<P>Another technique to calculate free energy differences is the
|
||||||
both the forward and reverse routes:</p>
|
acceptance ratio method <A HREF = "#Bennet">(Bennet)</A>, which can be implemented
|
||||||
<img alt="_images/compute_fep_bar.jpg" class="align-center" src="_images/compute_fep_bar.jpg" />
|
by calculating the potential energy differences with δ = 1.0 on
|
||||||
<p>The value of the free energy difference is determined by numerical
|
both the forward and reverse routes:
|
||||||
root finding to establish the equality.</p>
|
</P>
|
||||||
<p>Concerning the choice of how the atomic parameters are perturbed in
|
<CENTER><IMG SRC = "Eqs/compute_fep_bar.jpg">
|
||||||
|
</CENTER>
|
||||||
|
<P>The value of the free energy difference is determined by numerical
|
||||||
|
root finding to establish the equality.
|
||||||
|
</P>
|
||||||
|
<P>Concerning the choice of how the atomic parameters are perturbed in
|
||||||
order to setup an alchemical transformation route, several strategies
|
order to setup an alchemical transformation route, several strategies
|
||||||
are available, such as single-topology or double-topology strategies
|
are available, such as single-topology or double-topology strategies
|
||||||
<a class="reference internal" href="#pearlman"><span>(Pearlman)</span></a>. The latter does not require modification of
|
<A HREF = "#Pearlman">(Pearlman)</A>. The latter does not require modification of
|
||||||
bond lengths, angles or other internal coordinates.</p>
|
bond lengths, angles or other internal coordinates.
|
||||||
<p>IMPORTANT NOTES: This compute command does not take kinetic energy
|
</P>
|
||||||
|
<P>IMPORTANT NOTES: This compute command does not take kinetic energy
|
||||||
into account, therefore the masses of the particles should not be
|
into account, therefore the masses of the particles should not be
|
||||||
modified between the reference and perturbed states, or along the
|
modified between the reference and perturbed states, or along the
|
||||||
alchemical transformation route. This compute command does not change
|
alchemical transformation route. This compute command does not change
|
||||||
bond lengths or other internal coordinates <a class="reference internal" href="#boreschkarplus"><span>(Boresch, Karplus)</span></a>.</p>
|
bond lengths or other internal coordinates <A HREF = "#BoreschKarplus">(Boresch,
|
||||||
<hr class="docutils" />
|
Karplus)</A>.
|
||||||
<p>The <em>pair</em> attribute enables various parameters of potentials defined
|
</P>
|
||||||
by the <a class="reference internal" href="pair_style.html"><em>pair_style</em></a> and <a class="reference internal" href="pair_coeff.html"><em>pair_coeff</em></a>
|
<HR>
|
||||||
commands to be changed, if the pair style supports it.</p>
|
|
||||||
<p>The <em>pstyle</em> argument is the name of the pair style. For example,
|
<P>The <I>pair</I> attribute enables various parameters of potentials defined
|
||||||
<em>pstyle</em> could be specified as “lj/cut”. The <em>pparam</em> argument is the
|
by the <A HREF = "pair_style.html">pair_style</A> and <A HREF = "pair_coeff.html">pair_coeff</A>
|
||||||
|
commands to be changed, if the pair style supports it.
|
||||||
|
</P>
|
||||||
|
<P>The <I>pstyle</I> argument is the name of the pair style. For example,
|
||||||
|
<I>pstyle</I> could be specified as "lj/cut". The <I>pparam</I> argument is the
|
||||||
name of the parameter to change. This is a (non-exclusive) list of
|
name of the parameter to change. This is a (non-exclusive) list of
|
||||||
pair styles and parameters that can be used with this compute. See
|
pair styles and parameters that can be used with this compute. See
|
||||||
the doc pages for individual pair styles and their energy formulas for
|
the doc pages for individual pair styles and their energy formulas for
|
||||||
the meaning of these parameters:</p>
|
the meaning of these parameters:
|
||||||
<table border="1" class="docutils">
|
</P>
|
||||||
<colgroup>
|
<DIV ALIGN=center><TABLE BORDER=1 >
|
||||||
<col width="59%" />
|
<TR><TD ><A HREF = "pair_lj.html">lj/cut</A></TD><TD > epsilon,sigma</TD><TD > type pairs</TD></TR>
|
||||||
<col width="27%" />
|
<TR><TD ><A HREF = "pair_lj.html">lj/cut/coul/cut</A></TD><TD > epsilon,sigma</TD><TD > type pairs</TD></TR>
|
||||||
<col width="15%" />
|
<TR><TD ><A HREF = "pair_lj.html">lj/cut/coul/long</A></TD><TD > epsilon,sigma</TD><TD > type pairs</TD></TR>
|
||||||
</colgroup>
|
<TR><TD ><A HREF = "pair_lj_soft.html">lj/cut/soft</A></TD><TD > epsilon,sigma,lambda</TD><TD > type pairs</TD></TR>
|
||||||
<tbody valign="top">
|
<TR><TD ><A HREF = "pair_lj_soft.html">coul/cut/soft</A></TD><TD > lambda</TD><TD > type pairs</TD></TR>
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="pair_lj.html"><em>lj/cut</em></a></td>
|
<TR><TD ><A HREF = "pair_lj_soft.html">coul/long/soft</A></TD><TD > lambda</TD><TD > type pairs</TD></TR>
|
||||||
<td>epsilon,sigma</td>
|
<TR><TD ><A HREF = "pair_lj_soft.html">lj/cut/coul/cut/soft</A></TD><TD > epsilon,sigma,lambda</TD><TD > type pairs</TD></TR>
|
||||||
<td>type pairs</td>
|
<TR><TD ><A HREF = "pair_lj_soft.html">lj/cut/coul/long/soft</A></TD><TD > epsilon,sigma,lambda</TD><TD > type pairs</TD></TR>
|
||||||
</tr>
|
<TR><TD ><A HREF = "pair_lj_soft.html">lj/cut/tip4p/long/soft</A></TD><TD > epsilon,sigma,lambda</TD><TD > type pairs</TD></TR>
|
||||||
<tr class="row-even"><td><a class="reference internal" href="pair_lj.html"><em>lj/cut/coul/cut</em></a></td>
|
<TR><TD ><A HREF = "pair_lj_soft.html">tip4p/long/soft</A></TD><TD > lambda</TD><TD > type pairs</TD></TR>
|
||||||
<td>epsilon,sigma</td>
|
<TR><TD ><A HREF = "pair_lj_soft.html">lj/charmm/coul/long/soft</A></TD><TD > epsilon,sigma,lambda</TD><TD > type pairs</TD></TR>
|
||||||
<td>type pairs</td>
|
<TR><TD ><A HREF = "pair_born.html">born</A></TD><TD > a,b,c</TD><TD > type pairs</TD></TR>
|
||||||
</tr>
|
<TR><TD ><A HREF = "pair_buck.html">buck</A></TD><TD > a,c </TD><TD > type pairs
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="pair_lj.html"><em>lj/cut/coul/long</em></a></td>
|
</TD></TR></TABLE></DIV>
|
||||||
<td>epsilon,sigma</td>
|
|
||||||
<td>type pairs</td>
|
<P>Note that it is easy to add new potentials and their parameters to
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><a class="reference internal" href="pair_lj_soft.html"><em>lj/cut/soft</em></a></td>
|
|
||||||
<td>epsilon,sigma,lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="pair_lj_soft.html"><em>coul/cut/soft</em></a></td>
|
|
||||||
<td>lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><a class="reference internal" href="pair_lj_soft.html"><em>coul/long/soft</em></a></td>
|
|
||||||
<td>lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="pair_lj_soft.html"><em>lj/cut/coul/cut/soft</em></a></td>
|
|
||||||
<td>epsilon,sigma,lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><a class="reference internal" href="pair_lj_soft.html"><em>lj/cut/coul/long/soft</em></a></td>
|
|
||||||
<td>epsilon,sigma,lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="pair_lj_soft.html"><em>lj/cut/tip4p/long/soft</em></a></td>
|
|
||||||
<td>epsilon,sigma,lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><a class="reference internal" href="pair_lj_soft.html"><em>tip4p/long/soft</em></a></td>
|
|
||||||
<td>lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="pair_lj_soft.html"><em>lj/charmm/coul/long/soft</em></a></td>
|
|
||||||
<td>epsilon,sigma,lambda</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-even"><td><a class="reference internal" href="pair_born.html"><em>born</em></a></td>
|
|
||||||
<td>a,b,c</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
<tr class="row-odd"><td><a class="reference internal" href="pair_buck.html"><em>buck</em></a></td>
|
|
||||||
<td>a,c</td>
|
|
||||||
<td>type pairs</td>
|
|
||||||
</tr>
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
<p>Note that it is easy to add new potentials and their parameters to
|
|
||||||
this list. All it typically takes is adding an extract() method to
|
this list. All it typically takes is adding an extract() method to
|
||||||
the pair_*.cpp file associated with the potential.</p>
|
the pair_*.cpp file associated with the potential.
|
||||||
<p>Similar to the <a class="reference internal" href="pair_coeff.html"><em>pair_coeff</em></a> command, I and J can be
|
</P>
|
||||||
|
<P>Similar to the <A HREF = "pair_coeff.html">pair_coeff</A> command, I and J can be
|
||||||
specified in one of two ways. Explicit numeric values can be used for
|
specified in one of two ways. Explicit numeric values can be used for
|
||||||
each, as in the 1st example above. I <= J is required. LAMMPS sets
|
each, as in the 1st example above. I <= J is required. LAMMPS sets
|
||||||
the coefficients for the symmetric J,I interaction to the same
|
the coefficients for the symmetric J,I interaction to the same
|
||||||
values. A wild-card asterisk can be used in place of or in conjunction
|
values. A wild-card asterisk can be used in place of or in conjunction
|
||||||
with the I,J arguments to set the coefficients for multiple pairs of
|
with the I,J arguments to set the coefficients for multiple pairs of
|
||||||
atom types. This takes the form “*” or “<em>n” or “n</em>” or “m*n”. If N =
|
atom types. This takes the form "*" or "*n" or "n*" or "m*n". If N =
|
||||||
the number of atom types, then an asterisk with no numeric values
|
the number of atom types, then an asterisk with no numeric values
|
||||||
means all types from 1 to N. A leading asterisk means all types from
|
means all types from 1 to N. A leading asterisk means all types from
|
||||||
1 to n (inclusive). A trailing asterisk means all types from n to N
|
1 to n (inclusive). A trailing asterisk means all types from n to N
|
||||||
(inclusive). A middle asterisk means all types from m to n
|
(inclusive). A middle asterisk means all types from m to n
|
||||||
(inclusive). Note that only type pairs with I <= J are considered; if
|
(inclusive). Note that only type pairs with I <= J are considered; if
|
||||||
asterisks imply type pairs where J < I, they are ignored.</p>
|
asterisks imply type pairs where J < I, they are ignored.
|
||||||
<p>If <a class="reference internal" href="pair_hybrid.html"><em>pair_style hybrid or hybrid/overlay</em></a> is being
|
</P>
|
||||||
used, then the <em>pstyle</em> will be a sub-style name. You must specify
|
<P>If <A HREF = "pair_hybrid.html">pair_style hybrid or hybrid/overlay</A> is being
|
||||||
|
used, then the <I>pstyle</I> will be a sub-style name. You must specify
|
||||||
I,J arguments that correspond to type pair values defined (via the
|
I,J arguments that correspond to type pair values defined (via the
|
||||||
<a class="reference internal" href="pair_coeff.html"><em>pair_coeff</em></a> command) for that sub-style.</p>
|
<A HREF = "pair_coeff.html">pair_coeff</A> command) for that sub-style.
|
||||||
<p>The <em>v_name</em> argument for keyword <em>pair</em> is the name of an
|
</P>
|
||||||
<a class="reference internal" href="variable.html"><em>equal-style variable</em></a> which will be evaluated each time
|
<P>The <I>v_name</I> argument for keyword <I>pair</I> is the name of an
|
||||||
|
<A HREF = "variable.html">equal-style variable</A> which will be evaluated each time
|
||||||
this compute is invoked. It should be specified as v_name, where name
|
this compute is invoked. It should be specified as v_name, where name
|
||||||
is the variable name.</p>
|
is the variable name.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The <em>atom</em> attribute enables atom properties to be changed. The
|
<HR>
|
||||||
<em>aparam</em> argument is the name of the parameter to change. This is the
|
|
||||||
current list of atom parameters that can be used with this compute:</p>
|
<P>The <I>atom</I> attribute enables atom properties to be changed. The
|
||||||
<ul class="simple">
|
<I>aparam</I> argument is the name of the parameter to change. This is the
|
||||||
<li>charge = charge on particle</li>
|
current list of atom parameters that can be used with this compute:
|
||||||
</ul>
|
</P>
|
||||||
<p>The <em>v_name</em> argument for keyword <em>pair</em> is the name of an
|
<UL><LI>charge = charge on particle
|
||||||
<a class="reference internal" href="variable.html"><em>equal-style variable</em></a> which will be evaluated each time
|
</UL>
|
||||||
|
<P>The <I>v_name</I> argument for keyword <I>pair</I> is the name of an
|
||||||
|
<A HREF = "variable.html">equal-style variable</A> which will be evaluated each time
|
||||||
this compute is invoked. It should be specified as v_name, where name
|
this compute is invoked. It should be specified as v_name, where name
|
||||||
is the variable name.</p>
|
is the variable name.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The <em>tail</em> keyword controls the calculation of the tail correction to
|
<HR>
|
||||||
“van der Waals” pair energies beyond the cutoff, if this has been
|
|
||||||
activated via the <a class="reference internal" href="pair_modify.html"><em>pair_modify</em></a> command. If the
|
<P>The <I>tail</I> keyword controls the calculation of the tail correction to
|
||||||
|
"van der Waals" pair energies beyond the cutoff, if this has been
|
||||||
|
activated via the <A HREF = "pair_modify.html">pair_modify</A> command. If the
|
||||||
perturbation is small, the tail contribution to the energy difference
|
perturbation is small, the tail contribution to the energy difference
|
||||||
between the reference and perturbed systems should be negligible.</p>
|
between the reference and perturbed systems should be negligible.
|
||||||
<p>If the keyword <em>volume</em> = <em>yes</em>, then the Boltzmann term is multiplied
|
</P>
|
||||||
|
<P>If the keyword <I>volume</I> = <I>yes</I>, then the Boltzmann term is multiplied
|
||||||
by the volume so that correct ensemble averaging can be performed over
|
by the volume so that correct ensemble averaging can be performed over
|
||||||
trajectories during which the volume fluctuates or changes <a class="reference internal" href="#allentildesley"><span>(Allen and Tildesley)</span></a>:</p>
|
trajectories during which the volume fluctuates or changes <A HREF = "#AllenTildesley">(Allen and
|
||||||
<img alt="_images/compute_fep_vol.jpg" class="align-center" src="_images/compute_fep_vol.jpg" />
|
Tildesley)</A>:
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<CENTER><IMG SRC = "Eqs/compute_fep_vol.jpg">
|
||||||
<p>This compute calculates a global vector of length 3 which contains the
|
</CENTER>
|
||||||
energy difference (<em>U*<sub>1</sub>-*U*<sub>0</sub>) as c_ID[1], the
|
<HR>
|
||||||
Boltzmann factor exp(-(*U*<sub>1</sub>-*U*<sub>0</sub>)/*kT</em>), or
|
|
||||||
<em>V*exp(-(*U*<sub>1</sub>-*U*<sub>0</sub>)/*kT</em>), as c_ID[2] and the
|
<P><B>Output info:</B>
|
||||||
volume of the simulation box <em>V</em> as c_ID[3]. <a href="#id11"><span class="problematic" id="id12">*</span></a>U*<sub>1</sub> is the
|
</P>
|
||||||
|
<P>This compute calculates a global vector of length 3 which contains the
|
||||||
|
energy difference (<I>U</I><sub>1</sub>-<I>U</I><sub>0</sub>) as c_ID[1], the
|
||||||
|
Boltzmann factor exp(-(<I>U</I><sub>1</sub>-<I>U</I><sub>0</sub>)/<I>kT</I>), or
|
||||||
|
<I>V</I>exp(-(<I>U</I><sub>1</sub>-<I>U</I><sub>0</sub>)/<I>kT</I>), as c_ID[2] and the
|
||||||
|
volume of the simulation box <I>V</I> as c_ID[3]. <I>U</I><sub>1</sub> is the
|
||||||
pair potential energy obtained with the perturbed parameters and
|
pair potential energy obtained with the perturbed parameters and
|
||||||
<a href="#id13"><span class="problematic" id="id14">*</span></a>U*<sub>0</sub> is the pair potential energy obtained with the
|
<I>U</I><sub>0</sub> is the pair potential energy obtained with the
|
||||||
unperturbed parameters. The energies include kspace terms if these
|
unperturbed parameters. The energies include kspace terms if these
|
||||||
are used in the simulation.</p>
|
are used in the simulation.
|
||||||
<p>These output results can be used by any command that uses a global
|
</P>
|
||||||
scalar or vector from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
<P>These output results can be used by any command that uses a global
|
||||||
options. For example, the computed values can be averaged using <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>.</p>
|
scalar or vector from a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
<p>The values calculated by this compute are “extensive”.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
</div>
|
options. For example, the computed values can be averaged using <A HREF = "fix_ave_time.html">fix
|
||||||
<div class="section" id="restrictions">
|
ave/time</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>This compute is distributed as the USER-FEP package. It is only
|
<P>The values calculated by this compute are "extensive".
|
||||||
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>
|
</P>
|
||||||
</div>
|
<P><B>Restrictions:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P>This compute is distributed as the USER-FEP package. It is only
|
||||||
<p><a class="reference internal" href="fix_adapt_fep.html"><em>fix adapt/fep</em></a>, <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>,
|
enabled if LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<a class="reference external" href="pair_lj_soft_coul_soft.txt">pair_lj_soft_coul_soft</a></p>
|
LAMMPS</A> section for more info.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="default">
|
<P><B>Related commands:</B>
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>The option defaults are <em>tail</em> = <em>no</em>, <em>volume</em> = <em>no</em>.</p>
|
<P><A HREF = "fix_adapt_fep.html">fix adapt/fep</A>, <A HREF = "fix_ave_time.html">fix ave/time</A>,
|
||||||
<hr class="docutils" />
|
<A HREF = "pair_lj_soft_coul_soft.txt">pair_lj_soft_coul_soft</A>
|
||||||
<p id="pearlman"><strong>(Pearlman)</strong> Pearlman, J Chem Phys, 98, 1487 (1994)</p>
|
</P>
|
||||||
<p id="mezei"><strong>(Mezei)</strong> Mezei, J Chem Phys, 86, 7084 (1987)</p>
|
<P><B>Default:</B>
|
||||||
<p id="bennet"><strong>(Bennet)</strong> Bennet, J Comput Phys, 22, 245 (1976)</p>
|
</P>
|
||||||
<p id="boreschkarplus"><strong>(BoreschKarplus)</strong> Boresch and Karplus, J Phys Chem A, 103, 103 (1999)</p>
|
<P>The option defaults are <I>tail</I> = <I>no</I>, <I>volume</I> = <I>no</I>.
|
||||||
<p id="allentildesley"><strong>(AllenTildesley)</strong> Allen and Tildesley, Computer Simulation of
|
</P>
|
||||||
Liquids, Oxford University Press (1987)</p>
|
<HR>
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
<A NAME = "Pearlman"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(Pearlman)</B> Pearlman, J Chem Phys, 98, 1487 (1994)
|
||||||
</div>
|
</P>
|
||||||
<footer>
|
<A NAME = "Mezei"></A>
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
<P><B>(Mezei)</B> Mezei, J Chem Phys, 86, 7084 (1987)
|
||||||
|
</P>
|
||||||
|
<A NAME = "Bennet"></A>
|
||||||
|
|
||||||
<div role="contentinfo">
|
<P><B>(Bennet)</B> Bennet, J Comput Phys, 22, 245 (1976)
|
||||||
<p>
|
</P>
|
||||||
© Copyright .
|
<A NAME = "BoreschKarplus"></A>
|
||||||
</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>
|
<P><B>(BoreschKarplus)</B> Boresch and Karplus, J Phys Chem A, 103, 103 (1999)
|
||||||
|
</P>
|
||||||
|
<A NAME = "AllenTildesley"></A>
|
||||||
|
|
||||||
</div>
|
<P><B>(AllenTildesley)</B> Allen and Tildesley, Computer Simulation of
|
||||||
</div>
|
Liquids, Oxford University Press (1987)
|
||||||
|
</P>
|
||||||
</section>
|
</HTML>
|
||||||
|
|
||||||
</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>
|
|
||||||
|
|||||||
@ -1,295 +1,135 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute group/group command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute group/group command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute group/group command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID group/group group2-ID keyword value ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>group/group = style name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>group2-ID = group ID of second (or same) group
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>zero or more keyword/value pairs may be appended
|
||||||
|
|
||||||
</div>
|
<LI>keyword = <I>pair</I> or <I>kspace</I> or <I>boundary</I>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
<PRE> <I>pair</I> value = <I>yes</I> or <I>no</I>
|
||||||
|
<I>kspace</I> value = <I>yes</I> or <I>no</I>
|
||||||
<div class="section" id="compute-group-group-command">
|
<I>boundary</I> value = <I>yes</I> or <I>no</I>
|
||||||
<span id="index-0"></span><h1>compute group/group command<a class="headerlink" href="#compute-group-group-command" title="Permalink to this headline">¶</a></h1>
|
</PRE>
|
||||||
<div class="section" id="syntax">
|
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
</UL>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID group/group group2-ID keyword value ...
|
<P><B>Examples:</B>
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<PRE>compute 1 lower group/group upper
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>group/group = style name of this compute command</li>
|
|
||||||
<li>group2-ID = group ID of second (or same) group</li>
|
|
||||||
<li>zero or more keyword/value pairs may be appended</li>
|
|
||||||
<li>keyword = <em>pair</em> or <em>kspace</em> or <em>boundary</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>pair</em> value = <em>yes</em> or <em>no</em>
|
|
||||||
<em>kspace</em> value = <em>yes</em> or <em>no</em>
|
|
||||||
<em>boundary</em> value = <em>yes</em> or <em>no</em>
|
|
||||||
</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>compute 1 lower group/group upper
|
|
||||||
compute 1 lower group/group upper kspace yes
|
compute 1 lower group/group upper kspace yes
|
||||||
compute mine fluid group/group wall
|
compute mine fluid group/group wall
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="description">
|
<P>Define a computation that calculates the total energy and force
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the total energy and force
|
|
||||||
interaction between two groups of atoms: the compute group and the
|
interaction between two groups of atoms: the compute group and the
|
||||||
specified group2. The two groups can be the same.</p>
|
specified group2. The two groups can be the same.
|
||||||
<p>If the <em>pair</em> keyword is set to <em>yes</em>, which is the default, then the
|
</P>
|
||||||
|
<P>If the <I>pair</I> keyword is set to <I>yes</I>, which is the default, then the
|
||||||
the interaction energy will include a pair component which is defined
|
the interaction energy will include a pair component which is defined
|
||||||
as the pairwise energy between all pairs of atoms where one atom in
|
as the pairwise energy between all pairs of atoms where one atom in
|
||||||
the pair is in the first group and the other is in the second group.
|
the pair is in the first group and the other is in the second group.
|
||||||
Likewise, the interaction force calculated by this compute will
|
Likewise, the interaction force calculated by this compute will
|
||||||
include the force on the compute group atoms due to pairwise
|
include the force on the compute group atoms due to pairwise
|
||||||
interactions with atoms in the specified group2.</p>
|
interactions with atoms in the specified group2.
|
||||||
<p>If the <em>kspace</em> keyword is set to <em>yes</em>, which is not the default, and
|
</P>
|
||||||
if a <a class="reference internal" href="kspace_style.html"><em>kspace_style</em></a> is defined, then the interaction
|
<P>If the <I>kspace</I> keyword is set to <I>yes</I>, which is not the default, and
|
||||||
|
if a <A HREF = "kspace_style.html">kspace_style</A> is defined, then the interaction
|
||||||
energy will include a Kspace component which is the long-range
|
energy will include a Kspace component which is the long-range
|
||||||
Coulombic energy between all the atoms in the first group and all the
|
Coulombic energy between all the atoms in the first group and all the
|
||||||
atoms in the 2nd group. Likewise, the interaction force calculated by
|
atoms in the 2nd group. Likewise, the interaction force calculated by
|
||||||
this compute will include the force on the compute group atoms due to
|
this compute will include the force on the compute group atoms due to
|
||||||
long-range Coulombic interactions with atoms in the specified group2.</p>
|
long-range Coulombic interactions with atoms in the specified group2.
|
||||||
<p>Normally the long-range Coulombic energy converges only when the net
|
</P>
|
||||||
|
<P>Normally the long-range Coulombic energy converges only when the net
|
||||||
charge of the unit cell is zero. However, one can assume the net
|
charge of the unit cell is zero. However, one can assume the net
|
||||||
charge of the system is neutralized by a uniform background plasma,
|
charge of the system is neutralized by a uniform background plasma,
|
||||||
and a correction to the system energy can be applied to reduce
|
and a correction to the system energy can be applied to reduce
|
||||||
artifacts. For more information see <a class="reference internal" href="#bogusz"><span>(Bogusz)</span></a>. If the
|
artifacts. For more information see <A HREF = "#Bogusz">(Bogusz)</A>. If the
|
||||||
<em>boundary</em> keyword is set to <em>yes</em>, which is the default, and <em>kspace</em>
|
<I>boundary</I> keyword is set to <I>yes</I>, which is the default, and <I>kspace</I>
|
||||||
contributions are included, then this energy correction term will be
|
contributions are included, then this energy correction term will be
|
||||||
added to the total group-group energy. This correction term does not
|
added to the total group-group energy. This correction term does not
|
||||||
affect the force calculation and will be zero if one or both of the
|
affect the force calculation and will be zero if one or both of the
|
||||||
groups are charge neutral. This energy correction term is the same as
|
groups are charge neutral. This energy correction term is the same as
|
||||||
that included in the regular Ewald and PPPM routines.</p>
|
that included in the regular Ewald and PPPM routines.
|
||||||
<p>This compute does not calculate any bond or angle or dihedral or
|
</P>
|
||||||
improper interactions between atoms in the two groups.</p>
|
<P>This compute does not calculate any bond or angle or dihedral or
|
||||||
<hr class="docutils" />
|
improper interactions between atoms in the two groups.
|
||||||
<p>The pairwise contributions to the group-group interactions are
|
</P>
|
||||||
|
<HR>
|
||||||
|
|
||||||
|
<P>The pairwise contributions to the group-group interactions are
|
||||||
calculated by looping over a neighbor list. The Kspace contribution
|
calculated by looping over a neighbor list. The Kspace contribution
|
||||||
to the group-group interactions require essentially the same amount of
|
to the group-group interactions require essentially the same amount of
|
||||||
work (FFTs, Ewald summation) as computing long-range forces for the
|
work (FFTs, Ewald summation) as computing long-range forces for the
|
||||||
entire system. Thus it can be costly to invoke this compute too
|
entire system. Thus it can be costly to invoke this compute too
|
||||||
frequently.</p>
|
frequently.
|
||||||
<p>If you desire a breakdown of the interactions into a pairwise and
|
</P>
|
||||||
|
<P>If you desire a breakdown of the interactions into a pairwise and
|
||||||
Kspace component, simply invoke the compute twice with the appropriate
|
Kspace component, simply invoke the compute twice with the appropriate
|
||||||
yes/no settings for the <em>pair</em> and <em>kspace</em> keywords. This is no more
|
yes/no settings for the <I>pair</I> and <I>kspace</I> keywords. This is no more
|
||||||
costly than using a single compute with both keywords set to <em>yes</em>.
|
costly than using a single compute with both keywords set to <I>yes</I>.
|
||||||
The individual contributions can be summed in a
|
The individual contributions can be summed in a
|
||||||
<a class="reference internal" href="variable.html"><em>variable</em></a> if desired.</p>
|
<A HREF = "variable.html">variable</A> if desired.
|
||||||
<p>This <a class="reference external" href="PDF/kspace.pdf">document</a> describes how the long-range
|
</P>
|
||||||
group-group calculations are performed.</p>
|
<P>This <A HREF = "PDF/kspace.pdf">document</A> describes how the long-range
|
||||||
<hr class="docutils" />
|
group-group calculations are performed.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global scalar (the energy) and a global
|
<HR>
|
||||||
|
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the energy) and a global
|
||||||
vector of length 3 (force), which can be accessed by indices 1-3.
|
vector of length 3 (force), which can be accessed by indices 1-3.
|
||||||
These values can be used by any command that uses global scalar or
|
These values can be used by any command that uses global scalar or
|
||||||
vector values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
vector values from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>Both the scalar and vector values calculated by this compute are
|
options.
|
||||||
“extensive”. The scalar value will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.
|
</P>
|
||||||
The vector values will be in force <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
<P>Both the scalar and vector values calculated by this compute are
|
||||||
</div>
|
"extensive". The scalar value will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
The vector values will be in force <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>Not all pair styles can be evaluated in a pairwise mode as required by
|
<P><B>Restrictions:</B>
|
||||||
|
</P>
|
||||||
|
<P>Not all pair styles can be evaluated in a pairwise mode as required by
|
||||||
this compute. For example, 3-body and other many-body potentials,
|
this compute. For example, 3-body and other many-body potentials,
|
||||||
such as <a class="reference internal" href="pair_tersoff.html"><em>Tersoff</em></a> and
|
such as <A HREF = "pair_tersoff.html">Tersoff</A> and
|
||||||
<a class="reference internal" href="pair_sw.html"><em>Stillinger-Weber</em></a> cannot be used. <a class="reference internal" href="pair_eam.html"><em>EAM</em></a>
|
<A HREF = "pair_sw.html">Stillinger-Weber</A> cannot be used. <A HREF = "pair_eam.html">EAM</A>
|
||||||
potentials only include the pair potential portion of the EAM
|
potentials only include the pair potential portion of the EAM
|
||||||
interaction when used by this compute, not the embedding term.</p>
|
interaction when used by this compute, not the embedding term.
|
||||||
<p>Not all Kspace styles support calculation of group/group interactions.
|
</P>
|
||||||
The <em>ewald</em> and <em>pppm</em> styles do.</p>
|
<P>Not all Kspace styles support calculation of group/group interactions.
|
||||||
<p><strong>Related commands:</strong> none</p>
|
The <I>ewald</I> and <I>pppm</I> styles do.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="default">
|
<P><B>Related commands:</B> none
|
||||||
<h2>Default<a class="headerlink" href="#default" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>The option defaults are pair = yes, kspace = no, and boundary = yes.</p>
|
<P><B>Default:</B>
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p id="bogusz">Bogusz et al, J Chem Phys, 108, 7070 (1998)</p>
|
<P>The option defaults are pair = yes, kspace = no, and boundary = yes.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<HR>
|
||||||
|
|
||||||
|
<A NAME = "Bogusz"></A>
|
||||||
|
|
||||||
</div>
|
<P>Bogusz et al, J Chem Phys, 108, 7070 (1998)
|
||||||
</div>
|
</P>
|
||||||
<footer>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,257 +1,78 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute gyration command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute gyration command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute gyration command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID gyration
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>gyration = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 molecule gyration
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the radius of gyration Rg of the
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-gyration-command">
|
|
||||||
<span id="index-0"></span><h1>compute gyration command<a class="headerlink" href="#compute-gyration-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>compute ID group-ID gyration
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>gyration = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 molecule gyration
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the radius of gyration Rg of the
|
|
||||||
group of atoms, including all effects due to atoms passing thru
|
group of atoms, including all effects due to atoms passing thru
|
||||||
periodic boundaries.</p>
|
periodic boundaries.
|
||||||
<p>Rg is a measure of the size of the group of atoms, and is computed as
|
</P>
|
||||||
the square root of the Rg^2 value in this formula</p>
|
<P>Rg is a measure of the size of the group of atoms, and is computed as
|
||||||
<img alt="_images/compute_gyration.jpg" class="align-center" src="_images/compute_gyration.jpg" />
|
the square root of the Rg^2 value in this formula
|
||||||
<p>where M is the total mass of the group, Rcm is the center-of-mass
|
</P>
|
||||||
position of the group, and the sum is over all atoms in the group.</p>
|
<CENTER><IMG SRC = "Eqs/compute_gyration.jpg">
|
||||||
<p>A Rg^2 tensor, stored as a 6-element vector, is also calculated by
|
</CENTER>
|
||||||
|
<P>where M is the total mass of the group, Rcm is the center-of-mass
|
||||||
|
position of the group, and the sum is over all atoms in the group.
|
||||||
|
</P>
|
||||||
|
<P>A Rg^2 tensor, stored as a 6-element vector, is also calculated by
|
||||||
this compute. The formula for the components of the tensor is the
|
this compute. The formula for the components of the tensor is the
|
||||||
same as the above formula, except that (Ri - Rcm)^2 is replaced by
|
same as the above formula, except that (Ri - Rcm)^2 is replaced by
|
||||||
(Rix - Rcmx) * (Riy - Rcmy) for the xy component, etc. The 6
|
(Rix - Rcmx) * (Riy - Rcmy) for the xy component, etc. The 6
|
||||||
components of the vector are ordered xx, yy, zz, xy, xz, yz. Note
|
components of the vector are ordered xx, yy, zz, xy, xz, yz. Note
|
||||||
that unlike the scalar Rg, each of the 6 values of the tensor is
|
that unlike the scalar Rg, each of the 6 values of the tensor is
|
||||||
effectively a “squared” value, since the cross-terms may be negative
|
effectively a "squared" value, since the cross-terms may be negative
|
||||||
and taking a sqrt() would be invalid.</p>
|
and taking a sqrt() would be invalid.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The coordinates of an atom contribute to Rg in
|
||||||
<p class="last">The coordinates of an atom contribute to Rg in
|
"unwrapped" form, by using the image flags associated with each atom.
|
||||||
“unwrapped” form, by using the image flags associated with each atom.
|
See the <A HREF = "dump.html">dump custom</A> command for a discussion of
|
||||||
See the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command for a discussion of
|
"unwrapped" coordinates. See the Atoms section of the
|
||||||
“unwrapped” coordinates. See the Atoms section of the
|
<A HREF = "read_data.html">read_data</A> command for a discussion of image flags and
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command for a discussion of image flags and
|
|
||||||
how they are set for each atom. You can reset the image flags
|
how they are set for each atom. You can reset the image flags
|
||||||
(e.g. to 0) before invoking this compute by using the <a class="reference internal" href="set.html"><em>set image</em></a> command.</p>
|
(e.g. to 0) before invoking this compute by using the <A HREF = "set.html">set
|
||||||
</div>
|
image</A> command.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global scalar (Rg) and a global vector of
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (Rg) and a global vector of
|
||||||
length 6 (Rg^2 tensor), which can be accessed by indices 1-6. These
|
length 6 (Rg^2 tensor), which can be accessed by indices 1-6. These
|
||||||
values can be used by any command that uses a global scalar value or
|
values can be used by any command that uses a global scalar value or
|
||||||
vector values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
vector values from a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The scalar and vector values calculated by this compute are
|
options.
|
||||||
“intensive”. The scalar and vector values will be in distance and
|
</P>
|
||||||
distance^2 <a class="reference internal" href="units.html"><em>units</em></a> respectively.</p>
|
<P>The scalar and vector values calculated by this compute are
|
||||||
</div>
|
"intensive". The scalar and vector values will be in distance and
|
||||||
<div class="section" id="restrictions">
|
distance^2 <A HREF = "units.html">units</A> respectively.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "compute_gyration_chunk.html">compute gyration/chunk</A>
|
||||||
<p><a class="reference internal" href="compute_gyration_chunk.html"><em>compute gyration/chunk</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,288 +1,122 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute gyration/chunk command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute gyration/chunk command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute gyration/chunk command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID gyration/chunk chunkID keyword value ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>gyration/chunk = style name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>chunkID = ID of <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>zero or more keyword/value pairs may be appended
|
||||||
|
|
||||||
</div>
|
<LI>keyword = <I>tensor</I>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
|
||||||
<div itemprop="articleBody">
|
<PRE> <I>tensor</I> value = none
|
||||||
|
</PRE>
|
||||||
<div class="section" id="compute-gyration-chunk-command">
|
|
||||||
<span id="index-0"></span><h1>compute gyration/chunk command<a class="headerlink" href="#compute-gyration-chunk-command" title="Permalink to this headline">¶</a></h1>
|
</UL>
|
||||||
<div class="section" id="syntax">
|
<P><B>Examples:</B>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID gyration/chunk chunkID keyword value ...
|
<PRE>compute 1 molecule gyration/chunk molchunk
|
||||||
</pre></div>
|
compute 2 molecule gyration/chunk molchunk tensor
|
||||||
</div>
|
</PRE>
|
||||||
<ul class="simple">
|
<P><B>Description:</B>
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
</P>
|
||||||
<li>gyration/chunk = style name of this compute command</li>
|
<P>Define a computation that calculates the radius of gyration Rg for
|
||||||
<li>chunkID = ID of <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command</li>
|
multiple chunks of atoms.
|
||||||
<li>zero or more keyword/value pairs may be appended</li>
|
</P>
|
||||||
<li>keyword = <em>tensor</em></li>
|
<P>In LAMMPS, chunks are collections of atoms defined by a <A HREF = "compute_chunk_atom.html">compute
|
||||||
</ul>
|
chunk/atom</A> command, which assigns each atom
|
||||||
<pre class="literal-block">
|
|
||||||
<em>tensor</em> value = none
|
|
||||||
</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>compute 1 molecule gyration/chunk molchunk
|
|
||||||
compute 2 molecule gyration/chunk molchunk tensor
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the radius of gyration Rg for
|
|
||||||
multiple chunks of atoms.</p>
|
|
||||||
<p>In LAMMPS, chunks are collections of atoms defined by a <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command, which assigns each atom
|
|
||||||
to a single chunk (or no chunk). The ID for this command is specified
|
to a single chunk (or no chunk). The ID for this command is specified
|
||||||
as chunkID. For example, a single chunk could be the atoms in a
|
as chunkID. For example, a single chunk could be the atoms in a
|
||||||
molecule or atoms in a spatial bin. See the <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> doc page and “<a class="reference internal" href="Section_howto.html#howto-23"><span>Section_howto 23</span></a> for details of how chunks can be
|
molecule or atoms in a spatial bin. See the <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> doc page and "<A HREF = "Section_howto.html#howto_23">Section_howto
|
||||||
|
23</A> for details of how chunks can be
|
||||||
defined and examples of how they can be used to measure properties of
|
defined and examples of how they can be used to measure properties of
|
||||||
a system.</p>
|
a system.
|
||||||
<p>This compute calculates the radius of gyration Rg for each chunk,
|
</P>
|
||||||
|
<P>This compute calculates the radius of gyration Rg for each chunk,
|
||||||
which includes all effects due to atoms passing thru periodic
|
which includes all effects due to atoms passing thru periodic
|
||||||
boundaries.</p>
|
boundaries.
|
||||||
<p>Rg is a measure of the size of a chunk, and is computed by this
|
</P>
|
||||||
formula</p>
|
<P>Rg is a measure of the size of a chunk, and is computed by this
|
||||||
<img alt="_images/compute_gyration.jpg" class="align-center" src="_images/compute_gyration.jpg" />
|
formula
|
||||||
<p>where M is the total mass of the chunk, Rcm is the center-of-mass
|
</P>
|
||||||
|
<CENTER><IMG SRC = "Eqs/compute_gyration.jpg">
|
||||||
|
</CENTER>
|
||||||
|
<P>where M is the total mass of the chunk, Rcm is the center-of-mass
|
||||||
position of the chunk, and the sum is over all atoms in the
|
position of the chunk, and the sum is over all atoms in the
|
||||||
chunk.</p>
|
chunk.
|
||||||
<p>Note that only atoms in the specified group contribute to the
|
</P>
|
||||||
calculation. The <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command
|
<P>Note that only atoms in the specified group contribute to the
|
||||||
|
calculation. The <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
defines its own group; atoms will have a chunk ID = 0 if they are not
|
defines its own group; atoms will have a chunk ID = 0 if they are not
|
||||||
in that group, signifying they are not assigned to a chunk, and will
|
in that group, signifying they are not assigned to a chunk, and will
|
||||||
thus also not contribute to this calculation. You can specify the
|
thus also not contribute to this calculation. You can specify the
|
||||||
“all” group for this command if you simply want to include atoms with
|
"all" group for this command if you simply want to include atoms with
|
||||||
non-zero chunk IDs.</p>
|
non-zero chunk IDs.
|
||||||
<p>If the <em>tensor</em> keyword is specified, then the scalar Rg value is not
|
</P>
|
||||||
|
<P>If the <I>tensor</I> keyword is specified, then the scalar Rg value is not
|
||||||
calculated, but an Rg tensor is instead calculated for each chunk.
|
calculated, but an Rg tensor is instead calculated for each chunk.
|
||||||
The formula for the components of the tensor is the same as the above
|
The formula for the components of the tensor is the same as the above
|
||||||
formula, except that (Ri - Rcm)^2 is replaced by (Rix - Rcmx) * (Riy -
|
formula, except that (Ri - Rcm)^2 is replaced by (Rix - Rcmx) * (Riy -
|
||||||
Rcmy) for the xy component, etc. The 6 components of the tensor are
|
Rcmy) for the xy component, etc. The 6 components of the tensor are
|
||||||
ordered xx, yy, zz, xy, xz, yz.</p>
|
ordered xx, yy, zz, xy, xz, yz.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The coordinates of an atom contribute to Rg in
|
||||||
<p class="last">The coordinates of an atom contribute to Rg in
|
"unwrapped" form, by using the image flags associated with each atom.
|
||||||
“unwrapped” form, by using the image flags associated with each atom.
|
See the <A HREF = "dump.html">dump custom</A> command for a discussion of
|
||||||
See the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command for a discussion of
|
"unwrapped" coordinates. See the Atoms section of the
|
||||||
“unwrapped” coordinates. See the Atoms section of the
|
<A HREF = "read_data.html">read_data</A> command for a discussion of image flags and
|
||||||
<a class="reference internal" href="read_data.html"><em>read_data</em></a> command for a discussion of image flags and
|
|
||||||
how they are set for each atom. You can reset the image flags
|
how they are set for each atom. You can reset the image flags
|
||||||
(e.g. to 0) before invoking this compute by using the <a class="reference internal" href="set.html"><em>set image</em></a> command.</p>
|
(e.g. to 0) before invoking this compute by using the <A HREF = "set.html">set
|
||||||
</div>
|
image</A> command.
|
||||||
<p>The simplest way to output the results of the compute gyration/chunk
|
</P>
|
||||||
calculation to a file is to use the <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>
|
<P>The simplest way to output the results of the compute gyration/chunk
|
||||||
command, for example:</p>
|
calculation to a file is to use the <A HREF = "fix_ave_time.html">fix ave/time</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute cc1 all chunk/atom molecule
|
command, for example:
|
||||||
|
</P>
|
||||||
|
<PRE>compute cc1 all chunk/atom molecule
|
||||||
compute myChunk all gyration/chunk cc1
|
compute myChunk all gyration/chunk cc1
|
||||||
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Output info:</B>
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global vector if the <em>tensor</em> keyword is not
|
<P>This compute calculates a global vector if the <I>tensor</I> keyword is not
|
||||||
specified and a global array if it is. The length of the vector or
|
specified and a global array if it is. The length of the vector or
|
||||||
number of rows in the array = the number of chunks <em>Nchunk</em> as
|
number of rows in the array = the number of chunks <I>Nchunk</I> as
|
||||||
calculated by the specified <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command. If the <em>tensor</em> keyword
|
calculated by the specified <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> command. If the <I>tensor</I> keyword
|
||||||
is specified, the global array has 6 columns. The vector or array can
|
is specified, the global array has 6 columns. The vector or array can
|
||||||
be accessed by any command that uses global values from a compute as
|
be accessed by any command that uses global values from a compute as
|
||||||
input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview
|
input. See <A HREF = "Section_howto.html#howto_15">this section</A> for an overview
|
||||||
of LAMMPS output options.</p>
|
of LAMMPS output options.
|
||||||
<p>All the vector or array values calculated by this compute are
|
</P>
|
||||||
“intensive”. The vector or array values will be in distance
|
<P>All the vector or array values calculated by this compute are
|
||||||
<a class="reference internal" href="units.html"><em>units</em></a>, since they are the square root of values
|
"intensive". The vector or array values will be in distance
|
||||||
represented by the formula above.</p>
|
<A HREF = "units.html">units</A>, since they are the square root of values
|
||||||
</div>
|
represented by the formula above.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B> none
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<P><B>Related commands:</B> none
|
||||||
<p><strong>Related commands:</strong> none</p>
|
</P>
|
||||||
<p><a class="reference internal" href="compute_gyration.html"><em>compute gyration</em></a></p>
|
<P><A HREF = "compute_gyration.html">compute gyration</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,288 +1,175 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute heat/flux command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute heat/flux command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute heat/flux command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID heat/flux ke-ID pe-ID stress-ID
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>heat/flux = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>ke-ID = ID of a compute that calculates per-atom kinetic energy
|
||||||
|
<LI>pe-ID = ID of a compute that calculates per-atom potential energy
|
||||||
</li>
|
<LI>stress-ID = ID of a compute that calculates per-atom stress
|
||||||
</ul>
|
</UL>
|
||||||
<hr/>
|
<P><B>Examples:</B>
|
||||||
|
</P>
|
||||||
</div>
|
<PRE>compute myFlux all heat/flux myKE myPE myStress
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</PRE>
|
||||||
<div itemprop="articleBody">
|
<P><B>Description:</B>
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-heat-flux-command">
|
<P>Define a computation that calculates the heat flux vector based on
|
||||||
<span id="index-0"></span><h1>compute heat/flux command<a class="headerlink" href="#compute-heat-flux-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>compute ID group-ID heat/flux ke-ID pe-ID stress-ID
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>heat/flux = style name of this compute command</li>
|
|
||||||
<li>ke-ID = ID of a compute that calculates per-atom kinetic energy</li>
|
|
||||||
<li>pe-ID = ID of a compute that calculates per-atom potential energy</li>
|
|
||||||
<li>stress-ID = ID of a compute that calculates per-atom stress</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute myFlux all heat/flux myKE myPE myStress
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the heat flux vector based on
|
|
||||||
contributions from atoms in the specified group. This can be used by
|
contributions from atoms in the specified group. This can be used by
|
||||||
itself to measure the heat flux into or out of a reservoir of atoms,
|
itself to measure the heat flux into or out of a reservoir of atoms,
|
||||||
or to calculate a thermal conductivity using the Green-Kubo formalism.</p>
|
or to calculate a thermal conductivity using the Green-Kubo formalism.
|
||||||
<p>See the <a class="reference internal" href="fix_thermal_conductivity.html"><em>fix thermal/conductivity</em></a>
|
</P>
|
||||||
|
<P>See the <A HREF = "fix_thermal_conductivity.html">fix thermal/conductivity</A>
|
||||||
command for details on how to compute thermal conductivity in an
|
command for details on how to compute thermal conductivity in an
|
||||||
alternate way, via the Muller-Plathe method. See the <a class="reference internal" href="fix_heat.html"><em>fix heat</em></a> command for a way to control the heat added or
|
alternate way, via the Muller-Plathe method. See the <A HREF = "fix_heat.html">fix
|
||||||
subtracted to a group of atoms.</p>
|
heat</A> command for a way to control the heat added or
|
||||||
<p>The compute takes three arguments which are IDs of other
|
subtracted to a group of atoms.
|
||||||
<a class="reference internal" href="compute.html"><em>computes</em></a>. One calculates per-atom kinetic energy
|
</P>
|
||||||
(<em>ke-ID</em>), one calculates per-atom potential energy (<em>pe-ID)</em>, and the
|
<P>The compute takes three arguments which are IDs of other
|
||||||
third calcualtes per-atom stress (<em>stress-ID</em>). These should be
|
<A HREF = "compute.html">computes</A>. One calculates per-atom kinetic energy
|
||||||
|
(<I>ke-ID</I>), one calculates per-atom potential energy (<I>pe-ID)</I>, and the
|
||||||
|
third calcualtes per-atom stress (<I>stress-ID</I>). These should be
|
||||||
defined for the same group used by compute heat/flux, though LAMMPS
|
defined for the same group used by compute heat/flux, though LAMMPS
|
||||||
does not check for this.</p>
|
does not check for this.
|
||||||
<p>The Green-Kubo formulas relate the ensemble average of the
|
</P>
|
||||||
auto-correlation of the heat flux J to the thermal conductivity kappa:</p>
|
<P>The Green-Kubo formulas relate the ensemble average of the
|
||||||
<img alt="_images/heat_flux_J.jpg" class="align-center" src="_images/heat_flux_J.jpg" />
|
auto-correlation of the heat flux J to the thermal conductivity kappa:
|
||||||
<img alt="_images/heat_flux_k.jpg" class="align-center" src="_images/heat_flux_k.jpg" />
|
</P>
|
||||||
<p>Ei in the first term of the equation for J is the per-atom energy
|
<CENTER><IMG SRC = "Eqs/heat_flux_J.jpg">
|
||||||
(potential and kinetic). This is calculated by the computes <em>ke-ID</em>
|
</CENTER>
|
||||||
and <em>pe-ID</em>. Si in the second term of the equation for J is the
|
<CENTER><IMG SRC = "Eqs/heat_flux_k.jpg">
|
||||||
per-atom stress tensor calculated by the compute <em>stress-ID</em>. The
|
</CENTER>
|
||||||
|
<P>Ei in the first term of the equation for J is the per-atom energy
|
||||||
|
(potential and kinetic). This is calculated by the computes <I>ke-ID</I>
|
||||||
|
and <I>pe-ID</I>. Si in the second term of the equation for J is the
|
||||||
|
per-atom stress tensor calculated by the compute <I>stress-ID</I>. The
|
||||||
tensor multiplies Vi as a 3x3 matrix-vector multiply to yield a
|
tensor multiplies Vi as a 3x3 matrix-vector multiply to yield a
|
||||||
vector. Note that as discussed below, the 1/V scaling factor in the
|
vector. Note that as discussed below, the 1/V scaling factor in the
|
||||||
equation for J is NOT included in the calculation performed by this
|
equation for J is NOT included in the calculation performed by this
|
||||||
compute; you need to add it for a volume appropriate to the atoms
|
compute; you need to add it for a volume appropriate to the atoms
|
||||||
included in the calculation.</p>
|
included in the calculation.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The <A HREF = "compute_pe_atom.html">compute pe/atom</A> and
|
||||||
<p class="last">The <a class="reference internal" href="compute_pe_atom.html"><em>compute pe/atom</em></a> and
|
<A HREF = "compute_stress_atom.html">compute stress/atom</A> commands have options
|
||||||
<a class="reference internal" href="compute_stress_atom.html"><em>compute stress/atom</em></a> commands have options
|
|
||||||
for which terms to include in their calculation (pair, bond, etc).
|
for which terms to include in their calculation (pair, bond, etc).
|
||||||
The heat flux calculation will thus include exactly the same terms.
|
The heat flux calculation will thus include exactly the same terms.
|
||||||
Normally you should use <a class="reference internal" href="compute_stress_atom.html"><em>compute stress/atom virial</em></a> so as not to include a kinetic energy
|
Normally you should use <A HREF = "compute_stress_atom.html">compute stress/atom
|
||||||
term in the heat flux.</p>
|
virial</A> so as not to include a kinetic energy
|
||||||
</div>
|
term in the heat flux.
|
||||||
<p>This compute calculates 6 quantities and stores them in a 6-component
|
</P>
|
||||||
|
<P>This compute calculates 6 quantities and stores them in a 6-component
|
||||||
vector. The first 3 components are the x, y, z components of the full
|
vector. The first 3 components are the x, y, z components of the full
|
||||||
heat flux vector, i.e. (Jx, Jy, Jz). The next 3 components are the x,
|
heat flux vector, i.e. (Jx, Jy, Jz). The next 3 components are the x,
|
||||||
y, z components of just the convective portion of the flux, i.e. the
|
y, z components of just the convective portion of the flux, i.e. the
|
||||||
first term in the equation for J above.</p>
|
first term in the equation for J above.
|
||||||
<hr class="docutils" />
|
</P>
|
||||||
<p>The heat flux can be output every so many timesteps (e.g. via the
|
<HR>
|
||||||
<a class="reference internal" href="thermo_style.html"><em>thermo_style custom</em></a> command). Then as a
|
|
||||||
|
<P>The heat flux can be output every so many timesteps (e.g. via the
|
||||||
|
<A HREF = "thermo_style.html">thermo_style custom</A> command). Then as a
|
||||||
post-processing operation, an autocorrelation can be performed, its
|
post-processing operation, an autocorrelation can be performed, its
|
||||||
integral estimated, and the Green-Kubo formula above evaluated.</p>
|
integral estimated, and the Green-Kubo formula above evaluated.
|
||||||
<p>The <a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a> command can calclate
|
</P>
|
||||||
|
<P>The <A HREF = "fix_ave_correlate.html">fix ave/correlate</A> command can calclate
|
||||||
the autocorrelation. The trap() function in the
|
the autocorrelation. The trap() function in the
|
||||||
<a class="reference internal" href="variable.html"><em>variable</em></a> command can calculate the integral.</p>
|
<A HREF = "variable.html">variable</A> command can calculate the integral.
|
||||||
<p>An example LAMMPS input script for solid Ar is appended below. The
|
</P>
|
||||||
result should be: average conductivity ~0.29 in W/mK.</p>
|
<P>An example LAMMPS input script for solid Ar is appended below. The
|
||||||
<hr class="docutils" />
|
result should be: average conductivity ~0.29 in W/mK.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global vector of length 6 (total heat flux
|
<HR>
|
||||||
|
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global vector of length 6 (total heat flux
|
||||||
vector, followed by convective heat flux vector), which can be
|
vector, followed by convective heat flux vector), which can be
|
||||||
accessed by indices 1-6. These values can be used by any command that
|
accessed by indices 1-6. These values can be used by any command that
|
||||||
uses global vector values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
uses global vector values from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>The vector values calculated by this compute are “extensive”, meaning
|
options.
|
||||||
|
</P>
|
||||||
|
<P>The vector values calculated by this compute are "extensive", meaning
|
||||||
they scale with the number of atoms in the simulation. They can be
|
they scale with the number of atoms in the simulation. They can be
|
||||||
divided by the appropriate volume to get a flux, which would then be
|
divided by the appropriate volume to get a flux, which would then be
|
||||||
an “intensive” value, meaning independent of the number of atoms in
|
an "intensive" value, meaning independent of the number of atoms in
|
||||||
the simulation. Note that if the compute is “all”, then the
|
the simulation. Note that if the compute is "all", then the
|
||||||
appropriate volume to divide by is the simulation box volume.
|
appropriate volume to divide by is the simulation box volume.
|
||||||
However, if a sub-group is used, it should be the volume containing
|
However, if a sub-group is used, it should be the volume containing
|
||||||
those atoms.</p>
|
those atoms.
|
||||||
<p>The vector values will be in energy*velocity <a class="reference internal" href="units.html"><em>units</em></a>. Once
|
</P>
|
||||||
|
<P>The vector values will be in energy*velocity <A HREF = "units.html">units</A>. Once
|
||||||
divided by a volume the units will be that of flux, namely
|
divided by a volume the units will be that of flux, namely
|
||||||
energy/area/time <a class="reference internal" href="units.html"><em>units</em></a></p>
|
energy/area/time <A HREF = "units.html">units</A>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P><B>Restrictions:</B> none
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Related commands:</B>
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><A HREF = "fix_thermal_conductivity.html">fix thermal/conductivity</A>,
|
||||||
<div class="section" id="related-commands">
|
<A HREF = "fix_ave_correlate.html">fix ave/correlate</A>,
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<A HREF = "variable.html">variable</A>
|
||||||
<p><a class="reference internal" href="fix_thermal_conductivity.html"><em>fix thermal/conductivity</em></a>,
|
</P>
|
||||||
<a class="reference internal" href="fix_ave_correlate.html"><em>fix ave/correlate</em></a>,
|
<P><B>Default:</B> none
|
||||||
<a class="reference internal" href="variable.html"><em>variable</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<HR>
|
||||||
<hr class="docutils" />
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c"># Sample LAMMPS input script for thermal conductivity of solid Ar</span>
|
<PRE># Sample LAMMPS input script for thermal conductivity of solid Ar
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE>units real
|
||||||
<div class="highlight-python"><div class="highlight"><pre>units real
|
|
||||||
variable T equal 70
|
variable T equal 70
|
||||||
variable V equal vol
|
variable V equal vol
|
||||||
variable dt equal 4.0
|
variable dt equal 4.0
|
||||||
variable p equal 200 # correlation length
|
variable p equal 200 # correlation length
|
||||||
variable s equal 10 # sample interval
|
variable s equal 10 # sample interval
|
||||||
variable d equal $p*$s # dump interval
|
variable d equal $p*$s # dump interval
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE># convert from LAMMPS real units to SI
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c"># convert from LAMMPS real units to SI</span>
|
</PRE>
|
||||||
</pre></div>
|
<PRE>variable kB equal 1.3806504e-23 # [J/K] Boltzmann
|
||||||
</div>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>variable kB equal 1.3806504e-23 # [J/K] Boltzmann
|
|
||||||
variable kCal2J equal 4186.0/6.02214e23
|
variable kCal2J equal 4186.0/6.02214e23
|
||||||
variable A2m equal 1.0e-10
|
variable A2m equal 1.0e-10
|
||||||
variable fs2s equal 1.0e-15
|
variable fs2s equal 1.0e-15
|
||||||
variable convert equal ${kCal2J}*${kCal2J}/${fs2s}/${A2m}
|
variable convert equal ${kCal2J}*${kCal2J}/${fs2s}/${A2m}
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE># setup problem
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c"># setup problem</span>
|
</PRE>
|
||||||
</pre></div>
|
<PRE>dimension 3
|
||||||
</div>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>dimension 3
|
|
||||||
boundary p p p
|
boundary p p p
|
||||||
lattice fcc 5.376 orient x 1 0 0 orient y 0 1 0 orient z 0 0 1
|
lattice fcc 5.376 orient x 1 0 0 orient y 0 1 0 orient z 0 0 1
|
||||||
region box block 0 4 0 4 0 4
|
region box block 0 4 0 4 0 4
|
||||||
create_box 1 box
|
create_box 1 box
|
||||||
create_atoms 1 box
|
create_atoms 1 box
|
||||||
mass 1 39.948
|
mass 1 39.948
|
||||||
pair_style lj/cut 13.0
|
pair_style lj/cut 13.0
|
||||||
pair_coeff * * 0.2381 3.405
|
pair_coeff * * 0.2381 3.405
|
||||||
timestep ${dt}
|
timestep ${dt}
|
||||||
thermo $d
|
thermo $d
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE># equilibration and thermalization
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c"># equilibration and thermalization</span>
|
</PRE>
|
||||||
</pre></div>
|
<PRE>velocity all create $T 102486 mom yes rot yes dist gaussian
|
||||||
</div>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>velocity all create $T 102486 mom yes rot yes dist gaussian
|
|
||||||
fix NVT all nvt temp $T $T 10 drag 0.2
|
fix NVT all nvt temp $T $T 10 drag 0.2
|
||||||
run 8000
|
run 8000
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<PRE># thermal conductivity calculation, switch to NVE if desired
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c"># thermal conductivity calculation, switch to NVE if desired</span>
|
</PRE>
|
||||||
</pre></div>
|
<PRE>#unfix NVT
|
||||||
</div>
|
#fix NVE all nve
|
||||||
<div class="highlight-python"><div class="highlight"><pre><span class="c">#unfix NVT</span>
|
</PRE>
|
||||||
<span class="c">#fix NVE all nve</span>
|
<PRE>reset_timestep 0
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>reset_timestep 0
|
|
||||||
compute myKE all ke/atom
|
compute myKE all ke/atom
|
||||||
compute myPE all pe/atom
|
compute myPE all pe/atom
|
||||||
compute myStress all stress/atom NULL virial
|
compute myStress all stress/atom NULL virial
|
||||||
@ -290,7 +177,7 @@ compute flux all heat/flux myKE myPE myStress
|
|||||||
variable Jx equal c_flux[1]/vol
|
variable Jx equal c_flux[1]/vol
|
||||||
variable Jy equal c_flux[2]/vol
|
variable Jy equal c_flux[2]/vol
|
||||||
variable Jz equal c_flux[3]/vol
|
variable Jz equal c_flux[3]/vol
|
||||||
fix JJ all ave/correlate $s $p $d &
|
fix JJ all ave/correlate $s $p $d &
|
||||||
c_flux[1] c_flux[2] c_flux[3] type auto file J0Jt.dat ave running
|
c_flux[1] c_flux[2] c_flux[3] type auto file J0Jt.dat ave running
|
||||||
variable scale equal ${convert}/${kB}/$T/$T/$V*$s*${dt}
|
variable scale equal ${convert}/${kB}/$T/$T/$V*$s*${dt}
|
||||||
variable k11 equal trap(f_JJ[3])*${scale}
|
variable k11 equal trap(f_JJ[3])*${scale}
|
||||||
@ -300,72 +187,6 @@ thermo_style custom step temp v_Jx v_Jy v_Jz v_k11 v_k22 v_k33
|
|||||||
run 100000
|
run 100000
|
||||||
variable k equal (v_k11+v_k22+v_k33)/3.0
|
variable k equal (v_k11+v_k22+v_k33)/3.0
|
||||||
variable ndens equal count(all)/vol
|
variable ndens equal count(all)/vol
|
||||||
print "average conductivity: $k[W/mK] @ $T K, ${ndens} /A^3"
|
print "average conductivity: $k[W/mK] @ $T K, ${ndens} /A^3"
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,253 +1,79 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute improper/local command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute improper/local command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute improper/local command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID improper/local input1 input2 ...
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>improper/local = style name of this compute command
|
||||||
|
|
||||||
</li>
|
<LI>one or more keywords may be appended
|
||||||
</ul>
|
|
||||||
<hr/>
|
<LI>keyword = <I>chi</I>
|
||||||
|
|
||||||
</div>
|
<PRE> <I>chi</I> = tabulate improper angles
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</PRE>
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
</UL>
|
||||||
<div class="section" id="compute-improper-local-command">
|
<P><B>Examples:</B>
|
||||||
<span id="index-0"></span><h1>compute improper/local command<a class="headerlink" href="#compute-improper-local-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<PRE>compute 1 all improper/local chi
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
</PRE>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID improper/local input1 input2 ...
|
<P><B>Description:</B>
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<P>Define a computation that calculates properties of individual improper
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>improper/local = style name of this compute command</li>
|
|
||||||
<li>one or more keywords may be appended</li>
|
|
||||||
<li>keyword = <em>chi</em></li>
|
|
||||||
</ul>
|
|
||||||
<pre class="literal-block">
|
|
||||||
<em>chi</em> = tabulate improper angles
|
|
||||||
</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>compute 1 all improper/local chi
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates properties of individual improper
|
|
||||||
interactions. The number of datums generated, aggregated across all
|
interactions. The number of datums generated, aggregated across all
|
||||||
processors, equals the number of impropers in the system, modified by
|
processors, equals the number of impropers in the system, modified by
|
||||||
the group parameter as explained below.</p>
|
the group parameter as explained below.
|
||||||
<p>The local data stored by this command is generated by looping over all
|
</P>
|
||||||
|
<P>The local data stored by this command is generated by looping over all
|
||||||
the atoms owned on a processor and their impropers. An improper will
|
the atoms owned on a processor and their impropers. An improper will
|
||||||
only be included if all 4 atoms in the improper are in the specified
|
only be included if all 4 atoms in the improper are in the specified
|
||||||
compute group.</p>
|
compute group.
|
||||||
<p>Note that as atoms migrate from processor to processor, there will be
|
</P>
|
||||||
|
<P>Note that as atoms migrate from processor to processor, there will be
|
||||||
no consistent ordering of the entries within the local vector or array
|
no consistent ordering of the entries within the local vector or array
|
||||||
from one timestep to the next. The only consistency that is
|
from one timestep to the next. The only consistency that is
|
||||||
guaranteed is that the ordering on a particular timestep will be the
|
guaranteed is that the ordering on a particular timestep will be the
|
||||||
same for local vectors or arrays generated by other compute commands.
|
same for local vectors or arrays generated by other compute commands.
|
||||||
For example, improper output from the <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a> command can be combined
|
For example, improper output from the <A HREF = "compute_property_local.html">compute
|
||||||
with data from this command and output by the <a class="reference internal" href="dump.html"><em>dump local</em></a>
|
property/local</A> command can be combined
|
||||||
command in a consistent way.</p>
|
with data from this command and output by the <A HREF = "dump.html">dump local</A>
|
||||||
<p><strong>Output info:</strong></p>
|
command in a consistent way.
|
||||||
<p>This compute calculates a local vector or local array depending on the
|
</P>
|
||||||
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a local vector or local array depending on the
|
||||||
number of keywords. The length of the vector or number of rows in the
|
number of keywords. The length of the vector or number of rows in the
|
||||||
array is the number of impropers. If a single keyword is specified, a
|
array is the number of impropers. If a single keyword is specified, a
|
||||||
local vector is produced. If two or more keywords are specified, a
|
local vector is produced. If two or more keywords are specified, a
|
||||||
local array is produced where the number of columns = the number of
|
local array is produced where the number of columns = the number of
|
||||||
keywords. The vector or array can be accessed by any command that
|
keywords. The vector or array can be accessed by any command that
|
||||||
uses local values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>this section</span></a> for an overview of LAMMPS output
|
uses local values from a compute as input. See <A HREF = "Section_howto.html#howto_15">this
|
||||||
options.</p>
|
section</A> for an overview of LAMMPS output
|
||||||
<p>The output for <em>chi</em> will be in degrees.</p>
|
options.
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="restrictions">
|
<P>The output for <I>chi</I> will be in degrees.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "dump.html">dump local</A>, <A HREF = "compute_property_local.html">compute
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump local</em></a>, <a class="reference internal" href="compute_property_local.html"><em>compute property/local</em></a></p>
|
property/local</A>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
|
</HTML>
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,269 +1,93 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute inertia/chunk command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute inertia/chunk command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute inertia/chunk command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID inertia/chunk chunkID
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>inertia/chunk = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>chunkID = ID of <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 fluid inertia/chunk molchunk
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that calculates the inertia tensor for multiple
|
||||||
|
chunks of atoms.
|
||||||
<div class="section" id="compute-inertia-chunk-command">
|
</P>
|
||||||
<span id="index-0"></span><h1>compute inertia/chunk command<a class="headerlink" href="#compute-inertia-chunk-command" title="Permalink to this headline">¶</a></h1>
|
<P>In LAMMPS, chunks are collections of atoms defined by a <A HREF = "compute_chunk_atom.html">compute
|
||||||
<div class="section" id="syntax">
|
chunk/atom</A> command, which assigns each atom
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID inertia/chunk chunkID
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>inertia/chunk = style name of this compute command</li>
|
|
||||||
<li>chunkID = ID of <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 fluid inertia/chunk molchunk
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the inertia tensor for multiple
|
|
||||||
chunks of atoms.</p>
|
|
||||||
<p>In LAMMPS, chunks are collections of atoms defined by a <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command, which assigns each atom
|
|
||||||
to a single chunk (or no chunk). The ID for this command is specified
|
to a single chunk (or no chunk). The ID for this command is specified
|
||||||
as chunkID. For example, a single chunk could be the atoms in a
|
as chunkID. For example, a single chunk could be the atoms in a
|
||||||
molecule or atoms in a spatial bin. See the <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> doc page and “<a class="reference internal" href="Section_howto.html#howto-23"><span>Section_howto 23</span></a> for details of how chunks can be
|
molecule or atoms in a spatial bin. See the <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> doc page and "<A HREF = "Section_howto.html#howto_23">Section_howto
|
||||||
|
23</A> for details of how chunks can be
|
||||||
defined and examples of how they can be used to measure properties of
|
defined and examples of how they can be used to measure properties of
|
||||||
a system.</p>
|
a system.
|
||||||
<p>This compute calculates the 6 components of the symmetric intertia
|
</P>
|
||||||
|
<P>This compute calculates the 6 components of the symmetric intertia
|
||||||
tensor for each chunk, ordered Ixx,Iyy,Izz,Ixy,Iyz,Ixz. The
|
tensor for each chunk, ordered Ixx,Iyy,Izz,Ixy,Iyz,Ixz. The
|
||||||
calculation includes all effects due to atoms passing thru periodic
|
calculation includes all effects due to atoms passing thru periodic
|
||||||
boundaries.</p>
|
boundaries.
|
||||||
<p>Note that only atoms in the specified group contribute to the
|
</P>
|
||||||
calculation. The <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command
|
<P>Note that only atoms in the specified group contribute to the
|
||||||
|
calculation. The <A HREF = "compute_chunk_atom.html">compute chunk/atom</A> command
|
||||||
defines its own group; atoms will have a chunk ID = 0 if they are not
|
defines its own group; atoms will have a chunk ID = 0 if they are not
|
||||||
in that group, signifying they are not assigned to a chunk, and will
|
in that group, signifying they are not assigned to a chunk, and will
|
||||||
thus also not contribute to this calculation. You can specify the
|
thus also not contribute to this calculation. You can specify the
|
||||||
“all” group for this command if you simply want to include atoms with
|
"all" group for this command if you simply want to include atoms with
|
||||||
non-zero chunk IDs.</p>
|
non-zero chunk IDs.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The coordinates of an atom contribute to the chunk's
|
||||||
<p class="last">The coordinates of an atom contribute to the chunk’s
|
inertia tensor in "unwrapped" form, by using the image flags
|
||||||
inertia tensor in “unwrapped” form, by using the image flags
|
associated with each atom. See the <A HREF = "dump.html">dump custom</A> command
|
||||||
associated with each atom. See the <a class="reference internal" href="dump.html"><em>dump custom</em></a> command
|
for a discussion of "unwrapped" coordinates. See the Atoms section of
|
||||||
for a discussion of “unwrapped” coordinates. See the Atoms section of
|
the <A HREF = "read_data.html">read_data</A> command for a discussion of image flags
|
||||||
the <a class="reference internal" href="read_data.html"><em>read_data</em></a> command for a discussion of image flags
|
|
||||||
and how they are set for each atom. You can reset the image flags
|
and how they are set for each atom. You can reset the image flags
|
||||||
(e.g. to 0) before invoking this compute by using the <a class="reference internal" href="set.html"><em>set image</em></a> command.</p>
|
(e.g. to 0) before invoking this compute by using the <A HREF = "set.html">set
|
||||||
</div>
|
image</A> command.
|
||||||
<p>The simplest way to output the results of the compute inertia/chunk
|
</P>
|
||||||
calculation to a file is to use the <a class="reference internal" href="fix_ave_time.html"><em>fix ave/time</em></a>
|
<P>The simplest way to output the results of the compute inertia/chunk
|
||||||
command, for example:</p>
|
calculation to a file is to use the <A HREF = "fix_ave_time.html">fix ave/time</A>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute cc1 all chunk/atom molecule
|
command, for example:
|
||||||
|
</P>
|
||||||
|
<PRE>compute cc1 all chunk/atom molecule
|
||||||
compute myChunk all inertia/chunk cc1
|
compute myChunk all inertia/chunk cc1
|
||||||
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
fix 1 all ave/time 100 1 100 c_myChunk file tmp.out mode vector
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P><B>Output info:</B>
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global array where the number of rows = the
|
<P>This compute calculates a global array where the number of rows = the
|
||||||
number of chunks <em>Nchunk</em> as calculated by the specified <a class="reference internal" href="compute_chunk_atom.html"><em>compute chunk/atom</em></a> command. The number of columns =
|
number of chunks <I>Nchunk</I> as calculated by the specified <A HREF = "compute_chunk_atom.html">compute
|
||||||
|
chunk/atom</A> command. The number of columns =
|
||||||
6 for the 6 components of the inertia tensor for each chunk, ordered
|
6 for the 6 components of the inertia tensor for each chunk, ordered
|
||||||
as listed above. These values can be accessed by any command that
|
as listed above. These values can be accessed by any command that
|
||||||
uses global array values from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
uses global array values from a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The array values are “intensive”. The array values will be in
|
options.
|
||||||
mass*distance^2 <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The array values are "intensive". The array values will be in
|
||||||
<div class="section" id="restrictions">
|
mass*distance^2 <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<blockquote>
|
<P><B>Restrictions:</B> none
|
||||||
<div>none</div></blockquote>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B>
|
||||||
<div class="section" id="related-commands">
|
</P>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
<P><A HREF = "variable.html">variable inertia() function</A>
|
||||||
<p><a class="reference internal" href="variable.html"><em>variable inertia() function</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,245 +1,64 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute ke command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute ke command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute ke command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID ke
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>ke = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all ke
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the translational kinetic energy
|
||||||
<div itemprop="articleBody">
|
of a group of particles.
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-ke-command">
|
<P>The kinetic energy of each particle is computed as 1/2 m v^2, where m
|
||||||
<span id="index-0"></span><h1>compute ke command<a class="headerlink" href="#compute-ke-command" title="Permalink to this headline">¶</a></h1>
|
and v are the mass and velocity of the particle.
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<P>There is a subtle difference between the quantity calculated by this
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID ke
|
compute and the kinetic energy calculated by the <I>ke</I> or <I>etotal</I>
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>ke = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all ke
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the translational kinetic energy
|
|
||||||
of a group of particles.</p>
|
|
||||||
<p>The kinetic energy of each particle is computed as 1/2 m v^2, where m
|
|
||||||
and v are the mass and velocity of the particle.</p>
|
|
||||||
<p>There is a subtle difference between the quantity calculated by this
|
|
||||||
compute and the kinetic energy calculated by the <em>ke</em> or <em>etotal</em>
|
|
||||||
keyword used in thermodynamic output, as specified by the
|
keyword used in thermodynamic output, as specified by the
|
||||||
<a class="reference internal" href="thermo_style.html"><em>thermo_style</em></a> command. For this compute, kinetic
|
<A HREF = "thermo_style.html">thermo_style</A> command. For this compute, kinetic
|
||||||
energy is “translational” kinetic energy, calculated by the simple
|
energy is "translational" kinetic energy, calculated by the simple
|
||||||
formula above. For thermodynamic output, the <em>ke</em> keyword infers
|
formula above. For thermodynamic output, the <I>ke</I> keyword infers
|
||||||
kinetic energy from the temperature of the system with 1/2 Kb T of
|
kinetic energy from the temperature of the system with 1/2 Kb T of
|
||||||
energy for each degree of freedom. For the default temperature
|
energy for each degree of freedom. For the default temperature
|
||||||
computation via the <a class="reference internal" href="compute_temp.html"><em>compute temp</em></a> command, these
|
computation via the <A HREF = "compute_temp.html">compute temp</A> command, these
|
||||||
are the same. But different computes that calculate temperature can
|
are the same. But different computes that calculate temperature can
|
||||||
subtract out different non-thermal components of velocity and/or
|
subtract out different non-thermal components of velocity and/or
|
||||||
include different degrees of freedom (translational, rotational, etc).</p>
|
include different degrees of freedom (translational, rotational, etc).
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global scalar (the summed KE). This value
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the summed KE). This value
|
||||||
can be used by any command that uses a global scalar value from a
|
can be used by any command that uses a global scalar value from a
|
||||||
compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a>
|
compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto 15</A>
|
||||||
for an overview of LAMMPS output options.</p>
|
for an overview of LAMMPS output options.
|
||||||
<p>The scalar value calculated by this compute is “extensive”. The
|
</P>
|
||||||
scalar value will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
<P>The scalar value calculated by this compute is "extensive". The
|
||||||
</div>
|
scalar value will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B> none
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><A HREF = "compute_erotate_sphere.html">compute erotate/sphere</A>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="compute_erotate_sphere.html"><em>compute erotate/sphere</em></a></p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,234 +1,53 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute ke/atom command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute ke/atom command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute ke/atom command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID ke/atom
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>ke/atom = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all ke/atom
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the per-atom translational
|
||||||
<div itemprop="articleBody">
|
kinetic energy for each atom in a group.
|
||||||
|
</P>
|
||||||
<div class="section" id="compute-ke-atom-command">
|
<P>The kinetic energy is simply 1/2 m v^2, where m is the mass and v is
|
||||||
<span id="index-0"></span><h1>compute ke/atom command<a class="headerlink" href="#compute-ke-atom-command" title="Permalink to this headline">¶</a></h1>
|
the velocity of each atom.
|
||||||
<div class="section" id="syntax">
|
</P>
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
<P>The value of the kinetic energy will be 0.0 for atoms not in the
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID ke/atom
|
specified compute group.
|
||||||
</pre></div>
|
</P>
|
||||||
</div>
|
<P><B>Output info:</B>
|
||||||
<ul class="simple">
|
</P>
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
<P>This compute calculates a per-atom vector, which can be accessed by
|
||||||
<li>ke/atom = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all ke/atom
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the per-atom translational
|
|
||||||
kinetic energy for each atom in a group.</p>
|
|
||||||
<p>The kinetic energy is simply 1/2 m v^2, where m is the mass and v is
|
|
||||||
the velocity of each atom.</p>
|
|
||||||
<p>The value of the kinetic energy will be 0.0 for atoms not in the
|
|
||||||
specified compute group.</p>
|
|
||||||
<p><strong>Output info:</strong></p>
|
|
||||||
<p>This compute calculates a per-atom vector, which can be accessed by
|
|
||||||
any command that uses per-atom values from a compute as input. See
|
any command that uses per-atom values from a compute as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The per-atom vector values will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B> none
|
||||||
<blockquote>
|
</P>
|
||||||
<div>none</div></blockquote>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
<div class="section" id="related-commands">
|
<P><A HREF = "dump.html">dump custom</A>
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump custom</em></a></p>
|
<P><B>Default:</B> none
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,261 +1,82 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute ke/atom/eff command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute ke/atom/eff command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute ke/atom/eff command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID ke/atom/eff
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>ke/atom/eff = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all ke/atom/eff
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the per-atom translational
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-ke-atom-eff-command">
|
|
||||||
<span id="index-0"></span><h1>compute ke/atom/eff command<a class="headerlink" href="#compute-ke-atom-eff-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>compute ID group-ID ke/atom/eff
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>ke/atom/eff = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all ke/atom/eff
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the per-atom translational
|
|
||||||
(nuclei and electrons) and radial kinetic energy (electron only) in a
|
(nuclei and electrons) and radial kinetic energy (electron only) in a
|
||||||
group. The particles are assumed to be nuclei and electrons modeled
|
group. The particles are assumed to be nuclei and electrons modeled
|
||||||
with the <a class="reference internal" href="pair_eff.html"><em>electronic force field</em></a>.</p>
|
with the <A HREF = "pair_eff.html">electronic force field</A>.
|
||||||
<p>The kinetic energy for each nucleus is computed as 1/2 m v^2, where m
|
</P>
|
||||||
|
<P>The kinetic energy for each nucleus is computed as 1/2 m v^2, where m
|
||||||
corresponds to the corresponding nuclear mass, and the kinetic energy
|
corresponds to the corresponding nuclear mass, and the kinetic energy
|
||||||
for each electron is computed as 1/2 (me v^2 + 3/4 me s^2), where me
|
for each electron is computed as 1/2 (me v^2 + 3/4 me s^2), where me
|
||||||
and v correspond to the mass and translational velocity of each
|
and v correspond to the mass and translational velocity of each
|
||||||
electron, and s to its radial velocity, respectively.</p>
|
electron, and s to its radial velocity, respectively.
|
||||||
<p>There is a subtle difference between the quantity calculated by this
|
</P>
|
||||||
compute and the kinetic energy calculated by the <em>ke</em> or <em>etotal</em>
|
<P>There is a subtle difference between the quantity calculated by this
|
||||||
|
compute and the kinetic energy calculated by the <I>ke</I> or <I>etotal</I>
|
||||||
keyword used in thermodynamic output, as specified by the
|
keyword used in thermodynamic output, as specified by the
|
||||||
<a class="reference internal" href="thermo_style.html"><em>thermo_style</em></a> command. For this compute, kinetic
|
<A HREF = "thermo_style.html">thermo_style</A> command. For this compute, kinetic
|
||||||
energy is “translational” plus electronic “radial” kinetic energy,
|
energy is "translational" plus electronic "radial" kinetic energy,
|
||||||
calculated by the simple formula above. For thermodynamic output, the
|
calculated by the simple formula above. For thermodynamic output, the
|
||||||
<em>ke</em> keyword infers kinetic energy from the temperature of the system
|
<I>ke</I> keyword infers kinetic energy from the temperature of the system
|
||||||
with 1/2 Kb T of energy for each (nuclear-only) degree of freedom in
|
with 1/2 Kb T of energy for each (nuclear-only) degree of freedom in
|
||||||
eFF.</p>
|
eFF.
|
||||||
<div class="admonition warning">
|
</P>
|
||||||
<p class="first admonition-title">Warning</p>
|
<P>IMPORTANT NOTE: The temperature in eFF should be monitored via the
|
||||||
<p class="last">The temperature in eFF should be monitored via the
|
<A HREF = "compute_temp_eff.html">compute temp/eff</A> command, which can be printed
|
||||||
<a class="reference internal" href="compute_temp_eff.html"><em>compute temp/eff</em></a> command, which can be printed
|
|
||||||
with thermodynamic output by using the
|
with thermodynamic output by using the
|
||||||
<a class="reference internal" href="thermo_modify.html"><em>thermo_modify</em></a> command, as shown in the following
|
<A HREF = "thermo_modify.html">thermo_modify</A> command, as shown in the following
|
||||||
example:</p>
|
example:
|
||||||
</div>
|
</P>
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute effTemp all temp/eff
|
<PRE>compute effTemp all temp/eff
|
||||||
thermo_style custom step etotal pe ke temp press
|
thermo_style custom step etotal pe ke temp press
|
||||||
thermo_modify temp effTemp
|
thermo_modify temp effTemp
|
||||||
</pre></div>
|
</PRE>
|
||||||
</div>
|
<P>The value of the kinetic energy will be 0.0 for atoms (nuclei or
|
||||||
<p>The value of the kinetic energy will be 0.0 for atoms (nuclei or
|
electrons) not in the specified compute group.
|
||||||
electrons) not in the specified compute group.</p>
|
</P>
|
||||||
<p><strong>Output info:</strong></p>
|
<P><B>Output info:</B>
|
||||||
<p>This compute calculates a scalar quantity for each atom, which can be
|
</P>
|
||||||
|
<P>This compute calculates a scalar quantity for each atom, which can be
|
||||||
accessed by any command that uses per-atom computes as input. See
|
accessed by any command that uses per-atom computes as input. See
|
||||||
<a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of
|
<A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an overview of
|
||||||
LAMMPS output options.</p>
|
LAMMPS output options.
|
||||||
<p>The per-atom vector values will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The per-atom vector values will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute is part of the USER-EFF package. It is only enabled if
|
</P>
|
||||||
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>
|
<P>This compute is part of the USER-EFF package. It is only enabled if
|
||||||
</div>
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<div class="section" id="related-commands">
|
LAMMPS</A> section for more info.
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p><a class="reference internal" href="dump.html"><em>dump custom</em></a></p>
|
<P><B>Related commands:</B>
|
||||||
<p><strong>Default:</strong> none</p>
|
</P>
|
||||||
</div>
|
<P><A HREF = "dump.html">dump custom</A>
|
||||||
</div>
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
</div>
|
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,257 +1,83 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute ke/eff command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute ke/eff command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute ke/eff command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID ke/eff
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>ke/eff = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
</UL>
|
||||||
|
<P><B>Examples:</B>
|
||||||
</li>
|
</P>
|
||||||
</ul>
|
<PRE>compute 1 all ke/eff
|
||||||
<hr/>
|
</PRE>
|
||||||
|
<P><B>Description:</B>
|
||||||
</div>
|
</P>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
<P>Define a computation that calculates the kinetic energy of motion of a
|
||||||
<div itemprop="articleBody">
|
|
||||||
|
|
||||||
<div class="section" id="compute-ke-eff-command">
|
|
||||||
<span id="index-0"></span><h1>compute ke/eff command<a class="headerlink" href="#compute-ke-eff-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>compute ID group-ID ke/eff
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>ke/eff = style name of this compute command</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all ke/eff
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the kinetic energy of motion of a
|
|
||||||
group of eFF particles (nuclei and electrons), as modeled with the
|
group of eFF particles (nuclei and electrons), as modeled with the
|
||||||
<a class="reference internal" href="pair_eff.html"><em>electronic force field</em></a>.</p>
|
<A HREF = "pair_eff.html">electronic force field</A>.
|
||||||
<p>The kinetic energy for each nucleus is computed as 1/2 m v^2 and the
|
</P>
|
||||||
|
<P>The kinetic energy for each nucleus is computed as 1/2 m v^2 and the
|
||||||
kinetic energy for each electron is computed as 1/2(me v^2 + 3/4 me
|
kinetic energy for each electron is computed as 1/2(me v^2 + 3/4 me
|
||||||
s^2), where m corresponds to the nuclear mass, me to the electron
|
s^2), where m corresponds to the nuclear mass, me to the electron
|
||||||
mass, v to the translational velocity of each particle, and s to the
|
mass, v to the translational velocity of each particle, and s to the
|
||||||
radial velocity of the electron, respectively.</p>
|
radial velocity of the electron, respectively.
|
||||||
<p>There is a subtle difference between the quantity calculated by this
|
</P>
|
||||||
compute and the kinetic energy calculated by the <em>ke</em> or <em>etotal</em>
|
<P>There is a subtle difference between the quantity calculated by this
|
||||||
|
compute and the kinetic energy calculated by the <I>ke</I> or <I>etotal</I>
|
||||||
keyword used in thermodynamic output, as specified by the
|
keyword used in thermodynamic output, as specified by the
|
||||||
<a class="reference internal" href="thermo_style.html"><em>thermo_style</em></a> command. For this compute, kinetic
|
<A HREF = "thermo_style.html">thermo_style</A> command. For this compute, kinetic
|
||||||
energy is “translational” and “radial” (only for electrons) kinetic
|
energy is "translational" and "radial" (only for electrons) kinetic
|
||||||
energy, calculated by the simple formula above. For thermodynamic
|
energy, calculated by the simple formula above. For thermodynamic
|
||||||
output, the <em>ke</em> keyword infers kinetic energy from the temperature of
|
output, the <I>ke</I> keyword infers kinetic energy from the temperature of
|
||||||
the system with 1/2 Kb T of energy for each degree of freedom. For
|
the system with 1/2 Kb T of energy for each degree of freedom. For
|
||||||
the eFF temperature computation via the <a class="reference internal" href="compute_temp_eff.html"><em>compute temp_eff</em></a> command, these are the same. But
|
the eFF temperature computation via the <A HREF = "compute_temp_eff.html">compute
|
||||||
|
temp_eff</A> command, these are the same. But
|
||||||
different computes that calculate temperature can subtract out
|
different computes that calculate temperature can subtract out
|
||||||
different non-thermal components of velocity and/or include other
|
different non-thermal components of velocity and/or include other
|
||||||
degrees of freedom.</p>
|
degrees of freedom.
|
||||||
<p>IMPRORTANT NOTE: The temperature in eFF models should be monitored via
|
</P>
|
||||||
the <a class="reference internal" href="compute_temp_eff.html"><em>compute temp/eff</em></a> command, which can be
|
<P>IMPRORTANT NOTE: The temperature in eFF models should be monitored via
|
||||||
|
the <A HREF = "compute_temp_eff.html">compute temp/eff</A> command, which can be
|
||||||
printed with thermodynamic output by using the
|
printed with thermodynamic output by using the
|
||||||
<a class="reference internal" href="thermo_modify.html"><em>thermo_modify</em></a> command, as shown in the following
|
<A HREF = "thermo_modify.html">thermo_modify</A> command, as shown in the following
|
||||||
example:</p>
|
example:
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute effTemp all temp/eff
|
</P>
|
||||||
thermo_style custom step etotal pe ke temp press
|
<PRE>compute effTemp all temp/eff
|
||||||
thermo_modify temp effTemp
|
thermo_style custom step etotal pe ke temp press
|
||||||
</pre></div>
|
thermo_modify temp effTemp
|
||||||
</div>
|
</PRE>
|
||||||
<p>See <a class="reference internal" href="compute_temp_eff.html"><em>compute temp/eff</em></a>.</p>
|
<P>See <A HREF = "compute_temp_eff.html">compute temp/eff</A>.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global scalar (the KE). This value can be
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the KE). This value can be
|
||||||
used by any command that uses a global scalar value from a compute as
|
used by any command that uses a global scalar value from a compute as
|
||||||
input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an
|
input. See <A HREF = "Section_howto.html#howto_15">Section_howto 15</A> for an
|
||||||
overview of LAMMPS output options.</p>
|
overview of LAMMPS output options.
|
||||||
<p>The scalar value calculated by this compute is “extensive”. The
|
</P>
|
||||||
scalar value will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
<P>The scalar value calculated by this compute is "extensive". The
|
||||||
</div>
|
scalar value will be in energy <A HREF = "units.html">units</A>.
|
||||||
<div class="section" id="restrictions">
|
</P>
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
<P><B>Restrictions:</B>
|
||||||
<p>This compute is part of the USER-EFF package. It is only enabled if
|
</P>
|
||||||
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>
|
<P>This compute is part of the USER-EFF package. It is only enabled if
|
||||||
<p><strong>Related commands:</strong> none</p>
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<p><strong>Default:</strong> none</p>
|
LAMMPS</A> section for more info.
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P><B>Related commands:</B> none
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
@ -1,240 +1,65 @@
|
|||||||
|
<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>
|
||||||
|
|
||||||
|
|
||||||
<!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>compute ke/rigid command — 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 & 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 & 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>
|
|
||||||
|
|
||||||
</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">
|
<HR>
|
||||||
<div role="navigation" aria-label="breadcrumbs navigation">
|
|
||||||
<ul class="wy-breadcrumbs">
|
<H3>compute ke/rigid command
|
||||||
<li><a href="Manual.html">Docs</a> »</li>
|
</H3>
|
||||||
|
<P><B>Syntax:</B>
|
||||||
<li>compute ke/rigid command</li>
|
</P>
|
||||||
<li class="wy-breadcrumbs-aside">
|
<PRE>compute ID group-ID ke/rigid fix-ID
|
||||||
|
</PRE>
|
||||||
|
<UL><LI>ID, group-ID are documented in <A HREF = "compute.html">compute</A> command
|
||||||
<a href="http://lammps.sandia.gov">Website</a>
|
<LI>ke = style name of this compute command
|
||||||
<a href="Section_commands.html#comm">Commands</a>
|
<LI>fix-ID = ID of rigid body fix
|
||||||
|
</UL>
|
||||||
</li>
|
<P><B>Examples:</B>
|
||||||
</ul>
|
</P>
|
||||||
<hr/>
|
<PRE>compute 1 all ke/rigid myRigid
|
||||||
|
</PRE>
|
||||||
</div>
|
<P><B>Description:</B>
|
||||||
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
|
</P>
|
||||||
<div itemprop="articleBody">
|
<P>Define a computation that calculates the translational kinetic energy
|
||||||
|
of a collection of rigid bodies, as defined by one of the <A HREF = "fix_rigid.html">fix
|
||||||
<div class="section" id="compute-ke-rigid-command">
|
rigid</A> command variants.
|
||||||
<span id="index-0"></span><h1>compute ke/rigid command<a class="headerlink" href="#compute-ke-rigid-command" title="Permalink to this headline">¶</a></h1>
|
</P>
|
||||||
<div class="section" id="syntax">
|
<P>The kinetic energy of each rigid body is computed as 1/2 M Vcm^2,
|
||||||
<h2>Syntax<a class="headerlink" href="#syntax" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<div class="highlight-python"><div class="highlight"><pre>compute ID group-ID ke/rigid fix-ID
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
<ul class="simple">
|
|
||||||
<li>ID, group-ID are documented in <a class="reference internal" href="compute.html"><em>compute</em></a> command</li>
|
|
||||||
<li>ke = style name of this compute command</li>
|
|
||||||
<li>fix-ID = ID of rigid body fix</li>
|
|
||||||
</ul>
|
|
||||||
</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>compute 1 all ke/rigid myRigid
|
|
||||||
</pre></div>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
<div class="section" id="description">
|
|
||||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
||||||
<p>Define a computation that calculates the translational kinetic energy
|
|
||||||
of a collection of rigid bodies, as defined by one of the <a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a> command variants.</p>
|
|
||||||
<p>The kinetic energy of each rigid body is computed as 1/2 M Vcm^2,
|
|
||||||
where M is the total mass of the rigid body, and Vcm is its
|
where M is the total mass of the rigid body, and Vcm is its
|
||||||
center-of-mass velocity.</p>
|
center-of-mass velocity.
|
||||||
<p>The <em>fix-ID</em> should be the ID of one of the <a class="reference internal" href="fix_rigid.html"><em>fix rigid</em></a>
|
</P>
|
||||||
|
<P>The <I>fix-ID</I> should be the ID of one of the <A HREF = "fix_rigid.html">fix rigid</A>
|
||||||
commands which defines the rigid bodies. The group specified in the
|
commands which defines the rigid bodies. The group specified in the
|
||||||
compute command is ignored. The kinetic energy of all the rigid
|
compute command is ignored. The kinetic energy of all the rigid
|
||||||
bodies defined by the fix rigid command in included in the
|
bodies defined by the fix rigid command in included in the
|
||||||
calculation.</p>
|
calculation.
|
||||||
<p><strong>Output info:</strong></p>
|
</P>
|
||||||
<p>This compute calculates a global scalar (the summed KE of all the
|
<P><B>Output info:</B>
|
||||||
|
</P>
|
||||||
|
<P>This compute calculates a global scalar (the summed KE of all the
|
||||||
rigid bodies). This value can be used by any command that uses a
|
rigid bodies). This value can be used by any command that uses a
|
||||||
global scalar value from a compute as input. See <a class="reference internal" href="Section_howto.html#howto-15"><span>Section_howto 15</span></a> for an overview of LAMMPS output
|
global scalar value from a compute as input. See <A HREF = "Section_howto.html#howto_15">Section_howto
|
||||||
options.</p>
|
15</A> for an overview of LAMMPS output
|
||||||
<p>The scalar value calculated by this compute is “extensive”. The
|
options.
|
||||||
scalar value will be in energy <a class="reference internal" href="units.html"><em>units</em></a>.</p>
|
</P>
|
||||||
</div>
|
<P>The scalar value calculated by this compute is "extensive". The
|
||||||
<div class="section" id="restrictions">
|
scalar value will be in energy <A HREF = "units.html">units</A>.
|
||||||
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
|
</P>
|
||||||
<p>This compute is part of the RIGID package. It is only enabled if
|
<P><B>Restrictions:</B>
|
||||||
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>
|
</P>
|
||||||
</div>
|
<P>This compute is part of the RIGID package. It is only enabled if
|
||||||
<div class="section" id="related-commands">
|
LAMMPS was built with that package. See the <A HREF = "Section_start.html#start_3">Making
|
||||||
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
|
LAMMPS</A> section for more info.
|
||||||
<p><a class="reference internal" href="compute_erotate_rigid.html"><em>compute erotate/rigid</em></a></p>
|
</P>
|
||||||
<p><strong>Default:</strong> none</p>
|
<P><B>Related commands:</B>
|
||||||
</div>
|
</P>
|
||||||
</div>
|
<P><A HREF = "compute_erotate_rigid.html">compute erotate/rigid</A>
|
||||||
|
</P>
|
||||||
|
<P><B>Default:</B> none
|
||||||
</div>
|
</P>
|
||||||
</div>
|
</HTML>
|
||||||
<footer>
|
|
||||||
|
|
||||||
|
|
||||||
<hr/>
|
|
||||||
|
|
||||||
<div role="contentinfo">
|
|
||||||
<p>
|
|
||||||
© 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>
|
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user