<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>
<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 dilatation/atom
</pre></div>
</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
contribution of the IJ pair is a function of the change in bond length
(versus the initial length in the reference state), the volume
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
definition of dilatation.</p>
<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>
<p>The dilatation value 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
Section_howto 15 for an overview of LAMMPS output options.</p>
<p>The per-atom vector values are unitlesss numbers (theta) >= 0.0.</p>
</div>
<div class="section" id="restrictions">
<h2>Restrictions<a class="headerlink" href="#restrictions" title="Permalink to this headline">¶</a></h2>
<p>This compute is part of the PERI 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>
</div>
<div class="section" id="related-commands">
<h2>Related commands<a class="headerlink" href="#related-commands" title="Permalink to this headline">¶</a></h2>
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>.