suffix.html
bfb019efa901lammps-icms

suffix.html
View Options



			<!DOCTYPE html>
			<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
			<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
			<head>
			<meta charset="utf-8">

			<meta name="viewport" content="width=device-width, initial-scale=1.0">

			<title>suffix 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">
			<div role="navigation" aria-label="breadcrumbs navigation">
			<ul class="wy-breadcrumbs">
			<li><a href="Manual.html">Docs</a> »</li>

			<li>suffix command</li>
			<li class="wy-breadcrumbs-aside">


			<a href="http://lammps.sandia.gov">Website</a>
			<a href="Section_commands.html#comm">Commands</a>

			</li>
			</ul>
			<hr/>

			</div>
			<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
			<div itemprop="articleBody">

			<div class="section" id="suffix-command">
			<span id="index-0"></span><h1>suffix command<a class="headerlink" href="#suffix-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>suffix style args
			</pre></div>
			</div>
			<ul class="simple">
			<li>style = <em>off</em> or <em>on</em> or <em>cuda</em> or <em>gpu</em> or <em>intel</em> or <em>kk</em> or <em>omp</em> or <em>opt</em> or <em>hybrid</em></li>
			<li>args = for hybrid style, default suffix to be used and alternative suffix</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>suffix off
			suffix on
			suffix gpu
			suffix intel
			suffix hybrid intel omp
			suffix kk
			</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 allows you to use variants of various styles if they
			exist. In that respect it operates the same as the <a class="reference internal" href="Section_start.html#start-7"><span>-suffix command-line switch</span></a>. It also has options
			to turn off or back on any suffix setting made via the command line.</p>
			<p>The specified style can be <em>cuda</em>, <em>gpu</em>, <em>intel</em>, <em>kk</em>, <em>omp</em>, <em>opt</em>
			or <em>hybrid</em>. These refer to optional packages that LAMMPS can be built
			with, as described in <a class="reference internal" href="Section_start.html#start-3"><span>this section of the manual</span></a>. The “cuda” style corresponds to
			the USER-CUDA package, the “gpu” style to the GPU package, the “intel”
			style to the USER-INTEL package, the “kk” style to the KOKKOS package,
			the “omp” style to the USER-OMP package, and the “opt” style to the
			OPT package.</p>
			<p>These are the variants these packages provide:</p>
			<ul class="simple">
			<li>USER-CUDA = a collection of atom, pair, fix, compute, and intergrate
			styles, optimized to run on one or more NVIDIA GPUs</li>
			<li>GPU = a handful of pair styles and the PPPM kspace_style, optimized to
			run on one or more GPUs or multicore CPU/GPU nodes</li>
			<li>USER-INTEL = a collection of pair styles and neighbor routines
			optimized to run in single, mixed, or double precision on CPUs and
			Intel(R) Xeon Phi(TM) coprocessors.</li>
			<li>KOKKOS = a collection of atom, pair, and fix styles optimized to run
			using the Kokkos library on various kinds of hardware, including GPUs
			via Cuda and many-core chips via OpenMP or threading.</li>
			<li>USER-OMP = a collection of pair, bond, angle, dihedral, improper,
			kspace, compute, and fix styles with support for OpenMP
			multi-threading</li>
			<li>OPT = a handful of pair styles, cache-optimized for faster CPU
			performance</li>
			<li>HYBRID = a combination of two packages can be specified (see below)</li>
			</ul>
			<p>As an example, all of the packages provide a <a class="reference internal" href="pair_lj.html"><em>pair_style lj/cut</em></a> variant, with style names lj/cut/opt, lj/cut/omp,
			lj/cut/gpu, lj/cut/intel, lj/cut/cuda, or lj/cut/kk. A variant styles
			can be specified explicitly in your input script, e.g. pair_style
			lj/cut/gpu. If the suffix command is used with the appropriate style,
			you do not need to modify your input script. The specified suffix
			(opt,omp,gpu,intel,cuda,kk) is automatically appended whenever your
			input script command creates a new <a class="reference internal" href="atom_style.html"><em>atom</em></a>,
			<a class="reference internal" href="pair_style.html"><em>pair</em></a>, <a class="reference internal" href="bond_style.html"><em>bond</em></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 class="reference internal" href="improper_style.html"><em>improper</em></a>, <a class="reference internal" href="kspace_style.html"><em>kspace</em></a>,
			<a class="reference internal" href="fix.html"><em>fix</em></a>, <a class="reference internal" href="compute.html"><em>compute</em></a>, or <a class="reference internal" href="run_style.html"><em>run</em></a> style.
			If the variant version does not exist, the standard version is
			created.</p>
			<p>For “hybrid”, two packages are specified. The first is used whenever
			available. If a style with the first suffix is not available, the style
			with the suffix for the second package will be used if available. For
			example, “hybrid intel omp” will use styles from the USER-INTEL package
			as a first choice and styles from the USER-OMP package as a second choice
			if no USER-INTEL variant is available.</p>
			<p>If the specified style is <em>off</em>, then any previously specified suffix
			is temporarily disabled, whether it was specified by a command-line
			switch or a previous suffix command. If the specified style is <em>on</em>,
			a disabled suffix is turned back on. The use of these 2 commands lets
			your input script use a standard LAMMPS style (i.e. a non-accelerated
			variant), which can be useful for testing or benchmarking purposes.
			Of course this is also possible by not using any suffix commands, and
			explictly appending or not appending the suffix to the relevant
			commands in your input script.</p>
			</div>
			<div class="section" id="restrictions">
			<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
			<blockquote>
			<div>none</div></blockquote>
			</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="Section_start.html#start-7"><span>Command-line switch -suffix</span></a></p>
			<p><strong>Default:</strong> none</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>

lammps/doc/suffix.htmlbfb019efa901lammps-icms

suffix.htmlView Options

lammps/doc/suffix.html
bfb019efa901lammps-icms

suffix.html
View Options