2 * This file is part of the GROMACS molecular simulation package.
4 * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
5 * Copyright (c) 2001-2004, The GROMACS development team.
6 * Copyright (c) 2013, by the GROMACS development team, led by
7 * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
8 * and including many others, as listed in the AUTHORS file in the
9 * top-level source directory and at http://www.gromacs.org.
11 * GROMACS is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU Lesser General Public License
13 * as published by the Free Software Foundation; either version 2.1
14 * of the License, or (at your option) any later version.
16 * GROMACS is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * Lesser General Public License for more details.
21 * You should have received a copy of the GNU Lesser General Public
22 * License along with GROMACS; if not, see
23 * http://www.gnu.org/licenses, or write to the Free Software Foundation,
24 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
26 * If you want to redistribute modifications to GROMACS, please
27 * consider that scientific software is very special. Version
28 * control is crucial - bugs must be traceable. We will be happy to
29 * consider code for inclusion in the official distribution, but
30 * derived work must not be called official GROMACS. Details are found
31 * in the README & COPYING files - if they are missing, get the
32 * official version at http://www.gromacs.org.
34 * To help us fund GROMACS development, we humbly ask that you cite
35 * the research papers on the package. Check out http://www.gromacs.org.
43 #include "../sysstuff.h"
51 int n; /* Number of terms */
52 real *a; /* Coeffients (V / nm ) */
53 real *phi; /* Phase angles */
57 real E0; /* Field strength (V/nm) */
58 real omega; /* Frequency (1/ps) */
59 real t0; /* Centre of the Gaussian pulse (ps) */
60 real sigma; /* Width of the Gaussian pulse (FWHM) (ps) */
63 #define EGP_EXCL (1<<0)
64 #define EGP_TABLE (1<<1)
67 int ngtc; /* # T-Coupl groups */
68 int nhchainlength; /* # of nose-hoover chains per group */
69 int ngacc; /* # Accelerate groups */
70 int ngfrz; /* # Freeze groups */
71 int ngener; /* # Ener groups */
72 real *nrdf; /* Nr of degrees of freedom in a group */
73 real *ref_t; /* Coupling temperature per group */
74 int *annealing; /* No/simple/periodic SA for each group */
75 int *anneal_npoints; /* Number of annealing time points per grp */
76 real **anneal_time; /* For ea. group: Time points */
77 real **anneal_temp; /* For ea. grp: Temperature at these times */
78 /* Final temp after all intervals is ref_t */
79 real *tau_t; /* Tau coupling time */
80 rvec *acc; /* Acceleration per group */
81 ivec *nFreeze; /* Freeze the group in each direction ? */
82 int *egp_flags; /* Exclusions/tables of energy group pairs */
85 int ngQM; /* nr of QM groups */
86 int *QMmethod; /* Level of theory in the QM calculation */
87 int *QMbasis; /* Basisset in the QM calculation */
88 int *QMcharge; /* Total charge in the QM region */
89 int *QMmult; /* Spin multiplicicty in the QM region */
90 gmx_bool *bSH; /* surface hopping (diabatic hop only) */
91 int *CASorbitals; /* number of orbiatls in the active space */
92 int *CASelectrons; /* number of electrons in the active space */
93 real *SAon; /* at which gap (A.U.) the SA is switched on */
95 int *SAsteps; /* in how many steps SA goes from 1-1 to 0.5-0.5*/
101 epgrppbcNONE, epgrppbcREFAT, epgrppbcCOS
105 int nat; /* Number of atoms in the pull group */
106 atom_id *ind; /* The global atoms numbers */
107 int nat_loc; /* Number of local pull atoms */
108 int nalloc_loc; /* Allocation size for ind_loc and weight_loc */
109 atom_id *ind_loc; /* Local pull indices */
110 int nweight; /* The number of weights (0 or nat) */
111 real *weight; /* Weights (use all 1 when weight==NULL) */
112 real *weight_loc; /* Weights for the local indices */
113 int epgrppbc; /* The type of pbc for this pull group, see enum above */
114 atom_id pbcatom; /* The reference atom for pbc (global number) */
116 /* Variables not present in mdp, but used at run time */
117 real wscale; /* scaling factor for the weights: sum w m/sum w w m */
118 real invtm; /* inverse total mass of the group: 1/wscale sum w m */
119 dvec x; /* center of mass before update */
120 dvec xp; /* center of mass after update before constraining */
124 int group[2]; /* The pull groups, index in group in t_pull */
125 rvec origin; /* The origin for the absolute reference */
126 rvec vec; /* The pull vector, direction or position */
127 real init; /* Initial reference displacement */
128 real rate; /* Rate of motion (nm/ps) */
129 real k; /* force constant */
130 real kB; /* force constant for state B */
132 /* Variables not present in mdp, but used at run time */
133 dvec dr; /* The distance from the reference group */
134 double f_scal; /* Scalar force for directional pulling */
135 dvec f; /* force due to the pulling/constraining */
139 int eSimTempScale; /* simulated temperature scaling; linear or exponential */
140 real simtemp_low; /* the low temperature for simulated tempering */
141 real simtemp_high; /* the high temperature for simulated tempering */
142 real *temperatures; /* the range of temperatures used for simulated tempering */
146 int nstdhdl; /* The frequency for calculating dhdl */
147 double init_lambda; /* fractional value of lambda (usually will use
148 init_fep_state, this will only be for slow growth,
149 and for legacy free energy code. Only has a
150 valid value if positive) */
151 int init_fep_state; /* the initial number of the state */
152 double delta_lambda; /* change of lambda per time step (fraction of (0.1) */
153 gmx_bool bPrintEnergy; /* Whether to print the energy in the dhdl */
154 int n_lambda; /* The number of foreign lambda points */
155 double **all_lambda; /* The array of all lambda values */
156 int lambda_neighbors; /* The number of neighboring lambda states to
157 calculate the energy for in up and down directions
159 int lambda_start_n; /* The first lambda to calculate energies for */
160 int lambda_stop_n; /* The last lambda +1 to calculate energies for */
161 real sc_alpha; /* free energy soft-core parameter */
162 int sc_power; /* lambda power for soft-core interactions */
163 real sc_r_power; /* r power for soft-core interactions */
164 real sc_sigma; /* free energy soft-core sigma when c6 or c12=0 */
165 real sc_sigma_min; /* free energy soft-core sigma for ????? */
166 gmx_bool bScCoul; /* use softcore for the coulomb portion as well (default FALSE) */
167 gmx_bool separate_dvdl[efptNR]; /* whether to print the dvdl term associated with
168 this term; if it is not specified as separate,
169 it is lumped with the FEP term */
170 int separate_dhdl_file; /* whether to write a separate dhdl.xvg file
171 note: NOT a gmx_bool, but an enum */
172 int dhdl_derivatives; /* whether to calculate+write dhdl derivatives
173 note: NOT a gmx_bool, but an enum */
174 int dh_hist_size; /* The maximum table size for the dH histogram */
175 double dh_hist_spacing; /* The spacing for the dH histogram */
179 int nstexpanded; /* The frequency of expanded ensemble state changes */
180 int elamstats; /* which type of move updating do we use for lambda monte carlo (or no for none) */
181 int elmcmove; /* what move set will be we using for state space moves */
182 int elmceq; /* the method we use to decide of we have equilibrated the weights */
183 int equil_n_at_lam; /* the minumum number of samples at each lambda for deciding whether we have reached a minimum */
184 real equil_wl_delta; /* WL delta at which we stop equilibrating weights */
185 real equil_ratio; /* use the ratio of weights (ratio of minimum to maximum) to decide when to stop equilibrating */
186 int equil_steps; /* after equil_steps steps we stop equilibrating the weights */
187 int equil_samples; /* after equil_samples total samples (steps/nstfep), we stop equilibrating the weights */
188 int lmc_seed; /* random number seed for lambda mc switches */
189 gmx_bool minvar; /* whether to use minumum variance weighting */
190 int minvarmin; /* the number of samples needed before kicking into minvar routine */
191 real minvar_const; /* the offset for the variance in MinVar */
192 int c_range; /* range of cvalues used for BAR */
193 gmx_bool bSymmetrizedTMatrix; /* whether to print symmetrized matrices */
194 int nstTij; /* How frequently to print the transition matrices */
195 int lmc_repeats; /* number of repetitions in the MC lambda jumps */ /*MRS -- VERIFY THIS */
196 int lmc_forced_nstart; /* minimum number of samples for each state before free sampling */ /* MRS -- VERIFY THIS! */
197 int gibbsdeltalam; /* distance in lambda space for the gibbs interval */
198 real wl_scale; /* scaling factor for wang-landau */
199 real wl_ratio; /* ratio between largest and smallest number for freezing the weights */
200 real init_wl_delta; /* starting delta for wang-landau */
201 gmx_bool bWLoneovert; /* use one over t convergece for wang-landau when the delta get sufficiently small */
202 gmx_bool bInit_weights; /* did we initialize the weights? TODO: REMOVE FOR 5.0, no longer needed with new logic */
203 real mc_temp; /* To override the main temperature, or define it if it's not defined */
204 real *init_lambda_weights; /* user-specified initial weights to start with */
208 int ngroup; /* number of pull groups */
209 int ncoord; /* number of pull coordinates */
210 int eGeom; /* pull geometry */
211 ivec dim; /* used to select components for constraint */
212 real cyl_r1; /* radius of cylinder for dynamic COM */
213 real cyl_r0; /* radius of cylinder including switch length */
214 real constr_tol; /* absolute tolerance for constraints in (nm) */
215 gmx_bool bPrintRef; /* Print coordinates of the first group in each coord */
216 int nstxout; /* Output frequency for pull x */
217 int nstfout; /* Output frequency for pull f */
218 int ePBC; /* the boundary conditions */
219 int npbcdim; /* do pbc in dims 0 <= dim < npbcdim */
220 gmx_bool bRefAt; /* do we need reference atoms for a group COM ? */
221 int cosdim; /* dimension for cosine weighting, -1 if none */
222 gmx_bool bVirial; /* do we need to add the pull virial? */
223 t_pull_group *group; /* groups to pull/restrain/etc/ */
224 t_pull_coord *coord; /* the pull coordinates */
226 /* Variables not present in mdp, but used at run time */
227 t_pull_group *dyna; /* dynamic groups for use with local constraints */
228 rvec *rbuf; /* COM calculation buffer */
229 dvec *dbuf; /* COM calculation buffer */
230 double *dbuf_cyl; /* cylinder ref. groups COM calculation buffer */
232 FILE *out_x; /* output file for pull data */
233 FILE *out_f; /* output file for pull data */
237 /* Abstract types for enforced rotation only defined in pull_rotation.c */
238 typedef struct gmx_enfrot *gmx_enfrot_t;
239 typedef struct gmx_enfrotgrp *gmx_enfrotgrp_t;
242 int eType; /* Rotation type for this group */
243 int bMassW; /* Use mass-weighed positions? */
244 int nat; /* Number of atoms in the group */
245 atom_id *ind; /* The global atoms numbers */
246 rvec *x_ref; /* The reference positions */
247 rvec vec; /* The normalized rotation vector */
248 real rate; /* Rate of rotation (degree/ps) */
249 real k; /* Force constant (kJ/(mol nm^2) */
250 rvec pivot; /* Pivot point of rotation axis (nm) */
251 int eFittype; /* Type of fit to determine actual group angle */
252 int PotAngle_nstep; /* Number of angles around the reference angle
253 for which the rotation potential is also
254 evaluated (for fit type 'potential' only) */
255 real PotAngle_step; /* Distance between two angles in degrees (for
256 fit type 'potential' only) */
257 real slab_dist; /* Slab distance (nm) */
258 real min_gaussian; /* Minimum value the gaussian must have so that
259 the force is actually evaluated */
260 real eps; /* Additive constant for radial motion2 and
261 flexible2 potentials (nm^2) */
262 gmx_enfrotgrp_t enfrotgrp; /* Stores non-inputrec rotation data per group */
266 int ngrp; /* Number of rotation groups */
267 int nstrout; /* Output frequency for main rotation outfile */
268 int nstsout; /* Output frequency for per-slab data */
269 t_rotgrp *grp; /* Groups to rotate */
270 gmx_enfrot_t enfrot; /* Stores non-inputrec enforced rotation data */
275 int type; /* type of AdResS simulation */
276 gmx_bool bnew_wf; /* enable new AdResS weighting function */
277 gmx_bool bchempot_dx; /*true:interaction table format input is F=-dmu/dx false: dmu_dwp */
278 gmx_bool btf_full_box; /* true: appy therm force everywhere in the box according to table false: only in hybrid region */
279 real const_wf; /* value of weighting function for eAdressConst */
280 real ex_width; /* center of the explicit zone */
281 real hy_width; /* width of the hybrid zone */
282 int icor; /* type of interface correction */
283 int site; /* AdResS CG site location */
284 rvec refs; /* Coordinates for AdResS reference */
285 real ex_forcecap; /* in the hybrid zone, cap forces large then this to adress_ex_forcecap */
286 gmx_bool do_hybridpairs; /* If true pair interaction forces are also scaled in an adress way*/
288 int * tf_table_index; /* contains mapping of energy group index -> i-th adress tf table*/
295 int eI; /* Integration method */
296 gmx_int64_t nsteps; /* number of steps to be taken */
297 int simulation_part; /* Used in checkpointing to separate chunks */
298 gmx_int64_t init_step; /* start at a stepcount >0 (used w. tpbconv) */
299 int nstcalcenergy; /* frequency of energy calc. and T/P coupl. upd. */
300 int cutoff_scheme; /* group or verlet cutoffs */
301 int ns_type; /* which ns method should we use? */
302 int nstlist; /* number of steps before pairlist is generated */
303 int ndelta; /* number of cells per rlong */
304 int nstcomm; /* number of steps after which center of mass */
305 /* motion is removed */
306 int comm_mode; /* Center of mass motion removal algorithm */
307 int nstcheckpoint; /* checkpointing frequency */
308 int nstlog; /* number of steps after which print to logfile */
309 int nstxout; /* number of steps after which X is output */
310 int nstvout; /* id. for V */
311 int nstfout; /* id. for F */
312 int nstenergy; /* number of steps after which energies printed */
313 int nstxout_compressed; /* id. for compressed trj (.xtc,.tng) */
314 double init_t; /* initial time (ps) */
315 double delta_t; /* time step (ps) */
316 real x_compression_precision; /* precision of x in compressed trajectory file */
317 real fourier_spacing; /* requested fourier_spacing, when nk? not set */
318 int nkx, nky, nkz; /* number of k vectors in each spatial dimension*/
319 /* for fourier methods for long range electrost.*/
320 int pme_order; /* interpolation order for PME */
321 real ewald_rtol; /* Real space tolerance for Ewald, determines */
322 /* the real/reciprocal space relative weight */
323 real ewald_rtol_lj; /* Real space tolerance for LJ-Ewald */
324 int ewald_geometry; /* normal/3d ewald, or pseudo-2d LR corrections */
325 real epsilon_surface; /* Epsilon for PME dipole correction */
326 gmx_bool bOptFFT; /* optimize the fft plan at start */
327 int ljpme_combination_rule; /* Type of combination rule in LJ-PME */
328 int ePBC; /* Type of periodic boundary conditions */
329 int bPeriodicMols; /* Periodic molecules */
330 gmx_bool bContinuation; /* Continuation run: starting state is correct */
331 int etc; /* temperature coupling */
332 int nsttcouple; /* interval in steps for temperature coupling */
333 gmx_bool bPrintNHChains; /* whether to print nose-hoover chains */
334 int epc; /* pressure coupling */
335 int epct; /* pressure coupling type */
336 int nstpcouple; /* interval in steps for pressure coupling */
337 real tau_p; /* pressure coupling time (ps) */
338 tensor ref_p; /* reference pressure (kJ/(mol nm^3)) */
339 tensor compress; /* compressability ((mol nm^3)/kJ) */
340 int refcoord_scaling; /* How to scale absolute reference coordinates */
341 rvec posres_com; /* The COM of the posres atoms */
342 rvec posres_comB; /* The B-state COM of the posres atoms */
343 int andersen_seed; /* Random seed for Andersen thermostat (obsolete) */
344 real verletbuf_tol; /* Per atom pair energy drift tolerance (kJ/mol/ps/atom) for list buffer */
345 real rlist; /* short range pairlist cut-off (nm) */
346 real rlistlong; /* long range pairlist cut-off (nm) */
347 int nstcalclr; /* Frequency of evaluating direct space long-range interactions */
348 real rtpi; /* Radius for test particle insertion */
349 int coulombtype; /* Type of electrostatics treatment */
350 int coulomb_modifier; /* Modify the Coulomb interaction */
351 real rcoulomb_switch; /* Coulomb switch range start (nm) */
352 real rcoulomb; /* Coulomb cutoff (nm) */
353 real epsilon_r; /* relative dielectric constant */
354 real epsilon_rf; /* relative dielectric constant of the RF */
355 int implicit_solvent; /* No (=explicit water), or GBSA solvent models */
356 int gb_algorithm; /* Algorithm to use for calculation Born radii */
357 int nstgbradii; /* Frequency of updating Generalized Born radii */
358 real rgbradii; /* Cutoff for GB radii calculation */
359 real gb_saltconc; /* Salt concentration (M) for GBSA models */
360 real gb_epsilon_solvent; /* dielectric coeff. of implicit solvent */
361 real gb_obc_alpha; /* 1st scaling factor for Bashford-Case GB */
362 real gb_obc_beta; /* 2nd scaling factor for Bashford-Case GB */
363 real gb_obc_gamma; /* 3rd scaling factor for Bashford-Case GB */
364 real gb_dielectric_offset; /* Dielectric offset for Still/HCT/OBC */
365 int sa_algorithm; /* Algorithm for SA part of GBSA */
366 real sa_surface_tension; /* Energy factor for SA part of GBSA */
367 int vdwtype; /* Type of Van der Waals treatment */
368 int vdw_modifier; /* Modify the VdW interaction */
369 real rvdw_switch; /* Van der Waals switch range start (nm) */
370 real rvdw; /* Van der Waals cutoff (nm) */
371 int eDispCorr; /* Perform Long range dispersion corrections */
372 real tabext; /* Extension of the table beyond the cut-off, *
373 * as well as the table length for 1-4 interac. */
374 real shake_tol; /* tolerance for shake */
375 int efep; /* free energy calculations */
376 t_lambda *fepvals; /* Data for the FEP state */
377 gmx_bool bSimTemp; /* Whether to do simulated tempering */
378 t_simtemp *simtempvals; /* Variables for simulated tempering */
379 gmx_bool bExpanded; /* Whether expanded ensembles are used */
380 t_expanded *expandedvals; /* Expanded ensemble parameters */
381 int eDisre; /* Type of distance restraining */
382 real dr_fc; /* force constant for ta_disre */
383 int eDisreWeighting; /* type of weighting of pairs in one restraints */
384 gmx_bool bDisreMixed; /* Use comb of time averaged and instan. viol's */
385 int nstdisreout; /* frequency of writing pair distances to enx */
386 real dr_tau; /* time constant for memory function in disres */
387 real orires_fc; /* force constant for orientational restraints */
388 real orires_tau; /* time constant for memory function in orires */
389 int nstorireout; /* frequency of writing tr(SD) to enx */
390 real dihre_fc; /* force constant for dihedral restraints (obsolete) */
391 real em_stepsize; /* The stepsize for updating */
392 real em_tol; /* The tolerance */
393 int niter; /* Number of iterations for convergence of */
394 /* steepest descent in relax_shells */
395 real fc_stepsize; /* Stepsize for directional minimization */
396 /* in relax_shells */
397 int nstcgsteep; /* number of steps after which a steepest */
398 /* descents step is done while doing cg */
399 int nbfgscorr; /* Number of corrections to the hessian to keep */
400 int eConstrAlg; /* Type of constraint algorithm */
401 int nProjOrder; /* Order of the LINCS Projection Algorithm */
402 real LincsWarnAngle; /* If bond rotates more than %g degrees, warn */
403 int nLincsIter; /* Number of iterations in the final Lincs step */
404 gmx_bool bShakeSOR; /* Use successive overrelaxation for shake */
405 real bd_fric; /* Friction coefficient for BD (amu/ps) */
406 int ld_seed; /* Random seed for SD and BD */
407 int nwall; /* The number of walls */
408 int wall_type; /* The type of walls */
409 real wall_r_linpot; /* The potentail is linear for r<=wall_r_linpot */
410 int wall_atomtype[2]; /* The atom type for walls */
411 real wall_density[2]; /* Number density for walls */
412 real wall_ewald_zfac; /* Scaling factor for the box for Ewald */
413 int ePull; /* Type of pulling: no, umbrella or constraint */
414 t_pull *pull; /* The data for center of mass pulling */
415 gmx_bool bRot; /* Calculate enforced rotation potential(s)? */
416 t_rot *rot; /* The data for enforced rotation potentials */
417 real cos_accel; /* Acceleration for viscosity calculation */
418 tensor deform; /* Triclinic deformation velocities (nm/ps) */
419 int userint1; /* User determined parameters */
427 t_grpopts opts; /* Group options */
428 t_cosines ex[DIM]; /* Electric field stuff (spatial part) */
429 t_cosines et[DIM]; /* Electric field stuff (time part) */
430 gmx_bool bQMMM; /* QM/MM calculation */
431 int QMconstraints; /* constraints on QM bonds */
432 int QMMMscheme; /* Scheme: ONIOM or normal */
433 real scalefactor; /* factor for scaling the MM charges in QM calc.*/
434 /* parameter needed for AdResS simulation */
435 gmx_bool bAdress; /* Is AdResS enabled ? */
436 t_adress *adress; /* The data for adress simulations */
439 #define DEFORM(ir) ((ir).deform[XX][XX] != 0 || (ir).deform[YY][YY] != 0 || (ir).deform[ZZ][ZZ] != 0 || (ir).deform[YY][XX] != 0 || (ir).deform[ZZ][XX] != 0 || (ir).deform[ZZ][YY] != 0)
441 #define DYNAMIC_BOX(ir) ((ir).epc != epcNO || (ir).eI == eiTPI || DEFORM(ir))
443 #define PRESERVE_SHAPE(ir) ((ir).epc != epcNO && (ir).deform[XX][XX] == 0 && ((ir).epct == epctISOTROPIC || (ir).epct == epctSEMIISOTROPIC))
445 #define NEED_MUTOT(ir) (((ir).coulombtype == eelEWALD || EEL_PME((ir).coulombtype)) && ((ir).ewald_geometry == eewg3DC || (ir).epsilon_surface != 0))
447 #define IR_TWINRANGE(ir) ((ir).rlist > 0 && ((ir).rlistlong == 0 || (ir).rlistlong > (ir).rlist))
449 #define IR_ELEC_FIELD(ir) ((ir).ex[XX].n > 0 || (ir).ex[YY].n > 0 || (ir).ex[ZZ].n > 0)
451 #define IR_EXCL_FORCES(ir) (EEL_FULL((ir).coulombtype) || (EEL_RF((ir).coulombtype) && (ir).coulombtype != eelRF_NEC) || (ir).implicit_solvent != eisNO)
452 /* use pointer definitions of ir here, since that's what's usually used in the code */
453 #define IR_NPT_TROTTER(ir) ((((ir)->eI == eiVV) || ((ir)->eI == eiVVAK)) && (((ir)->epc == epcMTTK) && ((ir)->etc == etcNOSEHOOVER)))
455 #define IR_NVT_TROTTER(ir) ((((ir)->eI == eiVV) || ((ir)->eI == eiVVAK)) && ((!((ir)->epc == epcMTTK)) && ((ir)->etc == etcNOSEHOOVER)))
457 #define IR_NPH_TROTTER(ir) ((((ir)->eI == eiVV) || ((ir)->eI == eiVVAK)) && (((ir)->epc == epcMTTK) && (!(((ir)->etc == etcNOSEHOOVER)))))