:orphan:

.. index:: create_box

.. _create-box:

.. _create-box-command:

##################
create_box command
##################

.. _create-box-syntax:

*******
Syntax:
*******

::

   create_box xlo xhi ylo yhi zlo zhi

::

   xlo,xhi = box bounds in the x dimension (distance units)
   ylo,yhi = box bounds in the y dimension (distance units)
   zlo,zhi = box bounds in the z dimension (distance units)

.. _create-box-examples:

*********
Examples:
*********

::

   create_box 0 1 0 1 0 1
   create_box 0 1 0 1 -0.5 0.5
   create_box 0 10.0 0 5.0 -4.0 0.0

.. _create-box-descriptio:

************
Description:
************

Set the size of the simulation box.

For a 2d simulation, as specifed by the :ref:`dimension<dimension>`
command, *zlo* < 0.0 and *zhi* > 0.0 is required.  This means the z
dimensions straddle 0.0.  Typical values are -0.5 and 0.5, but this is
not required.  See :ref:`Section 6.1<howto-2d-simulation>` of the
manual for more information about 2d simulations.

For 2d axisymmetric simulations, as set by the
:ref:`dimension<dimension>` and :ref:`boundary<boundary>` commands, the
ylo setting must be 0.0.  See :ref:`Section 6.2<howto-axisymmetr-simulation>`
of the manual for more information about axisymmetric simulations.

.. _create-box-restrictio:

*************
Restrictions:
*************

none

.. _create-box-related-commands:

*****************
Related commands:
*****************

none

.. _create-box-default:

********
Default:
********

none