3 * This source code is part of
7 * GROningen MAchine for Chemical Simulations
10 * Written by David van der Spoel, Erik Lindahl, Berk Hess, and others.
11 * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
12 * Copyright (c) 2001-2004, The GROMACS development team,
13 * check out http://www.gromacs.org for more information.
15 * This program is free software; you can redistribute it and/or
16 * modify it under the terms of the GNU General Public License
17 * as published by the Free Software Foundation; either version 2
18 * of the License, or (at your option) any later version.
20 * If you want to redistribute modifications, please consider that
21 * scientific software is very special. Version control is crucial -
22 * bugs must be traceable. We will be happy to consider code for
23 * inclusion in the official distribution, but derived work must not
24 * be called official GROMACS. Details are found in the README & COPYING
25 * files - if they are missing, get the official version at www.gromacs.org.
27 * To help us fund GROMACS development, we humbly ask that you cite
28 * the papers on the package - you can find them in the top README file.
30 * For more info, check our website at http://www.gromacs.org
33 * GRoups of Organic Molecules in ACtion for Science
47 /* check kernel/toppush.c when you change these numbers */
49 #define MAXFORCEPARAM 12
53 typedef atom_id t_iatom;
55 /* this MUST correspond to the
56 t_interaction_function[F_NRE] in gmxlib/ifunc.c */
143 F_DVDL_TEMPERATURE, /* not calculated for now, but should just be the energy (NVT) or enthalpy (NPT), or 0 (NVE) */
144 F_NRE /* This number is for the total number of energies */
147 #define IS_RESTRAINT_TYPE(ifunc) (((ifunc==F_POSRES) || (ifunc==F_DISRES) || (ifunc==F_RESTRBONDS) || (ifunc==F_DISRESVIOL) || (ifunc==F_ORIRES) || (ifunc==F_ORIRESDEV) || (ifunc==F_ANGRES) || (ifunc == F_ANGRESZ) || (ifunc==F_DIHRES)))
151 /* Some parameters have A and B values for free energy calculations.
152 * The B values are not used for regular simulations of course.
153 * Free Energy for nonbondeds can be computed by changing the atom type.
154 * The harmonic type is used for all harmonic potentials:
155 * bonds, angles and improper dihedrals
157 struct {real a,b,c; } bham;
158 struct {real rA,krA,rB,krB; } harmonic;
159 struct {real klinA,aA,klinB,aB; } linangle;
160 struct {real lowA,up1A,up2A,kA,lowB,up1B,up2B,kB; } restraint;
161 /* No free energy supported for cubic bonds, FENE, WPOL or cross terms */
162 struct {real b0,kb,kcub; } cubic;
163 struct {real bm,kb; } fene;
164 struct {real r1e,r2e,krr; } cross_bb;
165 struct {real r1e,r2e,r3e,krt; } cross_ba;
166 struct {real thetaA,kthetaA,r13A,kUBA,thetaB,kthetaB,r13B,kUBB;} u_b;
167 struct {real theta,c[5]; } qangle;
168 struct {real alpha; } polarize;
169 struct {real alpha,drcut,khyp; } anharm_polarize;
170 struct {real al_x,al_y,al_z,rOH,rHH,rOD; } wpol;
171 struct {real a,alpha1,alpha2,rfac; } thole;
172 struct {real c6,c12; } lj;
173 struct {real c6A,c12A,c6B,c12B; } lj14;
174 struct {real fqq,qi,qj,c6,c12; } ljc14;
175 struct {real qi,qj,c6,c12; } ljcnb;
176 /* Proper dihedrals can not have different multiplicity when
177 * doing free energy calculations, because the potential would not
178 * be periodic anymore.
180 struct {real phiA,cpA;int mult;real phiB,cpB; } pdihs;
181 struct {real dA,dB; } constr;
182 /* Settle can not be used for Free energy calculations of water bond geometry.
183 * Use shake (or lincs) instead if you have to change the water bonds.
185 struct {real doh,dhh; } settle;
186 struct {real b0A,cbA,betaA,b0B,cbB,betaB; } morse;
187 struct {real pos0A[DIM],fcA[DIM],pos0B[DIM],fcB[DIM]; } posres;
188 struct {real rbcA[NR_RBDIHS], rbcB[NR_RBDIHS]; } rbdihs;
189 struct {real a,b,c,d,e,f; } vsite;
190 struct {int n; real a; } vsiten;
191 /* NOTE: npair is only set after reading the tpx file */
192 struct {real low,up1,up2,kfac;int type,label,npair; } disres;
193 struct {real phiA,dphiA,kfacA,phiB,dphiB,kfacB; } dihres;
194 struct {int ex,power,label; real c,obs,kfac; } orires;
195 struct {int table;real kA;real kB; } tab;
196 struct {real sar,st,pi,gbr,bmlt; } gb;
197 struct {int cmapA,cmapB; } cmap;
198 struct {real buf[MAXFORCEPARAM]; } generic; /* Conversion */
201 typedef int t_functype;
204 * The nonperturbed/perturbed interactions are now separated (sorted) in the
205 * ilist, such that the first 0..(nr_nonperturbed-1) ones are exactly that, and
206 * the remaining ones from nr_nonperturbed..(nr-1) are perturbed bonded
218 * The struct t_ilist defines a list of atoms with their interactions.
219 * General field description:
221 * the size (nr elements) of the interactions array (iatoms[]).
223 * specifies which atoms are involved in an interaction of a certain
224 * type. The layout of this array is as follows:
226 * +-----+---+---+---+-----+---+---+-----+---+---+---+-----+---+---+...
227 * |type1|at1|at2|at3|type2|at1|at2|type1|at1|at2|at3|type3|at1|at2|
228 * +-----+---+---+---+-----+---+---+-----+---+---+---+-----+---+---+...
230 * So for interaction type type1 3 atoms are needed, and for type2 and
231 * type3 only 2. The type identifier is used to select the function to
232 * calculate the interaction and its actual parameters. This type
233 * identifier is an index in a params[] and functype[] array.
238 real *cmap; /* Has length 4*grid_spacing*grid_spacing, */
239 /* there are 4 entries for each cmap type (V,dVdx,dVdy,d2dVdxdy) */
244 int ngrid; /* Number of allocated cmap (cmapdata_t ) grids */
245 int grid_spacing; /* Grid spacing */
246 cmapdata_t *cmapdata; /* Pointer to grid with actual, pre-interpolated data */
254 t_functype *functype;
256 double reppow; /* The repulsion power for VdW: C12*r^-reppow */
257 real fudgeQQ; /* The scaling factor for Coulomb 1-4: f*q1*q2 */
258 gmx_cmap_t cmap_grid; /* The dihedral correction maps */
262 ilsortUNKNOWN, ilsortNO_FE, ilsortFE_UNSORTED, ilsortFE_SORTED
269 t_functype *functype;
272 gmx_cmap_t cmap_grid;
273 t_iparams *iparams_posres;
274 int iparams_posres_nalloc;
281 * The struct t_idef defines all the interactions for the complete
282 * simulation. The structure is setup in such a way that the multinode
283 * version of the program can use it as easy as the single node version.
284 * General field description:
286 * defines the number of elements in functype[] and param[].
288 * the node id (if parallel machines)
290 * the number of atomtypes
291 * t_functype *functype
292 * array of length ntypes, defines for every force type what type of
293 * function to use. Every "bond" with the same function but different
294 * force parameters is a different force type. The type identifier in the
295 * forceatoms[] array is an index in this array.
297 * array of length ntypes, defines the parameters for every interaction
298 * type. The type identifier in the actual interaction list
299 * (ilist[ftype].iatoms[]) is an index in this array.
300 * gmx_cmap_t cmap_grid
301 * the grid for the dihedral pair correction maps.
302 * t_iparams *iparams_posres
303 * defines the parameters for position restraints only.
304 * Position restraints are the only interactions that have different
305 * parameters (reference positions) for different molecules
306 * of the same type. ilist[F_POSRES].iatoms[] is an index in this array.
308 * The list of interactions for each type. Note that some,
309 * such as LJ and COUL will have 0 entries.
313 int n; /* n+1 is the number of points */
314 real scale; /* distance between two points */
315 real *tab; /* the actual tables, per point there are 4 numbers */