.. 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_7>` of the manual for a discussion of
triclinic boxes in LIGGGHTS(R)-PUBLIC.

LIGGGHTS(R)-PUBLIC 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, LIGGGHTS(R)-PUBLIC 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, LIGGGHTS(R)-PUBLIC 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.


.. _liws: http://www.cfdem.com
.. _ld: Manual.html
.. _lc: Section_commands.html#comm