2 * This file is part of the GROMACS molecular simulation package.
4 * Copyright (c) 2018,2019, by the GROMACS development team, led by
5 * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
6 * and including many others, as listed in the AUTHORS file in the
7 * top-level source directory and at http://www.gromacs.org.
9 * GROMACS is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public License
11 * as published by the Free Software Foundation; either version 2.1
12 * of the License, or (at your option) any later version.
14 * GROMACS is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with GROMACS; if not, see
21 * http://www.gnu.org/licenses, or write to the Free Software Foundation,
22 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
24 * If you want to redistribute modifications to GROMACS, please
25 * consider that scientific software is very special. Version
26 * control is crucial - bugs must be traceable. We will be happy to
27 * consider code for inclusion in the official distribution, but
28 * derived work must not be called official GROMACS. Details are found
29 * in the README & COPYING files - if they are missing, get the
30 * official version at http://www.gromacs.org.
32 * To help us fund GROMACS development, we humbly ask that you cite
33 * the research papers on the package. Check out http://www.gromacs.org.
38 * \brief Declares the loop for MiMiC QM/MM
40 * \author Viacheslav Bolnykh <v.bolnykh@hpc-leap.eu>
41 * \ingroup module_mdrun
53 #include "gromacs/awh/awh.h"
54 #include "gromacs/commandline/filenm.h"
55 #include "gromacs/domdec/collect.h"
56 #include "gromacs/domdec/domdec.h"
57 #include "gromacs/domdec/domdec_network.h"
58 #include "gromacs/domdec/domdec_struct.h"
59 #include "gromacs/domdec/partition.h"
60 #include "gromacs/essentialdynamics/edsam.h"
61 #include "gromacs/ewald/pme.h"
62 #include "gromacs/ewald/pme-load-balancing.h"
63 #include "gromacs/fileio/trxio.h"
64 #include "gromacs/gmxlib/network.h"
65 #include "gromacs/gmxlib/nrnb.h"
66 #include "gromacs/gpu_utils/gpu_utils.h"
67 #include "gromacs/imd/imd.h"
68 #include "gromacs/listed_forces/manage-threading.h"
69 #include "gromacs/math/functions.h"
70 #include "gromacs/math/utilities.h"
71 #include "gromacs/math/vec.h"
72 #include "gromacs/math/vectypes.h"
73 #include "gromacs/mdlib/checkpointhandler.h"
74 #include "gromacs/mdlib/compute_io.h"
75 #include "gromacs/mdlib/constr.h"
76 #include "gromacs/mdlib/ebin.h"
77 #include "gromacs/mdlib/expanded.h"
78 #include "gromacs/mdlib/force.h"
79 #include "gromacs/mdlib/force_flags.h"
80 #include "gromacs/mdlib/forcerec.h"
81 #include "gromacs/mdlib/md_support.h"
82 #include "gromacs/mdlib/mdatoms.h"
83 #include "gromacs/mdlib/mdebin.h"
84 #include "gromacs/mdlib/mdoutf.h"
85 #include "gromacs/mdlib/mdrun.h"
86 #include "gromacs/mdlib/mdsetup.h"
87 #include "gromacs/mdlib/membed.h"
88 #include "gromacs/mdlib/nb_verlet.h"
89 #include "gromacs/mdlib/nbnxn_gpu_data_mgmt.h"
90 #include "gromacs/mdlib/ns.h"
91 #include "gromacs/mdlib/resethandler.h"
92 #include "gromacs/mdlib/shellfc.h"
93 #include "gromacs/mdlib/sighandler.h"
94 #include "gromacs/mdlib/sim_util.h"
95 #include "gromacs/mdlib/simulationsignal.h"
96 #include "gromacs/mdlib/stophandler.h"
97 #include "gromacs/mdlib/tgroup.h"
98 #include "gromacs/mdlib/trajectory_writing.h"
99 #include "gromacs/mdlib/update.h"
100 #include "gromacs/mdlib/vcm.h"
101 #include "gromacs/mdlib/vsite.h"
102 #include "gromacs/mdtypes/awh-history.h"
103 #include "gromacs/mdtypes/awh-params.h"
104 #include "gromacs/mdtypes/commrec.h"
105 #include "gromacs/mdtypes/df_history.h"
106 #include "gromacs/mdtypes/energyhistory.h"
107 #include "gromacs/mdtypes/fcdata.h"
108 #include "gromacs/mdtypes/forcerec.h"
109 #include "gromacs/mdtypes/group.h"
110 #include "gromacs/mdtypes/inputrec.h"
111 #include "gromacs/mdtypes/interaction_const.h"
112 #include "gromacs/mdtypes/md_enums.h"
113 #include "gromacs/mdtypes/mdatom.h"
114 #include "gromacs/mdtypes/observableshistory.h"
115 #include "gromacs/mdtypes/state.h"
116 #include "gromacs/mimic/MimicCommunicator.h"
117 #include "gromacs/mimic/MimicUtils.h"
118 #include "gromacs/pbcutil/mshift.h"
119 #include "gromacs/pbcutil/pbc.h"
120 #include "gromacs/pulling/pull.h"
121 #include "gromacs/swap/swapcoords.h"
122 #include "gromacs/timing/wallcycle.h"
123 #include "gromacs/timing/walltime_accounting.h"
124 #include "gromacs/topology/atoms.h"
125 #include "gromacs/topology/idef.h"
126 #include "gromacs/topology/mtop_util.h"
127 #include "gromacs/topology/topology.h"
128 #include "gromacs/trajectory/trajectoryframe.h"
129 #include "gromacs/utility/basedefinitions.h"
130 #include "gromacs/utility/cstringutil.h"
131 #include "gromacs/utility/fatalerror.h"
132 #include "gromacs/utility/logger.h"
133 #include "gromacs/utility/real.h"
134 #include "gromacs/utility/smalloc.h"
136 #include "integrator.h"
137 #include "replicaexchange.h"
139 using gmx::SimulationSignaller;
141 void gmx::Integrator::do_mimic()
143 t_inputrec *ir = inputrec;
144 int64_t step, step_rel;
145 double t, lam0[efptNR];
146 bool isLastStep = false;
147 bool doFreeEnergyPerturbation = false;
149 tensor force_vir, shake_vir, total_vir, pres;
152 gmx_enerdata_t *enerd;
153 PaddedVector<gmx::RVec> f {};
154 gmx_global_stat_t gstat;
155 t_graph *graph = nullptr;
156 gmx_groups_t *groups;
157 gmx_shellfc_t *shellfc;
161 /* Domain decomposition could incorrectly miss a bonded
162 interaction, but checking for that requires a global
163 communication stage, which does not otherwise happen in DD
164 code. So we do that alongside the first global energy reduction
165 after a new DD is made. These variables handle whether the
166 check happens, and the result it returns. */
167 bool shouldCheckNumberOfBondedInteractions = false;
168 int totalNumberOfBondedInteractions = -1;
170 SimulationSignals signals;
171 // Most global communnication stages don't propagate mdrun
172 // signals, and will use this object to achieve that.
173 SimulationSignaller nullSignaller(nullptr, nullptr, nullptr, false, false);
177 gmx_fatal(FARGS, "Expanded ensemble not supported by MiMiC.");
181 gmx_fatal(FARGS, "Simulated tempering not supported by MiMiC.");
185 gmx_fatal(FARGS, "AWH not supported by MiMiC.");
187 if (replExParams.exchangeInterval > 0)
189 gmx_fatal(FARGS, "Replica exchange not supported by MiMiC.");
191 if (opt2bSet("-ei", nfile, fnm) || observablesHistory->edsamHistory != nullptr)
193 gmx_fatal(FARGS, "Essential dynamics not supported by MiMiC.");
197 gmx_fatal(FARGS, "Interactive MD not supported by MiMiC.");
201 gmx_fatal(FARGS, "Multiple simulations not supported by MiMiC.");
203 if (std::any_of(ir->opts.annealing, ir->opts.annealing + ir->opts.ngtc,
204 [](int i){return i != eannNO; }))
206 gmx_fatal(FARGS, "Simulated annealing not supported by MiMiC.");
209 /* Settings for rerun */
211 ir->nstcalcenergy = 1;
212 int nstglobalcomm = 1;
213 const bool bNS = true;
215 // Communicator to interact with MiMiC
216 MimicCommunicator mimicCommunicator {};
219 mimicCommunicator.init();
220 mimicCommunicator.sendInitData(top_global, state_global->x);
221 ir->nsteps = mimicCommunicator.getStepNumber();
224 ir->nstxout_compressed = 0;
225 groups = &top_global->groups;
226 top_global->intermolecularExclusionGroup = genQmmmIndices(*top_global);
228 initialize_lambdas(fplog, *ir, MASTER(cr), &state_global->fep_state, state_global->lambda, lam0);
231 gmx_mdoutf *outf = init_mdoutf(fplog, nfile, fnm, mdrunOptions, cr, outputProvider, ir, top_global, oenv, wcycle);
232 t_mdebin *mdebin = init_mdebin(mdrunOptions.continuationOptions.appendFiles ? nullptr : mdoutf_get_fp_ene(outf),
233 top_global, ir, mdoutf_get_fp_dhdl(outf), true);
235 /* Energy terms and groups */
237 init_enerdata(top_global->groups.grps[egcENER].nr, ir->fepvals->n_lambda,
240 /* Kinetic energy data */
241 std::unique_ptr<gmx_ekindata_t> eKinData = std::make_unique<gmx_ekindata_t>();
242 gmx_ekindata_t *ekind = eKinData.get();
243 init_ekindata(fplog, top_global, &(ir->opts), ekind);
244 /* Copy the cos acceleration to the groups struct */
245 ekind->cosacc.cos_accel = ir->cos_accel;
247 gstat = global_stat_init(ir);
249 /* Check for polarizable models and flexible constraints */
250 shellfc = init_shell_flexcon(fplog,
251 top_global, constr ? constr->numFlexibleConstraints() : 0,
252 ir->nstcalcenergy, DOMAINDECOMP(cr));
255 double io = compute_io(ir, top_global->natoms, groups, mdebin->ebin->nener, 1);
256 if ((io > 2000) && MASTER(cr))
259 "\nWARNING: This run will generate roughly %.0f Mb of data\n\n",
264 // Local state only becomes valid now.
265 std::unique_ptr<t_state> stateInstance;
268 if (DOMAINDECOMP(cr))
270 dd_init_local_top(*top_global, &top);
272 stateInstance = std::make_unique<t_state>();
273 state = stateInstance.get();
274 dd_init_local_state(cr->dd, state_global, state);
276 /* Distribute the charge groups over the nodes from the master node */
277 dd_partition_system(fplog, mdlog, ir->init_step, cr, TRUE, 1,
278 state_global, *top_global, ir,
279 state, &f, mdAtoms, &top, fr,
281 nrnb, nullptr, FALSE);
282 shouldCheckNumberOfBondedInteractions = true;
283 gmx_bcast(sizeof(ir->nsteps), &ir->nsteps, cr);
287 state_change_natoms(state_global, state_global->natoms);
288 /* We need to allocate one element extra, since we might use
289 * (unaligned) 4-wide SIMD loads to access rvec entries.
291 f.resizeWithPadding(state_global->natoms);
292 /* Copy the pointer to the global state */
293 state = state_global;
295 mdAlgorithmsSetupAtomData(cr, ir, *top_global, &top, fr,
296 &graph, mdAtoms, constr, vsite, shellfc);
299 auto mdatoms = mdAtoms->mdatoms();
301 // NOTE: The global state is no longer used at this point.
302 // But state_global is still used as temporary storage space for writing
303 // the global state to file and potentially for replica exchange.
304 // (Global topology should persist.)
306 update_mdatoms(mdatoms, state->lambda[efptMASS]);
308 if (ir->efep != efepNO && ir->fepvals->nstdhdl != 0)
310 doFreeEnergyPerturbation = true;
314 int cglo_flags = (CGLO_INITIALIZATION | CGLO_GSTAT |
315 (shouldCheckNumberOfBondedInteractions ?
316 CGLO_CHECK_NUMBER_OF_BONDED_INTERACTIONS : 0));
317 bool bSumEkinhOld = false;
318 t_vcm *vcm = nullptr;
319 compute_globals(fplog, gstat, cr, ir, fr, ekind, state, mdatoms, nrnb, vcm,
320 nullptr, enerd, force_vir, shake_vir, total_vir, pres, mu_tot,
321 constr, &nullSignaller, state->box,
322 &totalNumberOfBondedInteractions, &bSumEkinhOld, cglo_flags);
324 checkNumberOfBondedInteractions(mdlog, cr, totalNumberOfBondedInteractions,
325 top_global, &top, state,
326 &shouldCheckNumberOfBondedInteractions);
330 fprintf(stderr, "starting MiMiC MD run '%s'\n\n",
331 *(top_global->name));
332 if (mdrunOptions.verbose)
334 fprintf(stderr, "Calculated time to finish depends on nsteps from "
335 "run input file,\nwhich may not correspond to the time "
336 "needed to process input trajectory.\n\n");
338 fprintf(fplog, "\n");
341 walltime_accounting_start_time(walltime_accounting);
342 wallcycle_start(wcycle, ewcRUN);
343 print_start(fplog, cr, walltime_accounting, "mdrun");
345 /***********************************************************
349 ************************************************************/
353 GMX_LOG(mdlog.info).asParagraph().
354 appendText("Simulations has constraints. Constraints will "
355 "be handled by CPMD.");
358 GMX_LOG(mdlog.info).asParagraph().
359 appendText("MiMiC does not report kinetic energy, total energy, temperature, virial and pressure.");
361 auto stopHandler = stopHandlerBuilder->getStopHandlerMD(
362 compat::not_null<SimulationSignal*>(&signals[eglsSTOPCOND]), false,
363 MASTER(cr), ir->nstlist, mdrunOptions.reproducible, nstglobalcomm,
364 mdrunOptions.maximumHoursToRun, ir->nstlist == 0, fplog, step, bNS, walltime_accounting);
366 // we don't do counter resetting in rerun - finish will always be valid
367 walltime_accounting_set_valid_finish(walltime_accounting);
369 DdOpenBalanceRegionBeforeForceComputation ddOpenBalanceRegion =
371 DdOpenBalanceRegionBeforeForceComputation::yes :
372 DdOpenBalanceRegionBeforeForceComputation::no);
373 DdCloseBalanceRegionAfterForceComputation ddCloseBalanceRegion =
375 DdCloseBalanceRegionAfterForceComputation::yes :
376 DdCloseBalanceRegionAfterForceComputation::no);
378 step = ir->init_step;
381 /* and stop now if we should */
382 isLastStep = (isLastStep || (ir->nsteps >= 0 && step_rel > ir->nsteps));
385 isLastStep = (isLastStep || (ir->nsteps >= 0 && step_rel == ir->nsteps));
386 wallcycle_start(wcycle, ewcSTEP);
392 mimicCommunicator.getCoords(&state_global->x, state_global->natoms);
395 if (ir->efep != efepNO)
397 setCurrentLambdasLocal(step, ir->fepvals, lam0, state);
402 const bool constructVsites = ((vsite != nullptr) && mdrunOptions.rerunConstructVsites);
403 if (constructVsites && DOMAINDECOMP(cr))
405 gmx_fatal(FARGS, "Vsite recalculation with -rerun is not implemented with domain decomposition, "
406 "use a single rank");
410 if (DOMAINDECOMP(cr))
412 /* Repartition the domain decomposition */
413 const bool bMasterState = true;
414 dd_partition_system(fplog, mdlog, step, cr,
415 bMasterState, nstglobalcomm,
416 state_global, *top_global, ir,
417 state, &f, mdAtoms, &top, fr,
420 mdrunOptions.verbose);
421 shouldCheckNumberOfBondedInteractions = true;
426 print_ebin_header(fplog, step, t); /* can we improve the information printed here? */
429 if (ir->efep != efepNO)
431 update_mdatoms(mdatoms, state->lambda[efptMASS]);
434 force_flags = (GMX_FORCE_STATECHANGED |
435 GMX_FORCE_DYNAMICBOX |
436 GMX_FORCE_ALLFORCES |
437 GMX_FORCE_VIRIAL | // TODO: Get rid of this once #2649 is solved
439 (doFreeEnergyPerturbation ? GMX_FORCE_DHDL : 0));
443 /* Now is the time to relax the shells */
444 relax_shell_flexcon(fplog, cr, ms, mdrunOptions.verbose,
445 enforcedRotation, step,
446 ir, bNS, force_flags, &top,
448 state, f.arrayRefWithPadding(), force_vir, mdatoms,
449 nrnb, wcycle, graph, groups,
450 shellfc, fr, ppForceWorkload, t, mu_tot,
452 ddOpenBalanceRegion, ddCloseBalanceRegion);
456 /* The coordinates (x) are shifted (to get whole molecules)
458 * This is parallellized as well, and does communication too.
459 * Check comments in sim_util.c
462 gmx_edsam *ed = nullptr;
463 do_force(fplog, cr, ms, ir, awh, enforcedRotation,
464 step, nrnb, wcycle, &top, groups,
465 state->box, state->x.arrayRefWithPadding(), &state->hist,
466 f.arrayRefWithPadding(), force_vir, mdatoms, enerd, fcd,
467 state->lambda, graph,
468 fr, ppForceWorkload, vsite, mu_tot, t, ed,
469 GMX_FORCE_NS | force_flags,
470 ddOpenBalanceRegion, ddCloseBalanceRegion);
473 /* Now we have the energies and forces corresponding to the
474 * coordinates at time t.
477 const bool isCheckpointingStep = false;
478 const bool doRerun = false;
479 const bool bSumEkinhOld = false;
480 do_md_trajectory_writing(fplog, cr, nfile, fnm, step, step_rel, t,
481 ir, state, state_global, observablesHistory,
483 outf, mdebin, ekind, f,
484 isCheckpointingStep, doRerun, isLastStep,
485 mdrunOptions.writeConfout,
489 stopHandler->setSignal();
493 /* Need to unshift here */
494 unshift_self(graph, state->box, as_rvec_array(state->x.data()));
497 if (vsite != nullptr)
499 wallcycle_start(wcycle, ewcVSITECONSTR);
500 if (graph != nullptr)
502 shift_self(graph, state->box, as_rvec_array(state->x.data()));
504 construct_vsites(vsite, as_rvec_array(state->x.data()), ir->delta_t, as_rvec_array(state->v.data()),
505 top.idef.iparams, top.idef.il,
506 fr->ePBC, fr->bMolPBC, cr, state->box);
508 if (graph != nullptr)
510 unshift_self(graph, state->box, as_rvec_array(state->x.data()));
512 wallcycle_stop(wcycle, ewcVSITECONSTR);
516 const bool doInterSimSignal = false;
517 const bool doIntraSimSignal = true;
518 bool bSumEkinhOld = false;
519 t_vcm *vcm = nullptr;
520 SimulationSignaller signaller(&signals, cr, ms, doInterSimSignal, doIntraSimSignal);
522 compute_globals(fplog, gstat, cr, ir, fr, ekind, state, mdatoms, nrnb, vcm,
523 wcycle, enerd, nullptr, nullptr, nullptr, nullptr, mu_tot,
526 &totalNumberOfBondedInteractions, &bSumEkinhOld,
527 CGLO_GSTAT | CGLO_ENERGY
528 | (shouldCheckNumberOfBondedInteractions ? CGLO_CHECK_NUMBER_OF_BONDED_INTERACTIONS : 0)
530 checkNumberOfBondedInteractions(mdlog, cr, totalNumberOfBondedInteractions,
531 top_global, &top, state,
532 &shouldCheckNumberOfBondedInteractions);
536 gmx::HostVector<gmx::RVec> fglobal(top_global->natoms);
537 gmx::ArrayRef<gmx::RVec> ftemp;
538 gmx::ArrayRef<const gmx::RVec> flocal = gmx::makeArrayRef(f);
539 if (DOMAINDECOMP(cr))
541 ftemp = gmx::makeArrayRef(fglobal);
542 dd_collect_vec(cr->dd, state, flocal, ftemp);
546 ftemp = gmx::makeArrayRef(f);
551 mimicCommunicator.sendEnergies(enerd->term[F_EPOT]);
552 mimicCommunicator.sendForces(ftemp, state_global->natoms);
558 /* Note: this is OK, but there are some numerical precision issues with using the convergence of
559 the virial that should probably be addressed eventually. state->veta has better properies,
560 but what we actually need entering the new cycle is the new shake_vir value. Ideally, we could
561 generate the new shake_vir, but test the veta value for convergence. This will take some thought. */
563 if (ir->efep != efepNO)
565 /* Sum up the foreign energy and dhdl terms for md and sd.
566 Currently done every step so that dhdl is correct in the .edr */
567 sum_dhdl(enerd, state->lambda, ir->fepvals);
573 const bool bCalcEnerStep = true;
574 upd_mdebin(mdebin, doFreeEnergyPerturbation, bCalcEnerStep,
575 t, mdatoms->tmass, enerd, state,
576 ir->fepvals, ir->expandedvals, state->box,
577 shake_vir, force_vir, total_vir, pres,
578 ekind, mu_tot, constr);
580 const bool do_ene = true;
581 const bool do_log = true;
583 const bool do_dr = ir->nstdisreout != 0;
584 const bool do_or = ir->nstorireout != 0;
586 print_ebin(mdoutf_get_fp_ene(outf), do_ene, do_dr, do_or, do_log ? fplog : nullptr,
588 eprNORMAL, mdebin, fcd, groups, &(ir->opts), awh);
590 if (do_per_step(step, ir->nstlog))
592 if (fflush(fplog) != 0)
594 gmx_fatal(FARGS, "Cannot flush logfile - maybe you are out of disk space?");
599 /* Print the remaining wall clock time for the run */
600 if (isMasterSimMasterRank(ms, cr) &&
601 (mdrunOptions.verbose || gmx_got_usr_signal()))
605 fprintf(stderr, "\n");
607 print_time(stderr, walltime_accounting, step, ir, cr);
610 cycles = wallcycle_stop(wcycle, ewcSTEP);
611 if (DOMAINDECOMP(cr) && wcycle)
613 dd_cycles_add(cr->dd, cycles, ddCyclStep);
616 /* increase the MD step number */
620 /* End of main MD loop */
622 /* Closing TNG files can include compressing data. Therefore it is good to do that
623 * before stopping the time measurements. */
624 mdoutf_tng_close(outf);
626 /* Stop measuring walltime */
627 walltime_accounting_end_time(walltime_accounting);
631 mimicCommunicator.finalize();
634 if (!thisRankHasDuty(cr, DUTY_PME))
636 /* Tell the PME only node to finish */
637 gmx_pme_send_finish(cr);
643 done_shellfc(fplog, shellfc, step_rel);
645 // Clean up swapcoords
646 if (ir->eSwapCoords != eswapNO)
648 finish_swapcoords(ir->swap);
651 walltime_accounting_set_nsteps_done(walltime_accounting, step_rel);
653 destroy_enerdata(enerd);