423c928bbed7f4357b5a1a6d38dcf7623b58e7a4
[alexxy/gromacs.git] / docs / old-html / online / mdp.html
1 <title>mdp file format</title>
2 <P> Follow <a href="mdp_opt.html">this link</a> for a detailed description of the options</a>.  </P>
3
4 <P> Below is a sample mdp file.
5 The ordering of the items is not important, but if you enter the same
6 thing twice, the <b>last</b> is used (grompp gives you a note when 
7 overriding values). Dashes and underscores on the 
8 left hand side are ignored.</P>
9
10 <P> The values of the options are reasonable values for a 1 nanosecond
11 MD run of a protein in a box of water. </P>  
12
13 <hr>
14 <pre>
15 title                    = Yo
16 cpp                      = /lib/cpp
17 include                  = -I../top
18 define                   = 
19 integrator               = md
20 dt                       = 0.002
21 nsteps                   = 500000
22 nstxout                  = 5000
23 nstvout                  = 5000
24 nstlog                   = 5000
25 nstenergy                = 250
26 nstxout-compressed       = 250
27 compressed-x-grps        = Protein
28 energygrps               = Protein  SOL
29 nstlist                  = 10
30 ns-type                  = grid
31 rlist                    = 0.8
32 coulombtype              = cut-off
33 rcoulomb                 = 1.4
34 rvdw                     = 0.8
35 tcoupl                   = Berendsen
36 tc-grps                  = Protein      SOL
37 tau-t                    = 0.1  0.1
38 ref-t                    = 300  300
39 Pcoupl                   = Berendsen
40 tau-p                    = 1.0
41 compressibility          = 4.5e-5
42 ref-p                    = 1.0
43 gen-vel                  = yes
44 gen-temp                 = 300
45 gen-seed                 = 173529
46 constraints              = all-bonds
47 </pre>
48 <hr>
49
50 <p>
51 With this input <a href="../programs/gmx-grompp.html"><tt>grompp</tt></a> will produce
52 an <tt>mdout.mdp</tt> with all the options and descriptions:
53 </p>
54
55 <hr>
56 <pre>
57 ; VARIOUS PREPROCESSING OPTIONS = 
58 title                    = Yo
59 cpp                      = /lib/cpp
60 include                  = -I../top
61 define                   = 
62
63 ; RUN CONTROL PARAMETERS = 
64 integrator               = md
65 ; start time and timestep in ps = 
66 tinit                    = 0
67 dt                       = 0.002
68 nsteps                   = 500000
69 ; number of steps for center of mass motion removal = 
70 nstcomm                  = 1
71 comm-grps                = 
72
73 ; LANGEVIN DYNAMICS OPTIONS = 
74 ; Temperature, friction coefficient (amu/ps) and random seed = 
75 bd-temp                  = 300
76 bd-fric                  = 0
77 ld-seed                  = 1993
78
79 ; ENERGY MINIMIZATION OPTIONS = 
80 ; Force tolerance and initial step-size = 
81 emtol                    = 100
82 emstep                   = 0.01
83 ; Max number of iterations in relax-shells = 
84 niter                    = 20
85 ; Frequency of steepest descents steps when doing CG = 
86 nstcgsteep               = 1000
87
88 ; OUTPUT CONTROL OPTIONS = 
89 ; Output frequency for coords (x), velocities (v) and forces (f) = 
90 nstxout                  = 5000
91 nstvout                  = 5000
92 nstfout                  = 0
93 ; Output frequency for energies to log file and energy file = 
94 nstlog                   = 5000
95 nstenergy                = 250
96 ; Output frequency and precision for xtc file = 
97 nstxout-compressed       = 250
98 compressed-x-precision   = 1000
99 ; This selects the subset of atoms for the xtc file. You can = 
100 ; select multiple groups. By default all atoms will be written. = 
101 compressed-x-grps        = Protein
102 ; Selection of energy groups = 
103 energygrps               = Protein  SOL
104
105 ; NEIGHBORSEARCHING PARAMETERS = 
106 ; nblist update frequency = 
107 nstlist                  = 10
108 ; ns algorithm (simple or grid) = 
109 ns-type                  = grid
110 ; Periodic boundary conditions: xyz or none = 
111 pbc                      = xyz
112 ; nblist cut-off         = 
113 rlist                    = 0.8
114
115 ; OPTIONS FOR ELECTROSTATICS AND VDW = 
116 ; Method for doing electrostatics = 
117 coulombtype              = cut-off
118 rcoulomb-switch          = 0
119 rcoulomb                 = 1.4
120 ; Dielectric constant (DC) for cut-off or DC of reaction field = 
121 epsilon-r                = 1
122 ; Method for doing Van der Waals = 
123 vdw-type                 = Cut-off
124 ; cut-off lengths        = 
125 rvdw-switch              = 0
126 rvdw                     = 0.8
127 ; Apply long range dispersion corrections for Energy and Pressure = 
128 DispCorr                 = No
129 ; Spacing for the PME/PPPM FFT grid = 
130 fourierspacing           = 0.12
131 ; FFT grid size, when a value is 0 fourierspacing will be used = 
132 fourier-nx               = 0
133 fourier-ny               = 0
134 fourier-nz               = 0
135 ; EWALD/PME/PPPM parameters = 
136 pme-order                = 4
137 ewald-rtol               = 1e-05
138 epsilon-surface          = 0
139 optimize-fft             = no
140
141 ; OPTIONS FOR WEAK COUPLING ALGORITHMS = 
142 ; Temperature coupling   = 
143 tcoupl                   = Berendsen
144 ; Groups to couple separately = 
145 tc-grps                  = Protein      SOL
146 ; Time constant (ps) and reference temperature (K) = 
147 tau-t                    = 0.1  0.1
148 ref-t                    = 300  300
149 ; Pressure coupling      = 
150 Pcoupl                   = Berendsen
151 Pcoupltype               = Isotropic
152 ; Time constant (ps), compressibility (1/bar) and reference P (bar) = 
153 tau-p                    = 1.0
154 compressibility          = 4.5e-5
155 ref-p                    = 1.0
156
157 ; SIMULATED ANNEALING CONTROL = 
158 annealing                = no
159 ; Time at which temperature should be zero (ps) = 
160 zero-temp-time           = 0
161
162 ; GENERATE VELOCITIES FOR STARTUP RUN = 
163 gen-vel                  = yes
164 gen-temp                 = 300
165 gen-seed                 = 173529
166
167 ; OPTIONS FOR BONDS     = 
168 constraints              = all-bonds
169 ; Type of constraint algorithm = 
170 constraint-algorithm     = Lincs
171 ; Do not constrain the start configuration = 
172 unconstrained-start      = no
173 ; Relative tolerance of shake = 
174 shake-tol                = 0.0001
175 ; Highest order in the expansion of the constraint coupling matrix = 
176 lincs-order              = 4
177 ; Lincs will write a warning to the stderr if in one step a bond = 
178 ; rotates over more degrees than = 
179 lincs-warnangle          = 30
180 ; Convert harmonic bonds to morse potentials = 
181 morse                    = no
182
183 ; NMR refinement stuff  = 
184 ; Distance restraints type: No, Simple or Ensemble = 
185 disre                    = No
186 ; Force weighting of pairs in one distance restraint: Equal or Conservative = 
187 disre-weighting          = Equal
188 ; Use sqrt of the time averaged times the instantaneous violation = 
189 disre-mixed              = no
190 disre-fc                 = 1000
191 disre-tau                = 0
192 ; Output frequency for pair distances to energy file = 
193 nstdisreout              = 100
194
195 ; Free energy control stuff = 
196 free-energy              = no
197 init-lambda              = 0
198 delta-lambda             = 0
199 sc-alpha                 = 0
200 sc-sigma                 = 0.3
201
202 ; Non-equilibrium MD stuff = 
203 acc-grps                 = 
204 accelerate               = 
205 freezegrps               = 
206 freezedim                = 
207 cos-acceleration         = 0
208 energygrp-excl           =
209
210 ; Electric fields       = 
211 ; Format is number of terms (int) and for all terms an amplitude (real) = 
212 ; and a phase angle (real) = 
213 E-x                      = 
214 E-xt                     = 
215 E-y                      = 
216 E-yt                     = 
217 E-z                      = 
218 E-zt                     = 
219
220 ; User defined thingies = 
221 user1-grps               = 
222 user2-grps               = 
223 userint1                 = 0
224 userint2                 = 0
225 userint3                 = 0
226 userint4                 = 0
227 userreal1                = 0
228 userreal2                = 0
229 userreal3                = 0
230 userreal4                = 0
231 </pre>