.TH gmx-angle 1 "" "VERSION 5.0.2" "GROMACS Manual"
.SH NAME
gmx-angle \- Calculate distributions and correlations for angles and dihedrals

.SH SYNOPSIS
gmx angle [\-f [<.xtc/.trr/...>]] [\-n [<.ndx>]] [\-od [<.xvg>]]
          [\-ov [<.xvg>]] [\-of [<.xvg>]] [\-ot [<.xvg>]] [\-oh [<.xvg>]]
          [\-oc [<.xvg>]] [\-or [<.trr>]] [\-nice <int>] [\-b <time>]
          [\-e <time>] [\-dt <time>] [\-[no]w] [\-xvg <enum>]
          [\-type <enum>] [\-[no]all] [\-binwidth <real>]
          [\-[no]periodic] [\-[no]chandler] [\-[no]avercorr]
          [\-acflen <int>] [\-[no]normalize] [\-P <enum>]
          [\-fitfn <enum>] [\-beginfit <real>] [\-endfit <real>]

.SH DESCRIPTION
\fBgmx angle\fR computes the angle distribution for a number of angles or dihedrals.

With option \fB\-ov\fR, you can plot the average angle of a group of angles as a function of time. With the \fB\-all\fR option, the first graph is the average and the rest are the individual angles.

With the \fB\-of\fR option, \fBgmx angle\fR also calculates the fraction of trans dihedrals (only for dihedrals) as function of time, but this is probably only fun for a select few.

With option \fB\-oc\fR, a dihedral correlation function is calculated.

It should be noted that the index file must contain atom triplets for angles or atom quadruplets for dihedrals. If this is not the case, the program will crash.

With option \fB\-or\fR, a trajectory file is dumped containing cos and sin of selected dihedral angles, which subsequently can be used as input for a principal components analysis using \fBgmx covar\fR.

Option \fB\-ot\fR plots when transitions occur between dihedral rotamers of multiplicity 3 and \fB\-oh\fR records a histogram of the times between such transitions, assuming the input trajectory frames are equally spaced in time.

.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 "\-n" " [<.ndx>] (angle.ndx) (Input)"
    Index file

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

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

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

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

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

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

.BI "\-or" " [<.trr>] (traj.trr) (Output, Optional)"
    Trajectory in portable xdr format


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 "\-type" " <enum> (angle)"
    Type of angle to analyse: angle, dihedral, improper, ryckaert\-bellemans

.BI "\-[no]all" "  (no)"
    Plot all angles separately in the averages file, in the order of appearance in the index file.

.BI "\-binwidth" " <real> (1)"
    binwidth (degrees) for calculating the distribution

.BI "\-[no]periodic" "  (yes)"
    Print dihedral angles modulo 360 degrees

.BI "\-[no]chandler" "  (no)"
    Use Chandler correlation function (N[trans] = 1, N[gauche] = 0) rather than cosine correlation function. Trans is defined as phi  \-60 or phi  60.

.BI "\-[no]avercorr" "  (no)"
    Average the correlation functions for the individual angles/dihedrals

.BI "\-acflen" " <int> (-1)"
    Length of the ACF, default is half the number of frames

.BI "\-[no]normalize" "  (yes)"
    Normalize ACF

.BI "\-P" " <enum> (0)"
    Order of Legendre polynomial for ACF (0 indicates none): 0, 1, 2, 3

.BI "\-fitfn" " <enum> (none)"
    Fit function: none, exp, aexp, exp_exp, vac, exp5, exp7, exp9, erffit

.BI "\-beginfit" " <real> (0)"
    Time where to begin the exponential fit of the correlation function

.BI "\-endfit" " <real> (-1)"
    Time where to end the exponential fit of the correlation function, \-1 is until the end


.SH KNOWN ISSUES


\- Counting transitions only works for dihedrals with multiplicity 3

.SH SEE ALSO
.BR gromacs(7)

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