GMX-ROTACF(1)

πŸ’– GMX-ROTACF(1) πŸ’–

okay bestie, so this is gmx-rotacf from the GROMACS manual, and it's literally the moment your molecules get their little spinny glow-up. let's go πŸŽ€


✨ NAME ✨

gmx-rotacf β€” Calculate the rotational correlation function for molecules


🌸 SYNOPSIS 🌸

gmx rotacf [-f [<.xtc/.trr/...>]] [-s [<.tpr>]] [-n [<.ndx>]]
           [-o [<.xvg>]] [-b <time>] [-e <time>] [-dt <time>]
           [-[no]w] [-xvg <enum>] [-[no]d] [-[no]aver]
           [-acflen <int>] [-[no]normalize] [-P <enum>]
           [-fitfn <enum>] [-beginfit <real>] [-endfit <real>]

πŸ¦‹ DESCRIPTION πŸ¦‹

so gmx rotacf calculates the rotational correlation function for molecules. that's the whole vibe. πŸ’…

but here's the tea: you have to give it atom triplets (i,j,k) in the index file, and those little guys define two vectors, ij and jk. then it calculates the rotational ACF as the autocorrelation function of the vector

n = ij x jk

aka the cross product of those two vectors. and no cap β€” since three atoms span a plane, the order of the three atoms does not matter. it's giving "any order works, we're not picky". 🫢

optionally, if you invoke the -d switch, you can calculate the rotational correlation function for linear molecules by specifying atom pairs (i,j) in the index file. iconic behaviour honestly.

🌈 EXAMPLES 🌈

gmx rotacf -P 1 -nparm 2 -fft -n index -o rotacf-x-P1 -fa expfit-x-P1
-beginfit 2.5 -endfit 20.0

so what this is doing: it'll calculate the rotational correlation function using a first order Legendre polynomial of the angle of a vector defined by the index file. then the correlation function gets fitted from 2.5 ps until 20.0 ps to a two-parameter exponential. slay. ✨


πŸ’… OPTIONS πŸ’…

πŸ“ Options to specify input files:

  • -f [<.xtc/.trr/...>] (traj.xtc) β€” Trajectory: xtc trr cpt gro g96 pdb tng h5md
  • -s [<.tpr>] (topol.tpr) β€” Portable xdr run input file
  • -n [<.ndx>] (index.ndx) β€” Index file

πŸŽ€ Options to specify output files:

  • -o [<.xvg>] (rotacf.xvg) β€” xvgr/xmgr 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
  • -[no]d (no) β€” Use index doublets (vectors) for correlation function instead of triplets (planes)
  • -[no]aver (yes) β€” Average over molecules
  • -acflen <int> (-1) β€” Length of the ACF, default is half the number of frames
  • -[no]normalize (yes) β€” Normalize ACF
  • -P <enum> (0) β€” Order of Legendre polynomial for ACF (0 indicates none): 0, 1, 2, 3
  • -fitfn <enum> (none) β€” Fit function: none, exp, aexp, exp_exp, exp5, exp7, exp9
  • -beginfit <real> (0) β€” Time where to begin the exponential fit of the correlation function
  • -endfit <real> (-1) β€” Time where to end the exponential fit of the correlation function, -1 is until the end

πŸ‘‘ SEE ALSO πŸ‘‘

gmx(1)

More information about GROMACS is available at <‐ http://www.gromacs.org/>.


2026, GROMACS development team


okay that's the whole page bestie, you ate that πŸ’– no more notes, go calculate some correlation functions and be the main character of your own trajectory. fr fr πŸ¦‹

2026.4 β€” Oct 02, 2026 🌈 mwah, love u, bye!! πŸ’…βœ¨

πŸ“¦ where this page comes from