.TH gmx-dos 1 "" "VERSION 5.0.2" "GROMACS Manual"
.SH NAME
gmx-dos \- Analyze density of states and properties based on that

.SH SYNOPSIS
gmx dos [\-f [<.trr/.cpt/...>]] [\-s [<.tpr/.tpb/...>]] [\-n [<.ndx>]]
        [\-vacf [<.xvg>]] [\-mvacf [<.xvg>]] [\-dos [<.xvg>]]
        [\-g [<.log>]] [\-nice <int>] [\-b <time>] [\-e <time>]
        [\-dt <time>] [\-[no]w] [\-xvg <enum>] [\-[no]v] [\-[no]recip]
        [\-[no]abs] [\-[no]normdos] [\-T <real>] [\-acflen <int>]
        [\-[no]normalize] [\-P <enum>] [\-fitfn <enum>]
        [\-beginfit <real>] [\-endfit <real>]

.SH DESCRIPTION
\fBgmx dos\fR computes the Density of States from a simulations. In order for this to be meaningful the velocities must be saved in the trajecotry with sufficiently high frequency such as to cover all vibrations. For flexible systems that would be around a few fs between saving. Properties based on the DoS are printed on the standard output.

.SH OPTIONS
Options to specify input and output files:

.BI "\-f" " [<.trr/.cpt/...>] (traj.trr) (Input)"
    Full precision trajectory: trr cpt trj tng

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

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

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

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

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

.BI "\-g" " [<.log>] (dos.log) (Output)"
    Log 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 "\-[no]v" "  (yes)"
    Be loud and noisy.

.BI "\-[no]recip" "  (no)"
    Use cm\-1 on X\-axis instead of 1/ps for DoS plots.

.BI "\-[no]abs" "  (no)"
    Use the absolute value of the Fourier transform of the VACF as the Density of States. Default is to use the real component only

.BI "\-[no]normdos" "  (no)"
    Normalize the DoS such that it adds up to 3N. This is a hack that should not be necessary.

.BI "\-T" " <real> (298.15)"
    Temperature in the simulation

.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


\- This program needs a lot of memory: total usage equals the number of atoms times 3 times number of frames times 4 (or 8 when run in double precision).

.SH SEE ALSO
.BR gromacs(7)

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