GMX-SANS-LEGACY(1)

✨ GMX-SANS-LEGACY(1) ✨

okay bestie, so this is a page from the GROMACS manual β€” manual section 1, the user commands, iykyk β€” and today's main character is gmx-sans-legacy. sit down, hydrate, let's get into it πŸ’–


🌸 NAME 🌸

gmx-sans-legacy β€” compute small angle neutron scattering spectra


πŸ¦‹ SYNOPSIS πŸ¦‹

gmx sans-legacy [-s [<.tpr>]] [-f [<.xtc/.trr/...>]] [-n [<.ndx>]]
             [-d [<.dat>]] [-pr [<.xvg>]] [-sq [<.xvg>]]
             [-prframe [<.xvg>]] [-sqframe [<.xvg>]] [-b <time>]
             [-e <time>] [-dt <time>] [-tu <enum>] [-xvg <enum>]
             [-mode <enum>] [-mcover <real>] [-[no]pbc]
             [-startq <real>] [-endq <real>] [-qstep <real>]
             [-seed <int>]

πŸ’… DESCRIPTION πŸ’…

So gmx sans-legacy computes SANS spectra using the Debye formula. and yes, it currently uses a topology file, because it literally needs to assign an element to each atom β€” no elements, no vibes, no spectra. 🫢

Parameters:

  • -pr β€” computes the normalized g(r) function, averaged over the trajectory
  • -prframe β€” computes the normalized g(r) function for each frame
  • -sq β€” computes the SANS intensity curve, averaged over the trajectory
  • -sqframe β€” computes the SANS intensity curve for each frame
  • -startq β€” starting q value, in nm
  • -endq β€” ending q value, in nm
  • -qstep β€” stepping in q space
Note: when you're using the Debye direct method, the computational cost goes up as 1/2 * N * (N - 1), where N is the atom number in the group of interest. it's giving quadratic, and not in a cute way. 😭
WARNING: if sq or pr are specified, this tool can produce a large number of files! up to two times larger than the number of frames! your directory is about to be booked and busy. πŸ’€

πŸŽ€ OPTIONS πŸŽ€

🌈 Options to specify input files

  • -s [<.tpr>] (topol.tpr) β€” portable xdr run input file
  • -f [<.xtc/.trr/...>] (traj.xtc) β€” trajectory: xtc trr cpt gro g96 pdb tng h5md
  • -n [<.ndx>] (index.ndx) (Optional) β€” index file
  • -d [<.dat>] (nsfactor.dat) (Optional) β€” generic data file

🧚 Options to specify output files

  • -pr [<.xvg>] (pr.xvg) β€” xvgr/xmgr file
  • -sq [<.xvg>] (sq.xvg) β€” xvgr/xmgr file
  • -prframe [<.xvg>] (prframe.xvg) (Optional) β€” xvgr/xmgr file
  • -sqframe [<.xvg>] (sqframe.xvg) (Optional) β€” xvgr/xmgr file

⭐ Other options

  • -b <time> (0) β€” time of the first frame to read from the trajectory (default unit ps)
  • -e <time> (0) β€” time of the last frame to read from the trajectory (default unit ps)
  • -dt <time> (0) β€” only use a frame when t MOD dt = first time (default unit ps)
  • -tu <enum> (ps) β€” unit for time values: fs, ps, ns, us, ms, s
  • -xvg <enum> (xmgrace) β€” xvg plot formatting: xmgrace, xmgr, none
  • -mode <enum> (direct) β€” mode for sans spectra calculation: direct, mc
  • -mcover <real> (-1) β€” Monte-Carlo coverage should be -1 (default) or (0,1]
  • -[no]pbc (yes) β€” use periodic boundary conditions for computing distances
  • -startq <real> (0) β€” starting q (1/nm)
  • -endq <real> (2) β€” ending q (1/nm)
  • -qstep <real> (0.01) β€” stepping in q (1/nm)
  • -seed <int> (0) β€” random seed for Monte-Carlo

πŸ‘‘ SEE ALSO πŸ‘‘

gmx(1)

more info about GROMACS is available at <‐ http://www.gromacs.org/.


2026, GROMACS development team


and that's the whole page, bestie, no notes πŸ“βœ¨ this was GROMACS 2026.4, dated Oct 02, 2026, straight out of the gmx-sans-legacy(1) girlies' group chat. go compute some spectra, you ate πŸ’…πŸ¦‹

πŸ“¦ where this page comes from