.TH gmx-current 1 "" "VERSION 5.0.2" "GROMACS Manual"
.SH NAME
gmx-current \- Calculate dielectric constants and current autocorrelation function

.SH SYNOPSIS
gmx current [\-s [<.tpr/.tpb/...>]] [\-n [<.ndx>]]
            [\-f [<.xtc/.trr/...>]] [\-o [<.xvg>]] [\-caf [<.xvg>]]
            [\-dsp [<.xvg>]] [\-md [<.xvg>]] [\-mj [<.xvg>]]
            [\-mc [<.xvg>]] [\-nice <int>] [\-b <time>] [\-e <time>]
            [\-dt <time>] [\-[no]w] [\-xvg <enum>] [\-sh <int>]
            [\-[no]nojump] [\-eps <real>] [\-bfit <real>] [\-efit <real>]
            [\-bvit <real>] [\-evit <real>] [\-tr <real>] [\-temp <real>]

.SH DESCRIPTION
\fBgmx current\fR is a tool for calculating the current autocorrelation function, the correlation of the rotational and translational dipole moment of the system, and the resulting static dielectric constant. To obtain a reasonable result, the index group has to be neutral. Furthermore, the routine is capable of extracting the static conductivity from the current autocorrelation function, if velocities are given. Additionally, an Einstein\-Helfand fit can be used to obtain the static conductivity.

The flag \fB\-caf\fR is for the output of the current autocorrelation function and \fB\-mc\fR writes the correlation of the rotational and translational part of the dipole moment in the corresponding file. However, this option is only available for trajectories containing velocities. Options \fB\-sh\fR and \fB\-tr\fR are responsible for the averaging and integration of the autocorrelation functions. Since averaging proceeds by shifting the starting point through the trajectory, the shift can be modified with \fB\-sh\fR to enable the choice of uncorrelated starting points. Towards the end, statistical inaccuracy grows and integrating the correlation function only yields reliable values until a certain point, depending on the number of frames. The option \fB\-tr\fR controls the region of the integral taken into account for calculating the static dielectric constant.

Option \fB\-temp\fR sets the temperature required for the computation of the static dielectric constant.

Option \fB\-eps\fR controls the dielectric constant of the surrounding medium for simulations using a Reaction Field or dipole corrections of the Ewald summation (\fB\-eps\fR=0 corresponds to tin\-foil boundary conditions).

\fB\-[no]nojump\fR unfolds the coordinates to allow free diffusion. This is required to get a continuous translational dipole moment, required for the Einstein\-Helfand fit. The results from the fit allow the determination of the dielectric constant for system of charged molecules. However, it is also possible to extract the dielectric constant from the fluctuations of the total dipole moment in folded coordinates. But this option has to be used with care, since only very short time spans fulfill the approximation that the density of the molecules is approximately constant and the averages are already converged. To be on the safe side, the dielectric constant should be calculated with the help of the Einstein\-Helfand method for the translational part of the dielectric constant.

.SH OPTIONS
Options to specify input and output files:

.BI "\-s" " [<.tpr/.tpb/...>] (topol.tpr) (Input)"
    Structure+mass(db): tpr tpb tpa gro g96 pdb brk ent

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

.BI "\-f" " [<.xtc/.trr/...>] (traj.xtc) (Input)"
    Trajectory: xtc trr cpt trj gro g96 pdb tng

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

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

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

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

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

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


Other options:

.BI "\-nice" " <int> (0)"
    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 "\-sh" " <int> (1000)"
    Shift of the frames for averaging the correlation functions and the mean\-square displacement.

.BI "\-[no]nojump" "  (yes)"
    Removes jumps of atoms across the box.

.BI "\-eps" " <real> (0)"
    Dielectric constant of the surrounding medium. The value zero corresponds to infinity (tin\-foil boundary conditions).

.BI "\-bfit" " <real> (100)"
    Begin of the fit of the straight line to the MSD of the translational fraction of the dipole moment.

.BI "\-efit" " <real> (400)"
    End of the fit of the straight line to the MSD of the translational fraction of the dipole moment.

.BI "\-bvit" " <real> (0.5)"
    Begin of the fit of the current autocorrelation function to a*tb.

.BI "\-evit" " <real> (5)"
    End of the fit of the current autocorrelation function to a*tb.

.BI "\-tr" " <real> (0.25)"
    Fraction of the trajectory taken into account for the integral.

.BI "\-temp" " <real> (300)"
    Temperature for calculating epsilon.


.SH SEE ALSO
.BR gromacs(7)

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