Merge branch 'release-4-5-patches' into release-4-6
[alexxy/gromacs.git] / src / mdlib / edsam.c
1 /* -*- mode: c; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; c-file-style: "stroustrup"; -*-
2  *
3  *
4  *                This source code is part of
5  *
6  *                 G   R   O   M   A   C   S
7  *
8  *          GROningen MAchine for Chemical Simulations
9  *
10  *                        VERSION 3.2.0
11  * Written by David van der Spoel, Erik Lindahl, Berk Hess, and others.
12  * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
13  * Copyright (c) 2001-2004, The GROMACS development team,
14  * 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.
19  *
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.
26  *
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.
29  *
30  * For more info, check our website at http://www.gromacs.org
31  *
32  * And Hey:
33  * GROwing Monsters And Cloning Shrimps
34  */
35 #ifdef HAVE_CONFIG_H
36 #include <config.h>
37 #endif
38
39 #include <stdio.h>
40 #include <time.h>
41 #include "typedefs.h"
42 #include "string2.h"
43 #include "smalloc.h"
44 #include "names.h"
45 #include "confio.h"
46 #include "mvdata.h"
47 #include "txtdump.h"
48 #include "vec.h"
49 #include <time.h>
50 #include "nrnb.h"
51 #include "mshift.h"
52 #include "mdrun.h"
53 #include "update.h"
54 #include "physics.h"
55 #include "nrjac.h"
56 #include "mtop_util.h"
57 #include "edsam.h"
58 #include "mpelogging.h"
59 #include "gmxfio.h"
60 #include "groupcoord.h"
61
62
63 /* We use the same defines as in mvdata.c here */
64 #define  block_bc(cr,   d) gmx_bcast(     sizeof(d),     &(d),(cr))
65 #define nblock_bc(cr,nr,d) gmx_bcast((nr)*sizeof((d)[0]), (d),(cr))
66 #define   snew_bc(cr,d,nr) { if (!MASTER(cr)) snew((d),(nr)); }
67
68
69 /* enum to identify the type of ED: none, normal ED, flooding */
70 enum {eEDnone, eEDedsam, eEDflood, eEDnr};
71
72 /* enum to identify operations on reference, average, origin, target structures */
73 enum {eedREF, eedAV, eedORI, eedTAR, eedNR};
74
75
76 typedef struct
77 {
78     int    neig;     /* nr of eigenvectors             */
79     int   *ieig;     /* index nrs of eigenvectors      */
80     real  *stpsz;    /* stepsizes (per eigenvector)    */
81     rvec  **vec;     /* eigenvector components         */
82     real  *xproj;    /* instantaneous x projections    */
83     real  *fproj;    /* instantaneous f projections    */
84     real  radius;    /* instantaneous radius           */
85     real  *refproj;  /* starting or target projecions  */
86     /* When using flooding as harmonic restraint: The current reference projection
87      * is at each step calculated from the initial refproj0 and the slope. */
88     real  *refproj0,*refprojslope;
89 } t_eigvec;
90
91
92 typedef struct
93 {
94     t_eigvec      mon;            /* only monitored, no constraints       */
95     t_eigvec      linfix;         /* fixed linear constraints             */
96     t_eigvec      linacc;         /* acceptance linear constraints        */
97     t_eigvec      radfix;         /* fixed radial constraints (exp)       */
98     t_eigvec      radacc;         /* acceptance radial constraints (exp)  */
99     t_eigvec      radcon;         /* acceptance rad. contraction constr.  */
100 } t_edvecs;
101
102
103 typedef struct
104 {
105     real deltaF0;
106     gmx_bool bHarmonic;           /* Use flooding for harmonic restraint on
107                                      the eigenvector                          */
108     gmx_bool bConstForce;         /* Do not calculate a flooding potential,
109                                      instead flood with a constant force      */
110     real tau;
111     real deltaF;
112     real Efl;
113     real kT;
114     real Vfl;
115     real dt;
116     real constEfl;
117     real alpha2;
118     int flood_id;
119     rvec *forces_cartesian;
120     t_eigvec vecs;         /* use flooding for these */
121 } t_edflood;
122
123
124 /* This type is for the average, reference, target, and origin structure    */
125 typedef struct gmx_edx
126 {
127     int           nr;             /* number of atoms this structure contains  */
128     int           nr_loc;         /* number of atoms on local node            */
129     int           *anrs;          /* atom index numbers                       */
130     int           *anrs_loc;      /* local atom index numbers                 */
131     int           nalloc_loc;     /* allocation size of anrs_loc              */
132     int           *c_ind;         /* at which position of the whole anrs
133                                    * array is a local atom?, i.e.
134                                    * c_ind[0...nr_loc-1] gives the atom index
135                                    * with respect to the collective
136                                    * anrs[0...nr-1] array                     */
137     rvec          *x;             /* positions for this structure             */
138     rvec          *x_old;         /* used to keep track of the shift vectors
139                                      such that the ED molecule can always be
140                                      made whole in the parallel case          */
141     real          *m;             /* masses                                   */
142     real          mtot;           /* total mass (only used in sref)           */
143     real          *sqrtm;         /* sqrt of the masses used for mass-
144                                    * weighting of analysis (only used in sav) */
145 } t_gmx_edx;
146
147
148 typedef struct edpar
149 {
150     int            nini;           /* total Nr of atoms                    */
151     gmx_bool       fitmas;         /* true if trans fit with cm            */
152     gmx_bool       pcamas;         /* true if mass-weighted PCA            */
153     int            presteps;       /* number of steps to run without any
154                                     *    perturbations ... just monitoring */
155     int            outfrq;         /* freq (in steps) of writing to edo    */
156     int            maxedsteps;     /* max nr of steps per cycle            */
157
158     /* all gmx_edx datasets are copied to all nodes in the parallel case   */
159     struct gmx_edx sref;           /* reference positions, to these fitting
160                                     * will be done                         */
161     gmx_bool       bRefEqAv;       /* If true, reference & average indices
162                                     * are the same. Used for optimization  */
163     struct gmx_edx sav;            /* average positions                    */
164     struct gmx_edx star;           /* target positions                     */
165     struct gmx_edx sori;           /* origin positions                     */
166
167     t_edvecs       vecs;           /* eigenvectors                         */
168     real           slope;          /* minimal slope in acceptance radexp   */
169
170     gmx_bool       bNeedDoEdsam;   /* if any of the options mon, linfix, ...
171                                     * is used (i.e. apart from flooding)   */
172     t_edflood      flood;          /* parameters especially for flooding   */
173     struct t_ed_buffer *buf;       /* handle to local buffers              */
174     struct edpar   *next_edi;      /* Pointer to another ed dataset        */
175 } t_edpar;
176
177
178 typedef struct gmx_edsam
179 {
180     int           eEDtype;        /* Type of ED: see enums above          */
181     const char    *edinam;        /* name of ED sampling input file       */
182     const char    *edonam;        /*                     output           */
183     FILE          *edo;           /* output file pointer                  */
184     t_edpar       *edpar;
185     gmx_bool      bFirst;
186     gmx_bool      bStartFromCpt;
187 } t_gmx_edsam;
188
189
190 struct t_do_edsam
191 {
192     matrix old_rotmat;
193     real oldrad;
194     rvec old_transvec,older_transvec,transvec_compact;
195     rvec *xcoll;         /* Positions from all nodes, this is the
196                             collective set we work on.
197                             These are the positions of atoms with
198                             average structure indices */
199     rvec *xc_ref;        /* same but with reference structure indices */
200     ivec *shifts_xcoll;        /* Shifts for xcoll  */
201     ivec *extra_shifts_xcoll;  /* xcoll shift changes since last NS step */
202     ivec *shifts_xc_ref;       /* Shifts for xc_ref */
203     ivec *extra_shifts_xc_ref; /* xc_ref shift changes since last NS step */
204     gmx_bool bUpdateShifts;    /* TRUE in NS steps to indicate that the
205                                   ED shifts for this ED dataset need to
206                                   be updated */
207 };
208
209
210 /* definition of ED buffer structure */
211 struct t_ed_buffer
212 {
213     struct t_fit_to_ref *           fit_to_ref;
214     struct t_do_edfit *             do_edfit;
215     struct t_do_edsam *             do_edsam;
216     struct t_do_radcon *            do_radcon;
217 };
218
219
220 /* Function declarations */
221 static void fit_to_reference(rvec *xcoll,rvec transvec,matrix rotmat,t_edpar *edi);
222
223 static void translate_and_rotate(rvec *x,int nat,rvec transvec,matrix rotmat);
224 /* End function declarations */
225
226
227 /* Does not subtract average positions, projection on single eigenvector is returned
228  * used by: do_linfix, do_linacc, do_radfix, do_radacc, do_radcon
229  * Average position is subtracted in ed_apply_constraints prior to calling projectx
230  */
231 static real projectx(t_edpar *edi, rvec *xcoll, rvec *vec)
232 {
233     int  i;
234     real proj=0.0;
235
236
237     for (i=0; i<edi->sav.nr; i++)
238         proj += edi->sav.sqrtm[i]*iprod(vec[i], xcoll[i]);
239
240     return proj;
241 }
242
243
244 /* Specialized: projection is stored in vec->refproj
245  * -> used for radacc, radfix, radcon  and center of flooding potential
246  * subtracts average positions, projects vector x */
247 static void rad_project(t_edpar *edi, rvec *x, t_eigvec *vec, t_commrec *cr)
248 {
249     int i;
250     real rad=0.0;
251
252     /* Subtract average positions */
253     for (i = 0; i < edi->sav.nr; i++)
254         rvec_dec(x[i], edi->sav.x[i]);
255
256     for (i = 0; i < vec->neig; i++)
257     {
258         vec->refproj[i] = projectx(edi,x,vec->vec[i]);
259         rad += pow((vec->refproj[i]-vec->xproj[i]),2);
260     }
261     vec->radius=sqrt(rad);
262
263     /* Add average positions */
264     for (i = 0; i < edi->sav.nr; i++)
265         rvec_inc(x[i], edi->sav.x[i]);
266 }
267
268
269 /* Project vector x, subtract average positions prior to projection and add
270  * them afterwards to retain the unchanged vector. Store in xproj. Mass-weighting
271  * is applied. */
272 static void project_to_eigvectors(rvec       *x,    /* The positions to project to an eigenvector */
273                                   t_eigvec   *vec,  /* The eigenvectors */
274                                   t_edpar    *edi)
275 {
276     int  i;
277
278
279     if (!vec->neig) return;
280
281     /* Subtract average positions */
282     for (i=0; i<edi->sav.nr; i++)
283         rvec_dec(x[i], edi->sav.x[i]);
284
285     for (i=0; i<vec->neig; i++)
286         vec->xproj[i] = projectx(edi, x, vec->vec[i]);
287
288     /* Add average positions */
289     for (i=0; i<edi->sav.nr; i++)
290         rvec_inc(x[i], edi->sav.x[i]);
291 }
292
293
294 /* Project vector x onto all edi->vecs (mon, linfix,...) */
295 static void project(rvec      *x,     /* positions to project */
296                     t_edpar   *edi)   /* edi data set */
297 {
298     /* It is not more work to subtract the average position in every
299      * subroutine again, because these routines are rarely used simultanely */
300     project_to_eigvectors(x, &edi->vecs.mon   , edi);
301     project_to_eigvectors(x, &edi->vecs.linfix, edi);
302     project_to_eigvectors(x, &edi->vecs.linacc, edi);
303     project_to_eigvectors(x, &edi->vecs.radfix, edi);
304     project_to_eigvectors(x, &edi->vecs.radacc, edi);
305     project_to_eigvectors(x, &edi->vecs.radcon, edi);
306 }
307
308
309 static real calc_radius(t_eigvec *vec)
310 {
311     int i;
312     real rad=0.0;
313
314
315     for (i=0; i<vec->neig; i++)
316         rad += pow((vec->refproj[i]-vec->xproj[i]),2);
317
318     return rad=sqrt(rad);
319 }
320
321
322 /* Debug helper */
323 #ifdef DEBUGHELPERS
324 static void dump_xcoll(t_edpar *edi, struct t_do_edsam *buf, t_commrec *cr,
325                        int step)
326 {
327     int i;
328     FILE *fp;
329     char fn[STRLEN];
330     rvec *xcoll;
331     ivec *shifts, *eshifts;
332
333
334     if (!MASTER(cr))
335         return;
336
337     xcoll   = buf->xcoll;
338     shifts  = buf->shifts_xcoll;
339     eshifts = buf->extra_shifts_xcoll;
340
341     sprintf(fn, "xcolldump_step%d.txt", step);
342     fp = fopen(fn, "w");
343
344     for (i=0; i<edi->sav.nr; i++)
345         fprintf(fp, "%d %9.5f %9.5f %9.5f   %d %d %d   %d %d %d\n",
346                 edi->sav.anrs[i]+1,
347                 xcoll[i][XX]  , xcoll[i][YY]  , xcoll[i][ZZ],
348                 shifts[i][XX] , shifts[i][YY] , shifts[i][ZZ],
349                 eshifts[i][XX], eshifts[i][YY], eshifts[i][ZZ]);
350
351     fclose(fp);
352 }
353
354
355 /* Debug helper */
356 static void dump_edi_positions(FILE *out, struct gmx_edx *s, const char name[])
357 {
358     int i;
359
360
361     fprintf(out, "#%s positions:\n%d\n", name, s->nr);
362     if (s->nr == 0)
363         return;
364
365     fprintf(out, "#index, x, y, z");
366     if (s->sqrtm)
367         fprintf(out, ", sqrt(m)");
368     for (i=0; i<s->nr; i++)
369     {
370         fprintf(out, "\n%6d  %11.6f %11.6f %11.6f",s->anrs[i], s->x[i][XX], s->x[i][YY], s->x[i][ZZ]);
371         if (s->sqrtm)
372             fprintf(out,"%9.3f",s->sqrtm[i]);
373     }
374     fprintf(out, "\n");
375 }
376
377
378 /* Debug helper */
379 static void dump_edi_eigenvecs(FILE *out, t_eigvec *ev,
380                                const char name[], int length)
381 {
382     int i,j;
383
384
385     fprintf(out, "#%s eigenvectors:\n%d\n", name, ev->neig);
386     /* Dump the data for every eigenvector: */
387     for (i=0; i<ev->neig; i++)
388     {
389         fprintf(out, "EV %4d\ncomponents %d\nstepsize %f\nxproj %f\nfproj %f\nrefproj %f\nradius %f\nComponents:\n",
390                 ev->ieig[i], length, ev->stpsz[i], ev->xproj[i], ev->fproj[i], ev->refproj[i], ev->radius);
391         for (j=0; j<length; j++)
392             fprintf(out, "%11.6f %11.6f %11.6f\n", ev->vec[i][j][XX], ev->vec[i][j][YY], ev->vec[i][j][ZZ]);
393     }
394 }
395
396
397 /* Debug helper */
398 static void dump_edi(t_edpar *edpars, t_commrec *cr, int nr_edi)
399 {
400     FILE  *out;
401     char  fn[STRLEN];
402
403
404     sprintf(fn, "EDdump_node%d_edi%d", cr->nodeid, nr_edi);
405     out = ffopen(fn, "w");
406
407     fprintf(out,"#NINI\n %d\n#FITMAS\n %d\n#ANALYSIS_MAS\n %d\n",
408             edpars->nini,edpars->fitmas,edpars->pcamas);
409     fprintf(out,"#OUTFRQ\n %d\n#MAXLEN\n %d\n#SLOPECRIT\n %f\n",
410             edpars->outfrq,edpars->maxedsteps,edpars->slope);
411     fprintf(out,"#PRESTEPS\n %d\n#DELTA_F0\n %f\n#TAU\n %f\n#EFL_NULL\n %f\n#ALPHA2\n %f\n",
412             edpars->presteps,edpars->flood.deltaF0,edpars->flood.tau,
413             edpars->flood.constEfl,edpars->flood.alpha2);
414
415     /* Dump reference, average, target, origin positions */
416     dump_edi_positions(out, &edpars->sref, "REFERENCE");
417     dump_edi_positions(out, &edpars->sav , "AVERAGE"  );
418     dump_edi_positions(out, &edpars->star, "TARGET"   );
419     dump_edi_positions(out, &edpars->sori, "ORIGIN"   );
420
421     /* Dump eigenvectors */
422     dump_edi_eigenvecs(out, &edpars->vecs.mon   , "MONITORED", edpars->sav.nr);
423     dump_edi_eigenvecs(out, &edpars->vecs.linfix, "LINFIX"   , edpars->sav.nr);
424     dump_edi_eigenvecs(out, &edpars->vecs.linacc, "LINACC"   , edpars->sav.nr);
425     dump_edi_eigenvecs(out, &edpars->vecs.radfix, "RADFIX"   , edpars->sav.nr);
426     dump_edi_eigenvecs(out, &edpars->vecs.radacc, "RADACC"   , edpars->sav.nr);
427     dump_edi_eigenvecs(out, &edpars->vecs.radcon, "RADCON"   , edpars->sav.nr);
428
429     /* Dump flooding eigenvectors */
430     dump_edi_eigenvecs(out, &edpars->flood.vecs, "FLOODING"  , edpars->sav.nr);
431
432     /* Dump ed local buffer */
433     fprintf(out, "buf->do_edfit         =%p\n", (void*)edpars->buf->do_edfit  );
434     fprintf(out, "buf->do_edsam         =%p\n", (void*)edpars->buf->do_edsam  );
435     fprintf(out, "buf->do_radcon        =%p\n", (void*)edpars->buf->do_radcon );
436
437     ffclose(out);
438 }
439
440
441 /* Debug helper */
442 static void dump_rotmat(FILE* out,matrix rotmat)
443 {
444     fprintf(out,"ROTMAT: %12.8f %12.8f %12.8f\n",rotmat[XX][XX],rotmat[XX][YY],rotmat[XX][ZZ]);
445     fprintf(out,"ROTMAT: %12.8f %12.8f %12.8f\n",rotmat[YY][XX],rotmat[YY][YY],rotmat[YY][ZZ]);
446     fprintf(out,"ROTMAT: %12.8f %12.8f %12.8f\n",rotmat[ZZ][XX],rotmat[ZZ][YY],rotmat[ZZ][ZZ]);
447 }
448
449
450 /* Debug helper */
451 static void dump_rvec(FILE *out, int dim, rvec *x)
452 {
453     int i;
454
455
456     for (i=0; i<dim; i++)
457         fprintf(out,"%4d   %f %f %f\n",i,x[i][XX],x[i][YY],x[i][ZZ]);
458 }
459
460
461 /* Debug helper */
462 static void dump_mat(FILE* out, int dim, double** mat)
463 {
464     int i,j;
465
466
467     fprintf(out,"MATRIX:\n");
468     for (i=0;i<dim;i++)
469     {
470         for (j=0;j<dim;j++)
471             fprintf(out,"%f ",mat[i][j]);
472         fprintf(out,"\n");
473     }
474 }
475 #endif
476
477
478 struct t_do_edfit {
479     double **omega;
480     double **om;
481 };
482
483 static void do_edfit(int natoms,rvec *xp,rvec *x,matrix R,t_edpar *edi)
484 {
485     /* this is a copy of do_fit with some modifications */
486     int    c,r,n,j,i,irot;
487     double d[6],xnr,xpc;
488     matrix vh,vk,u;
489     int    index;
490     real   max_d;
491
492     struct t_do_edfit *loc;
493     gmx_bool bFirst;
494
495     if(edi->buf->do_edfit != NULL)
496         bFirst = FALSE;
497     else
498     {
499         bFirst = TRUE;
500         snew(edi->buf->do_edfit,1);
501     }
502     loc = edi->buf->do_edfit;
503
504     if (bFirst)
505     {
506         snew(loc->omega,2*DIM);
507         snew(loc->om,2*DIM);
508         for(i=0; i<2*DIM; i++)
509         {
510             snew(loc->omega[i],2*DIM);
511             snew(loc->om[i],2*DIM);
512         }
513     }
514
515     for(i=0;(i<6);i++)
516     {
517         d[i]=0;
518         for(j=0;(j<6);j++)
519         {
520             loc->omega[i][j]=0;
521             loc->om[i][j]=0;
522         }
523     }
524
525     /* calculate the matrix U */
526     clear_mat(u);
527     for(n=0;(n<natoms);n++)
528     {
529         for(c=0; (c<DIM); c++)
530         {
531             xpc=xp[n][c];
532             for(r=0; (r<DIM); r++)
533             {
534                 xnr=x[n][r];
535                 u[c][r]+=xnr*xpc;
536             }
537         }
538     }
539
540     /* construct loc->omega */
541     /* loc->omega is symmetric -> loc->omega==loc->omega' */
542     for(r=0;(r<6);r++)
543         for(c=0;(c<=r);c++)
544             if ((r>=3) && (c<3))
545             {
546                 loc->omega[r][c]=u[r-3][c];
547                 loc->omega[c][r]=u[r-3][c];
548             }
549             else
550             {
551                 loc->omega[r][c]=0;
552                 loc->omega[c][r]=0;
553             }
554
555     /* determine h and k */
556 #ifdef DEBUG
557     {
558         int i;
559         dump_mat(stderr,2*DIM,loc->omega);
560         for (i=0; i<6; i++)
561             fprintf(stderr,"d[%d] = %f\n",i,d[i]);
562     }
563 #endif
564     jacobi(loc->omega,6,d,loc->om,&irot);
565
566     if (irot==0)
567         fprintf(stderr,"IROT=0\n");
568
569     index=0; /* For the compiler only */
570
571     for(j=0;(j<3);j++)
572     {
573         max_d=-1000;
574         for(i=0;(i<6);i++)
575             if (d[i]>max_d)
576             {
577                 max_d=d[i];
578                 index=i;
579             }
580         d[index]=-10000;
581         for(i=0;(i<3);i++)
582         {
583             vh[j][i]=M_SQRT2*loc->om[i][index];
584             vk[j][i]=M_SQRT2*loc->om[i+DIM][index];
585         }
586     }
587
588     /* determine R */
589     for(c=0;(c<3);c++)
590         for(r=0;(r<3);r++)
591             R[c][r]=vk[0][r]*vh[0][c]+
592             vk[1][r]*vh[1][c]+
593             vk[2][r]*vh[2][c];
594     if (det(R) < 0)
595         for(c=0;(c<3);c++)
596             for(r=0;(r<3);r++)
597                 R[c][r]=vk[0][r]*vh[0][c]+
598                 vk[1][r]*vh[1][c]-
599                 vk[2][r]*vh[2][c];
600 }
601
602
603 static void rmfit(int nat, rvec *xcoll, rvec transvec, matrix rotmat)
604 {
605     rvec vec;
606     matrix tmat;
607
608
609     /* Remove rotation.
610      * The inverse rotation is described by the transposed rotation matrix */
611     transpose(rotmat,tmat);
612     rotate_x(xcoll, nat, tmat);
613
614     /* Remove translation */
615     vec[XX]=-transvec[XX];
616     vec[YY]=-transvec[YY];
617     vec[ZZ]=-transvec[ZZ];
618     translate_x(xcoll, nat, vec);
619 }
620
621
622 /**********************************************************************************
623  ******************** FLOODING ****************************************************
624  **********************************************************************************
625
626 The flooding ability was added later to edsam. Many of the edsam functionality could be reused for that purpose.
627 The flooding covariance matrix, i.e. the selected eigenvectors and their corresponding eigenvalues are
628 read as 7th Component Group. The eigenvalues are coded into the stepsize parameter (as used by -linfix or -linacc).
629
630 do_md clls right in the beginning the function init_edsam, which reads the edi file, saves all the necessary information in
631 the edi structure and calls init_flood, to initialise some extra fields in the edi->flood structure.
632
633 since the flooding acts on forces do_flood is called from the function force() (force.c), while the other
634 edsam functionality is hooked into md via the update() (update.c) function acting as constraint on positions.
635
636 do_flood makes a copy of the positions,
637 fits them, projects them computes flooding_energy, and flooding forces. The forces are computed in the
638 space of the eigenvectors and are then blown up to the full cartesian space and rotated back to remove the
639 fit. Then do_flood adds these forces to the forcefield-forces
640 (given as parameter) and updates the adaptive flooding parameters Efl and deltaF.
641
642 To center the flooding potential at a different location one can use the -ori option in make_edi. The ori
643 structure is projected to the system of eigenvectors and then this position in the subspace is used as
644 center of the flooding potential.   If the option is not used, the center will be zero in the subspace,
645 i.e. the average structure as given in the make_edi file.
646
647 To use the flooding potential as restraint, make_edi has the option -restrain, which leads to inverted
648 signs of alpha2 and Efl, such that the sign in the exponential of Vfl is not inverted but the sign of
649 Vfl is inverted. Vfl = Efl * exp (- .../Efl/alpha2*x^2...) With tau>0 the negative Efl will grow slowly
650 so that the restraint is switched off slowly. When Efl==0 and inverted flooding is ON is reached no
651  further adaption is applied, Efl will stay constant at zero.
652
653 To use restraints with harmonic potentials switch -restrain and -harmonic. Then the eigenvalues are
654 used as spring constants for the harmonic potential.
655 Note that eq3 in the flooding paper (J. Comp. Chem. 2006, 27, 1693-1702) defines the parameter lambda \
656 as the inverse of the spring constant, whereas the implementation uses lambda as the spring constant.
657
658 To use more than one flooding matrix just concatenate several .edi files (cat flood1.edi flood2.edi > flood_all.edi)
659 the routine read_edi_file reads all of theses flooding files.
660 The structure t_edi is now organized as a list of t_edis and the function do_flood cycles through the list
661 calling the do_single_flood() routine for every single entry. Since every state variables have been kept in one
662 edi there is no interdependence whatsoever. The forces are added together.
663
664   To write energies into the .edr file, call the function
665         get_flood_enx_names(char**, int *nnames) to get the Header (Vfl1 Vfl2... Vfln)
666 and call
667         get_flood_energies(real Vfl[],int nnames);
668
669   TODO:
670 - one could program the whole thing such that Efl, Vfl and deltaF is written to the .edr file. -- i dont know how to do that, yet.
671
672   Maybe one should give a range of atoms for which to remove motion, so that motion is removed with
673   two edsam files from two peptide chains
674 */
675
676 static void write_edo_flood(t_edpar *edi, FILE *fp, gmx_large_int_t step)
677 {
678     int i;
679     char buf[22];
680     gmx_bool bOutputRef=FALSE;
681
682
683     fprintf(fp,"%d.th FL: %s %12.5e %12.5e %12.5e\n",
684             edi->flood.flood_id, gmx_step_str(step,buf),
685             edi->flood.Efl, edi->flood.Vfl, edi->flood.deltaF);
686
687
688     /* Check whether any of the references changes with time (this can happen
689      * in case flooding is used as harmonic restraint). If so, output all the
690      * current reference projections. */
691     if (edi->flood.bHarmonic)
692     {
693         for (i = 0; i < edi->flood.vecs.neig; i++)
694         {
695             if (edi->flood.vecs.refprojslope[i] != 0.0)
696                 bOutputRef=TRUE;
697         }
698         if (bOutputRef)
699         {
700             fprintf(fp, "Ref. projs.: ");
701             for (i = 0; i < edi->flood.vecs.neig; i++)
702             {
703                 fprintf(fp, "%12.5e ", edi->flood.vecs.refproj[i]);
704             }
705             fprintf(fp, "\n");
706         }
707     }
708     fprintf(fp,"FL_FORCES: ");
709
710     for (i=0; i<edi->flood.vecs.neig; i++)
711         fprintf(fp," %12.5e",edi->flood.vecs.fproj[i]);
712
713     fprintf(fp,"\n");
714 }
715
716
717 /* From flood.xproj compute the Vfl(x) at this point */
718 static real flood_energy(t_edpar *edi, gmx_large_int_t step)
719 {
720     /* compute flooding energy Vfl
721      Vfl = Efl * exp( - \frac {kT} {2Efl alpha^2} * sum_i { \lambda_i c_i^2 } )
722      \lambda_i is the reciprocal eigenvalue 1/\sigma_i
723          it is already computed by make_edi and stored in stpsz[i]
724      bHarmonic:
725        Vfl = - Efl * 1/2(sum _i {\frac 1{\lambda_i} c_i^2})
726      */
727     real sum;
728     real Vfl;
729     int i;
730
731
732     /* Each time this routine is called (i.e. each time step), we add a small
733      * value to the reference projection. This way a harmonic restraint towards
734      * a moving reference is realized. If no value for the additive constant
735      * is provided in the edi file, the reference will not change. */
736     if (edi->flood.bHarmonic)
737     {
738         for (i=0; i<edi->flood.vecs.neig; i++)
739         {
740             edi->flood.vecs.refproj[i] = edi->flood.vecs.refproj0[i] + step * edi->flood.vecs.refprojslope[i];
741         }
742     }
743
744     sum=0.0;
745     /* Compute sum which will be the exponent of the exponential */
746     for (i=0; i<edi->flood.vecs.neig; i++)
747     {
748         /* stpsz stores the reciprocal eigenvalue 1/sigma_i */
749         sum += edi->flood.vecs.stpsz[i]*(edi->flood.vecs.xproj[i]-edi->flood.vecs.refproj[i])*(edi->flood.vecs.xproj[i]-edi->flood.vecs.refproj[i]);
750     }
751
752     /* Compute the Gauss function*/
753     if (edi->flood.bHarmonic)
754     {
755         Vfl = -0.5*edi->flood.Efl*sum;  /* minus sign because Efl is negative, if restrain is on. */
756     }
757     else
758     {
759         Vfl = edi->flood.Efl!=0 ? edi->flood.Efl*exp(-edi->flood.kT/2/edi->flood.Efl/edi->flood.alpha2*sum) :0;
760     }
761
762     return Vfl;
763 }
764
765
766 /* From the position and from Vfl compute forces in subspace -> store in edi->vec.flood.fproj */
767 static void flood_forces(t_edpar *edi)
768 {
769     /* compute the forces in the subspace of the flooding eigenvectors
770      * by the formula F_i= V_{fl}(c) * ( \frac {kT} {E_{fl}} \lambda_i c_i */
771
772     int i;
773     real energy=edi->flood.Vfl;
774
775
776     if (edi->flood.bHarmonic)
777         for (i=0; i<edi->flood.vecs.neig; i++)
778         {
779             edi->flood.vecs.fproj[i] = edi->flood.Efl* edi->flood.vecs.stpsz[i]*(edi->flood.vecs.xproj[i]-edi->flood.vecs.refproj[i]);
780         }
781     else
782         for (i=0; i<edi->flood.vecs.neig; i++)
783         {
784             /* if Efl is zero the forces are zero if not use the formula */
785             edi->flood.vecs.fproj[i] = edi->flood.Efl!=0 ? edi->flood.kT/edi->flood.Efl/edi->flood.alpha2*energy*edi->flood.vecs.stpsz[i]*(edi->flood.vecs.xproj[i]-edi->flood.vecs.refproj[i]) : 0;
786         }
787 }
788
789
790 /* Raise forces from subspace into cartesian space */
791 static void flood_blowup(t_edpar *edi, rvec *forces_cart)
792 {
793     /* this function lifts the forces from the subspace to the cartesian space
794      all the values not contained in the subspace are assumed to be zero and then
795      a coordinate transformation from eigenvector to cartesian vectors is performed
796      The nonexistent values don't have to be set to zero explicitly, they would occur
797      as zero valued summands, hence we just stop to compute this part of the sum.
798
799      for every atom we add all the contributions to this atom from all the different eigenvectors.
800
801      NOTE: one could add directly to the forcefield forces, would mean we wouldn't have to clear the
802      field forces_cart prior the computation, but we compute the forces separately
803      to have them accessible for diagnostics
804      */
805     int  j,eig;
806     rvec dum;
807     real *forces_sub;
808
809
810     forces_sub = edi->flood.vecs.fproj;
811
812
813     /* Calculate the cartesian forces for the local atoms */
814
815     /* Clear forces first */
816     for (j=0; j<edi->sav.nr_loc; j++)
817         clear_rvec(forces_cart[j]);
818
819     /* Now compute atomwise */
820     for (j=0; j<edi->sav.nr_loc; j++)
821     {
822         /* Compute forces_cart[edi->sav.anrs[j]] */
823         for (eig=0; eig<edi->flood.vecs.neig; eig++)
824         {
825             /* Force vector is force * eigenvector (compute only atom j) */
826             svmul(forces_sub[eig],edi->flood.vecs.vec[eig][edi->sav.c_ind[j]],dum);
827             /* Add this vector to the cartesian forces */
828             rvec_inc(forces_cart[j],dum);
829         }
830     }
831 }
832
833
834 /* Update the values of Efl, deltaF depending on tau and Vfl */
835 static void update_adaption(t_edpar *edi)
836 {
837     /* this function updates the parameter Efl and deltaF according to the rules given in
838      * 'predicting unimolecular chemical reactions: chemical flooding' M Mueller et al,
839      * J. chem Phys. */
840
841     if ((edi->flood.tau < 0 ? -edi->flood.tau : edi->flood.tau ) > 0.00000001)
842     {
843         edi->flood.Efl = edi->flood.Efl+edi->flood.dt/edi->flood.tau*(edi->flood.deltaF0-edi->flood.deltaF);
844         /* check if restrain (inverted flooding) -> don't let EFL become positive */
845         if (edi->flood.alpha2<0 && edi->flood.Efl>-0.00000001)
846             edi->flood.Efl = 0;
847
848         edi->flood.deltaF = (1-edi->flood.dt/edi->flood.tau)*edi->flood.deltaF+edi->flood.dt/edi->flood.tau*edi->flood.Vfl;
849     }
850 }
851
852
853 static void do_single_flood(
854         FILE *edo,
855         rvec x[],
856         rvec force[],
857         t_edpar *edi,
858         gmx_large_int_t step,
859         matrix box,
860         t_commrec *cr,
861         gmx_bool bNS)       /* Are we in a neighbor searching step? */
862 {
863     int i;
864     matrix  rotmat;         /* rotation matrix */
865     matrix  tmat;           /* inverse rotation */
866     rvec    transvec;       /* translation vector */
867     struct t_do_edsam *buf;
868
869
870     buf=edi->buf->do_edsam;
871
872
873     /* Broadcast the positions of the AVERAGE structure such that they are known on
874      * every processor. Each node contributes its local positions x and stores them in
875      * the collective ED array buf->xcoll */
876     communicate_group_positions(cr, buf->xcoll, buf->shifts_xcoll, buf->extra_shifts_xcoll, bNS, x,
877                     edi->sav.nr, edi->sav.nr_loc, edi->sav.anrs_loc, edi->sav.c_ind, edi->sav.x_old, box);
878
879     /* Only assembly REFERENCE positions if their indices differ from the average ones */
880     if (!edi->bRefEqAv)
881         communicate_group_positions(cr, buf->xc_ref, buf->shifts_xc_ref, buf->extra_shifts_xc_ref, bNS, x,
882                 edi->sref.nr, edi->sref.nr_loc, edi->sref.anrs_loc, edi->sref.c_ind, edi->sref.x_old, box);
883
884     /* If bUpdateShifts was TRUE, the shifts have just been updated in get_positions.
885      * We do not need to update the shifts until the next NS step */
886     buf->bUpdateShifts = FALSE;
887
888     /* Now all nodes have all of the ED/flooding positions in edi->sav->xcoll,
889      * as well as the indices in edi->sav.anrs */
890
891     /* Fit the reference indices to the reference structure */
892     if (edi->bRefEqAv)
893         fit_to_reference(buf->xcoll , transvec, rotmat, edi);
894     else
895         fit_to_reference(buf->xc_ref, transvec, rotmat, edi);
896
897     /* Now apply the translation and rotation to the ED structure */
898     translate_and_rotate(buf->xcoll, edi->sav.nr, transvec, rotmat);
899
900     /* Project fitted structure onto supbspace -> store in edi->flood.vecs.xproj */
901     project_to_eigvectors(buf->xcoll,&edi->flood.vecs,edi);
902
903     if (FALSE == edi->flood.bConstForce)
904     {
905         /* Compute Vfl(x) from flood.xproj */
906         edi->flood.Vfl = flood_energy(edi, step);
907
908         update_adaption(edi);
909
910         /* Compute the flooding forces */
911         flood_forces(edi);
912     }
913
914     /* Translate them into cartesian positions */
915     flood_blowup(edi, edi->flood.forces_cartesian);
916
917     /* Rotate forces back so that they correspond to the given structure and not to the fitted one */
918     /* Each node rotates back its local forces */
919     transpose(rotmat,tmat);
920     rotate_x(edi->flood.forces_cartesian, edi->sav.nr_loc, tmat);
921
922     /* Finally add forces to the main force variable */
923     for (i=0; i<edi->sav.nr_loc; i++)
924         rvec_inc(force[edi->sav.anrs_loc[i]],edi->flood.forces_cartesian[i]);
925
926     /* Output is written by the master process */
927     if (do_per_step(step,edi->outfrq) && MASTER(cr))
928         write_edo_flood(edi,edo,step);
929 }
930
931
932 /* Main flooding routine, called from do_force */
933 extern void do_flood(
934         FILE            *log,    /* md.log file */
935         t_commrec       *cr,     /* Communication record */
936         rvec            x[],     /* Positions on the local processor */
937         rvec            force[], /* forcefield forces, to these the flooding forces are added */
938         gmx_edsam_t     ed,      /* ed data structure contains all ED and flooding datasets */
939         matrix          box,     /* the box */
940         gmx_large_int_t step,    /* The relative time step since ir->init_step is already subtracted */
941         gmx_bool        bNS)     /* Are we in a neighbor searching step? */
942 {
943     t_edpar *edi;
944
945
946     if (ed->eEDtype != eEDflood)
947         return;
948
949     edi = ed->edpar;
950     while (edi)
951     {
952         /* Call flooding for one matrix */
953         if (edi->flood.vecs.neig)
954             do_single_flood(ed->edo,x,force,edi,step,box,cr,bNS);
955         edi = edi->next_edi;
956     }
957 }
958
959
960 /* Called by init_edi, configure some flooding related variables and structures,
961  * print headers to output files */
962 static void init_flood(t_edpar *edi, gmx_edsam_t ed, real dt, t_commrec *cr)
963 {
964     int i;
965
966
967     edi->flood.Efl = edi->flood.constEfl;
968     edi->flood.Vfl = 0;
969     edi->flood.dt  = dt;
970
971     if (edi->flood.vecs.neig)
972     {
973         /* If in any of the datasets we find a flooding vector, flooding is turned on */
974         ed->eEDtype = eEDflood;
975
976         fprintf(stderr,"ED: Flooding of matrix %d is switched on.\n", edi->flood.flood_id);
977
978         if (edi->flood.bConstForce)
979         {
980             /* We have used stpsz as a vehicle to carry the fproj values for constant
981              * force flooding. Now we copy that to flood.vecs.fproj. Note that
982              * in const force flooding, fproj is never changed. */
983             for (i=0; i<edi->flood.vecs.neig; i++)
984             {
985                 edi->flood.vecs.fproj[i] = edi->flood.vecs.stpsz[i];
986
987                 fprintf(stderr, "ED: applying on eigenvector %d a constant force of %g\n",
988                         edi->flood.vecs.ieig[i], edi->flood.vecs.fproj[i]);
989             }
990         }
991         fprintf(ed->edo,"FL_HEADER: Flooding of matrix %d is switched on! The flooding output will have the following format:\n",
992                 edi->flood.flood_id);
993         fprintf(ed->edo,"FL_HEADER: Step     Efl          Vfl       deltaF\n");
994     }
995 }
996
997
998 #ifdef DEBUGHELPERS
999 /*********** Energy book keeping ******/
1000 static void get_flood_enx_names(t_edpar *edi, char** names, int *nnames)  /* get header of energies */
1001 {
1002     t_edpar *actual;
1003     int count;
1004     char buf[STRLEN];
1005     actual=edi;
1006     count = 1;
1007     while (actual)
1008     {
1009         srenew(names,count);
1010         sprintf(buf,"Vfl_%d",count);
1011         names[count-1]=strdup(buf);
1012         actual=actual->next_edi;
1013         count++;
1014     }
1015     *nnames=count-1;
1016 }
1017
1018
1019 static void get_flood_energies(t_edpar *edi, real Vfl[],int nnames)
1020 {
1021     /*fl has to be big enough to capture nnames-many entries*/
1022     t_edpar *actual;
1023     int count;
1024
1025
1026     actual=edi;
1027     count = 1;
1028     while (actual)
1029     {
1030         Vfl[count-1]=actual->flood.Vfl;
1031         actual=actual->next_edi;
1032         count++;
1033     }
1034     if (nnames!=count-1)
1035         gmx_fatal(FARGS,"Number of energies is not consistent with t_edi structure");
1036 }
1037 /************* END of FLOODING IMPLEMENTATION ****************************/
1038 #endif
1039
1040
1041 gmx_edsam_t ed_open(int nfile,const t_filenm fnm[],unsigned long Flags,t_commrec *cr)
1042 {
1043     gmx_edsam_t ed;
1044
1045
1046     /* Allocate space for the ED data structure */
1047     snew(ed, 1);
1048
1049     /* We want to perform ED (this switch might later be upgraded to eEDflood) */
1050     ed->eEDtype = eEDedsam;
1051
1052     if (MASTER(cr))
1053     {
1054         /* Open .edi input file: */
1055         ed->edinam=ftp2fn(efEDI,nfile,fnm);
1056         /* The master opens the .edo output file */
1057         fprintf(stderr,"ED sampling will be performed!\n");
1058         ed->edonam = ftp2fn(efEDO,nfile,fnm);
1059         ed->edo    = gmx_fio_fopen(ed->edonam,(Flags & MD_APPENDFILES)? "a+" : "w+");
1060         ed->bStartFromCpt = Flags & MD_STARTFROMCPT;
1061     }
1062     return ed;
1063 }
1064
1065
1066 /* Broadcasts the structure data */
1067 static void bc_ed_positions(t_commrec *cr, struct gmx_edx *s, int stype)
1068 {
1069     snew_bc(cr, s->anrs, s->nr   );    /* Index numbers     */
1070     snew_bc(cr, s->x   , s->nr   );    /* Positions         */
1071     nblock_bc(cr, s->nr, s->anrs );
1072     nblock_bc(cr, s->nr, s->x    );
1073
1074     /* For the average & reference structures we need an array for the collective indices,
1075      * and we need to broadcast the masses as well */
1076     if (stype == eedAV || stype == eedREF)
1077     {
1078         /* We need these additional variables in the parallel case: */
1079         snew(s->c_ind    , s->nr   );   /* Collective indices */
1080         /* Local atom indices get assigned in dd_make_local_group_indices.
1081          * There, also memory is allocated */
1082         s->nalloc_loc = 0;              /* allocation size of s->anrs_loc */
1083         snew_bc(cr, s->x_old, s->nr);   /* To be able to always make the ED molecule whole, ...        */
1084         nblock_bc(cr, s->nr, s->x_old); /* ... keep track of shift changes with the help of old coords */
1085     }
1086
1087     /* broadcast masses for the reference structure (for mass-weighted fitting) */
1088     if (stype == eedREF)
1089     {
1090         snew_bc(cr, s->m, s->nr);
1091         nblock_bc(cr, s->nr, s->m);
1092     }
1093
1094     /* For the average structure we might need the masses for mass-weighting */
1095     if (stype == eedAV)
1096     {
1097         snew_bc(cr, s->sqrtm, s->nr);
1098         nblock_bc(cr, s->nr, s->sqrtm);
1099         snew_bc(cr, s->m, s->nr);
1100         nblock_bc(cr, s->nr, s->m);
1101     }
1102 }
1103
1104
1105 /* Broadcasts the eigenvector data */
1106 static void bc_ed_vecs(t_commrec *cr, t_eigvec *ev, int length, gmx_bool bHarmonic)
1107 {
1108     int i;
1109
1110     snew_bc(cr, ev->ieig   , ev->neig);  /* index numbers of eigenvector  */
1111     snew_bc(cr, ev->stpsz  , ev->neig);  /* stepsizes per eigenvector     */
1112     snew_bc(cr, ev->xproj  , ev->neig);  /* instantaneous x projection    */
1113     snew_bc(cr, ev->fproj  , ev->neig);  /* instantaneous f projection    */
1114     snew_bc(cr, ev->refproj, ev->neig);  /* starting or target projection */
1115
1116     nblock_bc(cr, ev->neig, ev->ieig   );
1117     nblock_bc(cr, ev->neig, ev->stpsz  );
1118     nblock_bc(cr, ev->neig, ev->xproj  );
1119     nblock_bc(cr, ev->neig, ev->fproj  );
1120     nblock_bc(cr, ev->neig, ev->refproj);
1121
1122     snew_bc(cr, ev->vec, ev->neig);      /* Eigenvector components        */
1123     for (i=0; i<ev->neig; i++)
1124     {
1125         snew_bc(cr, ev->vec[i], length);
1126         nblock_bc(cr, length, ev->vec[i]);
1127     }
1128
1129     /* For harmonic restraints the reference projections can change with time */
1130     if (bHarmonic)
1131     {
1132         snew_bc(cr, ev->refproj0    , ev->neig);
1133         snew_bc(cr, ev->refprojslope, ev->neig);
1134         nblock_bc(cr, ev->neig, ev->refproj0    );
1135         nblock_bc(cr, ev->neig, ev->refprojslope);
1136     }
1137 }
1138
1139
1140 /* Broadcasts the ED / flooding data to other nodes
1141  * and allocates memory where needed */
1142 static void broadcast_ed_data(t_commrec *cr, gmx_edsam_t ed, int numedis)
1143 {
1144     int     nr;
1145     t_edpar *edi;
1146
1147
1148     /* Master lets the other nodes know if its ED only or also flooding */
1149     gmx_bcast(sizeof(ed->eEDtype), &(ed->eEDtype), cr);
1150
1151     snew_bc(cr, ed->edpar,1);
1152     /* Now transfer the ED data set(s) */
1153     edi = ed->edpar;
1154     for (nr=0; nr<numedis; nr++)
1155     {
1156         /* Broadcast a single ED data set */
1157         block_bc(cr, *edi);
1158
1159         /* Broadcast positions */
1160         bc_ed_positions(cr, &(edi->sref), eedREF); /* reference positions (don't broadcast masses)    */
1161         bc_ed_positions(cr, &(edi->sav ), eedAV ); /* average positions (do broadcast masses as well) */
1162         bc_ed_positions(cr, &(edi->star), eedTAR); /* target positions                                */
1163         bc_ed_positions(cr, &(edi->sori), eedORI); /* origin positions                                */
1164
1165         /* Broadcast eigenvectors */
1166         bc_ed_vecs(cr, &edi->vecs.mon   , edi->sav.nr, FALSE);
1167         bc_ed_vecs(cr, &edi->vecs.linfix, edi->sav.nr, FALSE);
1168         bc_ed_vecs(cr, &edi->vecs.linacc, edi->sav.nr, FALSE);
1169         bc_ed_vecs(cr, &edi->vecs.radfix, edi->sav.nr, FALSE);
1170         bc_ed_vecs(cr, &edi->vecs.radacc, edi->sav.nr, FALSE);
1171         bc_ed_vecs(cr, &edi->vecs.radcon, edi->sav.nr, FALSE);
1172         /* Broadcast flooding eigenvectors and, if needed, values for the moving reference */
1173         bc_ed_vecs(cr, &edi->flood.vecs,  edi->sav.nr, edi->flood.bHarmonic);
1174
1175         /* Set the pointer to the next ED dataset */
1176         if (edi->next_edi)
1177         {
1178           snew_bc(cr, edi->next_edi, 1);
1179           edi = edi->next_edi;
1180         }
1181     }
1182 }
1183
1184
1185 /* init-routine called for every *.edi-cycle, initialises t_edpar structure */
1186 static void init_edi(gmx_mtop_t *mtop,t_inputrec *ir,
1187                      t_commrec *cr,gmx_edsam_t ed,t_edpar *edi)
1188 {
1189     int  i;
1190     real totalmass = 0.0;
1191     rvec com;
1192     t_atom *atom;
1193
1194     /* NOTE Init_edi is executed on the master process only
1195      * The initialized data sets are then transmitted to the
1196      * other nodes in broadcast_ed_data */
1197
1198     edi->bNeedDoEdsam = edi->vecs.mon.neig
1199                      || edi->vecs.linfix.neig
1200                      || edi->vecs.linacc.neig
1201                      || edi->vecs.radfix.neig
1202                      || edi->vecs.radacc.neig
1203                      || edi->vecs.radcon.neig;
1204
1205     /* evaluate masses (reference structure) */
1206     snew(edi->sref.m, edi->sref.nr);
1207     for (i = 0; i < edi->sref.nr; i++)
1208     {
1209         if (edi->fitmas)
1210         {
1211             gmx_mtop_atomnr_to_atom(mtop,edi->sref.anrs[i],&atom);
1212             edi->sref.m[i] = atom->m;
1213         }
1214         else
1215         {
1216             edi->sref.m[i] = 1.0;
1217         }
1218
1219         /* Check that every m > 0. Bad things will happen otherwise. */
1220         if (edi->sref.m[i] <= 0.0)
1221         {
1222             gmx_fatal(FARGS, "Reference structure atom %d (sam.edi index %d) has a mass of %g.\n"
1223                              "For a mass-weighted fit, all reference structure atoms need to have a mass >0.\n"
1224                              "Either make the covariance analysis non-mass-weighted, or exclude massless\n"
1225                              "atoms from the reference structure by creating a proper index group.\n",
1226                       i, edi->sref.anrs[i]+1, edi->sref.m[i]);
1227         }
1228
1229         totalmass += edi->sref.m[i];
1230     }
1231     edi->sref.mtot = totalmass;
1232
1233     /* Masses m and sqrt(m) for the average structure. Note that m
1234      * is needed if forces have to be evaluated in do_edsam */
1235     snew(edi->sav.sqrtm, edi->sav.nr );
1236     snew(edi->sav.m    , edi->sav.nr );
1237     for (i = 0; i < edi->sav.nr; i++)
1238     {
1239         gmx_mtop_atomnr_to_atom(mtop,edi->sav.anrs[i],&atom);
1240         edi->sav.m[i] = atom->m;
1241         if (edi->pcamas)
1242         {
1243             edi->sav.sqrtm[i] = sqrt(atom->m);
1244         }
1245         else
1246         {
1247             edi->sav.sqrtm[i] = 1.0;
1248         }
1249
1250         /* Check that every m > 0. Bad things will happen otherwise. */
1251         if (edi->sav.sqrtm[i] <= 0.0)
1252         {
1253             gmx_fatal(FARGS, "Average structure atom %d (sam.edi index %d) has a mass of %g.\n"
1254                              "For ED with mass-weighting, all average structure atoms need to have a mass >0.\n"
1255                              "Either make the covariance analysis non-mass-weighted, or exclude massless\n"
1256                              "atoms from the average structure by creating a proper index group.\n",
1257                       i, edi->sav.anrs[i]+1, atom->m);
1258         }
1259     }
1260
1261     /* put reference structure in origin */
1262     get_center(edi->sref.x, edi->sref.m, edi->sref.nr, com);
1263     com[XX] = -com[XX];
1264     com[YY] = -com[YY];
1265     com[ZZ] = -com[ZZ];
1266     translate_x(edi->sref.x, edi->sref.nr, com);
1267
1268     /* Init ED buffer */
1269     snew(edi->buf, 1);
1270 }
1271
1272
1273 static void check(const char *line, const char *label)
1274 {
1275     if (!strstr(line,label))
1276         gmx_fatal(FARGS,"Could not find input parameter %s at expected position in edsam input-file (.edi)\nline read instead is %s",label,line);
1277 }
1278
1279
1280 static int read_checked_edint(FILE *file,const char *label)
1281 {
1282     char line[STRLEN+1];
1283     int idum;
1284
1285
1286     fgets2 (line,STRLEN,file);
1287     check(line,label);
1288     fgets2 (line,STRLEN,file);
1289     sscanf (line,"%d",&idum);
1290     return idum;
1291 }
1292
1293
1294 static int read_edint(FILE *file,gmx_bool *bEOF)
1295 {
1296     char line[STRLEN+1];
1297     int idum;
1298     char *eof;
1299
1300
1301     eof=fgets2 (line,STRLEN,file);
1302     if (eof==NULL)
1303     {
1304         *bEOF = TRUE;
1305         return -1;
1306     }
1307     eof=fgets2 (line,STRLEN,file);
1308     if (eof==NULL)
1309     {
1310         *bEOF = TRUE;
1311         return -1;
1312     }
1313     sscanf (line,"%d",&idum);
1314     *bEOF = FALSE;
1315     return idum;
1316 }
1317
1318
1319 static real read_checked_edreal(FILE *file,const char *label)
1320 {
1321     char line[STRLEN+1];
1322     double rdum;
1323
1324
1325     fgets2 (line,STRLEN,file);
1326     check(line,label);
1327     fgets2 (line,STRLEN,file);
1328     sscanf (line,"%lf",&rdum);
1329     return (real) rdum; /* always read as double and convert to single */
1330 }
1331
1332
1333 static void read_edx(FILE *file,int number,int *anrs,rvec *x)
1334 {
1335     int i,j;
1336     char line[STRLEN+1];
1337     double d[3];
1338
1339
1340     for(i=0; i<number; i++)
1341     {
1342         fgets2 (line,STRLEN,file);
1343         sscanf (line,"%d%lf%lf%lf",&anrs[i],&d[0],&d[1],&d[2]);
1344         anrs[i]--; /* we are reading FORTRAN indices */
1345         for(j=0; j<3; j++)
1346             x[i][j]=d[j]; /* always read as double and convert to single */
1347     }
1348 }
1349
1350
1351 static void scan_edvec(FILE *in,int nr,rvec *vec)
1352 {
1353     char line[STRLEN+1];
1354     int i;
1355     double x,y,z;
1356
1357
1358     for(i=0; (i < nr); i++)
1359     {
1360         fgets2 (line,STRLEN,in);
1361         sscanf (line,"%le%le%le",&x,&y,&z);
1362         vec[i][XX]=x;
1363         vec[i][YY]=y;
1364         vec[i][ZZ]=z;
1365     }
1366 }
1367
1368
1369 static void read_edvec(FILE *in,int nr,t_eigvec *tvec,gmx_bool bReadRefproj, gmx_bool *bHaveReference)
1370 {
1371     int i,idum,nscan;
1372     double rdum,refproj_dum=0.0,refprojslope_dum=0.0;
1373     char line[STRLEN+1];
1374
1375
1376     tvec->neig=read_checked_edint(in,"NUMBER OF EIGENVECTORS");
1377     if (tvec->neig >0)
1378     {
1379         snew(tvec->ieig   ,tvec->neig);
1380         snew(tvec->stpsz  ,tvec->neig);
1381         snew(tvec->vec    ,tvec->neig);
1382         snew(tvec->xproj  ,tvec->neig);
1383         snew(tvec->fproj  ,tvec->neig);
1384         snew(tvec->refproj,tvec->neig);
1385         if (bReadRefproj)
1386         {
1387             snew(tvec->refproj0    ,tvec->neig);
1388             snew(tvec->refprojslope,tvec->neig);
1389         }
1390
1391         for(i=0; (i < tvec->neig); i++)
1392         {
1393             fgets2 (line,STRLEN,in);
1394             if (bReadRefproj) /* ONLY when using flooding as harmonic restraint */
1395             {
1396                 nscan = sscanf(line,"%d%lf%lf%lf",&idum,&rdum,&refproj_dum,&refprojslope_dum);
1397                 /* Zero out values which were not scanned */
1398                 switch(nscan)
1399                 {
1400                     case 4:
1401                         /* Every 4 values read, including reference position */
1402                         *bHaveReference = TRUE;
1403                         break;
1404                     case 3:
1405                         /* A reference position is provided */
1406                         *bHaveReference = TRUE;
1407                         /* No value for slope, set to 0 */
1408                         refprojslope_dum = 0.0;
1409                         break;
1410                     case 2:
1411                         /* No values for reference projection and slope, set to 0 */
1412                         refproj_dum      = 0.0;
1413                         refprojslope_dum = 0.0;
1414                         break;
1415                     default:
1416                         gmx_fatal(FARGS,"Expected 2 - 4 (not %d) values for flooding vec: <nr> <spring const> <refproj> <refproj-slope>\n", nscan);
1417                         break;
1418                 }
1419                 tvec->refproj[i]=refproj_dum;
1420                 tvec->refproj0[i]=refproj_dum;
1421                 tvec->refprojslope[i]=refprojslope_dum;
1422             }
1423             else /* Normal flooding */
1424             {
1425                 nscan = sscanf(line,"%d%lf",&idum,&rdum);
1426                 if (nscan != 2)
1427                     gmx_fatal(FARGS,"Expected 2 values for flooding vec: <nr> <stpsz>\n");
1428             }
1429             tvec->ieig[i]=idum;
1430             tvec->stpsz[i]=rdum;
1431         } /* end of loop over eigenvectors */
1432
1433         for(i=0; (i < tvec->neig); i++)
1434         {
1435             snew(tvec->vec[i],nr);
1436             scan_edvec(in,nr,tvec->vec[i]);
1437         }
1438     }
1439 }
1440
1441
1442 /* calls read_edvec for the vector groups, only for flooding there is an extra call */
1443 static void read_edvecs(FILE *in,int nr,t_edvecs *vecs)
1444 {
1445         gmx_bool bHaveReference = FALSE;
1446
1447
1448     read_edvec(in, nr, &vecs->mon   , FALSE, &bHaveReference);
1449     read_edvec(in, nr, &vecs->linfix, FALSE, &bHaveReference);
1450     read_edvec(in, nr, &vecs->linacc, FALSE, &bHaveReference);
1451     read_edvec(in, nr, &vecs->radfix, FALSE, &bHaveReference);
1452     read_edvec(in, nr, &vecs->radacc, FALSE, &bHaveReference);
1453     read_edvec(in, nr, &vecs->radcon, FALSE, &bHaveReference);
1454 }
1455
1456
1457 /* Check if the same atom indices are used for reference and average positions */
1458 static gmx_bool check_if_same(struct gmx_edx sref, struct gmx_edx sav)
1459 {
1460     int i;
1461
1462
1463     /* If the number of atoms differs between the two structures,
1464      * they cannot be identical */
1465     if (sref.nr != sav.nr)
1466         return FALSE;
1467
1468     /* Now that we know that both stuctures have the same number of atoms,
1469      * check if also the indices are identical */
1470     for (i=0; i < sav.nr; i++)
1471     {
1472         if (sref.anrs[i] != sav.anrs[i])
1473             return FALSE;
1474     }
1475     fprintf(stderr, "ED: Note: Reference and average structure are composed of the same atom indices.\n");
1476
1477     return TRUE;
1478 }
1479
1480
1481 static int read_edi(FILE* in, gmx_edsam_t ed,t_edpar *edi,int nr_mdatoms, int edi_nr, t_commrec *cr)
1482 {
1483     int readmagic;
1484     const int magic=670;
1485     gmx_bool bEOF;
1486
1487     /* Was a specific reference point for the flooding/umbrella potential provided in the edi file? */
1488     gmx_bool bHaveReference = FALSE;
1489
1490
1491     /* the edi file is not free format, so expect problems if the input is corrupt. */
1492
1493     /* check the magic number */
1494     readmagic=read_edint(in,&bEOF);
1495     /* Check whether we have reached the end of the input file */
1496     if (bEOF)
1497         return 0;
1498
1499     if (readmagic != magic)
1500     {
1501         if (readmagic==666 || readmagic==667 || readmagic==668)
1502             gmx_fatal(FARGS,"Wrong magic number: Use newest version of make_edi to produce edi file");
1503         else if (readmagic != 669)
1504             gmx_fatal(FARGS,"Wrong magic number %d in %s",readmagic,ed->edinam);
1505     }
1506
1507     /* check the number of atoms */
1508     edi->nini=read_edint(in,&bEOF);
1509     if (edi->nini != nr_mdatoms)
1510         gmx_fatal(FARGS,"Nr of atoms in %s (%d) does not match nr of md atoms (%d)",
1511                 ed->edinam,edi->nini,nr_mdatoms);
1512
1513     /* Done checking. For the rest we blindly trust the input */
1514     edi->fitmas          = read_checked_edint(in,"FITMAS");
1515     edi->pcamas          = read_checked_edint(in,"ANALYSIS_MAS");
1516     edi->outfrq          = read_checked_edint(in,"OUTFRQ");
1517     edi->maxedsteps      = read_checked_edint(in,"MAXLEN");
1518     edi->slope           = read_checked_edreal(in,"SLOPECRIT");
1519
1520     edi->presteps        = read_checked_edint(in,"PRESTEPS");
1521     edi->flood.deltaF0   = read_checked_edreal(in,"DELTA_F0");
1522     edi->flood.deltaF    = read_checked_edreal(in,"INIT_DELTA_F");
1523     edi->flood.tau       = read_checked_edreal(in,"TAU");
1524     edi->flood.constEfl  = read_checked_edreal(in,"EFL_NULL");
1525     edi->flood.alpha2    = read_checked_edreal(in,"ALPHA2");
1526     edi->flood.kT        = read_checked_edreal(in,"KT");
1527     edi->flood.bHarmonic = read_checked_edint(in,"HARMONIC");
1528     if (readmagic > 669)
1529         edi->flood.bConstForce = read_checked_edint(in,"CONST_FORCE_FLOODING");
1530     else
1531         edi->flood.bConstForce = FALSE;
1532     edi->flood.flood_id  = edi_nr;
1533     edi->sref.nr         = read_checked_edint(in,"NREF");
1534
1535     /* allocate space for reference positions and read them */
1536     snew(edi->sref.anrs,edi->sref.nr);
1537     snew(edi->sref.x   ,edi->sref.nr);
1538     snew(edi->sref.x_old,edi->sref.nr);
1539     edi->sref.sqrtm    =NULL;
1540     read_edx(in,edi->sref.nr,edi->sref.anrs,edi->sref.x);
1541
1542     /* average positions. they define which atoms will be used for ED sampling */
1543     edi->sav.nr=read_checked_edint(in,"NAV");
1544     snew(edi->sav.anrs,edi->sav.nr);
1545     snew(edi->sav.x   ,edi->sav.nr);
1546     snew(edi->sav.x_old,edi->sav.nr);
1547     read_edx(in,edi->sav.nr,edi->sav.anrs,edi->sav.x);
1548
1549     /* Check if the same atom indices are used for reference and average positions */
1550     edi->bRefEqAv = check_if_same(edi->sref, edi->sav);
1551
1552     /* eigenvectors */
1553     read_edvecs(in,edi->sav.nr,&edi->vecs);
1554     read_edvec(in,edi->sav.nr,&edi->flood.vecs,edi->flood.bHarmonic, &bHaveReference);
1555
1556     /* target positions */
1557     edi->star.nr=read_edint(in,&bEOF);
1558     if (edi->star.nr > 0)
1559     {
1560         snew(edi->star.anrs,edi->star.nr);
1561         snew(edi->star.x   ,edi->star.nr);
1562         edi->star.sqrtm    =NULL;
1563         read_edx(in,edi->star.nr,edi->star.anrs,edi->star.x);
1564     }
1565
1566     /* positions defining origin of expansion circle */
1567     edi->sori.nr=read_edint(in,&bEOF);
1568     if (edi->sori.nr > 0)
1569     {
1570         if (bHaveReference)
1571         {
1572                 /* Both an -ori structure and a at least one manual reference point have been
1573                  * specified. That's ambiguous and probably not intentional. */
1574                 gmx_fatal(FARGS, "ED: An origin structure has been provided and a at least one (moving) reference\n"
1575                                  "    point was manually specified in the edi file. That is ambiguous. Aborting.\n");
1576         }
1577         snew(edi->sori.anrs,edi->sori.nr);
1578         snew(edi->sori.x   ,edi->sori.nr);
1579         edi->sori.sqrtm    =NULL;
1580         read_edx(in,edi->sori.nr,edi->sori.anrs,edi->sori.x);
1581     }
1582
1583     /* all done */
1584     return 1;
1585 }
1586
1587
1588
1589 /* Read in the edi input file. Note that it may contain several ED data sets which were
1590  * achieved by concatenating multiple edi files. The standard case would be a single ED
1591  * data set, though. */
1592 static void read_edi_file(gmx_edsam_t ed, t_edpar *edi, int nr_mdatoms, t_commrec *cr)
1593 {
1594     FILE    *in;
1595     t_edpar *curr_edi,*last_edi;
1596     t_edpar *edi_read;
1597     int     edi_nr = 0;
1598
1599
1600     /* This routine is executed on the master only */
1601
1602     /* Open the .edi parameter input file */
1603     in = gmx_fio_fopen(ed->edinam,"r");
1604     fprintf(stderr, "ED: Reading edi file %s\n", ed->edinam);
1605
1606     /* Now read a sequence of ED input parameter sets from the edi file */
1607     curr_edi=edi;
1608     last_edi=edi;
1609     while( read_edi(in, ed, curr_edi, nr_mdatoms, edi_nr, cr) )
1610     {
1611         edi_nr++;
1612         /* Make shure that the number of atoms in each dataset is the same as in the tpr file */
1613         if (edi->nini != nr_mdatoms)
1614             gmx_fatal(FARGS,"edi file %s (dataset #%d) was made for %d atoms, but the simulation contains %d atoms.",
1615                     ed->edinam, edi_nr, edi->nini, nr_mdatoms);
1616         /* Since we arrived within this while loop we know that there is still another data set to be read in */
1617         /* We need to allocate space for the data: */
1618         snew(edi_read,1);
1619         /* Point the 'next_edi' entry to the next edi: */
1620         curr_edi->next_edi=edi_read;
1621         /* Keep the curr_edi pointer for the case that the next dataset is empty: */
1622         last_edi = curr_edi;
1623         /* Let's prepare to read in the next edi data set: */
1624         curr_edi = edi_read;
1625     }
1626     if (edi_nr == 0)
1627         gmx_fatal(FARGS, "No complete ED data set found in edi file %s.", ed->edinam);
1628
1629     /* Terminate the edi dataset list with a NULL pointer: */
1630     last_edi->next_edi = NULL;
1631
1632     fprintf(stderr, "ED: Found %d ED dataset%s.\n", edi_nr, edi_nr>1? "s" : "");
1633
1634     /* Close the .edi file again */
1635     gmx_fio_fclose(in);
1636 }
1637
1638
1639 struct t_fit_to_ref {
1640     rvec *xcopy;       /* Working copy of the positions in fit_to_reference */
1641 };
1642
1643 /* Fit the current positions to the reference positions
1644  * Do not actually do the fit, just return rotation and translation.
1645  * Note that the COM of the reference structure was already put into
1646  * the origin by init_edi. */
1647 static void fit_to_reference(rvec      *xcoll,    /* The positions to be fitted */
1648                              rvec      transvec,  /* The translation vector */
1649                              matrix    rotmat,    /* The rotation matrix */
1650                              t_edpar   *edi)      /* Just needed for do_edfit */
1651 {
1652     rvec com;          /* center of mass */
1653     int  i;
1654     struct t_fit_to_ref *loc;
1655
1656
1657     GMX_MPE_LOG(ev_fit_to_reference_start);
1658
1659     /* Allocate memory the first time this routine is called for each edi dataset */
1660     if (NULL == edi->buf->fit_to_ref)
1661     {
1662         snew(edi->buf->fit_to_ref, 1);
1663         snew(edi->buf->fit_to_ref->xcopy, edi->sref.nr);
1664     }
1665     loc = edi->buf->fit_to_ref;
1666
1667     /* We do not touch the original positions but work on a copy. */
1668     for (i=0; i<edi->sref.nr; i++)
1669         copy_rvec(xcoll[i], loc->xcopy[i]);
1670
1671     /* Calculate the center of mass */
1672     get_center(loc->xcopy, edi->sref.m, edi->sref.nr, com);
1673
1674     transvec[XX] = -com[XX];
1675     transvec[YY] = -com[YY];
1676     transvec[ZZ] = -com[ZZ];
1677
1678     /* Subtract the center of mass from the copy */
1679     translate_x(loc->xcopy, edi->sref.nr, transvec);
1680
1681     /* Determine the rotation matrix */
1682     do_edfit(edi->sref.nr, edi->sref.x, loc->xcopy, rotmat, edi);
1683
1684     GMX_MPE_LOG(ev_fit_to_reference_finish);
1685 }
1686
1687
1688 static void translate_and_rotate(rvec *x,         /* The positions to be translated and rotated */
1689                                  int nat,         /* How many positions are there? */
1690                                  rvec transvec,   /* The translation vector */
1691                                  matrix rotmat)   /* The rotation matrix */
1692 {
1693     /* Translation */
1694     translate_x(x, nat, transvec);
1695
1696     /* Rotation */
1697     rotate_x(x, nat, rotmat);
1698 }
1699
1700
1701 /* Gets the rms deviation of the positions to the structure s */
1702 /* fit_to_structure has to be called before calling this routine! */
1703 static real rmsd_from_structure(rvec           *x,  /* The positions under consideration */
1704                                 struct gmx_edx *s)  /* The structure from which the rmsd shall be computed */
1705 {
1706     real  rmsd=0.0;
1707     int   i;
1708
1709
1710     for (i=0; i < s->nr; i++)
1711         rmsd += distance2(s->x[i], x[i]);
1712
1713     rmsd /= (real) s->nr;
1714     rmsd = sqrt(rmsd);
1715
1716     return rmsd;
1717 }
1718
1719
1720 void dd_make_local_ed_indices(gmx_domdec_t *dd, struct gmx_edsam *ed)
1721 {
1722     t_edpar *edi;
1723
1724
1725     if (ed->eEDtype != eEDnone)
1726     {
1727         /* Loop over ED datasets (usually there is just one dataset, though) */
1728         edi=ed->edpar;
1729         while (edi)
1730         {
1731             /* Local atoms of the reference structure (for fitting), need only be assembled
1732              * if their indices differ from the average ones */
1733             if (!edi->bRefEqAv)
1734                 dd_make_local_group_indices(dd->ga2la, edi->sref.nr, edi->sref.anrs,
1735                         &edi->sref.nr_loc, &edi->sref.anrs_loc, &edi->sref.nalloc_loc, edi->sref.c_ind);
1736
1737             /* Local atoms of the average structure (on these ED will be performed) */
1738             dd_make_local_group_indices(dd->ga2la, edi->sav.nr, edi->sav.anrs,
1739                     &edi->sav.nr_loc, &edi->sav.anrs_loc, &edi->sav.nalloc_loc, edi->sav.c_ind);
1740
1741             /* Indicate that the ED shift vectors for this structure need to be updated
1742              * at the next call to communicate_group_positions, since obviously we are in a NS step */
1743             edi->buf->do_edsam->bUpdateShifts = TRUE;
1744
1745             /* Set the pointer to the next ED dataset (if any) */
1746             edi=edi->next_edi;
1747         }
1748     }
1749 }
1750
1751
1752 static inline void ed_unshift_single_coord(matrix box, const rvec x, const ivec is, rvec xu)
1753 {
1754     int tx,ty,tz;
1755
1756
1757     GMX_MPE_LOG(ev_unshift_start);
1758
1759     tx=is[XX];
1760     ty=is[YY];
1761     tz=is[ZZ];
1762
1763     if(TRICLINIC(box))
1764     {
1765         xu[XX] = x[XX]-tx*box[XX][XX]-ty*box[YY][XX]-tz*box[ZZ][XX];
1766         xu[YY] = x[YY]-ty*box[YY][YY]-tz*box[ZZ][YY];
1767         xu[ZZ] = x[ZZ]-tz*box[ZZ][ZZ];
1768     } else
1769     {
1770         xu[XX] = x[XX]-tx*box[XX][XX];
1771         xu[YY] = x[YY]-ty*box[YY][YY];
1772         xu[ZZ] = x[ZZ]-tz*box[ZZ][ZZ];
1773     }
1774
1775     GMX_MPE_LOG(ev_unshift_finish);
1776 }
1777
1778
1779 static void do_linfix(rvec *xcoll, t_edpar *edi, int step, t_commrec *cr)
1780 {
1781     int  i, j;
1782     real proj, add;
1783     rvec vec_dum;
1784
1785
1786     /* loop over linfix vectors */
1787     for (i=0; i<edi->vecs.linfix.neig; i++)
1788     {
1789         /* calculate the projection */
1790         proj = projectx(edi, xcoll, edi->vecs.linfix.vec[i]);
1791
1792         /* calculate the correction */
1793         add = edi->vecs.linfix.refproj[i] + step*edi->vecs.linfix.stpsz[i] - proj;
1794
1795         /* apply the correction */
1796         add /= edi->sav.sqrtm[i];
1797         for (j=0; j<edi->sav.nr; j++)
1798         {
1799             svmul(add, edi->vecs.linfix.vec[i][j], vec_dum);
1800             rvec_inc(xcoll[j], vec_dum);
1801         }
1802     }
1803 }
1804
1805
1806 static void do_linacc(rvec *xcoll, t_edpar *edi, t_commrec *cr)
1807 {
1808     int  i, j;
1809     real proj, add;
1810     rvec vec_dum;
1811
1812
1813     /* loop over linacc vectors */
1814     for (i=0; i<edi->vecs.linacc.neig; i++)
1815     {
1816         /* calculate the projection */
1817         proj=projectx(edi, xcoll, edi->vecs.linacc.vec[i]);
1818
1819         /* calculate the correction */
1820         add = 0.0;
1821         if (edi->vecs.linacc.stpsz[i] > 0.0)
1822         {
1823             if ((proj-edi->vecs.linacc.refproj[i]) < 0.0)
1824                 add = edi->vecs.linacc.refproj[i] - proj;
1825         }
1826         if (edi->vecs.linacc.stpsz[i] < 0.0)
1827         {
1828             if ((proj-edi->vecs.linacc.refproj[i]) > 0.0)
1829                 add = edi->vecs.linacc.refproj[i] - proj;
1830         }
1831
1832         /* apply the correction */
1833         add /= edi->sav.sqrtm[i];
1834         for (j=0; j<edi->sav.nr; j++)
1835         {
1836             svmul(add, edi->vecs.linacc.vec[i][j], vec_dum);
1837             rvec_inc(xcoll[j], vec_dum);
1838         }
1839
1840         /* new positions will act as reference */
1841         edi->vecs.linacc.refproj[i] = proj + add;
1842     }
1843 }
1844
1845
1846 static void do_radfix(rvec *xcoll, t_edpar *edi, int step, t_commrec *cr)
1847 {
1848     int  i,j;
1849     real *proj, rad=0.0, ratio;
1850     rvec vec_dum;
1851
1852
1853     if (edi->vecs.radfix.neig == 0)
1854         return;
1855
1856     snew(proj, edi->vecs.radfix.neig);
1857
1858     /* loop over radfix vectors */
1859     for (i=0; i<edi->vecs.radfix.neig; i++)
1860     {
1861         /* calculate the projections, radius */
1862         proj[i] = projectx(edi, xcoll, edi->vecs.radfix.vec[i]);
1863         rad += pow(proj[i] - edi->vecs.radfix.refproj[i], 2);
1864     }
1865
1866     rad   = sqrt(rad);
1867     ratio = (edi->vecs.radfix.stpsz[0]+edi->vecs.radfix.radius)/rad - 1.0;
1868     edi->vecs.radfix.radius += edi->vecs.radfix.stpsz[0];
1869
1870     /* loop over radfix vectors */
1871     for (i=0; i<edi->vecs.radfix.neig; i++)
1872     {
1873         proj[i] -= edi->vecs.radfix.refproj[i];
1874
1875         /* apply the correction */
1876         proj[i] /= edi->sav.sqrtm[i];
1877         proj[i] *= ratio;
1878         for (j=0; j<edi->sav.nr; j++) {
1879             svmul(proj[i], edi->vecs.radfix.vec[i][j], vec_dum);
1880             rvec_inc(xcoll[j], vec_dum);
1881         }
1882     }
1883
1884     sfree(proj);
1885 }
1886
1887
1888 static void do_radacc(rvec *xcoll, t_edpar *edi, t_commrec *cr)
1889 {
1890     int  i,j;
1891     real *proj, rad=0.0, ratio=0.0;
1892     rvec vec_dum;
1893
1894
1895     if (edi->vecs.radacc.neig == 0)
1896         return;
1897
1898     snew(proj,edi->vecs.radacc.neig);
1899
1900     /* loop over radacc vectors */
1901     for (i=0; i<edi->vecs.radacc.neig; i++)
1902     {
1903         /* calculate the projections, radius */
1904         proj[i] = projectx(edi, xcoll, edi->vecs.radacc.vec[i]);
1905         rad += pow(proj[i] - edi->vecs.radacc.refproj[i], 2);
1906     }
1907     rad = sqrt(rad);
1908
1909     /* only correct when radius decreased */
1910     if (rad < edi->vecs.radacc.radius)
1911     {
1912         ratio = edi->vecs.radacc.radius/rad - 1.0;
1913         rad   = edi->vecs.radacc.radius;
1914     }
1915     else
1916         edi->vecs.radacc.radius = rad;
1917
1918     /* loop over radacc vectors */
1919     for (i=0; i<edi->vecs.radacc.neig; i++)
1920     {
1921         proj[i] -= edi->vecs.radacc.refproj[i];
1922
1923         /* apply the correction */
1924         proj[i] /= edi->sav.sqrtm[i];
1925         proj[i] *= ratio;
1926         for (j=0; j<edi->sav.nr; j++)
1927         {
1928             svmul(proj[i], edi->vecs.radacc.vec[i][j], vec_dum);
1929             rvec_inc(xcoll[j], vec_dum);
1930         }
1931     }
1932     sfree(proj);
1933 }
1934
1935
1936 struct t_do_radcon {
1937     real *proj;
1938 };
1939
1940 static void do_radcon(rvec *xcoll, t_edpar *edi, t_commrec *cr)
1941 {
1942     int  i,j;
1943     real rad=0.0, ratio=0.0;
1944     struct t_do_radcon *loc;
1945     gmx_bool bFirst;
1946     rvec vec_dum;
1947
1948
1949     if(edi->buf->do_radcon != NULL)
1950     {
1951         bFirst = FALSE;
1952         loc    = edi->buf->do_radcon;
1953     }
1954     else
1955     {
1956         bFirst = TRUE;
1957         snew(edi->buf->do_radcon, 1);
1958     }
1959     loc = edi->buf->do_radcon;
1960
1961     if (edi->vecs.radcon.neig == 0)
1962         return;
1963
1964     if (bFirst)
1965         snew(loc->proj, edi->vecs.radcon.neig);
1966
1967     /* loop over radcon vectors */
1968     for (i=0; i<edi->vecs.radcon.neig; i++)
1969     {
1970         /* calculate the projections, radius */
1971         loc->proj[i] = projectx(edi, xcoll, edi->vecs.radcon.vec[i]);
1972         rad += pow(loc->proj[i] - edi->vecs.radcon.refproj[i], 2);
1973     }
1974     rad = sqrt(rad);
1975     /* only correct when radius increased */
1976     if (rad > edi->vecs.radcon.radius)
1977     {
1978         ratio = edi->vecs.radcon.radius/rad - 1.0;
1979
1980         /* loop over radcon vectors */
1981         for (i=0; i<edi->vecs.radcon.neig; i++)
1982         {
1983             /* apply the correction */
1984             loc->proj[i] -= edi->vecs.radcon.refproj[i];
1985             loc->proj[i] /= edi->sav.sqrtm[i];
1986             loc->proj[i] *= ratio;
1987
1988             for (j=0; j<edi->sav.nr; j++)
1989             {
1990                 svmul(loc->proj[i], edi->vecs.radcon.vec[i][j], vec_dum);
1991                 rvec_inc(xcoll[j], vec_dum);
1992             }
1993         }
1994     }
1995     else
1996         edi->vecs.radcon.radius = rad;
1997
1998     if (rad != edi->vecs.radcon.radius)
1999     {
2000         rad = 0.0;
2001         for (i=0; i<edi->vecs.radcon.neig; i++)
2002         {
2003             /* calculate the projections, radius */
2004             loc->proj[i] = projectx(edi, xcoll, edi->vecs.radcon.vec[i]);
2005             rad += pow(loc->proj[i] - edi->vecs.radcon.refproj[i], 2);
2006         }
2007         rad = sqrt(rad);
2008     }
2009 }
2010
2011
2012 static void ed_apply_constraints(rvec *xcoll, t_edpar *edi, gmx_large_int_t step, t_commrec *cr)
2013 {
2014     int i;
2015
2016
2017     GMX_MPE_LOG(ev_ed_apply_cons_start);
2018
2019     /* subtract the average positions */
2020     for (i=0; i<edi->sav.nr; i++)
2021         rvec_dec(xcoll[i], edi->sav.x[i]);
2022
2023     /* apply the constraints */
2024     if (step >= 0)
2025         do_linfix(xcoll, edi, step, cr);
2026     do_linacc(xcoll, edi, cr);
2027     if (step >= 0)
2028         do_radfix(xcoll, edi, step, cr);
2029     do_radacc(xcoll, edi, cr);
2030     do_radcon(xcoll, edi, cr);
2031
2032     /* add back the average positions */
2033     for (i=0; i<edi->sav.nr; i++)
2034         rvec_inc(xcoll[i], edi->sav.x[i]);
2035
2036     GMX_MPE_LOG(ev_ed_apply_cons_finish);
2037 }
2038
2039
2040 /* Write out the projections onto the eigenvectors */
2041 static void write_edo(int nr_edi, t_edpar *edi, gmx_edsam_t ed, gmx_large_int_t step,real rmsd)
2042 {
2043     int i;
2044     char buf[22];
2045
2046
2047     if (edi->bNeedDoEdsam)
2048     {
2049         if (step == -1)
2050             fprintf(ed->edo, "Initial projections:\n");
2051         else
2052         {
2053             fprintf(ed->edo,"Step %s, ED #%d  ", gmx_step_str(step, buf), nr_edi);
2054             fprintf(ed->edo,"  RMSD %f nm\n",rmsd);
2055         }
2056
2057         if (edi->vecs.mon.neig)
2058         {
2059             fprintf(ed->edo,"  Monitor eigenvectors");
2060             for (i=0; i<edi->vecs.mon.neig; i++)
2061                 fprintf(ed->edo," %d: %12.5e ",edi->vecs.mon.ieig[i],edi->vecs.mon.xproj[i]);
2062             fprintf(ed->edo,"\n");
2063         }
2064         if (edi->vecs.linfix.neig)
2065         {
2066             fprintf(ed->edo,"  Linfix  eigenvectors");
2067             for (i=0; i<edi->vecs.linfix.neig; i++)
2068                 fprintf(ed->edo," %d: %12.5e ",edi->vecs.linfix.ieig[i],edi->vecs.linfix.xproj[i]);
2069             fprintf(ed->edo,"\n");
2070         }
2071         if (edi->vecs.linacc.neig)
2072         {
2073             fprintf(ed->edo,"  Linacc  eigenvectors");
2074             for (i=0; i<edi->vecs.linacc.neig; i++)
2075                 fprintf(ed->edo," %d: %12.5e ",edi->vecs.linacc.ieig[i],edi->vecs.linacc.xproj[i]);
2076             fprintf(ed->edo,"\n");
2077         }
2078         if (edi->vecs.radfix.neig)
2079         {
2080             fprintf(ed->edo,"  Radfix  eigenvectors");
2081             for (i=0; i<edi->vecs.radfix.neig; i++)
2082                 fprintf(ed->edo," %d: %12.5e ",edi->vecs.radfix.ieig[i],edi->vecs.radfix.xproj[i]);
2083             fprintf(ed->edo,"\n");
2084             fprintf(ed->edo,"  fixed increment radius = %f\n", calc_radius(&edi->vecs.radfix));
2085         }
2086         if (edi->vecs.radacc.neig)
2087         {
2088             fprintf(ed->edo,"  Radacc  eigenvectors");
2089             for (i=0; i<edi->vecs.radacc.neig; i++)
2090                 fprintf(ed->edo," %d: %12.5e ",edi->vecs.radacc.ieig[i],edi->vecs.radacc.xproj[i]);
2091             fprintf(ed->edo,"\n");
2092             fprintf(ed->edo,"  acceptance radius      = %f\n", calc_radius(&edi->vecs.radacc));
2093         }
2094         if (edi->vecs.radcon.neig)
2095         {
2096             fprintf(ed->edo,"  Radcon  eigenvectors");
2097             for (i=0; i<edi->vecs.radcon.neig; i++)
2098                 fprintf(ed->edo," %d: %12.5e ",edi->vecs.radcon.ieig[i],edi->vecs.radcon.xproj[i]);
2099             fprintf(ed->edo,"\n");
2100             fprintf(ed->edo,"  contracting radius     = %f\n", calc_radius(&edi->vecs.radcon));
2101         }
2102     }
2103 }
2104
2105 /* Returns if any constraints are switched on */
2106 static int ed_constraints(gmx_bool edtype, t_edpar *edi)
2107 {
2108     if (edtype == eEDedsam || edtype == eEDflood)
2109     {
2110         return (edi->vecs.linfix.neig || edi->vecs.linacc.neig ||
2111                 edi->vecs.radfix.neig || edi->vecs.radacc.neig ||
2112                 edi->vecs.radcon.neig);
2113     }
2114     return 0;
2115 }
2116
2117
2118 /* Copies reference projection 'refproj' to fixed 'refproj0' variable for flooding/
2119  * umbrella sampling simulations. */
2120 static void copyEvecReference(t_eigvec* floodvecs)
2121 {
2122     int i;
2123
2124
2125     if (NULL==floodvecs->refproj0)
2126         snew(floodvecs->refproj0, floodvecs->neig);
2127
2128     for (i=0; i<floodvecs->neig; i++)
2129     {
2130         floodvecs->refproj0[i] = floodvecs->refproj[i];
2131     }
2132 }
2133
2134
2135 void init_edsam(gmx_mtop_t  *mtop,   /* global topology                    */
2136                 t_inputrec  *ir,     /* input record                       */
2137                 t_commrec   *cr,     /* communication record               */
2138                 gmx_edsam_t ed,      /* contains all ED data               */
2139                 rvec        x[],     /* positions of the whole MD system   */
2140                 matrix      box)     /* the box                            */
2141 {
2142     t_edpar *edi = NULL;    /* points to a single edi data set */
2143     int     numedis=0;      /* keep track of the number of ED data sets in edi file */
2144     int     i,nr_edi,avindex;
2145     rvec    *x_pbc  = NULL; /* positions of the whole MD system with pbc removed  */
2146     rvec    *xfit   = NULL; /* the positions which will be fitted to the reference structure  */
2147     rvec    *xstart = NULL; /* the positions which are subject to ED sampling */
2148     rvec    fit_transvec;   /* translation ... */
2149     matrix  fit_rotmat;     /* ... and rotation from fit to reference structure */
2150
2151
2152     if (!DOMAINDECOMP(cr) && PAR(cr) && MASTER(cr))
2153         gmx_fatal(FARGS, "Please switch on domain decomposition to use essential dynamics in parallel.");
2154
2155     GMX_MPE_LOG(ev_edsam_start);
2156
2157     if (MASTER(cr))
2158         fprintf(stderr, "ED: Initializing essential dynamics constraints.\n");
2159
2160     /* Needed for initializing radacc radius in do_edsam */
2161     ed->bFirst = 1;
2162
2163     /* The input file is read by the master and the edi structures are
2164      * initialized here. Input is stored in ed->edpar. Then the edi
2165      * structures are transferred to the other nodes */
2166     if (MASTER(cr))
2167     {
2168         snew(ed->edpar,1);
2169         /* Read the whole edi file at once: */
2170         read_edi_file(ed,ed->edpar,mtop->natoms,cr);
2171
2172         /* Initialization for every ED/flooding dataset. Flooding uses one edi dataset per
2173          * flooding vector, Essential dynamics can be applied to more than one structure
2174          * as well, but will be done in the order given in the edi file, so
2175          * expect different results for different order of edi file concatenation! */
2176         edi=ed->edpar;
2177         while(edi != NULL)
2178         {
2179             init_edi(mtop,ir,cr,ed,edi);
2180
2181             /* Init flooding parameters if needed */
2182             init_flood(edi,ed,ir->delta_t,cr);
2183
2184             edi=edi->next_edi;
2185             numedis++;
2186         }
2187     }
2188
2189     /* The master does the work here. The other nodes get the positions
2190      * not before dd_partition_system which is called after init_edsam */
2191     if (MASTER(cr))
2192     {
2193         /* Remove pbc, make molecule whole.
2194          * When ir->bContinuation=TRUE this has already been done, but ok.
2195          */
2196         snew(x_pbc,mtop->natoms);
2197         m_rveccopy(mtop->natoms,x,x_pbc);
2198         do_pbc_first_mtop(NULL,ir->ePBC,box,mtop,x_pbc);
2199
2200         /* Reset pointer to first ED data set which contains the actual ED data */
2201         edi=ed->edpar;
2202
2203         /* Loop over all ED/flooding data sets (usually only one, though) */
2204         for (nr_edi = 1; nr_edi <= numedis; nr_edi++)
2205         {
2206             /* We use srenew to allocate memory since the size of the buffers
2207              * is likely to change with every ED dataset */
2208             srenew(xfit  , edi->sref.nr );
2209             srenew(xstart, edi->sav.nr  );
2210
2211             /* Extract the positions of the atoms to which will be fitted */
2212             for (i=0; i < edi->sref.nr; i++)
2213             {
2214                 copy_rvec(x_pbc[edi->sref.anrs[i]], xfit[i]);
2215
2216                 /* Save the sref positions such that in the next time step we can make the ED group whole
2217                  * in case any of the atoms do not have the correct PBC representation */
2218                 copy_rvec(xfit[i], edi->sref.x_old[i]);
2219             }
2220
2221             /* Extract the positions of the atoms subject to ED sampling */
2222             for (i=0; i < edi->sav.nr; i++)
2223             {
2224                 copy_rvec(x_pbc[edi->sav.anrs[i]], xstart[i]);
2225
2226                 /* Save the sav positions such that in the next time step we can make the ED group whole
2227                  * in case any of the atoms do not have the correct PBC representation */
2228                 copy_rvec(xstart[i], edi->sav.x_old[i]);
2229             }
2230
2231             /* Make the fit to the REFERENCE structure, get translation and rotation */
2232             fit_to_reference(xfit, fit_transvec, fit_rotmat, edi);
2233
2234             /* Output how well we fit to the reference at the start */
2235             translate_and_rotate(xfit, edi->sref.nr, fit_transvec, fit_rotmat);
2236             fprintf(stderr, "ED: Initial RMSD from reference after fit = %f nm (dataset #%d)\n",
2237                     rmsd_from_structure(xfit, &edi->sref), nr_edi);
2238
2239             /* Now apply the translation and rotation to the atoms on which ED sampling will be performed */
2240             translate_and_rotate(xstart, edi->sav.nr, fit_transvec, fit_rotmat);
2241
2242             /* calculate initial projections */
2243             project(xstart, edi);
2244
2245             /* For the target and origin structure both a reference (fit) and an
2246              * average structure can be provided in make_edi. If both structures
2247              * are the same, make_edi only stores one of them in the .edi file.
2248              * If they differ, first the fit and then the average structure is stored
2249              * in star (or sor), thus the number of entries in star/sor is
2250              * (n_fit + n_av) with n_fit the size of the fitting group and n_av
2251              * the size of the average group. */
2252
2253             /* process target structure, if required */
2254             if (edi->star.nr > 0)
2255             {
2256                 fprintf(stderr, "ED: Fitting target structure to reference structure\n");
2257
2258                 /* get translation & rotation for fit of target structure to reference structure */
2259                 fit_to_reference(edi->star.x, fit_transvec, fit_rotmat, edi);
2260                 /* do the fit */
2261                 translate_and_rotate(edi->star.x, edi->star.nr, fit_transvec, fit_rotmat);
2262                 if (edi->star.nr == edi->sav.nr)
2263                 {
2264                     avindex = 0;
2265                 }
2266                 else /* edi->star.nr = edi->sref.nr + edi->sav.nr */
2267                 {
2268                     /* The last sav.nr indices of the target structure correspond to
2269                      * the average structure, which must be projected */
2270                     avindex = edi->star.nr - edi->sav.nr;
2271                 }
2272                 rad_project(edi, &edi->star.x[avindex], &edi->vecs.radcon, cr);
2273             } else
2274                 rad_project(edi, xstart, &edi->vecs.radcon, cr);
2275
2276             /* process structure that will serve as origin of expansion circle */
2277             if ( (eEDflood == ed->eEDtype) && (FALSE == edi->flood.bConstForce) )
2278                 fprintf(stderr, "ED: Setting center of flooding potential (0 = average structure)\n");
2279
2280             if (edi->sori.nr > 0)
2281             {
2282                 fprintf(stderr, "ED: Fitting origin structure to reference structure\n");
2283
2284                 /* fit this structure to reference structure */
2285                 fit_to_reference(edi->sori.x, fit_transvec, fit_rotmat, edi);
2286                 /* do the fit */
2287                 translate_and_rotate(edi->sori.x, edi->sori.nr, fit_transvec, fit_rotmat);
2288                 if (edi->sori.nr == edi->sav.nr)
2289                 {
2290                     avindex = 0;
2291                 }
2292                 else /* edi->sori.nr = edi->sref.nr + edi->sav.nr */
2293                 {
2294                     /* For the projection, we need the last sav.nr indices of sori */
2295                     avindex = edi->sori.nr - edi->sav.nr;
2296                 }
2297
2298                 rad_project(edi, &edi->sori.x[avindex], &edi->vecs.radacc, cr);
2299                 rad_project(edi, &edi->sori.x[avindex], &edi->vecs.radfix, cr);
2300                 if ( (eEDflood == ed->eEDtype) && (FALSE == edi->flood.bConstForce) )
2301                 {
2302                     fprintf(stderr, "ED: The ORIGIN structure will define the flooding potential center.\n");
2303                     /* Set center of flooding potential to the ORIGIN structure */
2304                     rad_project(edi, &edi->sori.x[avindex], &edi->flood.vecs, cr);
2305                     /* We already know that no (moving) reference position was provided,
2306                      * therefore we can overwrite refproj[0]*/
2307                     copyEvecReference(&edi->flood.vecs);
2308                 }
2309             }
2310             else /* No origin structure given */
2311             {
2312                 rad_project(edi, xstart, &edi->vecs.radacc, cr);
2313                 rad_project(edi, xstart, &edi->vecs.radfix, cr);
2314                 if ( (eEDflood == ed->eEDtype) && (FALSE == edi->flood.bConstForce) )
2315                 {
2316                     if (edi->flood.bHarmonic)
2317                     {
2318                         fprintf(stderr, "ED: A (possibly changing) ref. projection will define the flooding potential center.\n");
2319                         for (i=0; i<edi->flood.vecs.neig; i++)
2320                             edi->flood.vecs.refproj[i] = edi->flood.vecs.refproj0[i];
2321                     }
2322                     else
2323                     {
2324                         fprintf(stderr, "ED: The AVERAGE structure will define the flooding potential center.\n");
2325                         /* Set center of flooding potential to the center of the covariance matrix,
2326                          * i.e. the average structure, i.e. zero in the projected system */
2327                         for (i=0; i<edi->flood.vecs.neig; i++)
2328                             edi->flood.vecs.refproj[i] = 0.0;
2329                     }
2330                 }
2331             }
2332             /* For convenience, output the center of the flooding potential for the eigenvectors */
2333             if ( (eEDflood == ed->eEDtype) && (FALSE == edi->flood.bConstForce) )
2334             {
2335                 for (i=0; i<edi->flood.vecs.neig; i++)
2336                 {
2337                     fprintf(stdout, "ED: EV %d flooding potential center: %11.4e", i, edi->flood.vecs.refproj[i]);
2338                     if (edi->flood.bHarmonic)
2339                         fprintf(stdout, " (adding %11.4e/timestep)", edi->flood.vecs.refprojslope[i]);
2340                     fprintf(stdout, "\n");
2341                 }
2342             }
2343
2344             /* set starting projections for linsam */
2345             rad_project(edi, xstart, &edi->vecs.linacc, cr);
2346             rad_project(edi, xstart, &edi->vecs.linfix, cr);
2347
2348             /* Output to file, set the step to -1 so that write_edo knows it was called from init_edsam */
2349             if (ed->edo && !(ed->bStartFromCpt))
2350                 write_edo(nr_edi, edi, ed, -1, 0);
2351
2352             /* Prepare for the next edi data set: */
2353             edi=edi->next_edi;
2354         }
2355         /* Cleaning up on the master node: */
2356         sfree(x_pbc);
2357         sfree(xfit);
2358         sfree(xstart);
2359
2360     } /* end of MASTER only section */
2361
2362     if (PAR(cr))
2363     {
2364         /* First let everybody know how many ED data sets to expect */
2365         gmx_bcast(sizeof(numedis), &numedis, cr);
2366         /* Broadcast the essential dynamics / flooding data to all nodes */
2367         broadcast_ed_data(cr, ed, numedis);
2368     }
2369     else
2370     {
2371         /* In the single-CPU case, point the local atom numbers pointers to the global
2372          * one, so that we can use the same notation in serial and parallel case: */
2373
2374         /* Loop over all ED data sets (usually only one, though) */
2375         edi=ed->edpar;
2376         for (nr_edi = 1; nr_edi <= numedis; nr_edi++)
2377         {
2378             edi->sref.anrs_loc = edi->sref.anrs;
2379             edi->sav.anrs_loc  = edi->sav.anrs;
2380             edi->star.anrs_loc = edi->star.anrs;
2381             edi->sori.anrs_loc = edi->sori.anrs;
2382             /* For the same reason as above, make a dummy c_ind array: */
2383             snew(edi->sav.c_ind, edi->sav.nr);
2384             /* Initialize the array */
2385             for (i=0; i<edi->sav.nr; i++)
2386                 edi->sav.c_ind[i] = i;
2387             /* In the general case we will need a different-sized array for the reference indices: */
2388             if (!edi->bRefEqAv)
2389             {
2390                 snew(edi->sref.c_ind, edi->sref.nr);
2391                 for (i=0; i<edi->sref.nr; i++)
2392                     edi->sref.c_ind[i] = i;
2393             }
2394             /* Point to the very same array in case of other structures: */
2395             edi->star.c_ind = edi->sav.c_ind;
2396             edi->sori.c_ind = edi->sav.c_ind;
2397             /* In the serial case, the local number of atoms is the global one: */
2398             edi->sref.nr_loc = edi->sref.nr;
2399             edi->sav.nr_loc  = edi->sav.nr;
2400             edi->star.nr_loc = edi->star.nr;
2401             edi->sori.nr_loc = edi->sori.nr;
2402
2403             /* An on we go to the next edi dataset */
2404             edi=edi->next_edi;
2405         }
2406     }
2407
2408     /* Allocate space for ED buffer variables */
2409     /* Again, loop over ED data sets */
2410     edi=ed->edpar;
2411     for (nr_edi = 1; nr_edi <= numedis; nr_edi++)
2412     {
2413         /* Allocate space for ED buffer */
2414         snew(edi->buf, 1);
2415         snew(edi->buf->do_edsam, 1);
2416
2417         /* Space for collective ED buffer variables */
2418
2419         /* Collective positions of atoms with the average indices */
2420         snew(edi->buf->do_edsam->xcoll                  , edi->sav.nr);
2421         snew(edi->buf->do_edsam->shifts_xcoll           , edi->sav.nr); /* buffer for xcoll shifts */
2422         snew(edi->buf->do_edsam->extra_shifts_xcoll     , edi->sav.nr);
2423         /* Collective positions of atoms with the reference indices */
2424         if (!edi->bRefEqAv)
2425         {
2426             snew(edi->buf->do_edsam->xc_ref             , edi->sref.nr);
2427             snew(edi->buf->do_edsam->shifts_xc_ref      , edi->sref.nr); /* To store the shifts in */
2428             snew(edi->buf->do_edsam->extra_shifts_xc_ref, edi->sref.nr);
2429         }
2430
2431         /* Get memory for flooding forces */
2432         snew(edi->flood.forces_cartesian                , edi->sav.nr);
2433
2434 #ifdef DUMPEDI
2435         /* Dump it all into one file per process */
2436         dump_edi(edi, cr, nr_edi);
2437 #endif
2438
2439         /* An on we go to the next edi dataset */
2440         edi=edi->next_edi;
2441     }
2442
2443     /* Flush the edo file so that the user can check some things
2444      * when the simulation has started */
2445     if (ed->edo)
2446         fflush(ed->edo);
2447
2448     GMX_MPE_LOG(ev_edsam_finish);
2449 }
2450
2451
2452 void do_edsam(t_inputrec  *ir,
2453               gmx_large_int_t step,
2454               t_mdatoms   *md,
2455               t_commrec   *cr,
2456               rvec        xs[],   /* The local current positions on this processor */
2457               rvec        v[],    /* The velocities */
2458               matrix      box,
2459               gmx_edsam_t ed)
2460 {
2461     int     i,edinr,iupdate=500;
2462     matrix  rotmat;         /* rotation matrix */
2463     rvec    transvec;       /* translation vector */
2464     rvec    dv,dx,x_unsh;   /* tmp vectors for velocity, distance, unshifted x coordinate */
2465     real    dt_1;           /* 1/dt */
2466     struct t_do_edsam *buf;
2467     t_edpar *edi;
2468     real    rmsdev=-1;      /* RMSD from reference structure prior to applying the constraints */
2469     gmx_bool bSuppress=FALSE; /* Write .edo file on master? */
2470
2471
2472     /* Check if ED sampling has to be performed */
2473     if ( ed->eEDtype==eEDnone )
2474         return;
2475
2476     /* Suppress output on first call of do_edsam if
2477      * two-step sd2 integrator is used */
2478     if ( (ir->eI==eiSD2) && (v != NULL) )
2479         bSuppress = TRUE;
2480
2481     dt_1 = 1.0/ir->delta_t;
2482
2483     /* Loop over all ED datasets (usually one) */
2484     edi  = ed->edpar;
2485     edinr = 0;
2486     while (edi != NULL)
2487     {
2488         edinr++;
2489         if (edi->bNeedDoEdsam)
2490         {
2491
2492             buf=edi->buf->do_edsam;
2493
2494             if (ed->bFirst)
2495                 /* initialise radacc radius for slope criterion */
2496                 buf->oldrad=calc_radius(&edi->vecs.radacc);
2497
2498             /* Copy the positions into buf->xc* arrays and after ED
2499              * feed back corrections to the official positions */
2500
2501             /* Broadcast the ED positions such that every node has all of them
2502              * Every node contributes its local positions xs and stores it in
2503              * the collective buf->xcoll array. Note that for edinr > 1
2504              * xs could already have been modified by an earlier ED */
2505
2506             communicate_group_positions(cr, buf->xcoll, buf->shifts_xcoll, buf->extra_shifts_xcoll, PAR(cr) ? buf->bUpdateShifts : TRUE, xs,
2507                     edi->sav.nr, edi->sav.nr_loc, edi->sav.anrs_loc, edi->sav.c_ind, edi->sav.x_old,  box);
2508
2509 #ifdef DEBUG_ED
2510             dump_xcoll(edi, buf, cr, step);
2511 #endif
2512             /* Only assembly reference positions if their indices differ from the average ones */
2513             if (!edi->bRefEqAv)
2514                 communicate_group_positions(cr, buf->xc_ref, buf->shifts_xc_ref, buf->extra_shifts_xc_ref, PAR(cr) ? buf->bUpdateShifts : TRUE, xs,
2515                         edi->sref.nr, edi->sref.nr_loc, edi->sref.anrs_loc, edi->sref.c_ind, edi->sref.x_old, box);
2516
2517             /* If bUpdateShifts was TRUE then the shifts have just been updated in communicate_group_positions.
2518              * We do not need to update the shifts until the next NS step. Note that dd_make_local_ed_indices
2519              * set bUpdateShifts=TRUE in the parallel case. */
2520             buf->bUpdateShifts = FALSE;
2521
2522             /* Now all nodes have all of the ED positions in edi->sav->xcoll,
2523              * as well as the indices in edi->sav.anrs */
2524
2525             /* Fit the reference indices to the reference structure */
2526             if (edi->bRefEqAv)
2527                 fit_to_reference(buf->xcoll , transvec, rotmat, edi);
2528             else
2529                 fit_to_reference(buf->xc_ref, transvec, rotmat, edi);
2530
2531             /* Now apply the translation and rotation to the ED structure */
2532             translate_and_rotate(buf->xcoll, edi->sav.nr, transvec, rotmat);
2533
2534             /* Find out how well we fit to the reference (just for output steps) */
2535             if (do_per_step(step,edi->outfrq) && MASTER(cr))
2536             {
2537                 if (edi->bRefEqAv)
2538                 {
2539                     /* Indices of reference and average structures are identical,
2540                      * thus we can calculate the rmsd to SREF using xcoll */
2541                     rmsdev = rmsd_from_structure(buf->xcoll,&edi->sref);
2542                 }
2543                 else
2544                 {
2545                     /* We have to translate & rotate the reference atoms first */
2546                     translate_and_rotate(buf->xc_ref, edi->sref.nr, transvec, rotmat);
2547                     rmsdev = rmsd_from_structure(buf->xc_ref,&edi->sref);
2548                 }
2549             }
2550
2551             /* update radsam references, when required */
2552             if (do_per_step(step,edi->maxedsteps) && step >= edi->presteps)
2553             {
2554                 project(buf->xcoll, edi);
2555                 rad_project(edi, buf->xcoll, &edi->vecs.radacc, cr);
2556                 rad_project(edi, buf->xcoll, &edi->vecs.radfix, cr);
2557                 buf->oldrad=-1.e5;
2558             }
2559
2560             /* update radacc references, when required */
2561             if (do_per_step(step,iupdate) && step >= edi->presteps)
2562             {
2563                 edi->vecs.radacc.radius = calc_radius(&edi->vecs.radacc);
2564                 if (edi->vecs.radacc.radius - buf->oldrad < edi->slope)
2565                 {
2566                     project(buf->xcoll, edi);
2567                     rad_project(edi, buf->xcoll, &edi->vecs.radacc, cr);
2568                     buf->oldrad = 0.0;
2569                 } else
2570                     buf->oldrad = edi->vecs.radacc.radius;
2571             }
2572
2573             /* apply the constraints */
2574             if (step >= edi->presteps && ed_constraints(ed->eEDtype, edi))
2575             {
2576                 /* ED constraints should be applied already in the first MD step
2577                  * (which is step 0), therefore we pass step+1 to the routine */
2578                 ed_apply_constraints(buf->xcoll, edi, step+1 - ir->init_step, cr);
2579             }
2580
2581             /* write to edo, when required */
2582             if (do_per_step(step,edi->outfrq))
2583             {
2584                 project(buf->xcoll, edi);
2585                 if (MASTER(cr) && !bSuppress)
2586                     write_edo(edinr, edi, ed, step, rmsdev);
2587             }
2588
2589             /* Copy back the positions unless monitoring only */
2590             if (ed_constraints(ed->eEDtype, edi))
2591             {
2592                 /* remove fitting */
2593                 rmfit(edi->sav.nr, buf->xcoll, transvec, rotmat);
2594
2595                 /* Copy the ED corrected positions into the coordinate array */
2596                 /* Each node copies its local part. In the serial case, nat_loc is the
2597                  * total number of ED atoms */
2598                 for (i=0; i<edi->sav.nr_loc; i++)
2599                 {
2600                     /* Unshift local ED coordinate and store in x_unsh */
2601                     ed_unshift_single_coord(box, buf->xcoll[edi->sav.c_ind[i]],
2602                                             buf->shifts_xcoll[edi->sav.c_ind[i]], x_unsh);
2603
2604                     /* dx is the ED correction to the positions: */
2605                     rvec_sub(x_unsh, xs[edi->sav.anrs_loc[i]], dx);
2606
2607                     if (v != NULL)
2608                     {
2609                         /* dv is the ED correction to the velocity: */
2610                         svmul(dt_1, dx, dv);
2611                         /* apply the velocity correction: */
2612                         rvec_inc(v[edi->sav.anrs_loc[i]], dv);
2613                     }
2614                     /* Finally apply the position correction due to ED: */
2615                     copy_rvec(x_unsh, xs[edi->sav.anrs_loc[i]]);
2616                 }
2617             }
2618         } /* END of if (edi->bNeedDoEdsam) */
2619
2620         /* Prepare for the next ED dataset */
2621         edi = edi->next_edi;
2622
2623     } /* END of loop over ED datasets */
2624
2625     ed->bFirst = FALSE;
2626
2627     GMX_MPE_LOG(ev_edsam_finish);
2628 }