doc/src/angle_cosine_periodic.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 angle_style cosine/periodic command :h3
  10 angle_style cosine/periodic/omp command :h3
  11
  12 [Syntax:]
  13
  14 angle_style cosine/periodic :pre
  15
  16 [Examples:]
  17
  18 angle_style cosine/periodic
  19 angle_coeff * 75.0 1 6 :pre
  20
  21 [Description:]
  22
  23 The {cosine/periodic} angle style uses the following potential, which
  24 is commonly used in the "DREIDING"_Section_howto.html#howto_4 force
  25 field, particularly for organometallic systems where {n} = 4 might be
  26 used for an octahedral complex and {n} = 3 might be used for a
  27 trigonal center:
  28
  29 :c,image(Eqs/angle_cosine_periodic.jpg)
  30
  31 where C, B and n are coefficients defined for each angle type.
  32
  33 See "(Mayo)"_#cosine-Mayo for a description of the DREIDING force field
  34
  35 The following coefficients must be defined for each angle type via the
  36 "angle_coeff"_angle_coeff.html command as in the example above, or in
  37 the data file or restart files read by the "read_data"_read_data.html
  38 or "read_restart"_read_restart.html commands:
  39
  40 C (energy)
  41 B = 1 or -1
  42 n = 1, 2, 3, 4, 5 or 6 for periodicity :ul
  43
  44 Note that the prefactor C is specified and not the overall force
  45 constant K = C / n^2.  When B = 1, it leads to a minimum for the
  46 linear geometry.  When B = -1, it leads to a maximum for the linear
  47 geometry.
  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 angle 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 "angle_coeff"_angle_coeff.html
  83
  84 [Default:] none
  85
  86 :line
  87
  88 :link(cosine-Mayo)
  89 [(Mayo)] Mayo, Olfason, Goddard III, J Phys Chem, 94, 8897-8909
  90 (1990).