doc/src/improper_style.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 command :h3
  10
  11 [Syntax:]
  12
  13 improper_style style :pre
  14
  15 style = {none} or {hybrid} or {class2} or {cvff} or {harmonic} :ul
  16
  17 [Examples:]
  18
  19 improper_style harmonic
  20 improper_style cvff
  21 improper_style hybrid cvff harmonic :pre
  22
  23 [Description:]
  24
  25 Set the formula(s) LAMMPS uses to compute improper interactions
  26 between quadruplets of atoms, which remain in force for the duration
  27 of the simulation.  The list of improper quadruplets is read in by a
  28 "read_data"_read_data.html or "read_restart"_read_restart.html command
  29 from a data or restart file.  Note that the ordering of the 4 atoms in
  30 an improper quadruplet determines the definition of the improper
  31 angle used in the formula for each style.  See the doc pages of
  32 individual styles for details.
  33
  34 Hybrid models where impropers are computed using different improper
  35 potentials can be setup using the {hybrid} improper style.
  36
  37 The coefficients associated with an improper style can be specified in
  38 a data or restart file or via the "improper_coeff"_improper_coeff.html
  39 command.
  40
  41 All improper potentials store their coefficient data in binary restart
  42 files which means improper_style and
  43 "improper_coeff"_improper_coeff.html commands do not need to be
  44 re-specified in an input script that restarts a simulation.  See the
  45 "read_restart"_read_restart.html command for details on how to do
  46 this.  The one exception is that improper_style {hybrid} only stores
  47 the list of sub-styles in the restart file; improper coefficients need
  48 to be re-specified.
  49
  50 NOTE: When both an improper and pair style is defined, the
  51 "special_bonds"_special_bonds.html command often needs to be used to
  52 turn off (or weight) the pairwise interaction that would otherwise
  53 exist between a group of 4 bonded atoms.
  54
  55 :line
  56
  57 Here is an alphabetic list of improper styles defined in LAMMPS.
  58 Click on the style to display the formula it computes and coefficients
  59 specified by the associated "improper_coeff"_improper_coeff.html
  60 command.
  61
  62 Note that there are also additional improper styles submitted by users
  63 which are included in the LAMMPS distribution.  The list of these with
  64 links to the individual styles are given in the improper section of
  65 "this page"_Section_commands.html#cmd_5.
  66
  67 "improper_style none"_improper_none.html - turn off improper interactions
  68 "improper_style zero"_improper_zero.html - topology but no interactions
  69 "improper_style hybrid"_improper_hybrid.html - define multiple styles of improper interactions :ul
  70
  71 "improper_style class2"_improper_class2.html - COMPASS (class 2) improper
  72 "improper_style cvff"_improper_cvff.html - CVFF improper
  73 "improper_style harmonic"_improper_harmonic.html - harmonic improper
  74 "improper_style umbrella"_improper_umbrella.html - DREIDING improper :ul
  75
  76 :line
  77
  78 [Restrictions:]
  79
  80 Improper styles can only be set for atom_style choices that allow
  81 impropers to be defined.
  82
  83 Most improper styles are part of the MOLECULE package.  They are only
  84 enabled if LAMMPS was built with that package.  See the "Making
  85 LAMMPS"_Section_start.html#start_3 section for more info on packages.
  86 The doc pages for individual improper potentials tell if it is part of
  87 a package.
  88
  89 [Related commands:]
  90
  91 "improper_coeff"_improper_coeff.html
  92
  93 [Default:]
  94
  95 improper_style none :pre