Merge branch 'release-4-5-patches' of git@git.gromacs.org:gromacs into release-4...
[gromacs/rigid-bodies.git] / man / man1 / g_helix.1
blobcfdd05e33ef015afebd317f31e44808b6a0bdebb
1 .TH g_helix 1 "Thu 26 Aug 2010" "" "GROMACS suite, VERSION 4.5"
2 .SH NAME
3 g_helix - calculates basic properties of alpha helices
5 .B VERSION 4.5
6 .SH SYNOPSIS
7 \f3g_helix\fP
8 .BI "\-s" " topol.tpr "
9 .BI "\-n" " index.ndx "
10 .BI "\-f" " traj.xtc "
11 .BI "\-to" " gtraj.g87 "
12 .BI "\-cz" " zconf.gro "
13 .BI "\-co" " waver.gro "
14 .BI "\-[no]h" ""
15 .BI "\-[no]version" ""
16 .BI "\-nice" " int "
17 .BI "\-b" " time "
18 .BI "\-e" " time "
19 .BI "\-dt" " time "
20 .BI "\-[no]w" ""
21 .BI "\-r0" " int "
22 .BI "\-[no]q" ""
23 .BI "\-[no]F" ""
24 .BI "\-[no]db" ""
25 .BI "\-prop" " enum "
26 .BI "\-[no]ev" ""
27 .BI "\-ahxstart" " int "
28 .BI "\-ahxend" " int "
29 .SH DESCRIPTION
30 \&g_helix computes all kind of helix properties. First, the peptide
31 \&is checked to find the longest helical part. This is determined by
32 \&Hydrogen bonds and Phi/Psi angles.
33 \&That bit is fitted
34 \&to an ideal helix around the Z\-axis and centered around the origin.
35 \&Then the following properties are computed:
38 \&\fB 1.\fR Helix radius (file radius.xvg). This is merely the
39 \&RMS deviation in two dimensions for all Calpha atoms.
40 \&it is calced as sqrt((SUM i(x2(i)+y2(i)))/N), where N is the number
41 \&of backbone atoms. For an ideal helix the radius is 0.23 nm
43 \&\fB 2.\fR Twist (file twist.xvg). The average helical angle per
44 \&residue is calculated. For alpha helix it is 100 degrees,
45 \&for 3\-10 helices it will be smaller,
46 \&for 5\-helices it will be larger.
48 \&\fB 3.\fR Rise per residue (file rise.xvg). The helical rise per
49 \&residue is plotted as the difference in Z\-coordinate between Ca
50 \&atoms. For an ideal helix this is 0.15 nm
52 \&\fB 4.\fR Total helix length (file len\-ahx.xvg). The total length
53 \&of the
54 \&helix in nm. This is simply the average rise (see above) times the
55 \&number of helical residues (see below).
57 \&\fB 5.\fR Number of helical residues (file n\-ahx.xvg). The title says
58 \&it all.
60 \&\fB 6.\fR Helix Dipole, backbone only (file dip\-ahx.xvg).
62 \&\fB 7.\fR RMS deviation from ideal helix, calculated for the Calpha
63 \&atoms only (file rms\-ahx.xvg).
65 \&\fB 8.\fR Average Calpha\-Calpha dihedral angle (file phi\-ahx.xvg).
67 \&\fB 9.\fR Average Phi and Psi angles (file phipsi.xvg).
69 \&\fB 10.\fR Ellipticity at 222 nm according to \fI Hirst and Brooks\fR
73 .SH FILES
74 .BI "\-s" " topol.tpr" 
75 .B Input
76  Run input file: tpr tpb tpa 
78 .BI "\-n" " index.ndx" 
79 .B Input
80  Index file 
82 .BI "\-f" " traj.xtc" 
83 .B Input
84  Trajectory: xtc trr trj gro g96 pdb cpt 
86 .BI "\-to" " gtraj.g87" 
87 .B Output, Opt.
88  Gromos\-87 ASCII trajectory format 
90 .BI "\-cz" " zconf.gro" 
91 .B Output
92  Structure file: gro g96 pdb etc. 
94 .BI "\-co" " waver.gro" 
95 .B Output
96  Structure file: gro g96 pdb etc. 
98 .SH OTHER OPTIONS
99 .BI "\-[no]h"  "no    "
100  Print help info and quit
102 .BI "\-[no]version"  "no    "
103  Print version info and quit
105 .BI "\-nice"  " int" " 19" 
106  Set the nicelevel
108 .BI "\-b"  " time" " 0     " 
109  First frame (ps) to read from trajectory
111 .BI "\-e"  " time" " 0     " 
112  Last frame (ps) to read from trajectory
114 .BI "\-dt"  " time" " 0     " 
115  Only use frame when t MOD dt = first time (ps)
117 .BI "\-[no]w"  "no    "
118  View output xvg, xpm, eps and pdb files
120 .BI "\-r0"  " int" " 1" 
121  The first residue number in the sequence
123 .BI "\-[no]q"  "no    "
124  Check at every step which part of the sequence is helical
126 .BI "\-[no]F"  "yes   "
127  Toggle fit to a perfect helix
129 .BI "\-[no]db"  "no    "
130  Print debug info
132 .BI "\-prop"  " enum" " RAD" 
133  Select property to weight eigenvectors with. WARNING experimental stuff: \fB RAD\fR, \fB TWIST\fR, \fB RISE\fR, \fB LEN\fR, \fB NHX\fR, \fB DIP\fR, \fB RMS\fR, \fB CPHI\fR, \fB RMSA\fR, \fB PHI\fR, \fB PSI\fR, \fB HB3\fR, \fB HB4\fR, \fB HB5\fR or \fB CD222\fR
135 .BI "\-[no]ev"  "no    "
136  Write a new 'trajectory' file for ED
138 .BI "\-ahxstart"  " int" " 0" 
139  First residue in helix
141 .BI "\-ahxend"  " int" " 0" 
142  Last residue in helix
144 .SH SEE ALSO
145 .BR gromacs(7)
147 More information about \fBGROMACS\fR is available at <\fIhttp://www.gromacs.org/\fR>.