ebbec487aefac7c710335f96193c9cee8a7813a2
[alexxy/gromacs.git] / share / 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="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 domain-decomposition     = no
115
116 ; OPTIONS FOR ELECTROSTATICS AND VDW = 
117 ; Method for doing electrostatics = 
118 coulombtype              = cut-off
119 rcoulomb-switch          = 0
120 rcoulomb                 = 1.4
121 ; Dielectric constant (DC) for cut-off or DC of reaction field = 
122 epsilon-r                = 1
123 ; Method for doing Van der Waals = 
124 vdw-type                 = Cut-off
125 ; cut-off lengths        = 
126 rvdw-switch              = 0
127 rvdw                     = 0.8
128 ; Apply long range dispersion corrections for Energy and Pressure = 
129 DispCorr                 = No
130 ; Spacing for the PME/PPPM FFT grid = 
131 fourierspacing           = 0.12
132 ; FFT grid size, when a value is 0 fourierspacing will be used = 
133 fourier-nx               = 0
134 fourier-ny               = 0
135 fourier-nz               = 0
136 ; EWALD/PME/PPPM parameters = 
137 pme-order                = 4
138 ewald-rtol               = 1e-05
139 epsilon-surface          = 0
140 optimize-fft             = no
141
142 ; OPTIONS FOR WEAK COUPLING ALGORITHMS = 
143 ; Temperature coupling   = 
144 tcoupl                   = Berendsen
145 ; Groups to couple separately = 
146 tc-grps                  = Protein      SOL
147 ; Time constant (ps) and reference temperature (K) = 
148 tau-t                    = 0.1  0.1
149 ref-t                    = 300  300
150 ; Pressure coupling      = 
151 Pcoupl                   = Berendsen
152 Pcoupltype               = Isotropic
153 ; Time constant (ps), compressibility (1/bar) and reference P (bar) = 
154 tau-p                    = 1.0
155 compressibility          = 4.5e-5
156 ref-p                    = 1.0
157
158 ; SIMULATED ANNEALING CONTROL = 
159 annealing                = no
160 ; Time at which temperature should be zero (ps) = 
161 zero-temp-time           = 0
162
163 ; GENERATE VELOCITIES FOR STARTUP RUN = 
164 gen-vel                  = yes
165 gen-temp                 = 300
166 gen-seed                 = 173529
167
168 ; OPTIONS FOR BONDS     = 
169 constraints              = all-bonds
170 ; Type of constraint algorithm = 
171 constraint-algorithm     = Lincs
172 ; Do not constrain the start configuration = 
173 unconstrained-start      = no
174 ; Relative tolerance of shake = 
175 shake-tol                = 0.0001
176 ; Highest order in the expansion of the constraint coupling matrix = 
177 lincs-order              = 4
178 ; Lincs will write a warning to the stderr if in one step a bond = 
179 ; rotates over more degrees than = 
180 lincs-warnangle          = 30
181 ; Convert harmonic bonds to morse potentials = 
182 morse                    = no
183
184 ; NMR refinement stuff  = 
185 ; Distance restraints type: No, Simple or Ensemble = 
186 disre                    = No
187 ; Force weighting of pairs in one distance restraint: Equal or Conservative = 
188 disre-weighting          = Equal
189 ; Use sqrt of the time averaged times the instantaneous violation = 
190 disre-mixed              = no
191 disre-fc                 = 1000
192 disre-tau                = 0
193 ; Output frequency for pair distances to energy file = 
194 nstdisreout              = 100
195
196 ; Free energy control stuff = 
197 free-energy              = no
198 init-lambda              = 0
199 delta-lambda             = 0
200 sc-alpha                 = 0
201 sc-sigma                 = 0.3
202
203 ; Non-equilibrium MD stuff = 
204 acc-grps                 = 
205 accelerate               = 
206 freezegrps               = 
207 freezedim                = 
208 cos-acceleration         = 0
209 energygrp-excl           =
210
211 ; Electric fields       = 
212 ; Format is number of terms (int) and for all terms an amplitude (real) = 
213 ; and a phase angle (real) = 
214 E-x                      = 
215 E-xt                     = 
216 E-y                      = 
217 E-yt                     = 
218 E-z                      = 
219 E-zt                     = 
220
221 ; User defined thingies = 
222 user1-grps               = 
223 user2-grps               = 
224 userint1                 = 0
225 userint2                 = 0
226 userint3                 = 0
227 userint4                 = 0
228 userreal1                = 0
229 userreal2                = 0
230 userreal3                = 0
231 userreal4                = 0
232 </pre>