share/html/online/g_density.html

   1 <HTML>
   2 <HEAD>
   3 <TITLE>g_density</TITLE>
   4 <LINK rel=stylesheet href="style.css" type="text/css">
   5 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000FF" vlink="#990000" alink="#FF0000">
   6 <TABLE WIDTH="98%" NOBORDER >
   7 <TR><TD WIDTH=400>
   8 <TABLE WIDTH=400 NOBORDER>
   9 <TD WIDTH=116>
  10 <a href="http://www.gromacs.org/"><img SRC="../images/gmxlogo_small.png"BORDER=0 </a></td>
  11 <td ALIGN=LEFT VALIGN=TOP WIDTH=280><br><h2>g_density</h2><font size=-1><A HREF="../online.html">Main Table of Contents</A></font><br><br></td>
  12 </TABLE></TD><TD WIDTH="*" ALIGN=RIGHT VALIGN=BOTTOM><p><B>VERSION 4.5<br>
  13 Thu 26 Aug 2010</B></td></tr></TABLE>
  14 <HR>
  15 <H3>Description</H3>
  16 <p>
  17 Compute partial densities across the box, using an index file. Densities
  18 in kg/m^3, number densities or electron densities can be
  19 calculated. For electron densities, a file describing the number of
  20 electrons for each type of atom should be provided using <tt>-ei</tt>.
  21 It should look like:<br>
  22    2<br>
  23    atomname = nrelectrons<br>
  24    atomname = nrelectrons<br>
  25 The first line contains the number of lines to read from the file.
  26 There should be one line for each unique atom name in your system.
  27 The number of electrons for each atom is modified by its atomic
  28 partial charge.
  29 <P>
  30 <H3>Files</H3>
  31 <TABLE BORDER=1 CELLSPACING=0 CELLPADDING=2>
  32 <TR><TH>option</TH><TH>filename</TH><TH>type</TH><TH>description</TH></TR>
  33 <TR><TD ALIGN=RIGHT> <b><tt>-f</tt></b> </TD><TD ALIGN=RIGHT> <tt><a href="files.html">    traj.xtc</a></tt> </TD><TD> Input </TD><TD> Trajectory: <a href="xtc.html">xtc</a> <a href="trr.html">trr</a> <a href="trj.html">trj</a> <a href="gro.html">gro</a> <a href="g96.html">g96</a> <a href="pdb.html">pdb</a> cpt </TD></TR>
  34 <TR><TD ALIGN=RIGHT> <b><tt>-n</tt></b> </TD><TD ALIGN=RIGHT> <tt><a href="ndx.html">   index.ndx</a></tt> </TD><TD> Input, Opt. </TD><TD> Index file </TD></TR>
  35 <TR><TD ALIGN=RIGHT> <b><tt>-s</tt></b> </TD><TD ALIGN=RIGHT> <tt><a href="files.html">   topol.tpr</a></tt> </TD><TD> Input </TD><TD> Run input file: <a href="tpr.html">tpr</a> <a href="tpb.html">tpb</a> <a href="tpa.html">tpa</a> </TD></TR>
  36 <TR><TD ALIGN=RIGHT> <b><tt>-ei</tt></b> </TD><TD ALIGN=RIGHT> <tt><a href="dat.html">electrons.dat</a></tt> </TD><TD> Input, Opt. </TD><TD> Generic data file </TD></TR>
  37 <TR><TD ALIGN=RIGHT> <b><tt>-o</tt></b> </TD><TD ALIGN=RIGHT> <tt><a href="xvg.html"> density.xvg</a></tt> </TD><TD> Output </TD><TD> xvgr/xmgr file </TD></TR>
  38 </TABLE>
  39 <P>
  40 <H3>Other options</H3>
  41 <TABLE BORDER=1 CELLSPACING=0 CELLPADDING=2>
  42 <TR><TH>option</TH><TH>type</TH><TH>default</TH><TH>description</TH></TR>
  43 <TR><TD ALIGN=RIGHT> <b><tt>-[no]h</tt></b> </TD><TD ALIGN=RIGHT> gmx_bool </TD><TD ALIGN=RIGHT> <tt>no    </tt> </TD><TD> Print help info and quit </TD></TD>
  44 <TR><TD ALIGN=RIGHT> <b><tt>-[no]version</tt></b> </TD><TD ALIGN=RIGHT> gmx_bool </TD><TD ALIGN=RIGHT> <tt>no    </tt> </TD><TD> Print version info and quit </TD></TD>
  45 <TR><TD ALIGN=RIGHT> <b><tt>-nice</tt></b> </TD><TD ALIGN=RIGHT> int </TD><TD ALIGN=RIGHT> <tt>19</tt> </TD><TD> Set the nicelevel </TD></TD>
  46 <TR><TD ALIGN=RIGHT> <b><tt>-b</tt></b> </TD><TD ALIGN=RIGHT> time </TD><TD ALIGN=RIGHT> <tt>0     </tt> </TD><TD> First frame (ps) to read from trajectory </TD></TD>
  47 <TR><TD ALIGN=RIGHT> <b><tt>-e</tt></b> </TD><TD ALIGN=RIGHT> time </TD><TD ALIGN=RIGHT> <tt>0     </tt> </TD><TD> Last frame (ps) to read from trajectory </TD></TD>
  48 <TR><TD ALIGN=RIGHT> <b><tt>-dt</tt></b> </TD><TD ALIGN=RIGHT> time </TD><TD ALIGN=RIGHT> <tt>0     </tt> </TD><TD> Only use frame when t MOD dt = first time (ps) </TD></TD>
  49 <TR><TD ALIGN=RIGHT> <b><tt>-[no]w</tt></b> </TD><TD ALIGN=RIGHT> gmx_bool </TD><TD ALIGN=RIGHT> <tt>no    </tt> </TD><TD> View output <a href="xvg.html">xvg</a>, <a href="xpm.html">xpm</a>, <a href="eps.html">eps</a> and <a href="pdb.html">pdb</a> files </TD></TD>
  50 <TR><TD ALIGN=RIGHT> <b><tt>-xvg</tt></b> </TD><TD ALIGN=RIGHT> enum </TD><TD ALIGN=RIGHT> <tt>xmgrace</tt> </TD><TD> <a href="xvg.html">xvg</a> plot formatting: <tt>xmgrace</tt>, <tt>xmgr</tt> or <tt>none</tt> </TD></TD>
  51 <TR><TD ALIGN=RIGHT> <b><tt>-d</tt></b> </TD><TD ALIGN=RIGHT> string </TD><TD ALIGN=RIGHT> <tt>Z</tt> </TD><TD> Take the normal on the membrane in direction X, Y or Z. </TD></TD>
  52 <TR><TD ALIGN=RIGHT> <b><tt>-sl</tt></b> </TD><TD ALIGN=RIGHT> int </TD><TD ALIGN=RIGHT> <tt>50</tt> </TD><TD> Divide the box in #nr slices. </TD></TD>
  53 <TR><TD ALIGN=RIGHT> <b><tt>-dens</tt></b> </TD><TD ALIGN=RIGHT> enum </TD><TD ALIGN=RIGHT> <tt>mass</tt> </TD><TD> Density: <tt>mass</tt>, <tt>number</tt>, <tt>charge</tt> or <tt>electron</tt> </TD></TD>
  54 <TR><TD ALIGN=RIGHT> <b><tt>-ng</tt></b> </TD><TD ALIGN=RIGHT> int </TD><TD ALIGN=RIGHT> <tt>1</tt> </TD><TD> Number of groups to compute densities of </TD></TD>
  55 <TR><TD ALIGN=RIGHT> <b><tt>-[no]symm</tt></b> </TD><TD ALIGN=RIGHT> gmx_bool </TD><TD ALIGN=RIGHT> <tt>no    </tt> </TD><TD> Symmetrize the density along the axis, with respect to the center. Useful for bilayers. </TD></TD>
  56 <TR><TD ALIGN=RIGHT> <b><tt>-[no]center</tt></b> </TD><TD ALIGN=RIGHT> gmx_bool </TD><TD ALIGN=RIGHT> <tt>no    </tt> </TD><TD> Shift the center of mass along the axis to zero. This means if your axis is Z and your box is bX, bY, bZ, the center of mass will be at bX/2, bY/2, 0. </TD></TD>
  57 </TABLE>
  58 <P>
  59 <H3>Known problems</H3>
  60 <UL>
  61 <LI>When calculating electron densities, atomnames are used instead of types. This is bad.
  62 </UL>
  63 <P>
  64 <hr>
  65 <div ALIGN=RIGHT>
  66 <font size="-1"><a href="http://www.gromacs.org">http://www.gromacs.org</a></font><br>
  67 <font size="-1"><a href="mailto:gromacs@gromacs.org">gromacs@gromacs.org</a></font><br>
  68 </div>
  69 </BODY>