doc/src/compute_event_displace.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 event/displace command :h3
  10
  11 [Syntax:]
  12
  13 compute ID group-ID event/displace threshold :pre
  14
  15 ID, group-ID are documented in "compute"_compute.html command
  16 event/displace = style name of this compute command
  17 threshold = minimum distance anyparticle must move to trigger an event (distance units) :ul
  18
  19 [Examples:]
  20
  21 compute 1 all event/displace 0.5 :pre
  22
  23 [Description:]
  24
  25 Define a computation that flags an "event" if any particle in the
  26 group has moved a distance greater than the specified threshold
  27 distance when compared to a previously stored reference state
  28 (i.e. the previous event).  This compute is typically used in
  29 conjunction with the "prd"_prd.html and "tad"_tad.html commands,
  30 to detect if a transition
  31 to a new minimum energy basin has occurred.
  32
  33 This value calculated by the compute is equal to 0 if no particle has
  34 moved far enough, and equal to 1 if one or more particles have moved
  35 further than the threshold distance.
  36
  37 NOTE: If the system is undergoing significant center-of-mass motion,
  38 due to thermal motion, an external force, or an initial net momentum,
  39 then this compute will not be able to distinguish that motion from
  40 local atom displacements and may generate "false postives."
  41
  42 [Output info:]
  43
  44 This compute calculates a global scalar (the flag).  This value can be
  45 used by any command that uses a global scalar value from a compute as
  46 input.  See "Section 6.15"_Section_howto.html#howto_15 for an
  47 overview of LAMMPS output options.
  48
  49 The scalar value calculated by this compute is "intensive".  The
  50 scalar value will be a 0 or 1 as explained above.
  51
  52 [Restrictions:]
  53
  54 This command can only be used if LAMMPS was built with the REPLICA
  55 package.  See the "Making LAMMPS"_Section_start.html#start_3 section
  56 for more info on packages.
  57
  58 [Related commands:]
  59
  60 "prd"_prd.html, "tad"_tad.html
  61
  62 [Default:] none