doc/src/pair_buck.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 pair_style buck command :h3
  10 pair_style buck/gpu command :h3
  11 pair_style buck/intel command :h3
  12 pair_style buck/kk command :h3
  13 pair_style buck/omp command :h3
  14 pair_style buck/coul/cut command :h3
  15 pair_style buck/coul/cut/gpu command :h3
  16 pair_style buck/coul/cut/intel command :h3
  17 pair_style buck/coul/cut/kk command :h3
  18 pair_style buck/coul/cut/omp command :h3
  19 pair_style buck/coul/long command :h3
  20 pair_style buck/coul/long/cs command :h3
  21 pair_style buck/coul/long/gpu command :h3
  22 pair_style buck/coul/long/intel command :h3
  23 pair_style buck/coul/long/kk command :h3
  24 pair_style buck/coul/long/omp command :h3
  25 pair_style buck/coul/msm command :h3
  26 pair_style buck/coul/msm/omp command :h3
  27
  28 [Syntax:]
  29
  30 pair_style style args :pre
  31
  32 style = {buck} or {buck/coul/cut} or {buck/coul/long} or {buck/coul/long/cs} or {buck/coul/msm}
  33 args = list of arguments for a particular style :ul
  34   {buck} args = cutoff
  35     cutoff = global cutoff for Buckingham interactions (distance units)
  36   {buck/coul/cut} args = cutoff (cutoff2)
  37     cutoff = global cutoff for Buckingham (and Coulombic if only 1 arg) (distance units)
  38     cutoff2 = global cutoff for Coulombic (optional) (distance units)
  39   {buck/coul/long} or {buck/coul/long/cs} args = cutoff (cutoff2)
  40     cutoff = global cutoff for Buckingham (and Coulombic if only 1 arg) (distance units)
  41     cutoff2 = global cutoff for Coulombic (optional) (distance units)
  42   {buck/coul/msm} args = cutoff (cutoff2)
  43     cutoff = global cutoff for Buckingham (and Coulombic if only 1 arg) (distance units)
  44     cutoff2 = global cutoff for Coulombic (optional) (distance units) :pre
  45
  46 [Examples:]
  47
  48 pair_style buck 2.5
  49 pair_coeff * * 100.0 1.5 200.0
  50 pair_coeff * * 100.0 1.5 200.0 3.0 :pre
  51
  52 pair_style buck/coul/cut 10.0
  53 pair_style buck/coul/cut 10.0 8.0
  54 pair_coeff * * 100.0 1.5 200.0
  55 pair_coeff 1 1 100.0 1.5 200.0 9.0
  56 pair_coeff 1 1 100.0 1.5 200.0 9.0 8.0 :pre
  57
  58 pair_style buck/coul/long 10.0
  59 pair_style buck/coul/long/cs 10.0
  60 pair_style buck/coul/long 10.0 8.0
  61 pair_style buck/coul/long/cs 10.0 8.0
  62 pair_coeff * * 100.0 1.5 200.0
  63 pair_coeff 1 1 100.0 1.5 200.0 9.0 :pre
  64
  65 pair_style buck/coul/msm 10.0
  66 pair_style buck/coul/msm 10.0 8.0
  67 pair_coeff * * 100.0 1.5 200.0
  68 pair_coeff 1 1 100.0 1.5 200.0 9.0 :pre
  69
  70 [Description:]
  71
  72 The {buck} style computes a Buckingham potential (exp/6 instead of
  73 Lennard-Jones 12/6) given by
  74
  75 :c,image(Eqs/pair_buck.jpg)
  76
  77 where rho is an ionic-pair dependent length parameter, and Rc is the
  78 cutoff on both terms.
  79
  80 The styles with {coul/cut} or {coul/long} or {coul/msm} add a
  81 Coulombic term as described for the "lj/cut"_pair_lj.html pair styles.
  82 For {buck/coul/long} and {buc/coul/msm}, an additional damping factor
  83 is applied to the Coulombic term so it can be used in conjunction with
  84 the "kspace_style"_kspace_style.html command and its {ewald} or {pppm}
  85 or {msm} option.  The Coulombic cutoff specified for this style means
  86 that pairwise interactions within this distance are computed directly;
  87 interactions outside that distance are computed in reciprocal space.
  88
  89 If one cutoff is specified for the {born/coul/cut} and
  90 {born/coul/long} and {born/coul/msm} styles, it is used for both the
  91 A,C and Coulombic terms.  If two cutoffs are specified, the first is
  92 used as the cutoff for the A,C terms, and the second is the cutoff for
  93 the Coulombic term.
  94
  95 Style {buck/coul/long/cs} is identical to {buck/coul/long} except that
  96 a term is added for the "core/shell model"_Section_howto.html#howto_25
  97 to allow charges on core and shell particles to be separated by r =
  98 0.0.
  99
 100 Note that these potentials are related to the "Born-Mayer-Huggins
 101 potential"_pair_born.html.
 102
 103 NOTE: For all these pair styles, the terms with A and C are always
 104 cutoff.  The additional Coulombic term can be cutoff or long-range (no
 105 cutoff) depending on whether the style name includes coul/cut or
 106 coul/long or coul/msm.  If you wish the C/r^6 term to be long-range
 107 (no cutoff), then see the "pair_style
 108 buck/long/coul/long"_pair_buck_long.html command.
 109
 110 The following coefficients must be defined for each pair of atoms
 111 types via the "pair_coeff"_pair_coeff.html command as in the examples
 112 above, or in the data file or restart files read by the
 113 "read_data"_read_data.html or "read_restart"_read_restart.html
 114 commands:
 115
 116 A (energy units)
 117 rho (distance units)
 118 C (energy-distance^6 units)
 119 cutoff (distance units)
 120 cutoff2 (distance units) :ul
 121
 122 The second coefficient, rho, must be greater than zero.
 123
 124 The latter 2 coefficients are optional.  If not specified, the global
 125 A,C and Coulombic cutoffs are used.  If only one cutoff is specified,
 126 it is used as the cutoff for both A,C and Coulombic interactions for
 127 this type pair.  If both coefficients are specified, they are used as
 128 the A,C and Coulombic cutoffs for this type pair.  You cannot specify
 129 2 cutoffs for style {buck}, since it has no Coulombic terms.
 130
 131 For {buck/coul/long} only the LJ cutoff can be specified since a
 132 Coulombic cutoff cannot be specified for an individual I,J type pair.
 133 All type pairs use the same global Coulombic cutoff specified in the
 134 pair_style command.
 135
 136 :line
 137
 138 Styles with a {gpu}, {intel}, {kk}, {omp}, or {opt} suffix are
 139 functionally the same as the corresponding style without the suffix.
 140 They have been optimized to run faster, depending on your available
 141 hardware, as discussed in "Section 5"_Section_accelerate.html
 142 of the manual.  The accelerated styles take the same arguments and
 143 should produce the same results, except for round-off and precision
 144 issues.
 145
 146 These accelerated styles are part of the GPU, USER-INTEL, KOKKOS,
 147 USER-OMP and OPT packages, respectively.  They are only enabled if
 148 LAMMPS was built with those packages.  See the "Making
 149 LAMMPS"_Section_start.html#start_3 section for more info.
 150
 151 You can specify the accelerated styles explicitly in your input script
 152 by including their suffix, or you can use the "-suffix command-line
 153 switch"_Section_start.html#start_7 when you invoke LAMMPS, or you can
 154 use the "suffix"_suffix.html command in your input script.
 155
 156 See "Section 5"_Section_accelerate.html of the manual for
 157 more instructions on how to use the accelerated styles effectively.
 158
 159 :line
 160
 161 [Mixing, shift, table, tail correction, restart, rRESPA info]:
 162
 163 These pair styles do not support mixing.  Thus, coefficients for all
 164 I,J pairs must be specified explicitly.
 165
 166 These styles support the "pair_modify"_pair_modify.html shift option
 167 for the energy of the exp() and 1/r^6 portion of the pair interaction.
 168
 169 The {buck/coul/long} pair style supports the
 170 "pair_modify"_pair_modify.html table option to tabulate the
 171 short-range portion of the long-range Coulombic interaction.
 172
 173 These styles support the pair_modify tail option for adding long-range
 174 tail corrections to energy and pressure for the A,C terms in the
 175 pair interaction.
 176
 177 These styles write their information to "binary restart
 178 files"_restart.html, so pair_style and pair_coeff commands do not need
 179 to be specified in an input script that reads a restart file.
 180
 181 These styles can only be used via the {pair} keyword of the "run_style
 182 respa"_run_style.html command.  They do not support the {inner},
 183 {middle}, {outer} keywords.
 184
 185 [Restrictions:]
 186
 187 The {buck/coul/long} style is part of the KSPACE package.  The
 188 {buck/coul/long/cs} style is part of the CORESHELL package.  They are
 189 only enabled if LAMMPS was built with that package.  See the
 190 "Making LAMMPS"_Section_start.html#start_3 section for more info.
 191
 192 [Related commands:]
 193
 194 "pair_coeff"_pair_coeff.html, "pair_style born"_pair_born.html
 195
 196 [Default:] none