doc/src/compute_ke_rigid.txt

   1 "LAMMPS WWW Site"_lws - "LAMMPS Documentation"_ld - "LAMMPS Commands"_lc :c
   2
   3 :link(lws,http://lammps.sandia.gov)
   4 :link(ld,Manual.html)
   5 :link(lc,Section_commands.html#comm)
   6
   7 :line
   8
   9 compute ke/rigid command :h3
  10
  11 [Syntax:]
  12
  13 compute ID group-ID ke/rigid fix-ID :pre
  14
  15 ID, group-ID are documented in "compute"_compute.html command
  16 ke = style name of this compute command
  17 fix-ID = ID of rigid body fix :ul
  18
  19 [Examples:]
  20
  21 compute 1 all ke/rigid myRigid :pre
  22
  23 [Description:]
  24
  25 Define a computation that calculates the translational kinetic energy
  26 of a collection of rigid bodies, as defined by one of the "fix
  27 rigid"_fix_rigid.html command variants.
  28
  29 The kinetic energy of each rigid body is computed as 1/2 M Vcm^2,
  30 where M is the total mass of the rigid body, and Vcm is its
  31 center-of-mass velocity.
  32
  33 The {fix-ID} should be the ID of one of the "fix rigid"_fix_rigid.html
  34 commands which defines the rigid bodies.  The group specified in the
  35 compute command is ignored.  The kinetic energy of all the rigid
  36 bodies defined by the fix rigid command in included in the
  37 calculation.
  38
  39 [Output info:]
  40
  41 This compute calculates a global scalar (the summed KE of all the
  42 rigid bodies).  This value can be used by any command that uses a
  43 global scalar value from a compute as input.  See "Section
  44 6.15"_Section_howto.html#howto_15 for an overview of LAMMPS output
  45 options.
  46
  47 The scalar value calculated by this compute is "extensive".  The
  48 scalar value will be in energy "units"_units.html.
  49
  50 [Restrictions:]
  51
  52 This compute is part of the RIGID package.  It is only enabled if
  53 LAMMPS was built with that package.  See the "Making
  54 LAMMPS"_Section_start.html#start_3 section for more info.
  55
  56 [Related commands:]
  57
  58 "compute erotate/rigid"_compute_erotate_rigid.html
  59
  60 [Default:] none