.TH gmx-disre 1 "" "VERSION 5.0.2" "GROMACS Manual"
.SH NAME
gmx-disre \- Analyze distance restraints

.SH SYNOPSIS
gmx disre [\-s [<.tpr/.tpb/...>]] [\-f [<.xtc/.trr/...>]]
          [\-ds [<.xvg>]] [\-da [<.xvg>]] [\-dn [<.xvg>]] [\-dm [<.xvg>]]
          [\-dr [<.xvg>]] [\-l [<.log>]] [\-n [<.ndx>]] [\-q [<.pdb>]]
          [\-c [<.ndx>]] [\-x [<.xpm>]] [\-nice <int>] [\-b <time>]
          [\-e <time>] [\-dt <time>] [\-[no]w] [\-xvg <enum>]
          [\-ntop <int>] [\-maxdr <real>] [\-nlevels <int>] [\-[no]third]

.SH DESCRIPTION
\fBgmx disre\fR computes violations of distance restraints. If necessary, all protons can be added to a protein molecule using the \fBgmx protonate\fR program.

The program always computes the instantaneous violations rather than time\-averaged, because this analysis is done from a trajectory file afterwards it does not make sense to use time averaging. However, the time averaged values per restraint are given in the log file.

An index file may be used to select specific restraints for printing.

When the optional \fB\-q\fR flag is given a \fB.pdb\fR file coloured by the amount of average violations.

When the \fB\-c\fR option is given, an index file will be read containing the frames in your trajectory corresponding to the clusters (defined in another manner) that you want to analyze. For these clusters the program will compute average violations using the third power averaging algorithm and print them in the log file.

.SH OPTIONS
Options to specify input and output files:

.BI "\-s" " [<.tpr/.tpb/...>] (topol.tpr) (Input)"
    Run input file: tpr tpb tpa

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

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

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

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

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

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

.BI "\-l" " [<.log>] (disres.log) (Output)"
    Log file

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

.BI "\-q" " [<.pdb>] (viol.pdb) (Output, Optional)"
    Protein data bank file

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

.BI "\-x" " [<.xpm>] (matrix.xpm) (Output, Optional)"
    X PixMap compatible matrix 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 "\-[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 "\-ntop" " <int> (0)"
    Number of large violations that are stored in the log file every step

.BI "\-maxdr" " <real> (0)"
    Maximum distance violation in matrix output. If less than or equal to 0 the maximum will be determined by the data.

.BI "\-nlevels" " <int> (20)"
    Number of levels in the matrix output

.BI "\-[no]third" "  (yes)"
    Use inverse third power averaging or linear for matrix output


.SH SEE ALSO
.BR gromacs(7)

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