doc/src/box.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 box command :h3
  10
  11 [Syntax:]
  12
  13 box keyword value ... :pre
  14
  15 one or more keyword/value pairs may be appended :ulb,l
  16 keyword = {tilt} :l
  17   {tilt} value = {small} or {large} :pre
  18 :ule
  19
  20 [Examples:]
  21
  22 box tilt large
  23 box tilt small :pre
  24
  25 [Description:]
  26
  27 Set attributes of the simulation box.
  28
  29 For triclinic (non-orthogonal) simulation boxes, the {tilt} keyword
  30 allows simulation domains to be created with arbitrary tilt factors,
  31 e.g. via the "create_box"_create_box.html or
  32 "read_data"_read_data.html commands.  Tilt factors determine how
  33 skewed the triclinic box is; see "this
  34 section"_Section_howto.html#howto_12 of the manual for a discussion of
  35 triclinic boxes in LAMMPS.
  36
  37 LAMMPS normally requires that no tilt factor can skew the box more
  38 than half the distance of the parallel box length, which is the 1st
  39 dimension in the tilt factor (x for xz).  If {tilt} is set to
  40 {small}, which is the default, then an error will be
  41 generated if a box is created which exceeds this limit.  If {tilt}
  42 is set to {large}, then no limit is enforced.  You can create
  43 a box with any tilt factors you wish.
  44
  45 Note that if a simulation box has a large tilt factor, LAMMPS will run
  46 less efficiently, due to the large volume of communication needed to
  47 acquire ghost atoms around a processor's irregular-shaped sub-domain.
  48 For extreme values of tilt, LAMMPS may also lose atoms and generate an
  49 error.
  50
  51 [Restrictions:]
  52
  53 This command cannot be used after the simulation box is defined by a
  54 "read_data"_read_data.html or "create_box"_create_box.html command or
  55 "read_restart"_read_restart.html command.
  56
  57 [Related commands:] none
  58
  59 [Default:]
  60
  61 The default value is tilt = small.