doc/src/pair_lcbop.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 lcbop command :h3
  10
  11 [Syntax:]
  12
  13 pair_style lcbop :pre
  14
  15 [Examples:]
  16
  17 pair_style lcbop
  18 pair_coeff * * ../potentials/C.lcbop C :pre
  19
  20 [Description:]
  21
  22 The {lcbop} pair style computes the long-range bond-order potential
  23 for carbon (LCBOP) of "(Los and Fasolino)"_#Los.  See section II in
  24 that paper for the analytic equations associated with the potential.
  25
  26 Only a single pair_coeff command is used with the {lcbop} style which
  27 specifies an LCBOP potential file with parameters for specific
  28 elements.  These are mapped to LAMMPS atom types by specifying N
  29 additional arguments after the filename in the pair_coeff command,
  30 where N is the number of LAMMPS atom types:
  31
  32 filename
  33 N element names = mapping of LCBOP elements to atom types :ul
  34
  35 See the "pair_coeff"_pair_coeff.html doc page for alternate ways
  36 to specify the path for the potential file.
  37
  38 As an example, if your LAMMPS simulation has 4 atom types and you want
  39 the 1st 3 to be C you would use the following pair_coeff command:
  40
  41 pair_coeff * * C.lcbop C C C NULL :pre
  42
  43 The 1st 2 arguments must be * * so as to span all LAMMPS atom types.
  44 The first C argument maps LAMMPS atom type 1 to the C element in the
  45 LCBOP file. If a mapping value is specified as NULL, the mapping is
  46 not performed.  This can be used when a {lcbop} potential is used as
  47 part of the {hybrid} pair style.  The NULL values are placeholders for
  48 atom types that will be used with other potentials.
  49
  50 The parameters/coefficients for the LCBOP potential as applied to C
  51 are listed in the C.lcbop file to agree with the original "(Los and
  52 Fasolino)"_#Los paper.  Thus the parameters are specific to this
  53 potential and the way it was fit, so modifying the file should be done
  54 carefully.
  55
  56 :line
  57
  58 [Mixing, shift, table, tail correction, restart, rRESPA info]:
  59
  60 This pair style does not support the "pair_modify"_pair_modify.html
  61 mix, shift, table, and tail options.
  62
  63 This pair style does not write its information to "binary restart
  64 files"_restart.html, since it is stored in potential files.  Thus, you
  65 need to re-specify the pair_style and pair_coeff commands in an input
  66 script that reads a restart file.
  67
  68 This pair style can only be used via the {pair} keyword of the
  69 "run_style respa"_run_style.html command.  It does not support the
  70 {inner}, {middle}, {outer} keywords.
  71
  72 [Restrictions:]
  73
  74 This pair styles is part of the MANYBODY package.  It is only enabled
  75 if LAMMPS was built with that package.  See
  76 the "Making LAMMPS"_Section_start.html#start_3 section for more info.
  77
  78 This pair potential requires the "newton"_newton.html setting to be
  79 "on" for pair interactions.
  80
  81 The C.lcbop potential file provided with LAMMPS (see the potentials
  82 directory) is parameterized for metal "units"_units.html.  You can use
  83 the LCBOP potential with any LAMMPS units, but you would need to
  84 create your own LCBOP potential file with coefficients listed in the
  85 appropriate units if your simulation doesn't use "metal" units.
  86
  87 [Related commands:]
  88
  89 "pair_airebo"_pair_airebo.html, "pair_coeff"_pair_coeff.html
  90
  91 [Default:] none
  92
  93 :line
  94
  95 :link(Los)
  96 [(Los and Fasolino)] J. H. Los and A. Fasolino, Phys. Rev. B 68, 024107
  97 (2003).