gmx-rmsdist - Calculate atom pair distances averaged with power -2, -3 or -6
Contents
Copyright
2025, GROMACS development team
2025.0 Feb 10, 2025 GMX-RMSDIST(1)
Description
gmxrmsdist computes the root mean square deviation of atom distances, which has the advantage that no
fit is needed like in standard RMS deviation as computed by gmxrms. The reference structure is taken
from the structure file. The RMSD at time t is calculated as the RMS of the differences in distance
between atom-pairs in the reference structure and the structure at time t.
gmxrmsdist can also produce matrices of the rms distances, rms distances scaled with the mean distance
and the mean distances and matrices with NMR averaged distances (1/r^3 and 1/r^6 averaging). Finally,
lists of atom pairs with 1/r^3 and 1/r^6 averaged distance below the maximum distance (-max, which will
default to 0.6 in this case) can be generated, by default averaging over equivalent hydrogens (all
triplets of hydrogens named *[123]). Additionally a list of equivalent atoms can be supplied (-equiv),
each line containing a set of equivalent atoms specified as residue number and name and atom name; e.g.:
HB*3SERHB13SERHB2
Residue and atom names must exactly match those in the structure file, including case. Specifying
non-sequential atoms is undefined.
Name
gmx-rmsdist - Calculate atom pair distances averaged with power -2, -3 or -6
Options
Options to specify input files:
-f[<.xtc/.trr/...>](traj.xtc)
Trajectory: xtctrrcptgrog96pdbtng-s[<.tpr/.gro/...>](topol.tpr)
Structure+mass(db): tprgrog96pdb brk ent
-n[<.ndx>](index.ndx)(Optional)
Index file
-equiv[<.dat>](equiv.dat)(Optional)
Generic data file
Options to specify output files:
-o[<.xvg>](distrmsd.xvg)
xvgr/xmgr file
-rms[<.xpm>](rmsdist.xpm)(Optional)
X PixMap compatible matrix file
-scl[<.xpm>](rmsscale.xpm)(Optional)
X PixMap compatible matrix file
-mean[<.xpm>](rmsmean.xpm)(Optional)
X PixMap compatible matrix file
-nmr3[<.xpm>](nmr3.xpm)(Optional)
X PixMap compatible matrix file
-nmr6[<.xpm>](nmr6.xpm)(Optional)
X PixMap compatible matrix file
-noe[<.dat>](noe.dat)(Optional)
Generic data file
Other options:
-b<time>(0)
Time of first frame to read from trajectory (default unit ps)
-e<time>(0)
Time of last frame to read from trajectory (default unit ps)
-dt<time>(0)
Only use frame when t MOD dt = first time (default unit ps)
-[no]w(no)
View output .xvg, .xpm, .eps and .pdb files
-xvg<enum>(xmgrace)
xvg plot formatting: xmgrace, xmgr, none
-nlevels<int>(40)
Discretize RMS in this number of levels
-max<real>(-1)
Maximum level in matrices
-[no]sumh(yes)
Average distance over equivalent hydrogens
-[no]pbc(yes)
Use periodic boundary conditions when computing distances
See Also
gmx(1) More information about GROMACS is available at <http://www.gromacs.org/>.
Synopsis
gmx rmsdist [-f[<.xtc/.trr/...>]] [-s[<.tpr/.gro/...>]] [-n[<.ndx>]]
[-equiv[<.dat>]] [-o[<.xvg>]] [-rms[<.xpm>]]
[-scl[<.xpm>]] [-mean[<.xpm>]] [-nmr3[<.xpm>]]
[-nmr6[<.xpm>]] [-noe[<.dat>]] [-b<time>] [-e<time>]
[-dt<time>] [-[no]w] [-xvg<enum>] [-nlevels<int>]
[-max<real>] [-[no]sumh] [-[no]pbc]
