.TH gmx-helixorient 1 "" "VERSION 5.0.2" "GROMACS Manual"
.SH NAME
gmx-helixorient \- Calculate local pitch/bending/rotation/orientation inside helices

.SH SYNOPSIS
gmx helixorient [\-s [<.tpr/.tpb/...>]] [\-f [<.xtc/.trr/...>]]
             [\-n [<.ndx>]] [\-oaxis [<.dat>]] [\-ocenter [<.dat>]]
             [\-orise [<.xvg>]] [\-oradius [<.xvg>]] [\-otwist [<.xvg>]]
             [\-obending [<.xvg>]] [\-otilt [<.xvg>]] [\-orot [<.xvg>]]
             [\-nice <int>] [\-b <time>] [\-e <time>] [\-dt <time>]
             [\-xvg <enum>] [\-[no]sidechain] [\-[no]incremental]

.SH DESCRIPTION
\fBgmx helixorient\fR calculates the coordinates and direction of the average axis inside an alpha helix, and the direction/vectors of both the Calpha and (optionally) a sidechain atom relative to the axis.

As input, you need to specify an index group with Calpha atoms corresponding to an alpha\-helix of continuous residues. Sidechain directions require a second index group of the same size, containing the heavy atom in each residue that should represent the sidechain.

\fBNote\fR that this program does not do any fitting of structures.

We need four Calpha coordinates to define the local direction of the helix axis.

The tilt/rotation is calculated from Euler rotations, where we define the helix axis as the local \fIx\fR\-axis, the residues/Calpha vector as \fIy\fR, and the \fIz\fR\-axis from their cross product. We use the Euler Y\-Z\-X rotation, meaning we first tilt the helix axis (1) around and (2) orthogonal to the residues vector, and finally apply the (3) rotation around it. For debugging or other purposes, we also write out the actual Euler rotation angles as \fBtheta[1\-3].xvg\fR

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

.BI "\-oaxis" " [<.dat>] (helixaxis.dat) (Output)"
    Generic data file

.BI "\-ocenter" " [<.dat>] (center.dat) (Output)"
    Generic data file

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

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

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

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

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

.BI "\-orot" " [<.xvg>] (rotation.xvg) (Output)"
    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 "\-xvg" " <enum> (xmgrace)"
    xvg plot formatting: xmgrace, xmgr, none

.BI "\-[no]sidechain" "  (no)"
    Calculate sidechain directions relative to helix axis too.

.BI "\-[no]incremental" "  (no)"
    Calculate incremental rather than total rotation/tilt.


.SH SEE ALSO
.BR gromacs(7)

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