.. _gmx genconf:

gmx genconf
===========
Synopsis
--------
.. parsed-literal::

    gmx genconf [:strong:`-f` :emphasis:`[<.gro/.g96/...>]`] [:strong:`-trj` :emphasis:`[<.xtc/.trr/...>]`]
                [:strong:`-o` :emphasis:`[<.gro/.g96/...>]`] [:strong:`-nbox` :emphasis:`<vector>`] [:strong:`-dist` :emphasis:`<vector>`]
                [:strong:`-seed` :emphasis:`<int>`] [:strong:`-[no]rot`] [:strong:`-[no]shuffle`] [:strong:`-[no]sort`]
                [:strong:`-block` :emphasis:`<int>`] [:strong:`-nmolat` :emphasis:`<int>`] [:strong:`-maxrot` :emphasis:`<vector>`]
                [:strong:`-[no]renumber`]

Description
-----------
``gmx genconf`` multiplies a given coordinate file by simply stacking them
on top of each other, like a small child playing with wooden blocks.
The program makes a grid of *user-defined*
proportions (``-nbox``),
and interspaces the grid point with an extra space ``-dist``.

When option ``-rot`` is used the program does not check for overlap
between molecules on grid points. It is recommended to make the box in
the input file at least as big as the coordinates +
van der Waals radius.

If the optional trajectory file is given, conformations are not
generated, but read from this file and translated appropriately to
build the grid.

Options
-------
Options to specify input files:

``-f`` [<.gro/.g96/...>] (conf.gro)
    Structure file: :ref:`gro` :ref:`g96` :ref:`pdb` brk ent esp :ref:`tpr`
``-trj`` [<.xtc/.trr/...>] (traj.xtc) (Optional)
    Trajectory: :ref:`xtc` :ref:`trr` :ref:`cpt` :ref:`gro` :ref:`g96` :ref:`pdb` :ref:`tng`

Options to specify output files:

``-o`` [<.gro/.g96/...>] (out.gro)
    Structure file: :ref:`gro` :ref:`g96` :ref:`pdb` brk ent esp

Other options:

``-nbox`` <vector> (1 1 1)
    Number of boxes
``-dist`` <vector> (0 0 0)
    Distance between boxes
``-seed`` <int> (0)
    Random generator seed, if 0 generated from the time
``-[no]rot``  (no)
    Randomly rotate conformations
``-[no]shuffle``  (no)
    Random shuffling of molecules
``-[no]sort``  (no)
    Sort molecules on X coord
``-block`` <int> (1)
    Divide the box in blocks on this number of cpus
``-nmolat`` <int> (3)
    Number of atoms per molecule, assumed to start from 0. If you set this wrong, it will screw up your system!
``-maxrot`` <vector> (180 180 180)
    Maximum random rotation
``-[no]renumber``  (yes)
    Renumber residues

Known Issues
------------
* The program should allow for random displacement of lattice points.

.. only:: man

   See also
   --------

   :manpage:`gmx(1)`

   More information about |Gromacs| is available at <http://www.gromacs.org/>.