home | help
GMX-SPOL(1)			     GROMACS			     GMX-SPOL(1)

NAME
     gmx-spol  -  Analyze  solvent  dipole  orientation  and polarization around
     solutes

SYNOPSIS
	gmx spol [-f [<.xtc/.trr/...>]] [-s [<.tpr>]] [-n [<.ndx>]]
		 [-o [<.xvg>]] [-b <time>] [-e <time>] [-dt <time>] [-[no]w]
		 [-xvg <enum>] [-[no]com] [-refat <int>] [-rmin <real>]
		 [-rmax <real>] [-dip <real>] [-bw <real>]

DESCRIPTION
     gmx spol analyzes dipoles around a solute; it is especially useful for  po-
     larizable	water. A group of reference atoms, or a center of mass reference
     (option -com) and a group of solvent atoms is required. The program  splits
     the  group  of  solvent atoms into molecules. For each solvent molecule the
     distance to the closest atom in reference group or to  the  COM  is  deter-
     mined.   A cumulative distribution of these distances is plotted.	For each
     distance between -rmin and -rmax the inner product of the	distance  vector
     and  the  dipole  of the solvent molecule is determined.  For solvent mole-
     cules with net charge (ions), the net  charge  of	the  ion  is  subtracted
     evenly  from  all atoms in the selection of each ion.  The average of these
     dipole components is printed.  The same is done for the polarization, where
     the average dipole is subtracted from the instantaneous dipole. The  magni-
     tude  of  the  average dipole is set with the option -dip, the direction is
     defined by the vector from the first atom in the selected solvent group  to
     the midpoint between the second and the third atom.

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) (Optional)
	    Index file

     Options to specify output files:

     -o [<.xvg>] (scdist.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]com (no)
	    Use the center of mass as the reference position

     -refat <int> (1)
	    The reference atom of the solvent molecule

     -rmin <real> (0)
	    Maximum distance (nm)

     -rmax <real> (0.32)
	    Maximum distance (nm)

     -dip <real> (0)
	    The average dipole (D)

     -bw <real> (0.01)
	    The bin width

SEE ALSO
     gmx(1)

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

COPYRIGHT
     2026, GROMACS development team

2026.3				  Jun 25, 2026			     GMX-SPOL(1)

home | help