man/man1/g_angle.1

   1 .TH g_angle 1 "Thu 26 Aug 2010" "" "GROMACS suite, VERSION 4.5"
   2 .SH NAME
   3 g_angle - calculates distributions and correlations for angles and dihedrals
   4
   5 .B VERSION 4.5
   6 .SH SYNOPSIS
   7 \f3g_angle\fP
   8 .BI "\-f" " traj.xtc "
   9 .BI "\-n" " angle.ndx "
  10 .BI "\-od" " angdist.xvg "
  11 .BI "\-ov" " angaver.xvg "
  12 .BI "\-of" " dihfrac.xvg "
  13 .BI "\-ot" " dihtrans.xvg "
  14 .BI "\-oh" " trhisto.xvg "
  15 .BI "\-oc" " dihcorr.xvg "
  16 .BI "\-or" " traj.trr "
  17 .BI "\-[no]h" ""
  18 .BI "\-[no]version" ""
  19 .BI "\-nice" " int "
  20 .BI "\-b" " time "
  21 .BI "\-e" " time "
  22 .BI "\-dt" " time "
  23 .BI "\-[no]w" ""
  24 .BI "\-xvg" " enum "
  25 .BI "\-type" " enum "
  26 .BI "\-[no]all" ""
  27 .BI "\-binwidth" " real "
  28 .BI "\-[no]periodic" ""
  29 .BI "\-[no]chandler" ""
  30 .BI "\-[no]avercorr" ""
  31 .BI "\-acflen" " int "
  32 .BI "\-[no]normalize" ""
  33 .BI "\-P" " enum "
  34 .BI "\-fitfn" " enum "
  35 .BI "\-ncskip" " int "
  36 .BI "\-beginfit" " real "
  37 .BI "\-endfit" " real "
  38 .SH DESCRIPTION
  39 \&g_angle computes the angle distribution for a number of angles
  40 \&or dihedrals. This way you can check whether your simulation
  41 \&is correct. With option \-ov you can plot the average angle of
  42 \&a group of angles as a function of time. With the \-all option
  43 \&the first graph is the average, the rest are the individual angles.
  44
  45
  46 \&With the \-of option g_angle also calculates the fraction of trans
  47 \&dihedrals (only for dihedrals) as function of time, but this is
  48 \&probably only fun for a selected few.
  49
  50
  51 \&With option \-oc a dihedral correlation function is calculated.
  52
  53
  54 \&It should be noted that the indexfile should contain
  55 \&atom\-triples for angles or atom\-quadruplets for dihedrals.
  56 \&If this is not the case, the program will crash.
  57
  58
  59 \&With option \fB \-or\fR a trajectory file is dumped containing cos and
  60 \&sin of selected dihedral angles which subsequently can be used as
  61 \&input for a PCA analysis using \fB g_covar\fR.
  62 .SH FILES
  63 .BI "\-f" " traj.xtc"
  64 .B Input
  65  Trajectory: xtc trr trj gro g96 pdb cpt
  66
  67 .BI "\-n" " angle.ndx"
  68 .B Input
  69  Index file
  70
  71 .BI "\-od" " angdist.xvg"
  72 .B Output
  73  xvgr/xmgr file
  74
  75 .BI "\-ov" " angaver.xvg"
  76 .B Output, Opt.
  77  xvgr/xmgr file
  78
  79 .BI "\-of" " dihfrac.xvg"
  80 .B Output, Opt.
  81  xvgr/xmgr file
  82
  83 .BI "\-ot" " dihtrans.xvg"
  84 .B Output, Opt.
  85  xvgr/xmgr file
  86
  87 .BI "\-oh" " trhisto.xvg"
  88 .B Output, Opt.
  89  xvgr/xmgr file
  90
  91 .BI "\-oc" " dihcorr.xvg"
  92 .B Output, Opt.
  93  xvgr/xmgr file
  94
  95 .BI "\-or" " traj.trr"
  96 .B Output, Opt.
  97  Trajectory in portable xdr format
  98
  99 .SH OTHER OPTIONS
 100 .BI "\-[no]h"  "no    "
 101  Print help info and quit
 102
 103 .BI "\-[no]version"  "no    "
 104  Print version info and quit
 105
 106 .BI "\-nice"  " int" " 19"
 107  Set the nicelevel
 108
 109 .BI "\-b"  " time" " 0     "
 110  First frame (ps) to read from trajectory
 111
 112 .BI "\-e"  " time" " 0     "
 113  Last frame (ps) to read from trajectory
 114
 115 .BI "\-dt"  " time" " 0     "
 116  Only use frame when t MOD dt = first time (ps)
 117
 118 .BI "\-[no]w"  "no    "
 119  View output xvg, xpm, eps and pdb files
 120
 121 .BI "\-xvg"  " enum" " xmgrace"
 122  xvg plot formatting: \fB xmgrace\fR, \fB xmgr\fR or \fB none\fR
 123
 124 .BI "\-type"  " enum" " angle"
 125  Type of angle to analyse: \fB angle\fR, \fB dihedral\fR, \fB improper\fR or \fB ryckaert\-bellemans\fR
 126
 127 .BI "\-[no]all"  "no    "
 128  Plot all angles separately in the averages file, in the order of appearance in the index file.
 129
 130 .BI "\-binwidth"  " real" " 1     "
 131  binwidth (degrees) for calculating the distribution
 132
 133 .BI "\-[no]periodic"  "yes   "
 134  Print dihedral angles modulo 360 degrees
 135
 136 .BI "\-[no]chandler"  "no    "
 137  Use Chandler correlation function (N[trans] = 1, N[gauche] = 0) rather than cosine correlation function. Trans is defined as phi  \-60 || phi  60.
 138
 139 .BI "\-[no]avercorr"  "no    "
 140  Average the correlation functions for the individual angles/dihedrals
 141
 142 .BI "\-acflen"  " int" " \-1"
 143  Length of the ACF, default is half the number of frames
 144
 145 .BI "\-[no]normalize"  "yes   "
 146  Normalize ACF
 147
 148 .BI "\-P"  " enum" " 0"
 149  Order of Legendre polynomial for ACF (0 indicates none): \fB 0\fR, \fB 1\fR, \fB 2\fR or \fB 3\fR
 150
 151 .BI "\-fitfn"  " enum" " none"
 152  Fit function: \fB none\fR, \fB exp\fR, \fB aexp\fR, \fB exp_exp\fR, \fB vac\fR, \fB exp5\fR, \fB exp7\fR or \fB exp9\fR
 153
 154 .BI "\-ncskip"  " int" " 0"
 155  Skip N points in the output file of correlation functions
 156
 157 .BI "\-beginfit"  " real" " 0     "
 158  Time where to begin the exponential fit of the correlation function
 159
 160 .BI "\-endfit"  " real" " \-1    "
 161  Time where to end the exponential fit of the correlation function, \-1 is until the end
 162
 163 .SH KNOWN PROBLEMS
 164 \- Counting transitions only works for dihedrals with multiplicity 3
 165
 166 .SH SEE ALSO
 167 .BR gromacs(7)
 168
 169 More information about \fBGROMACS\fR is available at <\fIhttp://www.gromacs.org/\fR>.