doc/src/improper_umbrella.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 improper_style umbrella command :h3
  10 improper_style umbrella/omp command :h3
  11
  12 [Syntax:]
  13
  14 improper_style umbrella :pre
  15
  16 [Examples:]
  17
  18 improper_style umbrella
  19 improper_coeff 1 100.0 180.0 :pre
  20
  21 [Description:]
  22
  23 The {umbrella} improper style uses the following potential, which is
  24 commonly referred to as a classic inversion and used in the
  25 "DREIDING"_Section_howto.html#howto_4 force field:
  26
  27 :c,image(Eqs/improper_umbrella.jpg)
  28
  29 where K is the force constant and omega is the angle between the IL
  30 axis and the IJK plane:
  31
  32 :c,image(Eqs/umbrella.jpg)
  33
  34 If omega0 = 0 the potential term has a minimum for the planar
  35 structure.  Otherwise it has two minima at +/- omega0, with a barrier
  36 in between.
  37
  38 See "(Mayo)"_#umbrella-Mayo for a description of the DREIDING force field.
  39
  40 The following coefficients must be defined for each improper type via
  41 the "improper_coeff"_improper_coeff.html command as in the example
  42 above, or in the data file or restart files read by the
  43 "read_data"_read_data.html or "read_restart"_read_restart.html
  44 commands:
  45
  46 K (energy)
  47 omega0 (degrees) :ul
  48
  49 :line
  50
  51 Styles with a {gpu}, {intel}, {kk}, {omp}, or {opt} suffix are
  52 functionally the same as the corresponding style without the suffix.
  53 They have been optimized to run faster, depending on your available
  54 hardware, as discussed in "Section 5"_Section_accelerate.html
  55 of the manual.  The accelerated styles take the same arguments and
  56 should produce the same results, except for round-off and precision
  57 issues.
  58
  59 These accelerated styles are part of the GPU, USER-INTEL, KOKKOS,
  60 USER-OMP and OPT packages, respectively.  They are only enabled if
  61 LAMMPS was built with those packages.  See the "Making
  62 LAMMPS"_Section_start.html#start_3 section for more info.
  63
  64 You can specify the accelerated styles explicitly in your input script
  65 by including their suffix, or you can use the "-suffix command-line
  66 switch"_Section_start.html#start_7 when you invoke LAMMPS, or you can
  67 use the "suffix"_suffix.html command in your input script.
  68
  69 See "Section 5"_Section_accelerate.html of the manual for
  70 more instructions on how to use the accelerated styles effectively.
  71
  72 :line
  73
  74 [Restrictions:]
  75
  76 This improper style can only be used if LAMMPS was built with the
  77 MOLECULE package.  See the "Making
  78 LAMMPS"_Section_start.html#start_3 section for more info on packages.
  79
  80 [Related commands:]
  81
  82 "improper_coeff"_improper_coeff.html
  83
  84 [Default:] none
  85
  86 :line
  87
  88 :link(umbrella-Mayo)
  89 [(Mayo)] Mayo, Olfason, Goddard III, J Phys Chem, 94, 8897-8909
  90 (1990),