doc/src/fix_addtorque.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 fix addtorque command :h3
  10
  11 [Syntax:]
  12
  13 fix ID group-ID addtorque Tx Ty Tz :pre
  14
  15 ID, group-ID are documented in "fix"_fix.html command :ulb,l
  16 addtorque = style name of this fix command :l
  17 Tx,Ty,Tz = torque component values (torque units) :l
  18 any of Tx,Ty,Tz can be a variable (see below) :l
  19 :ule
  20
  21 [Examples:]
  22
  23 fix kick bead addtorque 2.0 3.0 5.0
  24 fix kick bead addtorque 0.0 0.0 v_oscillate :pre
  25
  26 [Description:]
  27
  28 Add a set of forces to each atom in
  29 the group such that:
  30
  31 the components of the total torque applied on the group (around its
  32 center of mass) are Tx,Ty,Tz :ulb,l
  33
  34 the group would move as a rigid body in the absence of other
  35 forces. :l
  36 :ule
  37
  38 This command can be used to drive a group of atoms into rotation.
  39
  40 Any of the 3 quantities defining the torque components can be specified
  41 as an equal-style "variable"_variable.html, namely {Tx},
  42 {Ty}, {Tz}.  If the value is a variable, it should be specified as
  43 v_name, where name is the variable name.  In this case, the variable
  44 will be evaluated each timestep, and its value used to determine the
  45 torque component.
  46
  47 Equal-style variables can specify formulas with various mathematical
  48 functions, and include "thermo_style"_thermo_style.html command
  49 keywords for the simulation box parameters and timestep and elapsed
  50 time.  Thus it is easy to specify a time-dependent torque.
  51
  52 :line
  53
  54 [Restart, fix_modify, output, run start/stop, minimize info:]
  55
  56 No information about this fix is written to "binary restart
  57 files"_restart.html.
  58
  59 The "fix_modify"_fix_modify.html {energy} option is supported by this
  60 fix to add the potential "energy" inferred by the added forces to the
  61 system's potential energy as part of "thermodynamic
  62 output"_thermo_style.html.  This is a fictitious quantity but is
  63 needed so that the "minimize"_minimize.html command can include the
  64 forces added by this fix in a consistent manner.  I.e. there is a
  65 decrease in potential energy when atoms move in the direction of the
  66 added forces.
  67
  68 The "fix_modify"_fix_modify.html {respa} option is supported by
  69 this fix. This allows to set at which level of the "r-RESPA"_run_style.html
  70 integrator the fix is adding its torque. Default is the outermost level.
  71
  72 This fix computes a global scalar and a global 3-vector, which can be
  73 accessed by various "output commands"_Section_howto.html#howto_15.
  74 The scalar is the potential energy discussed above.  The vector is the
  75 total torque on the group of atoms before the forces on individual
  76 atoms are changed by the fix.  The scalar and vector values calculated
  77 by this fix are "extensive".
  78
  79 No parameter of this fix can be used with the {start/stop} keywords of
  80 the "run"_run.html command.
  81
  82 The forces due to this fix are imposed during an energy minimization,
  83 invoked by the "minimize"_minimize.html command.  You should not
  84 specify force components with a variable that has time-dependence for
  85 use with a minimizer, since the minimizer increments the timestep as
  86 the iteration count during the minimization.
  87
  88 [Restrictions:]
  89
  90 This fix is part of the USER-MISC package.  It is only enabled if
  91 LAMMPS was built with that package.  See the "Making
  92 LAMMPS"_Section_start.html#start_3 section for more info.
  93
  94 [Related commands:]
  95
  96 "fix addforce"_fix_addforce.html
  97
  98 [Default:] none