Merge pull request #2295 from akohlmey/add-fix-momentum-chunk

   * :doc:`manifoldforce <fix_manifoldforce>`

   * :doc:`meso/move <fix_meso_move>`

   * :doc:`momentum (k) <fix_momentum>`

   * :doc:`momentum/chunk <fix_momentum>`

   * :doc:`move <fix_move>`

   * :doc:`mscg <fix_mscg>`

   * :doc:`msst <fix_msst>`

* :doc:`oxdna2/fene <bond_oxdna>` - same as oxdna but used with different pair styles

* :doc:`oxrna2/fene <bond_oxdna>` - modified FENE bond suitable for RNA modeling

* :doc:`quartic <bond_quartic>` - breakable quartic bond

* :doc:`special <bond_special>` - enable special bond exclusions for 1-5 pairs and beyond

* :doc:`table <bond_table>` - tabulated by bond length

----------

* :doc:`manifoldforce <fix_manifoldforce>` - restrain atoms to a manifold during minimization

* :doc:`meso/move <fix_meso_move>` - move mesoscopic SPH/SDPD particles in a prescribed fashion

* :doc:`momentum <fix_momentum>` - zero the linear and/or angular momentum of a group of atoms

* :doc:`momentum/chunk <fix_momentum>` - zero the linear and/or angular momentum of a chunk of atoms

* :doc:`move <fix_move>` - move atoms in a prescribed fashion

* :doc:`mscg <fix_mscg>` - apply MSCG method for force-matching to generate coarse grain models

* :doc:`msst <fix_msst>` - multi-scale shock technique (MSST) integration

fix momentum/kk command

=======================

fix momentum/chunk command

==========================

Syntax

""""""

* ID, group-ID are documented in :doc:`fix <fix>` command

* momentum = style name of this fix command

* N = adjust the momentum every this many timesteps

  one or more keyword/value pairs may be appended

* keyword = *linear* or *angular* or *rescale*

   fix ID group-ID momentum/chunk N chunkID keyword values ...

* ID, group-ID are documented in :doc:`fix <fix>` command

* momentum/chunk = style name of this fix command

* N = adjust the momentum per chunk every this many timesteps

* chunkID = ID of :doc:`compute chunk/atom <compute_chunk_atom>` command

  one or more keyword/value pairs may be appended

* keyword = *linear* or *angular* or *rescale*

       *linear* values = xflag yflag zflag

         xflag,yflag,zflag = 0/1 to exclude/include each dimension

       *angular* values = none

  .. parsed-literal::

       *rescale* values = none

Examples

   fix 1 all momentum 1 linear 1 1 0

   fix 1 all momentum 1 linear 1 1 1 rescale

   fix 1 all momentum 100 linear 1 1 1 angular

   fix 1 all momentum/chunk 100 molchunk linear 1 1 1 angular

Description

"""""""""""

Zero the linear and/or angular momentum of the group of atoms every N

timesteps by adjusting the velocities of the atoms.  One (or both) of

the *linear* or *angular* keywords must be specified.

Fix momentum zeroes the linear and/or angular momentum of the group of

atoms every N timesteps by adjusting the velocities of the atoms.

Fix momentum/chunk works equivalently, but operates on a per-chunk basis.

One (or both) of the *linear* or *angular* keywords **must** be specified.

If the *linear* keyword is used, the linear momentum is zeroed by

subtracting the center-of-mass velocity of the group from each atom.

This does not change the relative velocity of any pair of atoms.  One

or more dimensions can be excluded from this operation by setting the

corresponding flag to 0.

subtracting the center-of-mass velocity of the group or chunk from each

atom.  This does not change the relative velocity of any pair of atoms.

One or more dimensions can be excluded from this operation by setting

the corresponding flag to 0.

If the *angular* keyword is used, the angular momentum is zeroed by

subtracting a rotational component from each atom.

thermostatting).

The *rescale* keyword enables conserving the kinetic energy of the group

of atoms by rescaling the velocities after the momentum was removed.

or chunk of atoms by rescaling the velocities after the momentum was removed.

Note that the :doc:`velocity <velocity>` command can be used to create

initial velocities with zero aggregate linear and/or angular momentum.

**Restart, fix_modify, output, run start/stop, minimize info:**

No information about this fix is written to :doc:`binary restart files <restart>`.  None of the :doc:`fix_modify <fix_modify>` options

are relevant to this fix.  No global or per-atom quantities are stored

by this fix for access by various :doc:`output commands <Howto_output>`.

No information about this fix is written to :doc:`binary restart files

<restart>`.  None of the :doc:`fix_modify <fix_modify>` options are

relevant to this fix.  No global or per-atom quantities are stored by

this fix for access by various :doc:`output commands <Howto_output>`.

No parameter of this fix can be used with the *start/stop* keywords of

the :doc:`run <run>` command.  This fix is not invoked during :doc:`energy minimization <minimize>`.

the :doc:`run <run>` command.  This fix is not invoked during

:doc:`energy minimization <minimize>`.

Restrictions

""""""""""""

 none

Fix momentum/chunk is part of the USER-MISC package.  It is only enabled

if LAMMPS was built with that package.  See the :doc:`Build package

<Build_package>` doc page for more info.

Related commands

""""""""""""""""

fix grem, David Stelter, dstelter@bu.edu, 22 Nov 16

fix imd, Axel Kohlmeyer, akohlmey at gmail.com, 9 Nov 2009

fix ipi, Michele Ceriotti (EPFL Lausanne), michele.ceriotti at gmail.com, 24 Nov 2014

fix momentum/chunk, Jiang Xiao (Hong Kong Polytechnic University), polyu-xiao.jiang at connect.polyu.hk, 19 Aug 2020

fix npt/cauchy, R. E. Miller (Carleton University), F. Pavia and S. Pattamatta, 12 Jan 2020

fix nvk, Efrem Braun (UC Berkeley), efrem.braun at gmail.com, https://github.com/lammps/lammps/pull/310

fix orient/eco Adrian A. Schratt and Volker Mohles (Ruhr-Uni Bochum), volker.mohles at rub.de, 6 Jun 2020