doc/src/improper_coeff.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_coeff command :h3
  10
  11 [Syntax:]
  12
  13 improper_coeff N args :pre
  14
  15 N = improper type (see asterisk form below)
  16 args = coefficients for one or more improper types :ul
  17
  18 [Examples:]
  19
  20 improper_coeff 1 300.0 0.0
  21 improper_coeff * 80.2 -1 2
  22 improper_coeff *4 80.2 -1 2 :pre
  23
  24 [Description:]
  25
  26 Specify the improper force field coefficients for one or more improper
  27 types.  The number and meaning of the coefficients depends on the
  28 improper style.  Improper coefficients can also be set in the data
  29 file read by the "read_data"_read_data.html command or in a restart
  30 file.
  31
  32 N can be specified in one of two ways.  An explicit numeric value can
  33 be used, as in the 1st example above.  Or a wild-card asterisk can be
  34 used to set the coefficients for multiple improper types.  This takes
  35 the form "*" or "*n" or "n*" or "m*n".  If N = the number of improper
  36 types, then an asterisk with no numeric values means all types from 1
  37 to N.  A leading asterisk means all types from 1 to n (inclusive).  A
  38 trailing asterisk means all types from n to N (inclusive).  A middle
  39 asterisk means all types from m to n (inclusive).
  40
  41 Note that using an improper_coeff command can override a previous
  42 setting for the same improper type.  For example, these commands set
  43 the coeffs for all improper types, then overwrite the coeffs for just
  44 improper type 2:
  45
  46 improper_coeff * 300.0 0.0
  47 improper_coeff 2 50.0 0.0 :pre
  48
  49 A line in a data file that specifies improper coefficients uses the
  50 exact same format as the arguments of the improper_coeff command in an
  51 input script, except that wild-card asterisks should not be used since
  52 coefficients for all N types must be listed in the file.  For example,
  53 under the "Improper Coeffs" section of a data file, the line that
  54 corresponds to the 1st example above would be listed as
  55
  56 1 300.0 0.0 :pre
  57
  58 The "improper_style class2"_improper_class2.html is an exception to
  59 this rule, in that an additional argument is used in the input script
  60 to allow specification of the cross-term coefficients.  See its doc
  61 page for details.
  62
  63 :line
  64
  65 Here is an alphabetic list of improper styles defined in LAMMPS.  Click on
  66 the style to display the formula it computes and coefficients
  67 specified by the associated "improper_coeff"_improper_coeff.html command.
  68
  69 Note that there are also additional improper styles submitted by users
  70 which are included in the LAMMPS distribution.  The list of these with
  71 links to the individual styles are given in the improper section of
  72 "this page"_Section_commands.html#cmd_5.
  73
  74 "improper_style none"_improper_none.html - turn off improper interactions
  75 "improper_style hybrid"_improper_hybrid.html - define multiple styles of improper interactions :ul
  76
  77 "improper_style class2"_improper_class2.html - COMPASS (class 2) improper
  78 "improper_style cvff"_improper_cvff.html - CVFF improper
  79 "improper_style harmonic"_improper_harmonic.html - harmonic improper
  80 "improper_style umbrella"_improper_umbrella.html - DREIDING improper :ul
  81
  82 :line
  83
  84 [Restrictions:]
  85
  86 This command must come after the simulation box is defined by a
  87 "read_data"_read_data.html, "read_restart"_read_restart.html, or
  88 "create_box"_create_box.html command.
  89
  90 An improper style must be defined before any improper coefficients are
  91 set, either in the input script or in a data file.
  92
  93 [Related commands:]
  94
  95 "improper_style"_improper_style.html
  96
  97 [Default:] none