Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
       gmx-densmap - Calculate 2D planar or axial-radial density maps

SYNOPSIS
	  gmx densmap [-f [<.xtc/.trr/...>]] [-s [<.tpr/.gro/...>]] [-n	[<.ndx>]]
		      [-od [<.dat>]] [-o [<.xpm>]] [-b <time>] [-e <time>]
		      [-dt <time>] [-[no]w] [-bin <real>] [-aver <enum>]
		      [-xmin <real>] [-xmax <real>] [-n1 <int>]	[-n2 <int>]
		      [-amax <real>] [-rmax <real>] [-[no]mirror] [-[no]sums]
		      [-unit <enum>] [-dmin <real>] [-dmax <real>]

DESCRIPTION
       gmx  densmap  computes  2D number-density maps.	It can make planar and
       axial-radial density maps.  The output .xpm file	can be visualized with
       for instance xv and can be converted to postscript  with	 xpm2ps.   Op-
       tionally,  output  can be in text form to a .dat	file with -od, instead
       of the usual .xpm file with -o.

       The default analysis is a 2-D number-density map	for a  selected	 group
       of atoms	in the x-y plane.  The averaging direction can be changed with
       the  option -aver.  When	-xmin and/or -xmax are set only	atoms that are
       within the limit(s) in the averaging direction are taken	into  account.
       The  grid  spacing  is  set  with  the option -bin.  When -n1 or	-n2 is
       non-zero, the grid size is set by this option.  Box  size  fluctuations
       are properly taken into account.

       When  options  -amax  and -rmax are set,	an axial-radial	number-density
       map is made. Three groups should	be supplied, the centers  of  mass  of
       the  first  two	groups define the axis,	the third defines the analysis
       group. The axial	direction goes from -amax to +amax, where  the	center
       is defined as the midpoint between the centers of mass and the positive
       direction goes from the first to	the second center of mass.  The	radial
       direction  goes	from 0 to rmax or from -rmax to	+rmax when the -mirror
       option has been set.

       The normalization of the	output is set with the -unit option.  The  de-
       fault  produces a true number density. Unit nm-2	leaves out the normal-
       ization for the averaging or the	angular	direction.  Option count  pro-
       duces  the count	for each grid cell.  When you do not want the scale in
       the output to go	from zero to the maximum density, you can set the max-
       imum with the option -dmax.

OPTIONS
       Options to specify input	files:

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

       -s [<.tpr/.gro/...>] (topol.tpr)	(Optional)
	      Structure+mass(db): tpr gro g96 pdb brk ent

       -n [<.ndx>] (index.ndx) (Optional)
	      Index file

       Options to specify output files:

       -od [<.dat>] (densmap.dat) (Optional)
	      Generic data file

       -o [<.xpm>] (densmap.xpm)
	      X	PixMap compatible matrix 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

       -bin <real> (0.02)
	      Grid size	(nm)

       -aver <enum> (z)
	      The direction to average over: z,	y, x

       -xmin <real> (-1)
	      Minimum coordinate for averaging

       -xmax <real> (-1)
	      Maximum coordinate for averaging

       -n1 <int> (0)
	      Number of	grid cells in the first	direction

       -n2 <int> (0)
	      Number of	grid cells in the second direction

       -amax <real> (0)
	      Maximum axial distance from the center

       -rmax <real> (0)
	      Maximum radial distance

       -[no]mirror (no)
	      Add the mirror image below the axial axis

       -[no]sums (no)
	      Print density sums (1D map) to stdout

       -unit <enum> (nm-3)
	      Unit for the output: nm-3, nm-2, count

       -dmin <real> (0)
	      Minimum density in output

       -dmax <real> (0)
	      Maximum density in output	(0 means calculate it)

SEE ALSO
       gmx(1)

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

COPYRIGHT
       2025, GROMACS development team

2025.0				 Feb 10, 2025			GMX-DENSMAP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gmx-densmap&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help