lammps/doc/html/pair_lubricateU.html

367 lines
18 KiB
HTML

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>pair_style lubricateU command &mdash; LAMMPS documentation</title>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/sphinxcontrib-images/LightBox2/lightbox2/css/lightbox.css" type="text/css" />
<link rel="top" title="LAMMPS documentation" href="index.html"/>
<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 &amp; scalability</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_tools.html">9. Additional tools</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_modify.html">10. Modifying &amp; extending LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_python.html">11. Python interface to LAMMPS</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_errors.html">12. Errors</a></li>
<li class="toctree-l1"><a class="reference internal" href="Section_history.html">13. Future and history</a></li>
</ul>
</div>
&nbsp;
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="Manual.html">LAMMPS</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="Manual.html">Docs</a> &raquo;</li>
<li>pair_style lubricateU 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="pair-style-lubricateu-command">
<span id="index-0"></span><h1>pair_style lubricateU command</h1>
</div>
<div class="section" id="pair-style-lubricateu-poly-command">
<h1>pair_style lubricateU/poly command</h1>
<div class="section" id="syntax">
<h2>Syntax</h2>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">pair_style</span> <span class="n">style</span> <span class="n">mu</span> <span class="n">flaglog</span> <span class="n">cutinner</span> <span class="n">cutoff</span> <span class="n">gdot</span> <span class="n">flagHI</span> <span class="n">flagVF</span>
</pre></div>
</div>
<ul class="simple">
<li>style = <em>lubricateU</em> or <em>lubricateU/poly</em></li>
<li>mu = dynamic viscosity (dynamic viscosity units)</li>
<li>flaglog = 0/1 to exclude/include log terms in the lubrication approximation</li>
<li>cutinner = inner cut off distance (distance units)</li>
<li>cutoff = outer cutoff for interactions (distance units)</li>
<li>gdot = shear rate (1/time units)</li>
<li>flagHI (optional) = 0/1 to exclude/include 1/r hydrodynamic interactions</li>
<li>flagVF (optional) = 0/1 to exclude/include volume fraction corrections in the long-range isotropic terms</li>
</ul>
<p><strong>Examples:</strong> (all assume radius = 1)</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">pair_style</span> <span class="n">lubricateU</span> <span class="mf">1.5</span> <span class="mi">1</span> <span class="mf">2.01</span> <span class="mf">2.5</span> <span class="mf">0.01</span> <span class="mi">1</span> <span class="mi">1</span>
<span class="n">pair_coeff</span> <span class="mi">1</span> <span class="mi">1</span> <span class="mf">2.05</span> <span class="mf">2.8</span>
<span class="n">pair_coeff</span> <span class="o">*</span> <span class="o">*</span>
</pre></div>
</div>
</div>
<div class="section" id="description">
<h2>Description</h2>
<p>Styles <em>lubricateU</em> and <em>lubricateU/poly</em> compute velocities and
angular velocities for finite-size spherical particles such that the
hydrodynamic interaction balances the force and torque due to all
other types of interactions.</p>
<p>The interactions have 2 components. The first is
Ball-Melrose lubrication terms via the formulas in <a class="reference internal" href="#ball"><span class="std std-ref">(Ball and Melrose)</span></a></p>
<img alt="_images/pair_lubricate.jpg" class="align-center" src="_images/pair_lubricate.jpg" />
<p>which represents the dissipation W between two nearby particles due to
their relative velocities in the presence of a background solvent with
viscosity <em>mu</em>. Note that this is dynamic viscosity which has units of
mass/distance/time, not kinematic viscosity.</p>
<p>The Asq (squeeze) term is the strongest and is included as long as
<em>flagHI</em> is set to 1 (default). It scales as 1/gap where gap is the
separation between the surfaces of the 2 particles. The Ash (shear)
and Apu (pump) terms are only included if <em>flaglog</em> is set to 1. They
are the next strongest interactions, and the only other singular
interaction, and scale as log(gap). Note that <em>flaglog</em> = 1 and
<em>flagHI</em> = 0 is invalid, and will result in a warning message, after
which <em>flagHI</em> will be set to 1. The Atw (twist) term is currently not
included. It is typically a very small contribution to the lubrication
forces.</p>
<p>The <em>flagHI</em> and <em>flagVF</em> settings are optional. Neither should be
used, or both must be defined.</p>
<p><em>Cutinner</em> sets the minimum center-to-center separation that will be
used in calculations irrespective of the actual separation. <em>Cutoff</em>
is the maximum center-to-center separation at which an interaction is
computed. Using a <em>cutoff</em> less than 3 radii is recommended if
<em>flaglog</em> is set to 1.</p>
<p>The other component is due to the Fast Lubrication Dynamics (FLD)
approximation, described in <a class="reference internal" href="#kumar"><span class="std std-ref">(Kumar)</span></a>. The equation being
solved to balance the forces and torques is</p>
<img alt="_images/fld2.jpg" class="align-center" src="_images/fld2.jpg" />
<p>where U represents the velocities and angular velocities of the
particles, U^<em>infty</em> represents the velocities and the angular
velocities of the undisturbed fluid, and E^<em>infty</em> represents the rate
of strain tensor of the undisturbed fluid flow with viscosity
<em>mu</em>. Again, note that this is dynamic viscosity which has units of
mass/distance/time, not kinematic viscosity. Volume fraction
corrections to R_FU are included if <em>flagVF</em> is set to 1 (default).</p>
<p>F<em>rest</em> represents the forces and torques due to all other types of
interactions, e.g. Brownian, electrostatic etc. Note that this
algorithm neglects the inertial terms, thereby removing the
restriction of resolving the small interial time scale, which may not
be of interest for colloidal particles. This pair style solves for
the velocity such that the hydrodynamic force balances all other types
of forces, thereby resulting in a net zero force (zero inertia limit).
When defining this pair style, it must be defined last so that when
this style is invoked all other types of forces have already been
computed. For the same reason, it won&#8217;t work if additional non-pair
styles are defined (such as bond or Kspace forces) as they are
calculated in LAMMPS after the pairwise interactions have been
computed.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">When using these styles, the these pair styles are designed to
be used with implicit time integration and a correspondingly larger
timestep. Thus either <a class="reference internal" href="fix_nve_noforce.html"><span class="doc">fix nve/noforce</span></a> should
be used for spherical particles defined via <a class="reference internal" href="atom_style.html"><span class="doc">atom_style sphere</span></a> or <a class="reference internal" href="fix_nve_asphere_noforce.html"><span class="doc">fix nve/asphere/noforce</span></a> should be used for
spherical particles defined via <a class="reference internal" href="atom_style.html"><span class="doc">atom_style ellipsoid</span></a>. This is because the velocity and angular
momentum of each particle is set by the pair style, and should not be
reset by the time integration fix.</p>
</div>
<p>Style <em>lubricateU</em> requires monodisperse spherical particles; style
<em>lubricateU/poly</em> allows for polydisperse spherical particles.</p>
<p>If the suspension is sheared via the <a class="reference internal" href="fix_deform.html"><span class="doc">fix deform</span></a>
command then the pair style uses the shear rate to adjust the
hydrodynamic interactions accordingly. Volume changes due to fix
deform are accounted for when computing the volume fraction
corrections to R_FU.</p>
<p>When computing the volume fraction corrections to R_FU, the presence
of walls (whether moving or stationary) will affect the volume
fraction available to colloidal particles. This is currently accounted
for with the following types of walls: <a class="reference internal" href="fix_wall.html"><span class="doc">wall/lj93</span></a>,
<a class="reference internal" href="fix_wall.html"><span class="doc">wall/lj126</span></a>, <a class="reference internal" href="fix_wall.html"><span class="doc">wall/colloid</span></a>, and
&#8220;wall/harmonic_fix_wall.html&#8221;. For these wall styles, the correct
volume fraction will be used when walls do not coincide with the box
boundary, as well as when walls move and thereby cause a change in the
volume fraction. To use these wall styles with pair_style <em>lubricateU</em>
or <em>lubricateU/poly</em>, the <em>fld yes</em> option must be specified in the
fix wall command.</p>
<p>Since lubrication forces are dissipative, it is usually desirable to
thermostat the system at a constant temperature. If Brownian motion
(at a constant temperature) is desired, it can be set using the
<a class="reference internal" href="pair_brownian.html"><span class="doc">pair_style brownian</span></a> command. These pair styles
and the brownian style should use consistent parameters for <em>mu</em>,
<em>flaglog</em>, <em>flagfld</em>, <em>cutinner</em>, <em>cutoff</em>, <em>flagHI</em> and <em>flagVF</em>.</p>
<hr class="docutils" />
<p>The following coefficients must be defined for each pair of atoms
types via the <a class="reference internal" href="pair_coeff.html"><span class="doc">pair_coeff</span></a> command as in the examples
above, or in the data file or restart files read by the
<a class="reference internal" href="read_data.html"><span class="doc">read_data</span></a> or <a class="reference internal" href="read_restart.html"><span class="doc">read_restart</span></a>
commands, or by mixing as described below:</p>
<ul class="simple">
<li>cutinner (distance units)</li>
<li>cutoff (distance units)</li>
</ul>
<p>The two coefficients are optional. If neither is specified, the two
cutoffs specified in the pair_style command are used. Otherwise both
must be specified.</p>
<hr class="docutils" />
<p><strong>Mixing, shift, table, tail correction, restart, rRESPA info</strong>:</p>
<p>For atom type pairs I,J and I != J, the two cutoff distances for this
pair style can be mixed. The default mix value is <em>geometric</em>. See
the &#8220;pair_modify&#8221; command for details.</p>
<p>This pair style does not support the <a class="reference internal" href="pair_modify.html"><span class="doc">pair_modify</span></a>
shift option for the energy of the pair interaction.</p>
<p>The <a class="reference internal" href="pair_modify.html"><span class="doc">pair_modify</span></a> table option is not relevant
for this pair style.</p>
<p>This pair style does not support the <a class="reference internal" href="pair_modify.html"><span class="doc">pair_modify</span></a>
tail option for adding long-range tail corrections to energy and
pressure.</p>
<p>This pair style writes its information to <a class="reference internal" href="restart.html"><span class="doc">binary restart files</span></a>, so pair_style and pair_coeff commands do not need
to be specified in an input script that reads a restart file.</p>
<p>This pair style can only be used via the <em>pair</em> keyword of the
<a class="reference internal" href="run_style.html"><span class="doc">run_style respa</span></a> command. It does not support the
<em>inner</em>, <em>middle</em>, <em>outer</em> keywords.</p>
</div>
<hr class="docutils" />
<div class="section" id="restrictions">
<h2>Restrictions</h2>
<p>These styles are part of the COLLOID package. They are only enabled
if LAMMPS was built with that package. See the <a class="reference internal" href="Section_start.html#start-2-3"><span class="std std-ref">Making LAMMPS</span></a> section for more info.</p>
<p>Currently, these pair styles assume that all other types of
forces/torques on the particles have been already been computed when
it is invoked. This requires this style to be defined as the last of
the pair styles, and that no fixes apply additional constraint forces.
One exception is the <a class="reference internal" href="fix_wall.html"><span class="doc">fix wall/colloid</span></a> commands, which
has an &#8220;fld&#8221; option to apply their wall forces correctly.</p>
<p>Only spherical monodisperse particles are allowed for pair_style
lubricateU.</p>
<p>Only spherical particles are allowed for pair_style lubricateU/poly.</p>
<p>For sheared suspensions, it is assumed that the shearing is done in
the xy plane, with x being the velocity direction and y being the
velocity-gradient direction. In this case, one must use <a class="reference internal" href="fix_deform.html"><span class="doc">fix deform</span></a> with the same rate of shear (erate).</p>
</div>
<div class="section" id="related-commands">
<h2>Related commands</h2>
<p><a class="reference internal" href="pair_coeff.html"><span class="doc">pair_coeff</span></a>, <a class="reference internal" href="pair_lubricate.html"><span class="doc">pair_style lubricate</span></a></p>
</div>
<div class="section" id="default">
<h2>Default</h2>
<p>The default settings for the optional args are flagHI = 1 and flagVF =
1.</p>
<hr class="docutils" />
<p id="ball"><strong>(Ball)</strong> Ball and Melrose, Physica A, 247, 444-472 (1997).</p>
<p id="kumar"><strong>(Kumar)</strong> Kumar and Higdon, Phys Rev E, 82, 051401 (2010).</p>
</div>
</div>
</div>
</div>
<footer>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright 2013 Sandia Corporation.
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'./',
VERSION:'',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2/js/jquery-1.11.0.min.js"></script>
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2/js/lightbox.min.js"></script>
<script type="text/javascript" src="_static/sphinxcontrib-images/LightBox2/lightbox2-customize/jquery-noconflict.js"></script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.StickyNav.enable();
});
</script>
</body>
</html>