Release 4.5.6
[gromacs.git] / man / man1 / g_sas.1
blobb6d3f78d07c2fad1d24b242a5695b1769274578a
1 .TH g_sas 1 "Fri 18 Jan 2013" "" "GROMACS suite, VERSION 4.5.6"
2 .SH NAME
3 g_sas - computes solvent accessible surface area
5 .B VERSION 4.5.6
6 .SH SYNOPSIS
7 \f3g_sas\fP
8 .BI "\-f" " traj.xtc "
9 .BI "\-s" " topol.tpr "
10 .BI "\-o" " area.xvg "
11 .BI "\-or" " resarea.xvg "
12 .BI "\-oa" " atomarea.xvg "
13 .BI "\-tv" " volume.xvg "
14 .BI "\-q" " connelly.pdb "
15 .BI "\-n" " index.ndx "
16 .BI "\-i" " surfat.itp "
17 .BI "\-[no]h" ""
18 .BI "\-[no]version" ""
19 .BI "\-nice" " int "
20 .BI "\-b" " time "
21 .BI "\-e" " time "
22 .BI "\-dt" " time "
23 .BI "\-[no]w" ""
24 .BI "\-xvg" " enum "
25 .BI "\-probe" " real "
26 .BI "\-ndots" " int "
27 .BI "\-qmax" " real "
28 .BI "\-[no]f_index" ""
29 .BI "\-minarea" " real "
30 .BI "\-[no]pbc" ""
31 .BI "\-[no]prot" ""
32 .BI "\-dgs" " real "
33 .SH DESCRIPTION
34 \&\fB g_sas\fR computes hydrophobic, hydrophilic and total solvent
35 \&accessible surface area. See Eisenhaber F, Lijnzaad P, Argos P,
36 \&Sander C, & Scharf M (1995) J. Comput. Chem. 16, 273\-284.
37 \&As a side effect, the Connolly surface can be generated as well in
38 \&a \fB .pdb\fR file where the nodes are represented as atoms and the
39 \&vertice connecting the nearest nodes as CONECT records.
40 \&The program will ask for a group for the surface calculation
41 \&and a group for the output. The calculation group should always
42 \&consists of all the non\-solvent atoms in the system.
43 \&The output group can be the whole or part of the calculation group.
44 \&The average and standard deviation of the area over the trajectory can be plotted
45 \&per residue and atom as well (options \fB \-or\fR and \fB \-oa\fR).
46 \&In combination with the latter option an \fB .itp\fR file can be
47 \&generated (option \fB \-i\fR)
48 \&which can be used to restrain surface atoms.
51 \&By default, periodic boundary conditions are taken into account,
52 \&this can be turned off using the \fB \-nopbc\fR option.
55 \&With the \fB \-tv\fR option the total volume and density of the
56 \&molecule can be computed.
57 \&Please consider whether the normal probe radius is appropriate
58 \&in this case or whether you would rather use e.g. 0. It is good
59 \&to keep in mind that the results for volume and density are very
60 \&approximate. For example, in ice Ih, one can easily fit water molecules in the
61 \&pores which would yield a volume that is too low, and surface area and density
62 \&that are both too high.
63 .SH FILES
64 .BI "\-f" " traj.xtc" 
65 .B Input
66  Trajectory: xtc trr trj gro g96 pdb cpt 
68 .BI "\-s" " topol.tpr" 
69 .B Input
70  Structure+mass(db): tpr tpb tpa gro g96 pdb 
72 .BI "\-o" " area.xvg" 
73 .B Output
74  xvgr/xmgr file 
76 .BI "\-or" " resarea.xvg" 
77 .B Output, Opt.
78  xvgr/xmgr file 
80 .BI "\-oa" " atomarea.xvg" 
81 .B Output, Opt.
82  xvgr/xmgr file 
84 .BI "\-tv" " volume.xvg" 
85 .B Output, Opt.
86  xvgr/xmgr file 
88 .BI "\-q" " connelly.pdb" 
89 .B Output, Opt.
90  Protein data bank file 
92 .BI "\-n" " index.ndx" 
93 .B Input, Opt.
94  Index file 
96 .BI "\-i" " surfat.itp" 
97 .B Output, Opt.
98  Include file for topology 
100 .SH OTHER OPTIONS
101 .BI "\-[no]h"  "no    "
102  Print help info and quit
104 .BI "\-[no]version"  "no    "
105  Print version info and quit
107 .BI "\-nice"  " int" " 19" 
108  Set the nicelevel
110 .BI "\-b"  " time" " 0     " 
111  First frame (ps) to read from trajectory
113 .BI "\-e"  " time" " 0     " 
114  Last frame (ps) to read from trajectory
116 .BI "\-dt"  " time" " 0     " 
117  Only use frame when t MOD dt = first time (ps)
119 .BI "\-[no]w"  "no    "
120  View output \fB .xvg\fR, \fB .xpm\fR, \fB .eps\fR and \fB .pdb\fR files
122 .BI "\-xvg"  " enum" " xmgrace" 
123  xvg plot formatting: \fB xmgrace\fR, \fB xmgr\fR or \fB none\fR
125 .BI "\-probe"  " real" " 0.14  " 
126  Radius of the solvent probe (nm)
128 .BI "\-ndots"  " int" " 24" 
129  Number of dots per sphere, more dots means more accuracy
131 .BI "\-qmax"  " real" " 0.2   " 
132  The maximum charge (e, absolute value) of a hydrophobic atom
134 .BI "\-[no]f_index"  "no    "
135  Determine from a group in the index file what are the hydrophobic atoms rather than from the charge
137 .BI "\-minarea"  " real" " 0.5   " 
138  The minimum area (nm2) to count an atom as a surface atom when writing a position restraint file  (see help)
140 .BI "\-[no]pbc"  "yes   "
141  Take periodicity into account
143 .BI "\-[no]prot"  "yes   "
144  Output the protein to the Connelly \fB .pdb\fR file too
146 .BI "\-dgs"  " real" " 0     " 
147  Default value for solvation free energy per area (kJ/mol/nm2)
149 .SH SEE ALSO
150 .BR gromacs(7)
152 More information about \fBGROMACS\fR is available at <\fIhttp://www.gromacs.org/\fR>.