Files
lammps/doc/html/Intro_citing.html
2025-01-13 14:55:48 +00:00

231 lines
15 KiB
HTML

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>1.8. Citing LAMMPS &mdash; LAMMPS documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/sphinx-design.min.css" type="text/css" />
<link rel="stylesheet" href="_static/css/lammps.css" type="text/css" />
<link rel="shortcut icon" href="_static/lammps.ico"/>
<link rel="canonical" href="https://docs.lammps.org/Intro_citing.html" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
<script src="_static/jquery.js?v=5d32c60e"></script>
<script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="_static/documentation_options.js?v=5929fcd5"></script>
<script src="_static/doctools.js?v=9bcbadda"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/design-tabs.js?v=f930bc37"></script>
<script async="async" src="_static/mathjax/es5/tex-mml-chtml.js?v=cadf963e"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="1.9. Additional website links" href="Intro_website.html" />
<link rel="prev" title="1.7. Authors of LAMMPS" href="Intro_authors.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="Manual.html">
<img src="_static/lammps-logo.png" class="logo" alt="Logo"/>
</a>
<div class="lammps_version">Version: <b>19 Nov 2024</b></div>
<div class="lammps_release">git info: </div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="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="Navigation menu">
<p class="caption" role="heading"><span class="caption-text">User Guide</span></p>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="Intro.html">1. Introduction</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="Intro_overview.html">1.1. Overview of LAMMPS</a></li>
<li class="toctree-l2"><a class="reference internal" href="Manual_version.html">1.2. What does a LAMMPS version mean</a></li>
<li class="toctree-l2"><a class="reference internal" href="Intro_features.html">1.3. LAMMPS features</a></li>
<li class="toctree-l2"><a class="reference internal" href="Intro_nonfeatures.html">1.4. LAMMPS non-features</a></li>
<li class="toctree-l2"><a class="reference internal" href="Intro_portability.html">1.5. LAMMPS portability and compatibility</a></li>
<li class="toctree-l2"><a class="reference internal" href="Intro_opensource.html">1.6. LAMMPS open-source license</a></li>
<li class="toctree-l2"><a class="reference internal" href="Intro_authors.html">1.7. Authors of LAMMPS</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">1.8. Citing LAMMPS</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#core-algorithms">1.8.1. Core Algorithms</a></li>
<li class="toctree-l3"><a class="reference internal" href="#doi-for-the-lammps-source-code">1.8.2. DOI for the LAMMPS source code</a></li>
<li class="toctree-l3"><a class="reference internal" href="#home-page">1.8.3. Home page</a></li>
<li class="toctree-l3"><a class="reference internal" href="#citing-contributions">1.8.4. Citing contributions</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="Intro_website.html">1.9. Additional website links</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="Install.html">2. Install LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Build.html">3. Build LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Run_head.html">4. Run LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Commands.html">5. Commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="Packages.html">6. Optional packages</a></li>
<li class="toctree-l1"><a class="reference internal" href="Speed.html">7. Accelerate performance</a></li>
<li class="toctree-l1"><a class="reference internal" href="Howto.html">8. Howto discussions</a></li>
<li class="toctree-l1"><a class="reference internal" href="Examples.html">9. Example scripts</a></li>
<li class="toctree-l1"><a class="reference internal" href="Tools.html">10. Auxiliary tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="Errors.html">11. Errors</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Programmer Guide</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="Library.html">1. LAMMPS Library Interfaces</a></li>
<li class="toctree-l1"><a class="reference internal" href="Python_head.html">2. Use Python with LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Modify.html">3. Modifying &amp; extending LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Developer.html">4. Information for Developers</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Command Reference</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="commands_list.html">Commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="fixes.html">Fix Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="computes.html">Compute Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="pairs.html">Pair Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="bonds.html">Bond Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="angles.html">Angle Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="dihedrals.html">Dihedral Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="impropers.html">Improper Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="dumps.html">Dump Styles</a></li>
<li class="toctree-l1"><a class="reference internal" href="fix_modify_atc_commands.html">fix_modify AtC commands</a></li>
<li class="toctree-l1"><a class="reference internal" href="Bibliography.html">Bibliography</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<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 style-external-links">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="Manual.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item"><a href="Intro.html"><span class="section-number">1. </span>Introduction</a></li>
<li class="breadcrumb-item active"><span class="section-number">1.8. </span>Citing LAMMPS</li>
<li class="wy-breadcrumbs-aside">
<a href="https://www.lammps.org"><img src="_static/lammps-logo.png" width="64" height="16" alt="LAMMPS Homepage"></a> | <a href="Commands_all.html">Commands</a>
</li>
</ul><div class="rst-breadcrumbs-buttons" role="navigation" aria-label="Sequential page navigation">
<a href="Intro_authors.html" class="btn btn-neutral float-left" title="1.7. Authors of LAMMPS" accesskey="p"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="Intro_website.html" class="btn btn-neutral float-right" title="1.9. Additional website links" accesskey="n">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<p><span class="math notranslate nohighlight">\(\renewcommand{\AA}{\text{Å}}\)</span></p>
<section id="citing-lammps">
<h1><span class="section-number">1.8. </span>Citing LAMMPS<a class="headerlink" href="#citing-lammps" title="Link to this heading"></a></h1>
<section id="core-algorithms">
<h2><span class="section-number">1.8.1. </span>Core Algorithms<a class="headerlink" href="#core-algorithms" title="Link to this heading"></a></h2>
<p>The paper mentioned below is the best overview of LAMMPS, but there are
also publications describing particular models or algorithms implemented
in LAMMPS or complementary software that is has interfaces to. Please
see below for how to cite contributions to LAMMPS.</p>
<p id="lammps-paper">The latest canonical publication that describes the basic features, the
source code design, the program structure, the spatial decomposition
approach, the neighbor finding, basic communications algorithms, and how
users and developers have contributed to LAMMPS is:</p>
<blockquote>
<div><p><a class="reference external" href="https://doi.org/10.1016/j.cpc.2021.108171">LAMMPS - A flexible simulation tool for particle-based materials modeling at the atomic, meso, and continuum scales, Comp. Phys. Comm. 271, 108171 (2022)</a></p>
</div></blockquote>
<p>So a project using LAMMPS or a derivative application that uses LAMMPS
as a simulation engine should cite this paper. The paper is expected to
be published in its final form under the same DOI in the first half
of 2022. Please also give the URL of the LAMMPS website in your paper,
namely <a class="reference external" href="https://www.lammps.org">https://www.lammps.org</a>.</p>
<p>The original publication describing the parallel algorithms used in the
initial versions of LAMMPS is:</p>
<blockquote>
<div><p><a class="reference external" href="https://doi.org/10.1006/jcph.1995.1039">S. Plimpton, Fast Parallel Algorithms for Short-Range Molecular Dynamics, J Comp Phys, 117, 1-19 (1995).</a></p>
</div></blockquote>
</section>
<section id="doi-for-the-lammps-source-code">
<h2><span class="section-number">1.8.2. </span>DOI for the LAMMPS source code<a class="headerlink" href="#doi-for-the-lammps-source-code" title="Link to this heading"></a></h2>
<p>The LAMMPS developers use the <a class="reference external" href="https://zenodo.org/">Zenodo service at CERN</a>
to create digital object identifiers (DOI) for stable releases of the
LAMMPS source code. There are two types of DOIs for the LAMMPS source code.</p>
<p>The canonical DOI for <strong>all</strong> versions of LAMMPS, which will always
point to the <strong>latest</strong> stable release version, is:</p>
<ul class="simple">
<li><p>DOI: <a class="reference external" href="https://dx.doi.org/10.5281/zenodo.3726416">10.5281/zenodo.3726416</a></p></li>
</ul>
<p>In addition there are DOIs generated for individual stable releases:</p>
<ul class="simple">
<li><p>3 March 2020 version: <a class="reference external" href="https://dx.doi.org/10.5281/zenodo.3726417">DOI:10.5281/zenodo.3726417</a></p></li>
<li><p>29 October 2020 version: <a class="reference external" href="https://dx.doi.org/10.5281/zenodo.4157471">DOI:10.5281/zenodo.4157471</a></p></li>
<li><p>29 September 2021 version: <a class="reference external" href="https://dx.doi.org/10.5281/zenodo.6386596">DOI:10.5281/zenodo.6386596</a></p></li>
<li><p>23 June 2022 version: <a class="reference external" href="https://doi.org/10.5281/zenodo.10806836">DOI:10.5281/zenodo.10806836</a></p></li>
<li><p>2 August 2023 version: <a class="reference external" href="https://doi.org/10.5281/zenodo.10806852">DOI:10.5281/zenodo.10806852</a></p></li>
</ul>
</section>
<section id="home-page">
<h2><span class="section-number">1.8.3. </span>Home page<a class="headerlink" href="#home-page" title="Link to this heading"></a></h2>
<p>The LAMMPS website at <a class="reference external" href="https://www.lammps.org">https://www.lammps.org/</a> is the canonical location for information
about LAMMPS and its features.</p>
</section>
<section id="citing-contributions">
<h2><span class="section-number">1.8.4. </span>Citing contributions<a class="headerlink" href="#citing-contributions" title="Link to this heading"></a></h2>
<p>LAMMPS has many features that use either previously published methods
and algorithms or novel features. It also includes potential parameter
files for specific models. Where available, a reminder about references
for optional features used in a specific run is printed to the screen
and log file. Style and output location can be selected with the
<a class="reference internal" href="Run_options.html#cite"><span class="std std-ref">-cite command-line switch</span></a>. Additional references are
given in the documentation of the <a class="reference internal" href="Commands_all.html"><span class="doc">corresponding commands</span></a> or in the <a class="reference internal" href="Howto.html"><span class="doc">Howto tutorials</span></a>. Please make
certain, that you provide the proper acknowledgments and citations in
any published works using LAMMPS.</p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="Intro_authors.html" class="btn btn-neutral float-left" title="1.7. Authors of LAMMPS" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="Intro_website.html" class="btn btn-neutral float-right" title="1.9. Additional website links" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright 2003-2025 Sandia Corporation.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(false);
});
</script>
</body>
</html>