.TH gmx-mindist 1 "" "VERSION 5.0.2" "GROMACS Manual"
.SH NAME
gmx-mindist \- Calculate the minimum distance between two groups

.SH SYNOPSIS
gmx mindist [\-f [<.xtc/.trr/...>]] [\-s [<.tpr/.tpb/...>]]
            [\-n [<.ndx>]] [\-od [<.xvg>]] [\-on [<.xvg>]] [\-o [<.out>]]
            [\-ox [<.xtc/.trr/...>]] [\-or [<.xvg>]] [\-nice <int>]
            [\-b <time>] [\-e <time>] [\-dt <time>] [\-tu <enum>]
            [\-[no]w] [\-xvg <enum>] [\-[no]matrix] [\-[no]max]
            [\-d <real>] [\-[no]group] [\-[no]pi] [\-[no]split]
            [\-ng <int>] [\-[no]pbc] [\-[no]respertime]
            [\-[no]printresname]

.SH DESCRIPTION
\fBgmx mindist\fR computes the distance between one group and a number of other groups. Both the minimum distance (between any pair of atoms from the respective groups) and the number of contacts within a given distance are written to two separate output files. With the \fB\-group\fR option a contact of an atom in another group with multiple atoms in the first group is counted as one contact instead of as multiple contacts. With \fB\-or\fR, minimum distances to each residue in the first group are determined and plotted as a function of residue number.

With option \fB\-pi\fR the minimum distance of a group to its periodic image is plotted. This is useful for checking if a protein has seen its periodic image during a simulation. Only one shift in each direction is considered, giving a total of 26 shifts. It also plots the maximum distance within the group and the lengths of the three box vectors.

Also \fBgmx distance\fR calculates distances.

.SH OPTIONS
Options to specify input and output files:

.BI "\-f" " [<.xtc/.trr/...>] (traj.xtc) (Input)"
    Trajectory: xtc trr cpt trj gro g96 pdb tng

.BI "\-s" " [<.tpr/.tpb/...>] (topol.tpr) (Input, Optional)"
    Structure+mass(db): tpr tpb tpa gro g96 pdb brk ent

.BI "\-n" " [<.ndx>] (index.ndx) (Input, Optional)"
    Index file

.BI "\-od" " [<.xvg>] (mindist.xvg) (Output)"
    xvgr/xmgr file

.BI "\-on" " [<.xvg>] (numcont.xvg) (Output, Optional)"
    xvgr/xmgr file

.BI "\-o" " [<.out>] (atm-pair.out) (Output, Optional)"
    Generic output file

.BI "\-ox" " [<.xtc/.trr/...>] (mindist.xtc) (Output, Optional)"
    Trajectory: xtc trr trj gro g96 pdb tng

.BI "\-or" " [<.xvg>] (mindistres.xvg) (Output, Optional)"
    xvgr/xmgr file


Other options:

.BI "\-nice" " <int> (19)"
    Set the nicelevel

.BI "\-b" " <time> (0)"
    First frame (ps) to read from trajectory

.BI "\-e" " <time> (0)"
    Last frame (ps) to read from trajectory

.BI "\-dt" " <time> (0)"
    Only use frame when t MOD dt = first time (ps)

.BI "\-tu" " <enum> (ps)"
    Time unit: fs, ps, ns, us, ms, s

.BI "\-[no]w" "  (no)"
    View output \fB.xvg\fR, \fB.xpm\fR, \fB.eps\fR and \fB.pdb\fR files

.BI "\-xvg" " <enum> (xmgrace)"
    xvg plot formatting: xmgrace, xmgr, none

.BI "\-[no]matrix" "  (no)"
    Calculate half a matrix of group\-group distances

.BI "\-[no]max" "  (no)"
    Calculate *maximum* distance instead of minimum

.BI "\-d" " <real> (0.6)"
    Distance for contacts

.BI "\-[no]group" "  (no)"
    Count contacts with multiple atoms in the first group as one

.BI "\-[no]pi" "  (no)"
    Calculate minimum distance with periodic images

.BI "\-[no]split" "  (no)"
    Split graph where time is zero

.BI "\-ng" " <int> (1)"
    Number of secondary groups to compute distance to a central group

.BI "\-[no]pbc" "  (yes)"
    Take periodic boundary conditions into account

.BI "\-[no]respertime" "  (no)"
    When writing per\-residue distances, write distance for each time point

.BI "\-[no]printresname" "  (no)"
    Write residue names


.SH SEE ALSO
.BR gromacs(7)

More information about \fBGROMACS\fR is available at <\fIhttp://www.gromacs.org/\fR>.