<li>ID, group-ID are documented in <aclass="reference internal"href="fix.html"><spanclass="doc">fix</span></a> command</li>
<li>lb/viscous = style name of this fix command</li>
</ul>
</div>
<divclass="section"id="examples">
<h2>Examples</h2>
<p>fix 1 flow lb/viscous</p>
</div>
<divclass="section"id="description">
<h2>Description</h2>
<p>This fix is similar to the <aclass="reference internal"href="fix_viscous.html"><spanclass="doc">fix viscous</span></a> command, and
is to be used in place of that command when a lattice-Boltzmann fluid
is present, and the user wishes to integrate the particle motion using
one of the built in LAMMPS integrators.</p>
<p>This fix adds a force, F = - Gamma*(velocity-fluid_velocity), to each
atom, where Gamma is the force coupling constant described in the <aclass="reference internal"href="fix_lb_fluid.html"><spanclass="doc">fix lb/fluid</span></a> command (which applies an equal and
opposite force to the fluid).</p>
<divclass="admonition note">
<pclass="first admonition-title">Note</p>
<pclass="last">This fix should only be used in conjunction with one of the
built in LAMMPS integrators; it should not be used with the <aclass="reference internal"href="fix_lb_pc.html"><spanclass="doc">fix lb/pc</span></a> or <aclass="reference internal"href="fix_lb_rigid_pc_sphere.html"><spanclass="doc">fix lb/rigid/pc/sphere</span></a> integrators, which
already include the hydrodynamic forces. These latter fixes should
only be used if the force coupling constant has been set by the user
(instead of using the default value); if the default force coupling
value is used, then this fix provides the only method for adding the
hydrodynamic forces to the particles.</p>
</div>
<hrclass="docutils"/>
<p>For further details, as well as descriptions and results of several
test runs, see <aclass="reference internal"href="#mackay"><spanclass="std std-ref">Mackay et al.</span></a>. Please include a citation to
this paper if this fix is used in work contributing to published
research.</p>
<hrclass="docutils"/>
<p><strong>Restart, fix_modify, output, run start/stop, minimize info:</strong></p>
<p>As described in the <aclass="reference internal"href="fix_viscous.html"><spanclass="doc">fix viscous</span></a> documentation:</p>
<p>“No information about this fix is written to <aclass="reference internal"href="restart.html"><spanclass="doc">binary restart files</span></a>. None of the <aclass="reference internal"href="fix_modify.html"><spanclass="doc">fix_modify</span></a> options
are relevant to this fix. No global or per-atom quantities are stored
by this fix for access by various <aclass="reference internal"href="Section_howto.html#howto-15"><spanclass="std std-ref">output commands</span></a>. No parameter of this fix can
be used with the <em>start/stop</em> keywords of the <aclass="reference internal"href="run.html"><spanclass="doc">run</span></a> command.</p>
<p>The forces due to this fix are imposed during an energy minimization,
invoked by the <aclass="reference internal"href="minimize.html"><spanclass="doc">minimize</span></a> command. This fix should only
be used with damped dynamics minimizers that allow for
non-conservative forces. See the <aclass="reference internal"href="min_style.html"><spanclass="doc">min_style</span></a> command
for details.”</p>
</div>
<divclass="section"id="restrictions">
<h2>Restrictions</h2>
<p>This fix is part of the USER-LB package. It is only enabled if LAMMPS
was built with that package. See the <aclass="reference internal"href="Section_start.html#start-3"><spanclass="std std-ref">Making LAMMPS</span></a> section for more info.</p>
<p>Can only be used if a lattice-Boltzmann fluid has been created via the
<aclass="reference internal"href="fix_lb_fluid.html"><spanclass="doc">fix lb/fluid</span></a> command, and must come after this
command.</p>
<p>This fix should not be used if either the <aclass="reference internal"href="fix_lb_pc.html"><spanclass="doc">fix lb/pc</span></a>
or <aclass="reference internal"href="fix_lb_rigid_pc_sphere.html"><spanclass="doc">fix lb/rigid/pc/sphere</span></a> integrator is
<pid="mackay"><strong>(Mackay et al.)</strong> Mackay, F. E., Ollila, S.T.T., and Denniston, C., Hydrodynamic Forces Implemented into LAMMPS through a lattice-Boltzmann fluid, Computer Physics Communications 184 (2013) 2021-2031.</p>
Built with <ahref="http://sphinx-doc.org/">Sphinx</a> using a <ahref="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <ahref="https://readthedocs.org">Read the Docs</a>.