git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@14950 f3b2605a-c512-4ea7-a41b-209d697bcdaa

doc/html/_sources/box.txt

@@ -0,0 +1,73 @@
+.. index:: box
+
+box command
+===========
+
+Syntax
+""""""
+
+.. parsed-literal::
+
+   box keyword value ...
+
+* one or more keyword/value pairs may be appended
+* keyword = *tilt*
+.. parsed-literal::
+
+     *tilt* value = *small* or *large*
+
+
+
+Examples
+""""""""
+
+.. parsed-literal::
+
+   box tilt large
+   box tilt small
+
+Description
+"""""""""""
+
+Set attributes of the simulation box.
+
+For triclinic (non-orthogonal) simulation boxes, the *tilt* keyword
+allows simulation domains to be created with arbitrary tilt factors,
+e.g. via the :doc:`create_box <create_box>` or
+:doc:`read_data <read_data>` commands.  Tilt factors determine how
+skewed the triclinic box is; see :ref:`this section <howto_12>` of the manual for a discussion of
+triclinic boxes in LAMMPS.
+
+LAMMPS normally requires that no tilt factor can skew the box more
+than half the distance of the parallel box length, which is the 1st
+dimension in the tilt factor (x for xz).  If *tilt* is set to
+*small*\ , which is the default, then an error will be
+generated if a box is created which exceeds this limit.  If *tilt*
+is set to *large*\ , then no limit is enforced.  You can create
+a box with any tilt factors you wish.
+
+Note that if a simulation box has a large tilt factor, LAMMPS will run
+less efficiently, due to the large volume of communication needed to
+acquire ghost atoms around a processor's irregular-shaped sub-domain.
+For extreme values of tilt, LAMMPS may also lose atoms and generate an
+error.
+
+Restrictions
+""""""""""""
+
+
+This command cannot be used after the simulation box is defined by a
+:doc:`read_data <read_data>` or :doc:`create_box <create_box>` command or
+:doc:`read_restart <read_restart>` command.
+
+**Related commands:** none
+
+Default
+"""""""
+
+The default value is tilt = small.
+
+
+.. _lws: http://lammps.sandia.gov
+.. _ld: Manual.html
+.. _lc: Section_commands.html#comm