1 /* -*- mode: c; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; c-file-style: "stroustrup"; -*-
4 * This source code is part of
8 * GROningen MAchine for Chemical Simulations
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.
16 * This program is free software; you can redistribute it and/or
17 * modify it under the terms of the GNU General Public License
18 * as published by the Free Software Foundation; either version 2
19 * of the License, or (at your option) any later version.
21 * If you want to redistribute modifications, please consider that
22 * scientific software is very special. Version control is crucial -
23 * bugs must be traceable. We will be happy to consider code for
24 * inclusion in the official distribution, but derived work must not
25 * be called official GROMACS. Details are found in the README & COPYING
26 * files - if they are missing, get the official version at www.gromacs.org.
28 * To help us fund GROMACS development, we humbly ask that you cite
29 * the papers on the package - you can find them in the top README file.
31 * For more info, check our website at http://www.gromacs.org
34 * GROwing Monsters And Cloning Shrimps
50 #include "chargegroup.h"
55 #include "gmx_fatal.h"
70 #include "gmx_random.h"
75 #include "gmx_wallcycle.h"
76 #include "mtop_util.h"
80 #include "gromacs/timing/walltime_accounting.h"
83 #include "gmx_x86_sse2.h"
87 static void global_max(t_commrec *cr, int *n)
91 snew(sum, cr->nnodes);
93 gmx_sumi(cr->nnodes, sum, cr);
94 for (i = 0; i < cr->nnodes; i++)
102 static void realloc_bins(double **bin, int *nbin, int nbin_new)
106 if (nbin_new != *nbin)
108 srenew(*bin, nbin_new);
109 for (i = *nbin; i < nbin_new; i++)
117 double do_tpi(FILE *fplog, t_commrec *cr,
118 int nfile, const t_filenm fnm[],
119 const output_env_t oenv, gmx_bool bVerbose, gmx_bool gmx_unused bCompact,
120 int gmx_unused nstglobalcomm,
121 gmx_vsite_t gmx_unused *vsite, gmx_constr_t gmx_unused constr,
122 int gmx_unused stepout,
123 t_inputrec *inputrec,
124 gmx_mtop_t *top_global, t_fcdata *fcd,
127 t_nrnb *nrnb, gmx_wallcycle_t wcycle,
128 gmx_edsam_t gmx_unused ed,
130 int gmx_unused repl_ex_nst, int gmx_unused repl_ex_nex, int gmx_unused repl_ex_seed,
131 gmx_membed_t gmx_unused membed,
132 real gmx_unused cpt_period, real gmx_unused max_hours,
133 const char gmx_unused *deviceOptions,
134 unsigned long gmx_unused Flags,
135 gmx_walltime_accounting_t walltime_accounting)
137 const char *TPI = "Test Particle Insertion";
139 gmx_groups_t *groups;
140 gmx_enerdata_t *enerd;
142 real lambda, t, temp, beta, drmax, epot;
143 double embU, sum_embU, *sum_UgembU, V, V_all, VembU_all;
146 gmx_bool bDispCorr, bCharge, bRFExcl, bNotLastFrame, bStateChanged, bNS, bOurStep;
147 tensor force_vir, shake_vir, vir, pres;
148 int cg_tp, a_tp0, a_tp1, ngid, gid_tp, nener, e;
150 rvec mu_tot, x_init, dx, x_tp;
151 int nnodes, frame, nsteps, step;
155 char *ptr, *dump_pdb, **leg, str[STRLEN], str2[STRLEN];
156 double dbl, dump_ener;
158 int nat_cavity = 0, d;
159 real *mass_cavity = NULL, mass_tot;
161 double invbinw, *bin, refvolshift, logV, bUlogV;
162 real dvdl, prescorr, enercorr, dvdlcorr;
163 gmx_bool bEnergyOutOfBounds;
164 const char *tpid_leg[2] = {"direct", "reweighted"};
166 /* Since there is no upper limit to the insertion energies,
167 * we need to set an upper limit for the distribution output.
169 real bU_bin_limit = 50;
170 real bU_logV_bin_limit = bU_bin_limit + 10;
174 top = gmx_mtop_generate_local_top(top_global, inputrec);
176 groups = &top_global->groups;
178 bCavity = (inputrec->eI == eiTPIC);
181 ptr = getenv("GMX_TPIC_MASSES");
188 /* Read (multiple) masses from env var GMX_TPIC_MASSES,
189 * The center of mass of the last atoms is then used for TPIC.
192 while (sscanf(ptr, "%lf%n", &dbl, &i) > 0)
194 srenew(mass_cavity, nat_cavity+1);
195 mass_cavity[nat_cavity] = dbl;
196 fprintf(fplog, "mass[%d] = %f\n",
197 nat_cavity+1, mass_cavity[nat_cavity]);
203 gmx_fatal(FARGS, "Found %d masses in GMX_TPIC_MASSES", nat_cavity);
209 init_em(fplog,TPI,inputrec,&lambda,nrnb,mu_tot,
210 state->box,fr,mdatoms,top,cr,nfile,fnm,NULL,NULL);*/
211 /* We never need full pbc for TPI */
213 /* Determine the temperature for the Boltzmann weighting */
214 temp = inputrec->opts.ref_t[0];
217 for (i = 1; (i < inputrec->opts.ngtc); i++)
219 if (inputrec->opts.ref_t[i] != temp)
221 fprintf(fplog, "\nWARNING: The temperatures of the different temperature coupling groups are not identical\n\n");
222 fprintf(stderr, "\nWARNING: The temperatures of the different temperature coupling groups are not identical\n\n");
226 "\n The temperature for test particle insertion is %.3f K\n\n",
229 beta = 1.0/(BOLTZ*temp);
231 /* Number of insertions per frame */
232 nsteps = inputrec->nsteps;
234 /* Use the same neighborlist with more insertions points
235 * in a sphere of radius drmax around the initial point
237 /* This should be a proper mdp parameter */
238 drmax = inputrec->rtpi;
240 /* An environment variable can be set to dump all configurations
241 * to pdb with an insertion energy <= this value.
243 dump_pdb = getenv("GMX_TPI_DUMP");
247 sscanf(dump_pdb, "%lf", &dump_ener);
250 atoms2md(top_global, inputrec, 0, NULL, 0, top_global->natoms, mdatoms);
251 update_mdatoms(mdatoms, inputrec->fepvals->init_lambda);
254 init_enerdata(groups->grps[egcENER].nr, inputrec->fepvals->n_lambda, enerd);
255 snew(f, top_global->natoms);
257 /* Print to log file */
258 walltime_accounting_start(walltime_accounting);
259 print_date_and_time(fplog, cr->nodeid,
260 "Started Test Particle Insertion",
261 walltime_accounting);
262 wallcycle_start(wcycle, ewcRUN);
264 /* The last charge group is the group to be inserted */
265 cg_tp = top->cgs.nr - 1;
266 a_tp0 = top->cgs.index[cg_tp];
267 a_tp1 = top->cgs.index[cg_tp+1];
270 fprintf(debug, "TPI cg %d, atoms %d-%d\n", cg_tp, a_tp0, a_tp1);
272 if (a_tp1 - a_tp0 > 1 &&
273 (inputrec->rlist < inputrec->rcoulomb ||
274 inputrec->rlist < inputrec->rvdw))
276 gmx_fatal(FARGS, "Can not do TPI for multi-atom molecule with a twin-range cut-off");
278 snew(x_mol, a_tp1-a_tp0);
280 bDispCorr = (inputrec->eDispCorr != edispcNO);
282 for (i = a_tp0; i < a_tp1; i++)
284 /* Copy the coordinates of the molecule to be insterted */
285 copy_rvec(state->x[i], x_mol[i-a_tp0]);
286 /* Check if we need to print electrostatic energies */
287 bCharge |= (mdatoms->chargeA[i] != 0 ||
288 (mdatoms->chargeB && mdatoms->chargeB[i] != 0));
290 bRFExcl = (bCharge && EEL_RF(fr->eeltype) && fr->eeltype != eelRF_NEC);
292 calc_cgcm(fplog, cg_tp, cg_tp+1, &(top->cgs), state->x, fr->cg_cm);
295 if (norm(fr->cg_cm[cg_tp]) > 0.5*inputrec->rlist && fplog)
297 fprintf(fplog, "WARNING: Your TPI molecule is not centered at 0,0,0\n");
298 fprintf(stderr, "WARNING: Your TPI molecule is not centered at 0,0,0\n");
303 /* Center the molecule to be inserted at zero */
304 for (i = 0; i < a_tp1-a_tp0; i++)
306 rvec_dec(x_mol[i], fr->cg_cm[cg_tp]);
312 fprintf(fplog, "\nWill insert %d atoms %s partial charges\n",
313 a_tp1-a_tp0, bCharge ? "with" : "without");
315 fprintf(fplog, "\nWill insert %d times in each frame of %s\n",
316 nsteps, opt2fn("-rerun", nfile, fnm));
321 if (inputrec->nstlist > 1)
323 if (drmax == 0 && a_tp1-a_tp0 == 1)
325 gmx_fatal(FARGS, "Re-using the neighborlist %d times for insertions of a single atom in a sphere of radius %f does not make sense", inputrec->nstlist, drmax);
329 fprintf(fplog, "Will use the same neighborlist for %d insertions in a sphere of radius %f\n", inputrec->nstlist, drmax);
337 fprintf(fplog, "Will insert randomly in a sphere of radius %f around the center of the cavity\n", drmax);
341 ngid = groups->grps[egcENER].nr;
342 gid_tp = GET_CGINFO_GID(fr->cginfo[cg_tp]);
355 if (EEL_FULL(fr->eeltype))
360 snew(sum_UgembU, nener);
362 /* Initialize random generator */
363 tpi_rand = gmx_rng_init(inputrec->ld_seed);
367 fp_tpi = xvgropen(opt2fn("-tpi", nfile, fnm),
368 "TPI energies", "Time (ps)",
369 "(kJ mol\\S-1\\N) / (nm\\S3\\N)", oenv);
370 xvgr_subtitle(fp_tpi, "f. are averages over one frame", oenv);
373 sprintf(str, "-kT log(<Ve\\S-\\betaU\\N>/<V>)");
374 leg[e++] = strdup(str);
375 sprintf(str, "f. -kT log<e\\S-\\betaU\\N>");
376 leg[e++] = strdup(str);
377 sprintf(str, "f. <e\\S-\\betaU\\N>");
378 leg[e++] = strdup(str);
379 sprintf(str, "f. V");
380 leg[e++] = strdup(str);
381 sprintf(str, "f. <Ue\\S-\\betaU\\N>");
382 leg[e++] = strdup(str);
383 for (i = 0; i < ngid; i++)
385 sprintf(str, "f. <U\\sVdW %s\\Ne\\S-\\betaU\\N>",
386 *(groups->grpname[groups->grps[egcENER].nm_ind[i]]));
387 leg[e++] = strdup(str);
391 sprintf(str, "f. <U\\sdisp c\\Ne\\S-\\betaU\\N>");
392 leg[e++] = strdup(str);
396 for (i = 0; i < ngid; i++)
398 sprintf(str, "f. <U\\sCoul %s\\Ne\\S-\\betaU\\N>",
399 *(groups->grpname[groups->grps[egcENER].nm_ind[i]]));
400 leg[e++] = strdup(str);
404 sprintf(str, "f. <U\\sRF excl\\Ne\\S-\\betaU\\N>");
405 leg[e++] = strdup(str);
407 if (EEL_FULL(fr->eeltype))
409 sprintf(str, "f. <U\\sCoul recip\\Ne\\S-\\betaU\\N>");
410 leg[e++] = strdup(str);
413 xvgr_legend(fp_tpi, 4+nener, (const char**)leg, oenv);
414 for (i = 0; i < 4+nener; i++)
428 bNotLastFrame = read_first_frame(oenv, &status, opt2fn("-rerun", nfile, fnm),
429 &rerun_fr, TRX_NEED_X);
432 if (rerun_fr.natoms - (bCavity ? nat_cavity : 0) !=
433 mdatoms->nr - (a_tp1 - a_tp0))
435 gmx_fatal(FARGS, "Number of atoms in trajectory (%d)%s "
436 "is not equal the number in the run input file (%d) "
437 "minus the number of atoms to insert (%d)\n",
438 rerun_fr.natoms, bCavity ? " minus one" : "",
439 mdatoms->nr, a_tp1-a_tp0);
442 refvolshift = log(det(rerun_fr.box));
445 /* Make sure we don't detect SSE overflow generated before this point */
446 gmx_mm_check_and_reset_overflow();
449 while (bNotLastFrame)
451 lambda = rerun_fr.lambda;
455 for (e = 0; e < nener; e++)
460 /* Copy the coordinates from the input trajectory */
461 for (i = 0; i < rerun_fr.natoms; i++)
463 copy_rvec(rerun_fr.x[i], state->x[i]);
465 copy_mat(rerun_fr.box, state->box);
470 bStateChanged = TRUE;
472 for (step = 0; step < nsteps; step++)
474 /* In parallel all nodes generate all random configurations.
475 * In that way the result is identical to a single cpu tpi run.
479 /* Random insertion in the whole volume */
480 bNS = (step % inputrec->nstlist == 0);
483 /* Generate a random position in the box */
484 x_init[XX] = gmx_rng_uniform_real(tpi_rand)*state->box[XX][XX];
485 x_init[YY] = gmx_rng_uniform_real(tpi_rand)*state->box[YY][YY];
486 x_init[ZZ] = gmx_rng_uniform_real(tpi_rand)*state->box[ZZ][ZZ];
488 if (inputrec->nstlist == 1)
490 copy_rvec(x_init, x_tp);
494 /* Generate coordinates within |dx|=drmax of x_init */
497 dx[XX] = (2*gmx_rng_uniform_real(tpi_rand) - 1)*drmax;
498 dx[YY] = (2*gmx_rng_uniform_real(tpi_rand) - 1)*drmax;
499 dx[ZZ] = (2*gmx_rng_uniform_real(tpi_rand) - 1)*drmax;
501 while (norm2(dx) > drmax*drmax);
502 rvec_add(x_init, dx, x_tp);
507 /* Random insertion around a cavity location
508 * given by the last coordinate of the trajectory.
514 /* Copy the location of the cavity */
515 copy_rvec(rerun_fr.x[rerun_fr.natoms-1], x_init);
519 /* Determine the center of mass of the last molecule */
522 for (i = 0; i < nat_cavity; i++)
524 for (d = 0; d < DIM; d++)
527 mass_cavity[i]*rerun_fr.x[rerun_fr.natoms-nat_cavity+i][d];
529 mass_tot += mass_cavity[i];
531 for (d = 0; d < DIM; d++)
533 x_init[d] /= mass_tot;
537 /* Generate coordinates within |dx|=drmax of x_init */
540 dx[XX] = (2*gmx_rng_uniform_real(tpi_rand) - 1)*drmax;
541 dx[YY] = (2*gmx_rng_uniform_real(tpi_rand) - 1)*drmax;
542 dx[ZZ] = (2*gmx_rng_uniform_real(tpi_rand) - 1)*drmax;
544 while (norm2(dx) > drmax*drmax);
545 rvec_add(x_init, dx, x_tp);
548 if (a_tp1 - a_tp0 == 1)
550 /* Insert a single atom, just copy the insertion location */
551 copy_rvec(x_tp, state->x[a_tp0]);
555 /* Copy the coordinates from the top file */
556 for (i = a_tp0; i < a_tp1; i++)
558 copy_rvec(x_mol[i-a_tp0], state->x[i]);
560 /* Rotate the molecule randomly */
561 rotate_conf(a_tp1-a_tp0, state->x+a_tp0, NULL,
562 2*M_PI*gmx_rng_uniform_real(tpi_rand),
563 2*M_PI*gmx_rng_uniform_real(tpi_rand),
564 2*M_PI*gmx_rng_uniform_real(tpi_rand));
565 /* Shift to the insertion location */
566 for (i = a_tp0; i < a_tp1; i++)
568 rvec_inc(state->x[i], x_tp);
572 /* Check if this insertion belongs to this node */
576 switch (inputrec->eI)
579 bOurStep = ((step / inputrec->nstlist) % nnodes == cr->nodeid);
582 bOurStep = (step % nnodes == cr->nodeid);
585 gmx_fatal(FARGS, "Unknown integrator %s", ei_names[inputrec->eI]);
590 /* Clear some matrix variables */
591 clear_mat(force_vir);
592 clear_mat(shake_vir);
596 /* Set the charge group center of mass of the test particle */
597 copy_rvec(x_init, fr->cg_cm[top->cgs.nr-1]);
599 /* Calc energy (no forces) on new positions.
600 * Since we only need the intermolecular energy
601 * and the RF exclusion terms of the inserted molecule occur
602 * within a single charge group we can pass NULL for the graph.
603 * This also avoids shifts that would move charge groups
606 * Some checks above ensure than we can not have
607 * twin-range interactions together with nstlist > 1,
608 * therefore we do not need to remember the LR energies.
610 /* Make do_force do a single node force calculation */
612 do_force(fplog, cr, inputrec,
613 step, nrnb, wcycle, top, &top_global->groups,
614 state->box, state->x, &state->hist,
615 f, force_vir, mdatoms, enerd, fcd,
617 NULL, fr, NULL, mu_tot, t, NULL, NULL, FALSE,
618 GMX_FORCE_NONBONDED | GMX_FORCE_ENERGY |
619 (bNS ? GMX_FORCE_DYNAMICBOX | GMX_FORCE_NS | GMX_FORCE_DO_LR : 0) |
620 (bStateChanged ? GMX_FORCE_STATECHANGED : 0));
622 bStateChanged = FALSE;
625 /* Calculate long range corrections to pressure and energy */
626 calc_dispcorr(fplog, inputrec, fr, step, top_global->natoms, state->box,
627 lambda, pres, vir, &prescorr, &enercorr, &dvdlcorr);
628 /* figure out how to rearrange the next 4 lines MRS 8/4/2009 */
629 enerd->term[F_DISPCORR] = enercorr;
630 enerd->term[F_EPOT] += enercorr;
631 enerd->term[F_PRES] += prescorr;
632 enerd->term[F_DVDL_VDW] += dvdlcorr;
634 epot = enerd->term[F_EPOT];
635 bEnergyOutOfBounds = FALSE;
637 /* With SSE the energy can overflow, check for this */
638 if (gmx_mm_check_and_reset_overflow())
642 fprintf(debug, "Found an SSE overflow, assuming the energy is out of bounds\n");
644 bEnergyOutOfBounds = TRUE;
647 /* If the compiler doesn't optimize this check away
648 * we catch the NAN energies.
649 * The epot>GMX_REAL_MAX check catches inf values,
650 * which should nicely result in embU=0 through the exp below,
651 * but it does not hurt to check anyhow.
653 /* Non-bonded Interaction usually diverge at r=0.
654 * With tabulated interaction functions the first few entries
655 * should be capped in a consistent fashion between
656 * repulsion, dispersion and Coulomb to avoid accidental
657 * negative values in the total energy.
658 * The table generation code in tables.c does this.
659 * With user tbales the user should take care of this.
661 if (epot != epot || epot > GMX_REAL_MAX)
663 bEnergyOutOfBounds = TRUE;
665 if (bEnergyOutOfBounds)
669 fprintf(debug, "\n time %.3f, step %d: non-finite energy %f, using exp(-bU)=0\n", t, step, epot);
675 embU = exp(-beta*epot);
677 /* Determine the weighted energy contributions of each energy group */
679 sum_UgembU[e++] += epot*embU;
682 for (i = 0; i < ngid; i++)
685 (enerd->grpp.ener[egBHAMSR][GID(i, gid_tp, ngid)] +
686 enerd->grpp.ener[egBHAMLR][GID(i, gid_tp, ngid)])*embU;
691 for (i = 0; i < ngid; i++)
694 (enerd->grpp.ener[egLJSR][GID(i, gid_tp, ngid)] +
695 enerd->grpp.ener[egLJLR][GID(i, gid_tp, ngid)])*embU;
700 sum_UgembU[e++] += enerd->term[F_DISPCORR]*embU;
704 for (i = 0; i < ngid; i++)
707 (enerd->grpp.ener[egCOULSR][GID(i, gid_tp, ngid)] +
708 enerd->grpp.ener[egCOULLR][GID(i, gid_tp, ngid)])*embU;
712 sum_UgembU[e++] += enerd->term[F_RF_EXCL]*embU;
714 if (EEL_FULL(fr->eeltype))
716 sum_UgembU[e++] += enerd->term[F_COUL_RECIP]*embU;
721 if (embU == 0 || beta*epot > bU_bin_limit)
727 i = (int)((bU_logV_bin_limit
728 - (beta*epot - logV + refvolshift))*invbinw
736 realloc_bins(&bin, &nbin, i+10);
743 fprintf(debug, "TPI %7d %12.5e %12.5f %12.5f %12.5f\n",
744 step, epot, x_tp[XX], x_tp[YY], x_tp[ZZ]);
747 if (dump_pdb && epot <= dump_ener)
749 sprintf(str, "t%g_step%d.pdb", t, step);
750 sprintf(str2, "t: %f step %d ener: %f", t, step, epot);
751 write_sto_conf_mtop(str, str2, top_global, state->x, state->v,
752 inputrec->ePBC, state->box);
759 /* When running in parallel sum the energies over the processes */
760 gmx_sumd(1, &sum_embU, cr);
761 gmx_sumd(nener, sum_UgembU, cr);
766 VembU_all += V*sum_embU/nsteps;
770 if (bVerbose || frame%10 == 0 || frame < 10)
772 fprintf(stderr, "mu %10.3e <mu> %10.3e\n",
773 -log(sum_embU/nsteps)/beta, -log(VembU_all/V_all)/beta);
776 fprintf(fp_tpi, "%10.3f %12.5e %12.5e %12.5e %12.5e",
778 VembU_all == 0 ? 20/beta : -log(VembU_all/V_all)/beta,
779 sum_embU == 0 ? 20/beta : -log(sum_embU/nsteps)/beta,
781 for (e = 0; e < nener; e++)
783 fprintf(fp_tpi, " %12.5e", sum_UgembU[e]/nsteps);
785 fprintf(fp_tpi, "\n");
789 bNotLastFrame = read_next_frame(oenv, status, &rerun_fr);
790 } /* End of the loop */
791 walltime_accounting_end(walltime_accounting);
797 gmx_fio_fclose(fp_tpi);
802 fprintf(fplog, "\n");
803 fprintf(fplog, " <V> = %12.5e nm^3\n", V_all/frame);
804 fprintf(fplog, " <mu> = %12.5e kJ/mol\n", -log(VembU_all/V_all)/beta);
807 /* Write the Boltzmann factor histogram */
810 /* When running in parallel sum the bins over the processes */
813 realloc_bins(&bin, &nbin, i);
814 gmx_sumd(nbin, bin, cr);
818 fp_tpi = xvgropen(opt2fn("-tpid", nfile, fnm),
819 "TPI energy distribution",
820 "\\betaU - log(V/<V>)", "count", oenv);
821 sprintf(str, "number \\betaU > %g: %9.3e", bU_bin_limit, bin[0]);
822 xvgr_subtitle(fp_tpi, str, oenv);
823 xvgr_legend(fp_tpi, 2, (const char **)tpid_leg, oenv);
824 for (i = nbin-1; i > 0; i--)
826 bUlogV = -i/invbinw + bU_logV_bin_limit - refvolshift + log(V_all/frame);
827 fprintf(fp_tpi, "%6.2f %10d %12.5e\n",
830 bin[i]*exp(-bUlogV)*V_all/VembU_all);
832 gmx_fio_fclose(fp_tpi);
838 walltime_accounting_set_nsteps_done(walltime_accounting, frame*inputrec->nsteps);