Fix part of old-style casting
[alexxy/gromacs.git] / src / gromacs / mdrun / runner.cpp
1 /*
2  * This file is part of the GROMACS molecular simulation package.
3  *
4  * Copyright (c) 1991-2000, University of Groningen, The Netherlands.
5  * Copyright (c) 2001-2004, The GROMACS development team.
6  * Copyright (c) 2011,2012,2013,2014,2015,2016,2017,2018, by the GROMACS development team, led by
7  * Mark Abraham, David van der Spoel, Berk Hess, and Erik Lindahl,
8  * and including many others, as listed in the AUTHORS file in the
9  * top-level source directory and at http://www.gromacs.org.
10  *
11  * GROMACS is free software; you can redistribute it and/or
12  * modify it under the terms of the GNU Lesser General Public License
13  * as published by the Free Software Foundation; either version 2.1
14  * of the License, or (at your option) any later version.
15  *
16  * GROMACS is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
19  * Lesser General Public License for more details.
20  *
21  * You should have received a copy of the GNU Lesser General Public
22  * License along with GROMACS; if not, see
23  * http://www.gnu.org/licenses, or write to the Free Software Foundation,
24  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.
25  *
26  * If you want to redistribute modifications to GROMACS, please
27  * consider that scientific software is very special. Version
28  * control is crucial - bugs must be traceable. We will be happy to
29  * consider code for inclusion in the official distribution, but
30  * derived work must not be called official GROMACS. Details are found
31  * in the README & COPYING files - if they are missing, get the
32  * official version at http://www.gromacs.org.
33  *
34  * To help us fund GROMACS development, we humbly ask that you cite
35  * the research papers on the package. Check out http://www.gromacs.org.
36  */
37 /*! \internal \file
38  *
39  * \brief Implements the MD runner routine calling all integrators.
40  *
41  * \author David van der Spoel <david.vanderspoel@icm.uu.se>
42  * \ingroup module_mdrun
43  */
44 #include "gmxpre.h"
45
46 #include "runner.h"
47
48 #include "config.h"
49
50 #include <cassert>
51 #include <csignal>
52 #include <cstdlib>
53 #include <cstring>
54
55 #include <algorithm>
56
57 #include "gromacs/commandline/filenm.h"
58 #include "gromacs/compat/make_unique.h"
59 #include "gromacs/domdec/domdec.h"
60 #include "gromacs/domdec/domdec_struct.h"
61 #include "gromacs/domdec/localatomsetmanager.h"
62 #include "gromacs/ewald/ewald-utils.h"
63 #include "gromacs/ewald/pme.h"
64 #include "gromacs/ewald/pme-gpu-program.h"
65 #include "gromacs/fileio/checkpoint.h"
66 #include "gromacs/fileio/oenv.h"
67 #include "gromacs/fileio/tpxio.h"
68 #include "gromacs/gmxlib/network.h"
69 #include "gromacs/gmxlib/nrnb.h"
70 #include "gromacs/gpu_utils/clfftinitializer.h"
71 #include "gromacs/gpu_utils/gpu_utils.h"
72 #include "gromacs/hardware/cpuinfo.h"
73 #include "gromacs/hardware/detecthardware.h"
74 #include "gromacs/hardware/printhardware.h"
75 #include "gromacs/listed-forces/disre.h"
76 #include "gromacs/listed-forces/orires.h"
77 #include "gromacs/math/functions.h"
78 #include "gromacs/math/utilities.h"
79 #include "gromacs/math/vec.h"
80 #include "gromacs/mdlib/boxdeformation.h"
81 #include "gromacs/mdlib/calc_verletbuf.h"
82 #include "gromacs/mdlib/forcerec.h"
83 #include "gromacs/mdlib/gmx_omp_nthreads.h"
84 #include "gromacs/mdlib/main.h"
85 #include "gromacs/mdlib/makeconstraints.h"
86 #include "gromacs/mdlib/md_support.h"
87 #include "gromacs/mdlib/mdatoms.h"
88 #include "gromacs/mdlib/mdrun.h"
89 #include "gromacs/mdlib/membed.h"
90 #include "gromacs/mdlib/nb_verlet.h"
91 #include "gromacs/mdlib/nbnxn_gpu_data_mgmt.h"
92 #include "gromacs/mdlib/nbnxn_search.h"
93 #include "gromacs/mdlib/nbnxn_tuning.h"
94 #include "gromacs/mdlib/qmmm.h"
95 #include "gromacs/mdlib/repl_ex.h"
96 #include "gromacs/mdlib/sighandler.h"
97 #include "gromacs/mdlib/sim_util.h"
98 #include "gromacs/mdrunutility/mdmodules.h"
99 #include "gromacs/mdrunutility/threadaffinity.h"
100 #include "gromacs/mdtypes/commrec.h"
101 #include "gromacs/mdtypes/fcdata.h"
102 #include "gromacs/mdtypes/inputrec.h"
103 #include "gromacs/mdtypes/md_enums.h"
104 #include "gromacs/mdtypes/observableshistory.h"
105 #include "gromacs/mdtypes/state.h"
106 #include "gromacs/pbcutil/pbc.h"
107 #include "gromacs/pulling/pull.h"
108 #include "gromacs/pulling/pull_rotation.h"
109 #include "gromacs/swap/swapcoords.h"
110 #include "gromacs/taskassignment/decidegpuusage.h"
111 #include "gromacs/taskassignment/resourcedivision.h"
112 #include "gromacs/taskassignment/taskassignment.h"
113 #include "gromacs/taskassignment/usergpuids.h"
114 #include "gromacs/timing/wallcycle.h"
115 #include "gromacs/topology/mtop_util.h"
116 #include "gromacs/trajectory/trajectoryframe.h"
117 #include "gromacs/utility/basenetwork.h"
118 #include "gromacs/utility/cstringutil.h"
119 #include "gromacs/utility/exceptions.h"
120 #include "gromacs/utility/fatalerror.h"
121 #include "gromacs/utility/filestream.h"
122 #include "gromacs/utility/gmxassert.h"
123 #include "gromacs/utility/gmxmpi.h"
124 #include "gromacs/utility/logger.h"
125 #include "gromacs/utility/loggerbuilder.h"
126 #include "gromacs/utility/physicalnodecommunicator.h"
127 #include "gromacs/utility/pleasecite.h"
128 #include "gromacs/utility/programcontext.h"
129 #include "gromacs/utility/smalloc.h"
130 #include "gromacs/utility/stringutil.h"
131
132 #include "integrator.h"
133
134 #ifdef GMX_FAHCORE
135 #include "corewrap.h"
136 #endif
137
138 namespace gmx
139 {
140
141 /*! \brief Barrier for safe simultaneous thread access to mdrunner data
142  *
143  * Used to ensure that the master thread does not modify mdrunner during copy
144  * on the spawned threads. */
145 static void threadMpiMdrunnerAccessBarrier()
146 {
147 #if GMX_THREAD_MPI
148     MPI_Barrier(MPI_COMM_WORLD);
149 #endif
150 }
151
152 void Mdrunner::reinitializeOnSpawnedThread()
153 {
154     threadMpiMdrunnerAccessBarrier();
155
156     cr  = reinitialize_commrec_for_this_thread(cr);
157
158     GMX_RELEASE_ASSERT(!MASTER(cr), "reinitializeOnSpawnedThread should only be called on spawned threads");
159
160     // Only the master rank writes to the log file
161     fplog = nullptr;
162 }
163
164 /*! \brief The callback used for running on spawned threads.
165  *
166  * Obtains the pointer to the master mdrunner object from the one
167  * argument permitted to the thread-launch API call, copies it to make
168  * a new runner for this thread, reinitializes necessary data, and
169  * proceeds to the simulation. */
170 static void mdrunner_start_fn(const void *arg)
171 {
172     try
173     {
174         auto masterMdrunner = reinterpret_cast<const gmx::Mdrunner *>(arg);
175         /* copy the arg list to make sure that it's thread-local. This
176            doesn't copy pointed-to items, of course; fnm, cr and fplog
177            are reset in the call below, all others should be const. */
178         gmx::Mdrunner mdrunner = *masterMdrunner;
179         mdrunner.reinitializeOnSpawnedThread();
180         mdrunner.mdrunner();
181     }
182     GMX_CATCH_ALL_AND_EXIT_WITH_FATAL_ERROR;
183 }
184
185
186 /*! \brief Start thread-MPI threads.
187  *
188  * Called by mdrunner() to start a specific number of threads
189  * (including the main thread) for thread-parallel runs. This in turn
190  * calls mdrunner() for each thread. All options are the same as for
191  * mdrunner(). */
192 t_commrec *Mdrunner::spawnThreads(int numThreadsToLaunch) const
193 {
194
195     /* first check whether we even need to start tMPI */
196     if (numThreadsToLaunch < 2)
197     {
198         return cr;
199     }
200
201 #if GMX_THREAD_MPI
202     /* now spawn new threads that start mdrunner_start_fn(), while
203        the main thread returns, we set thread affinity later */
204     if (tMPI_Init_fn(TRUE, numThreadsToLaunch, TMPI_AFFINITY_NONE,
205                      mdrunner_start_fn, static_cast<const void*>(this)) != TMPI_SUCCESS)
206     {
207         GMX_THROW(gmx::InternalError("Failed to spawn thread-MPI threads"));
208     }
209
210     threadMpiMdrunnerAccessBarrier();
211 #else
212     GMX_UNUSED_VALUE(mdrunner_start_fn);
213 #endif
214
215     return reinitialize_commrec_for_this_thread(cr);
216 }
217
218 }      // namespace
219
220 /*! \brief Initialize variables for Verlet scheme simulation */
221 static void prepare_verlet_scheme(FILE                           *fplog,
222                                   t_commrec                      *cr,
223                                   t_inputrec                     *ir,
224                                   int                             nstlist_cmdline,
225                                   const gmx_mtop_t               *mtop,
226                                   const matrix                    box,
227                                   bool                            makeGpuPairList,
228                                   const gmx::CpuInfo             &cpuinfo)
229 {
230     /* For NVE simulations, we will retain the initial list buffer */
231     if (EI_DYNAMICS(ir->eI) &&
232         ir->verletbuf_tol > 0 &&
233         !(EI_MD(ir->eI) && ir->etc == etcNO))
234     {
235         /* Update the Verlet buffer size for the current run setup */
236
237         /* Here we assume SIMD-enabled kernels are being used. But as currently
238          * calc_verlet_buffer_size gives the same results for 4x8 and 4x4
239          * and 4x2 gives a larger buffer than 4x4, this is ok.
240          */
241         ListSetupType      listType  = (makeGpuPairList ? ListSetupType::Gpu : ListSetupType::CpuSimdWhenSupported);
242         VerletbufListSetup listSetup = verletbufGetSafeListSetup(listType);
243
244         real               rlist_new;
245         calc_verlet_buffer_size(mtop, det(box), ir, ir->nstlist, ir->nstlist - 1, -1, &listSetup, nullptr, &rlist_new);
246
247         if (rlist_new != ir->rlist)
248         {
249             if (fplog != nullptr)
250             {
251                 fprintf(fplog, "\nChanging rlist from %g to %g for non-bonded %dx%d atom kernels\n\n",
252                         ir->rlist, rlist_new,
253                         listSetup.cluster_size_i, listSetup.cluster_size_j);
254             }
255             ir->rlist     = rlist_new;
256         }
257     }
258
259     if (nstlist_cmdline > 0 && (!EI_DYNAMICS(ir->eI) || ir->verletbuf_tol <= 0))
260     {
261         gmx_fatal(FARGS, "Can not set nstlist without %s",
262                   !EI_DYNAMICS(ir->eI) ? "dynamics" : "verlet-buffer-tolerance");
263     }
264
265     if (EI_DYNAMICS(ir->eI))
266     {
267         /* Set or try nstlist values */
268         increaseNstlist(fplog, cr, ir, nstlist_cmdline, mtop, box, makeGpuPairList, cpuinfo);
269     }
270 }
271
272 /*! \brief Override the nslist value in inputrec
273  *
274  * with value passed on the command line (if any)
275  */
276 static void override_nsteps_cmdline(const gmx::MDLogger &mdlog,
277                                     int64_t              nsteps_cmdline,
278                                     t_inputrec          *ir)
279 {
280     assert(ir);
281
282     /* override with anything else than the default -2 */
283     if (nsteps_cmdline > -2)
284     {
285         char sbuf_steps[STEPSTRSIZE];
286         char sbuf_msg[STRLEN];
287
288         ir->nsteps = nsteps_cmdline;
289         if (EI_DYNAMICS(ir->eI) && nsteps_cmdline != -1)
290         {
291             sprintf(sbuf_msg, "Overriding nsteps with value passed on the command line: %s steps, %.3g ps",
292                     gmx_step_str(nsteps_cmdline, sbuf_steps),
293                     fabs(nsteps_cmdline*ir->delta_t));
294         }
295         else
296         {
297             sprintf(sbuf_msg, "Overriding nsteps with value passed on the command line: %s steps",
298                     gmx_step_str(nsteps_cmdline, sbuf_steps));
299         }
300
301         GMX_LOG(mdlog.warning).asParagraph().appendText(sbuf_msg);
302     }
303     else if (nsteps_cmdline < -2)
304     {
305         gmx_fatal(FARGS, "Invalid nsteps value passed on the command line: %ld",
306                   nsteps_cmdline);
307     }
308     /* Do nothing if nsteps_cmdline == -2 */
309 }
310
311 namespace gmx
312 {
313
314 /*! \brief Return whether GPU acceleration of nonbondeds is supported with the given settings.
315  *
316  * If not, and if a warning may be issued, logs a warning about
317  * falling back to CPU code. With thread-MPI, only the first
318  * call to this function should have \c issueWarning true. */
319 static bool gpuAccelerationOfNonbondedIsUseful(const MDLogger   &mdlog,
320                                                const t_inputrec *ir,
321                                                bool              issueWarning)
322 {
323     if (ir->opts.ngener - ir->nwall > 1)
324     {
325         /* The GPU code does not support more than one energy group.
326          * If the user requested GPUs explicitly, a fatal error is given later.
327          */
328         if (issueWarning)
329         {
330             GMX_LOG(mdlog.warning).asParagraph()
331                 .appendText("Multiple energy groups is not implemented for GPUs, falling back to the CPU. "
332                             "For better performance, run on the GPU without energy groups and then do "
333                             "gmx mdrun -rerun option on the trajectory with an energy group .tpr file.");
334         }
335         return false;
336     }
337     return true;
338 }
339
340 //! Initializes the logger for mdrun.
341 static gmx::LoggerOwner buildLogger(FILE *fplog, const t_commrec *cr)
342 {
343     gmx::LoggerBuilder builder;
344     if (fplog != nullptr)
345     {
346         builder.addTargetFile(gmx::MDLogger::LogLevel::Info, fplog);
347     }
348     if (cr == nullptr || SIMMASTER(cr))
349     {
350         builder.addTargetStream(gmx::MDLogger::LogLevel::Warning,
351                                 &gmx::TextOutputFile::standardError());
352     }
353     return builder.build();
354 }
355
356 //! Make a TaskTarget from an mdrun argument string.
357 static TaskTarget findTaskTarget(const char *optionString)
358 {
359     TaskTarget returnValue = TaskTarget::Auto;
360
361     if (strncmp(optionString, "auto", 3) == 0)
362     {
363         returnValue = TaskTarget::Auto;
364     }
365     else if (strncmp(optionString, "cpu", 3) == 0)
366     {
367         returnValue = TaskTarget::Cpu;
368     }
369     else if (strncmp(optionString, "gpu", 3) == 0)
370     {
371         returnValue = TaskTarget::Gpu;
372     }
373     else
374     {
375         GMX_ASSERT(false, "Option string should have been checked for sanity already");
376     }
377
378     return returnValue;
379 }
380
381 int Mdrunner::mdrunner()
382 {
383     matrix                    box;
384     t_nrnb                   *nrnb;
385     t_forcerec               *fr               = nullptr;
386     t_fcdata                 *fcd              = nullptr;
387     real                      ewaldcoeff_q     = 0;
388     real                      ewaldcoeff_lj    = 0;
389     gmx_vsite_t              *vsite            = nullptr;
390     int                       nChargePerturbed = -1, nTypePerturbed = 0;
391     gmx_wallcycle_t           wcycle;
392     gmx_walltime_accounting_t walltime_accounting = nullptr;
393     int                       rc;
394     int64_t                   reset_counters;
395     int                       nthreads_pme = 1;
396     gmx_membed_t *            membed       = nullptr;
397     gmx_hw_info_t            *hwinfo       = nullptr;
398
399     /* CAUTION: threads may be started later on in this function, so
400        cr doesn't reflect the final parallel state right now */
401     std::unique_ptr<gmx::MDModules> mdModules(new gmx::MDModules);
402     t_inputrec                      inputrecInstance;
403     t_inputrec                     *inputrec = &inputrecInstance;
404     gmx_mtop_t                      mtop;
405
406     if (mdrunOptions.continuationOptions.appendFiles)
407     {
408         fplog = nullptr;
409     }
410
411     bool doMembed = opt2bSet("-membed", nfile, fnm);
412     bool doRerun  = mdrunOptions.rerun;
413
414     // Handle task-assignment related user options.
415     EmulateGpuNonbonded emulateGpuNonbonded = (getenv("GMX_EMULATE_GPU") != nullptr ?
416                                                EmulateGpuNonbonded::Yes : EmulateGpuNonbonded::No);
417     std::vector<int>    gpuIdsAvailable;
418     try
419     {
420         gpuIdsAvailable = parseUserGpuIds(hw_opt.gpuIdsAvailable);
421         // TODO We could put the GPU IDs into a std::map to find
422         // duplicates, but for the small numbers of IDs involved, this
423         // code is simple and fast.
424         for (size_t i = 0; i != gpuIdsAvailable.size(); ++i)
425         {
426             for (size_t j = i+1; j != gpuIdsAvailable.size(); ++j)
427             {
428                 if (gpuIdsAvailable[i] == gpuIdsAvailable[j])
429                 {
430                     GMX_THROW(InvalidInputError(formatString("The string of available GPU device IDs '%s' may not contain duplicate device IDs", hw_opt.gpuIdsAvailable.c_str())));
431                 }
432             }
433         }
434     }
435     GMX_CATCH_ALL_AND_EXIT_WITH_FATAL_ERROR;
436
437     std::vector<int> userGpuTaskAssignment;
438     try
439     {
440         userGpuTaskAssignment = parseUserGpuIds(hw_opt.userGpuTaskAssignment);
441     }
442     GMX_CATCH_ALL_AND_EXIT_WITH_FATAL_ERROR;
443     auto       nonbondedTarget = findTaskTarget(nbpu_opt);
444     auto       pmeTarget       = findTaskTarget(pme_opt);
445     auto       pmeFftTarget    = findTaskTarget(pme_fft_opt);
446     PmeRunMode pmeRunMode      = PmeRunMode::None;
447
448     // Here we assume that SIMMASTER(cr) does not change even after the
449     // threads are started.
450     gmx::LoggerOwner logOwner(buildLogger(fplog, cr));
451     gmx::MDLogger    mdlog(logOwner.logger());
452
453     // TODO The thread-MPI master rank makes a working
454     // PhysicalNodeCommunicator here, but it gets rebuilt by all ranks
455     // after the threads have been launched. This works because no use
456     // is made of that communicator until after the execution paths
457     // have rejoined. But it is likely that we can improve the way
458     // this is expressed, e.g. by expressly running detection only the
459     // master rank for thread-MPI, rather than relying on the mutex
460     // and reference count.
461     PhysicalNodeCommunicator physicalNodeComm(MPI_COMM_WORLD, gmx_physicalnode_id_hash());
462     hwinfo = gmx_detect_hardware(mdlog, physicalNodeComm);
463
464     gmx_print_detected_hardware(fplog, cr, ms, mdlog, hwinfo);
465
466     std::vector<int> gpuIdsToUse;
467     auto             compatibleGpus = getCompatibleGpus(hwinfo->gpu_info);
468     if (gpuIdsAvailable.empty())
469     {
470         gpuIdsToUse = compatibleGpus;
471     }
472     else
473     {
474         for (const auto &availableGpuId : gpuIdsAvailable)
475         {
476             bool availableGpuIsCompatible = false;
477             for (const auto &compatibleGpuId : compatibleGpus)
478             {
479                 if (availableGpuId == compatibleGpuId)
480                 {
481                     availableGpuIsCompatible = true;
482                     break;
483                 }
484             }
485             if (!availableGpuIsCompatible)
486             {
487                 gmx_fatal(FARGS, "You limited the set of compatible GPUs to a set that included ID #%d, but that ID is not for a compatible GPU. List only compatible GPUs.", availableGpuId);
488             }
489             gpuIdsToUse.push_back(availableGpuId);
490         }
491     }
492
493     if (fplog != nullptr)
494     {
495         /* Print references after all software/hardware printing */
496         please_cite(fplog, "Abraham2015");
497         please_cite(fplog, "Pall2015");
498         please_cite(fplog, "Pronk2013");
499         please_cite(fplog, "Hess2008b");
500         please_cite(fplog, "Spoel2005a");
501         please_cite(fplog, "Lindahl2001a");
502         please_cite(fplog, "Berendsen95a");
503     }
504
505     std::unique_ptr<t_state> globalState;
506
507     if (SIMMASTER(cr))
508     {
509         /* Only the master rank has the global state */
510         globalState = compat::make_unique<t_state>();
511
512         /* Read (nearly) all data required for the simulation */
513         read_tpx_state(ftp2fn(efTPR, nfile, fnm), inputrec, globalState.get(), &mtop);
514
515         if (inputrec->cutoff_scheme != ecutsVERLET)
516         {
517             if (nstlist_cmdline > 0)
518             {
519                 gmx_fatal(FARGS, "Can not set nstlist with the group cut-off scheme");
520             }
521
522             if (!compatibleGpus.empty())
523             {
524                 GMX_LOG(mdlog.warning).asParagraph().appendText(
525                         "NOTE: GPU(s) found, but the current simulation can not use GPUs\n"
526                         "      To use a GPU, set the mdp option: cutoff-scheme = Verlet");
527             }
528         }
529     }
530
531     /* Check and update the hardware options for internal consistency */
532     check_and_update_hw_opt_1(mdlog, &hw_opt, cr, domdecOptions.numPmeRanks);
533
534     /* Early check for externally set process affinity. */
535     gmx_check_thread_affinity_set(mdlog, cr,
536                                   &hw_opt, hwinfo->nthreads_hw_avail, FALSE);
537
538     if (GMX_THREAD_MPI && SIMMASTER(cr))
539     {
540         if (domdecOptions.numPmeRanks > 0 && hw_opt.nthreads_tmpi <= 0)
541         {
542             gmx_fatal(FARGS, "You need to explicitly specify the number of MPI threads (-ntmpi) when using separate PME ranks");
543         }
544
545         /* Since the master knows the cut-off scheme, update hw_opt for this.
546          * This is done later for normal MPI and also once more with tMPI
547          * for all tMPI ranks.
548          */
549         check_and_update_hw_opt_2(&hw_opt, inputrec->cutoff_scheme);
550
551         bool useGpuForNonbonded = false;
552         bool useGpuForPme       = false;
553         try
554         {
555             // If the user specified the number of ranks, then we must
556             // respect that, but in default mode, we need to allow for
557             // the number of GPUs to choose the number of ranks.
558
559             useGpuForNonbonded = decideWhetherToUseGpusForNonbondedWithThreadMpi
560                     (nonbondedTarget, gpuIdsToUse, userGpuTaskAssignment, emulateGpuNonbonded,
561                     inputrec->cutoff_scheme == ecutsVERLET,
562                     gpuAccelerationOfNonbondedIsUseful(mdlog, inputrec, GMX_THREAD_MPI),
563                     hw_opt.nthreads_tmpi);
564             auto canUseGpuForPme   = pme_gpu_supports_build(nullptr) && pme_gpu_supports_input(inputrec, nullptr);
565             useGpuForPme = decideWhetherToUseGpusForPmeWithThreadMpi
566                     (useGpuForNonbonded, pmeTarget, gpuIdsToUse, userGpuTaskAssignment,
567                     canUseGpuForPme, hw_opt.nthreads_tmpi, domdecOptions.numPmeRanks);
568
569         }
570         GMX_CATCH_ALL_AND_EXIT_WITH_FATAL_ERROR;
571
572         /* Determine how many thread-MPI ranks to start.
573          *
574          * TODO Over-writing the user-supplied value here does
575          * prevent any possible subsequent checks from working
576          * correctly. */
577         hw_opt.nthreads_tmpi = get_nthreads_mpi(hwinfo,
578                                                 &hw_opt,
579                                                 gpuIdsToUse,
580                                                 useGpuForNonbonded,
581                                                 useGpuForPme,
582                                                 inputrec, &mtop,
583                                                 mdlog,
584                                                 doMembed);
585
586         // Now start the threads for thread MPI.
587         cr = spawnThreads(hw_opt.nthreads_tmpi);
588         /* The main thread continues here with a new cr. We don't deallocate
589            the old cr because other threads may still be reading it. */
590         // TODO Both master and spawned threads call dup_tfn and
591         // reinitialize_commrec_for_this_thread. Find a way to express
592         // this better.
593         physicalNodeComm = PhysicalNodeCommunicator(MPI_COMM_WORLD, gmx_physicalnode_id_hash());
594     }
595     // END OF CAUTION: cr and physicalNodeComm are now reliable
596
597     if (PAR(cr))
598     {
599         /* now broadcast everything to the non-master nodes/threads: */
600         init_parallel(cr, inputrec, &mtop);
601     }
602
603     // Now each rank knows the inputrec that SIMMASTER read and used,
604     // and (if applicable) cr->nnodes has been assigned the number of
605     // thread-MPI ranks that have been chosen. The ranks can now all
606     // run the task-deciding functions and will agree on the result
607     // without needing to communicate.
608     //
609     // TODO Should we do the communication in debug mode to support
610     // having an assertion?
611     //
612     // Note that these variables describe only their own node.
613     bool useGpuForNonbonded = false;
614     bool useGpuForPme       = false;
615     try
616     {
617         // It's possible that there are different numbers of GPUs on
618         // different nodes, which is the user's responsibilty to
619         // handle. If unsuitable, we will notice that during task
620         // assignment.
621         bool gpusWereDetected = hwinfo->ngpu_compatible_tot > 0;
622         useGpuForNonbonded = decideWhetherToUseGpusForNonbonded(nonbondedTarget, userGpuTaskAssignment,
623                                                                 emulateGpuNonbonded, inputrec->cutoff_scheme == ecutsVERLET,
624                                                                 gpuAccelerationOfNonbondedIsUseful(mdlog, inputrec, !GMX_THREAD_MPI),
625                                                                 gpusWereDetected);
626         auto canUseGpuForPme   = pme_gpu_supports_build(nullptr) && pme_gpu_supports_input(inputrec, nullptr);
627         useGpuForPme = decideWhetherToUseGpusForPme(useGpuForNonbonded, pmeTarget, userGpuTaskAssignment,
628                                                     canUseGpuForPme, cr->nnodes, domdecOptions.numPmeRanks,
629                                                     gpusWereDetected);
630
631         pmeRunMode   = (useGpuForPme ? PmeRunMode::GPU : PmeRunMode::CPU);
632         if (pmeRunMode == PmeRunMode::GPU)
633         {
634             if (pmeFftTarget == TaskTarget::Cpu)
635             {
636                 pmeRunMode = PmeRunMode::Mixed;
637             }
638         }
639         else if (pmeFftTarget == TaskTarget::Gpu)
640         {
641             gmx_fatal(FARGS, "Assigning FFTs to GPU requires PME to be assigned to GPU as well. With PME on CPU you should not be using -pmefft.");
642         }
643     }
644     GMX_CATCH_ALL_AND_EXIT_WITH_FATAL_ERROR;
645
646     // TODO: Error handling
647     mdModules->assignOptionsToModules(*inputrec->params, nullptr);
648
649     if (fplog != nullptr)
650     {
651         pr_inputrec(fplog, 0, "Input Parameters", inputrec, FALSE);
652         fprintf(fplog, "\n");
653     }
654
655     if (SIMMASTER(cr))
656     {
657         /* now make sure the state is initialized and propagated */
658         set_state_entries(globalState.get(), inputrec);
659     }
660
661     /* NM and TPI parallelize over force/energy calculations, not atoms,
662      * so we need to initialize and broadcast the global state.
663      */
664     if (inputrec->eI == eiNM || inputrec->eI == eiTPI)
665     {
666         if (!MASTER(cr))
667         {
668             globalState = compat::make_unique<t_state>();
669         }
670         broadcastStateWithoutDynamics(cr, globalState.get());
671     }
672
673     /* A parallel command line option consistency check that we can
674        only do after any threads have started. */
675     if (!PAR(cr) && (domdecOptions.numCells[XX] > 1 ||
676                      domdecOptions.numCells[YY] > 1 ||
677                      domdecOptions.numCells[ZZ] > 1 ||
678                      domdecOptions.numPmeRanks > 0))
679     {
680         gmx_fatal(FARGS,
681                   "The -dd or -npme option request a parallel simulation, "
682 #if !GMX_MPI
683                   "but %s was compiled without threads or MPI enabled"
684 #else
685 #if GMX_THREAD_MPI
686                   "but the number of MPI-threads (option -ntmpi) is not set or is 1"
687 #else
688                   "but %s was not started through mpirun/mpiexec or only one rank was requested through mpirun/mpiexec"
689 #endif
690 #endif
691                   , output_env_get_program_display_name(oenv)
692                   );
693     }
694
695     if (doRerun &&
696         (EI_ENERGY_MINIMIZATION(inputrec->eI) || eiNM == inputrec->eI))
697     {
698         gmx_fatal(FARGS, "The .mdp file specified an energy mininization or normal mode algorithm, and these are not compatible with mdrun -rerun");
699     }
700
701     if (can_use_allvsall(inputrec, TRUE, cr, fplog) && DOMAINDECOMP(cr))
702     {
703         gmx_fatal(FARGS, "All-vs-all loops do not work with domain decomposition, use a single MPI rank");
704     }
705
706     if (!(EEL_PME(inputrec->coulombtype) || EVDW_PME(inputrec->vdwtype)))
707     {
708         if (domdecOptions.numPmeRanks > 0)
709         {
710             gmx_fatal_collective(FARGS, cr->mpi_comm_mysim, MASTER(cr),
711                                  "PME-only ranks are requested, but the system does not use PME for electrostatics or LJ");
712         }
713
714         domdecOptions.numPmeRanks = 0;
715     }
716
717     if (useGpuForNonbonded && domdecOptions.numPmeRanks < 0)
718     {
719         /* With NB GPUs we don't automatically use PME-only CPU ranks. PME ranks can
720          * improve performance with many threads per GPU, since our OpenMP
721          * scaling is bad, but it's difficult to automate the setup.
722          */
723         domdecOptions.numPmeRanks = 0;
724     }
725     if (useGpuForPme)
726     {
727         if (domdecOptions.numPmeRanks < 0)
728         {
729             domdecOptions.numPmeRanks = 0;
730             // TODO possibly print a note that one can opt-in for a separate PME GPU rank?
731         }
732         else
733         {
734             GMX_RELEASE_ASSERT(domdecOptions.numPmeRanks <= 1, "PME GPU decomposition is not supported");
735         }
736     }
737
738 #ifdef GMX_FAHCORE
739     if (MASTER(cr))
740     {
741         fcRegisterSteps(inputrec->nsteps, inputrec->init_step);
742     }
743 #endif
744
745     /* NMR restraints must be initialized before load_checkpoint,
746      * since with time averaging the history is added to t_state.
747      * For proper consistency check we therefore need to extend
748      * t_state here.
749      * So the PME-only nodes (if present) will also initialize
750      * the distance restraints.
751      */
752     snew(fcd, 1);
753
754     /* This needs to be called before read_checkpoint to extend the state */
755     init_disres(fplog, &mtop, inputrec, cr, ms, fcd, globalState.get(), replExParams.exchangeInterval > 0);
756
757     init_orires(fplog, &mtop, inputrec, cr, ms, globalState.get(), &(fcd->orires));
758
759     auto                 deform = prepareBoxDeformation(globalState->box, cr, *inputrec);
760
761     ObservablesHistory   observablesHistory = {};
762
763     ContinuationOptions &continuationOptions = mdrunOptions.continuationOptions;
764
765     if (continuationOptions.startedFromCheckpoint)
766     {
767         /* Check if checkpoint file exists before doing continuation.
768          * This way we can use identical input options for the first and subsequent runs...
769          */
770         gmx_bool bReadEkin;
771
772         load_checkpoint(opt2fn_master("-cpi", nfile, fnm, cr), &fplog,
773                         cr, domdecOptions.numCells,
774                         inputrec, globalState.get(),
775                         &bReadEkin, &observablesHistory,
776                         continuationOptions.appendFiles,
777                         continuationOptions.appendFilesOptionSet,
778                         mdrunOptions.reproducible);
779
780         if (bReadEkin)
781         {
782             continuationOptions.haveReadEkin = true;
783         }
784     }
785
786     if (SIMMASTER(cr) && continuationOptions.appendFiles)
787     {
788         gmx_log_open(ftp2fn(efLOG, nfile, fnm), cr,
789                      continuationOptions.appendFiles, &fplog);
790         logOwner = buildLogger(fplog, nullptr);
791         mdlog    = logOwner.logger();
792     }
793
794     if (mdrunOptions.numStepsCommandline > -2)
795     {
796         GMX_LOG(mdlog.info).asParagraph().
797             appendText("The -nsteps functionality is deprecated, and may be removed in a future version. "
798                        "Consider using gmx convert-tpr -nsteps or changing the appropriate .mdp file field.");
799     }
800     /* override nsteps with value set on the commamdline */
801     override_nsteps_cmdline(mdlog, mdrunOptions.numStepsCommandline, inputrec);
802
803     if (SIMMASTER(cr))
804     {
805         copy_mat(globalState->box, box);
806     }
807
808     if (PAR(cr))
809     {
810         gmx_bcast(sizeof(box), box, cr);
811     }
812
813     /* Update rlist and nstlist. */
814     if (inputrec->cutoff_scheme == ecutsVERLET)
815     {
816         prepare_verlet_scheme(fplog, cr, inputrec, nstlist_cmdline, &mtop, box,
817                               useGpuForNonbonded || (emulateGpuNonbonded == EmulateGpuNonbonded::Yes), *hwinfo->cpuInfo);
818     }
819
820     LocalAtomSetManager atomSets;
821
822     if (PAR(cr) && !(EI_TPI(inputrec->eI) ||
823                      inputrec->eI == eiNM))
824     {
825         cr->dd = init_domain_decomposition(fplog, cr, domdecOptions, mdrunOptions,
826                                            &mtop, inputrec,
827                                            box, positionsFromStatePointer(globalState.get()),
828                                            &atomSets);
829         // Note that local state still does not exist yet.
830     }
831     else
832     {
833         /* PME, if used, is done on all nodes with 1D decomposition */
834         cr->npmenodes = 0;
835         cr->duty      = (DUTY_PP | DUTY_PME);
836
837         if (inputrec->ePBC == epbcSCREW)
838         {
839             gmx_fatal(FARGS,
840                       "pbc=%s is only implemented with domain decomposition",
841                       epbc_names[inputrec->ePBC]);
842         }
843     }
844
845     if (PAR(cr))
846     {
847         /* After possible communicator splitting in make_dd_communicators.
848          * we can set up the intra/inter node communication.
849          */
850         gmx_setup_nodecomm(fplog, cr);
851     }
852
853 #if GMX_MPI
854     if (isMultiSim(ms))
855     {
856         GMX_LOG(mdlog.warning).asParagraph().appendTextFormatted(
857                 "This is simulation %d out of %d running as a composite GROMACS\n"
858                 "multi-simulation job. Setup for this simulation:\n",
859                 ms->sim, ms->nsim);
860     }
861     GMX_LOG(mdlog.warning).appendTextFormatted(
862             "Using %d MPI %s\n",
863             cr->nnodes,
864 #if GMX_THREAD_MPI
865             cr->nnodes == 1 ? "thread" : "threads"
866 #else
867             cr->nnodes == 1 ? "process" : "processes"
868 #endif
869             );
870     fflush(stderr);
871 #endif
872
873     /* Check and update hw_opt for the cut-off scheme */
874     check_and_update_hw_opt_2(&hw_opt, inputrec->cutoff_scheme);
875
876     /* Check and update the number of OpenMP threads requested */
877     checkAndUpdateRequestedNumOpenmpThreads(&hw_opt, *hwinfo, cr, ms, physicalNodeComm.size_,
878                                             pmeRunMode, mtop);
879
880     gmx_omp_nthreads_init(mdlog, cr,
881                           hwinfo->nthreads_hw_avail,
882                           physicalNodeComm.size_,
883                           hw_opt.nthreads_omp,
884                           hw_opt.nthreads_omp_pme,
885                           !thisRankHasDuty(cr, DUTY_PP),
886                           inputrec->cutoff_scheme == ecutsVERLET);
887
888     // Enable FP exception but not in Release mode and not for compilers
889     // with known buggy FP exception support (clang with any optimization)
890     // or suspected buggy FP exception support (gcc 7.* with optimization).
891 #if !defined NDEBUG && \
892     !((defined __clang__ || (defined(__GNUC__) && !defined(__ICC) && __GNUC__ == 7)) \
893     && defined __OPTIMIZE__)
894     const bool bEnableFPE = !EI_TPI(inputrec->eI) &&
895         inputrec->cutoff_scheme == ecutsVERLET;
896 #else
897     const bool bEnableFPE = false;
898 #endif
899     //FIXME - reconcile with gmx_feenableexcept() call from CommandLineModuleManager::run()
900     if (bEnableFPE)
901     {
902         gmx_feenableexcept();
903     }
904
905     // Build a data structure that expresses which kinds of non-bonded
906     // task are handled by this rank.
907     //
908     // TODO Later, this might become a loop over all registered modules
909     // relevant to the mdp inputs, to find those that have such tasks.
910     //
911     // TODO This could move before init_domain_decomposition() as part
912     // of refactoring that separates the responsibility for duty
913     // assignment from setup for communication between tasks, and
914     // setup for tasks handled with a domain (ie including short-ranged
915     // tasks, bonded tasks, etc.).
916     //
917     // Note that in general useGpuForNonbonded, etc. can have a value
918     // that is inconsistent with the presence of actual GPUs on any
919     // rank, and that is not known to be a problem until the
920     // duty of the ranks on a node become node.
921     //
922     // TODO Later we might need the concept of computeTasksOnThisRank,
923     // from which we construct gpuTasksOnThisRank.
924     //
925     // Currently the DD code assigns duty to ranks that can
926     // include PP work that currently can be executed on a single
927     // GPU, if present and compatible.  This has to be coordinated
928     // across PP ranks on a node, with possible multiple devices
929     // or sharing devices on a node, either from the user
930     // selection, or automatically.
931     auto                 haveGpus = !gpuIdsToUse.empty();
932     std::vector<GpuTask> gpuTasksOnThisRank;
933     if (thisRankHasDuty(cr, DUTY_PP))
934     {
935         if (useGpuForNonbonded)
936         {
937             if (haveGpus)
938             {
939                 gpuTasksOnThisRank.push_back(GpuTask::Nonbonded);
940             }
941             else if (nonbondedTarget == TaskTarget::Gpu)
942             {
943                 gmx_fatal(FARGS, "Cannot run short-ranged nonbonded interactions on a GPU because there is none detected.");
944             }
945         }
946     }
947     // TODO cr->duty & DUTY_PME should imply that a PME algorithm is active, but currently does not.
948     if (EEL_PME(inputrec->coulombtype) && (thisRankHasDuty(cr, DUTY_PME)))
949     {
950         if (useGpuForPme)
951         {
952             if (haveGpus)
953             {
954                 gpuTasksOnThisRank.push_back(GpuTask::Pme);
955             }
956             else if (pmeTarget == TaskTarget::Gpu)
957             {
958                 gmx_fatal(FARGS, "Cannot run PME on a GPU because there is none detected.");
959             }
960         }
961     }
962
963     GpuTaskAssignment gpuTaskAssignment;
964     try
965     {
966         // Produce the task assignment for this rank.
967         gpuTaskAssignment = runTaskAssignment(gpuIdsToUse, userGpuTaskAssignment, *hwinfo,
968                                               mdlog, cr, ms, physicalNodeComm, gpuTasksOnThisRank);
969     }
970     GMX_CATCH_ALL_AND_EXIT_WITH_FATAL_ERROR;
971
972     /* Prevent other ranks from continuing after an issue was found
973      * and reported as a fatal error.
974      *
975      * TODO This function implements a barrier so that MPI runtimes
976      * can organize an orderly shutdown if one of the ranks has had to
977      * issue a fatal error in various code already run. When we have
978      * MPI-aware error handling and reporting, this should be
979      * improved. */
980 #if GMX_MPI
981     if (PAR(cr))
982     {
983         MPI_Barrier(cr->mpi_comm_mysim);
984     }
985     if (isMultiSim(ms))
986     {
987         if (SIMMASTER(cr))
988         {
989             MPI_Barrier(ms->mpi_comm_masters);
990         }
991         /* We need another barrier to prevent non-master ranks from contiuing
992          * when an error occured in a different simulation.
993          */
994         MPI_Barrier(cr->mpi_comm_mysim);
995     }
996 #endif
997
998     /* Now that we know the setup is consistent, check for efficiency */
999     check_resource_division_efficiency(hwinfo, !gpuTaskAssignment.empty(), mdrunOptions.ntompOptionIsSet,
1000                                        cr, mdlog);
1001
1002     gmx_device_info_t *nonbondedDeviceInfo = nullptr;
1003
1004     if (thisRankHasDuty(cr, DUTY_PP))
1005     {
1006         // This works because only one task of each type is currently permitted.
1007         auto nbGpuTaskMapping = std::find_if(gpuTaskAssignment.begin(), gpuTaskAssignment.end(),
1008                                              hasTaskType<GpuTask::Nonbonded>);
1009         if (nbGpuTaskMapping != gpuTaskAssignment.end())
1010         {
1011             int nonbondedDeviceId = nbGpuTaskMapping->deviceId_;
1012             nonbondedDeviceInfo = getDeviceInfo(hwinfo->gpu_info, nonbondedDeviceId);
1013             init_gpu(mdlog, nonbondedDeviceInfo);
1014
1015             if (DOMAINDECOMP(cr))
1016             {
1017                 /* When we share GPUs over ranks, we need to know this for the DLB */
1018                 dd_setup_dlb_resource_sharing(cr, nonbondedDeviceId);
1019             }
1020
1021         }
1022     }
1023
1024     std::unique_ptr<ClfftInitializer> initializedClfftLibrary;
1025
1026     gmx_device_info_t                *pmeDeviceInfo = nullptr;
1027     // Later, this program could contain kernels that might be later
1028     // re-used as auto-tuning progresses, or subsequent simulations
1029     // are invoked.
1030     PmeGpuProgramStorage pmeGpuProgram;
1031     // This works because only one task of each type is currently permitted.
1032     auto                 pmeGpuTaskMapping     = std::find_if(gpuTaskAssignment.begin(), gpuTaskAssignment.end(), hasTaskType<GpuTask::Pme>);
1033     const bool           thisRankHasPmeGpuTask = (pmeGpuTaskMapping != gpuTaskAssignment.end());
1034     if (thisRankHasPmeGpuTask)
1035     {
1036         pmeDeviceInfo = getDeviceInfo(hwinfo->gpu_info, pmeGpuTaskMapping->deviceId_);
1037         init_gpu(mdlog, pmeDeviceInfo);
1038         pmeGpuProgram = buildPmeGpuProgram(pmeDeviceInfo);
1039         // TODO It would be nice to move this logic into the factory
1040         // function. See Redmine #2535.
1041         bool isMasterThread = !GMX_THREAD_MPI || MASTER(cr);
1042         if (pmeRunMode == PmeRunMode::GPU && !initializedClfftLibrary && isMasterThread)
1043         {
1044             initializedClfftLibrary = initializeClfftLibrary();
1045         }
1046     }
1047
1048     /* getting number of PP/PME threads
1049        PME: env variable should be read only on one node to make sure it is
1050        identical everywhere;
1051      */
1052     nthreads_pme = gmx_omp_nthreads_get(emntPME);
1053
1054     int numThreadsOnThisRank;
1055     /* threads on this MPI process or TMPI thread */
1056     if (thisRankHasDuty(cr, DUTY_PP))
1057     {
1058         numThreadsOnThisRank = gmx_omp_nthreads_get(emntNonbonded);
1059     }
1060     else
1061     {
1062         numThreadsOnThisRank = nthreads_pme;
1063     }
1064
1065     checkHardwareOversubscription(numThreadsOnThisRank, cr->nodeid,
1066                                   *hwinfo->hardwareTopology,
1067                                   physicalNodeComm, mdlog);
1068
1069     if (hw_opt.thread_affinity != threadaffOFF)
1070     {
1071         /* Before setting affinity, check whether the affinity has changed
1072          * - which indicates that probably the OpenMP library has changed it
1073          * since we first checked).
1074          */
1075         gmx_check_thread_affinity_set(mdlog, cr,
1076                                       &hw_opt, hwinfo->nthreads_hw_avail, TRUE);
1077
1078         int numThreadsOnThisNode, intraNodeThreadOffset;
1079         analyzeThreadsOnThisNode(physicalNodeComm, numThreadsOnThisRank, &numThreadsOnThisNode,
1080                                  &intraNodeThreadOffset);
1081
1082         /* Set the CPU affinity */
1083         gmx_set_thread_affinity(mdlog, cr, &hw_opt, *hwinfo->hardwareTopology,
1084                                 numThreadsOnThisRank, numThreadsOnThisNode,
1085                                 intraNodeThreadOffset, nullptr);
1086     }
1087
1088     if (mdrunOptions.timingOptions.resetStep > -1)
1089     {
1090         GMX_LOG(mdlog.info).asParagraph().
1091             appendText("The -resetstep functionality is deprecated, and may be removed in a future version.");
1092     }
1093     wcycle = wallcycle_init(fplog, mdrunOptions.timingOptions.resetStep, cr);
1094
1095     if (PAR(cr))
1096     {
1097         /* Master synchronizes its value of reset_counters with all nodes
1098          * including PME only nodes */
1099         reset_counters = wcycle_get_reset_counters(wcycle);
1100         gmx_bcast_sim(sizeof(reset_counters), &reset_counters, cr);
1101         wcycle_set_reset_counters(wcycle, reset_counters);
1102     }
1103
1104     // Membrane embedding must be initialized before we call init_forcerec()
1105     if (doMembed)
1106     {
1107         if (MASTER(cr))
1108         {
1109             fprintf(stderr, "Initializing membed");
1110         }
1111         /* Note that membed cannot work in parallel because mtop is
1112          * changed here. Fix this if we ever want to make it run with
1113          * multiple ranks. */
1114         membed = init_membed(fplog, nfile, fnm, &mtop, inputrec, globalState.get(), cr, &mdrunOptions.checkpointOptions.period);
1115     }
1116
1117     std::unique_ptr<MDAtoms> mdAtoms;
1118
1119     snew(nrnb, 1);
1120     if (thisRankHasDuty(cr, DUTY_PP))
1121     {
1122         /* Initiate forcerecord */
1123         fr                 = mk_forcerec();
1124         fr->forceProviders = mdModules->initForceProviders();
1125         init_forcerec(fplog, mdlog, fr, fcd,
1126                       inputrec, &mtop, cr, box,
1127                       opt2fn("-table", nfile, fnm),
1128                       opt2fn("-tablep", nfile, fnm),
1129                       opt2fns("-tableb", nfile, fnm),
1130                       *hwinfo, nonbondedDeviceInfo,
1131                       FALSE,
1132                       pforce);
1133
1134         /* Initialize QM-MM */
1135         if (fr->bQMMM)
1136         {
1137             GMX_LOG(mdlog.info).asParagraph().
1138                 appendText("Large parts of the QM/MM support is deprecated, and may be removed in a future "
1139                            "version. Please get in touch with the developers if you find the support useful, "
1140                            "as help is needed if the functionality is to continue to be available.");
1141             init_QMMMrec(cr, &mtop, inputrec, fr);
1142         }
1143
1144         /* Initialize the mdAtoms structure.
1145          * mdAtoms is not filled with atom data,
1146          * as this can not be done now with domain decomposition.
1147          */
1148         mdAtoms = makeMDAtoms(fplog, mtop, *inputrec, thisRankHasPmeGpuTask);
1149         if (globalState && thisRankHasPmeGpuTask)
1150         {
1151             // The pinning of coordinates in the global state object works, because we only use
1152             // PME on GPU without DD or on a separate PME rank, and because the local state pointer
1153             // points to the global state object without DD.
1154             // FIXME: MD and EM separately set up the local state - this should happen in the same function,
1155             // which should also perform the pinning.
1156             changePinningPolicy(&globalState->x, pme_get_pinning_policy());
1157         }
1158
1159         /* Initialize the virtual site communication */
1160         vsite = initVsite(mtop, cr);
1161
1162         calc_shifts(box, fr->shift_vec);
1163
1164         /* With periodic molecules the charge groups should be whole at start up
1165          * and the virtual sites should not be far from their proper positions.
1166          */
1167         if (!inputrec->bContinuation && MASTER(cr) &&
1168             !(inputrec->ePBC != epbcNONE && inputrec->bPeriodicMols))
1169         {
1170             /* Make molecules whole at start of run */
1171             if (fr->ePBC != epbcNONE)
1172             {
1173                 rvec *xGlobal = as_rvec_array(globalState->x.data());
1174                 do_pbc_first_mtop(fplog, inputrec->ePBC, box, &mtop, xGlobal);
1175             }
1176             if (vsite)
1177             {
1178                 /* Correct initial vsite positions are required
1179                  * for the initial distribution in the domain decomposition
1180                  * and for the initial shell prediction.
1181                  */
1182                 constructVsitesGlobal(mtop, globalState->x);
1183             }
1184         }
1185
1186         if (EEL_PME(fr->ic->eeltype) || EVDW_PME(fr->ic->vdwtype))
1187         {
1188             ewaldcoeff_q  = fr->ic->ewaldcoeff_q;
1189             ewaldcoeff_lj = fr->ic->ewaldcoeff_lj;
1190         }
1191     }
1192     else
1193     {
1194         /* This is a PME only node */
1195
1196         GMX_ASSERT(globalState == nullptr, "We don't need the state on a PME only rank and expect it to be unitialized");
1197
1198         ewaldcoeff_q  = calc_ewaldcoeff_q(inputrec->rcoulomb, inputrec->ewald_rtol);
1199         ewaldcoeff_lj = calc_ewaldcoeff_lj(inputrec->rvdw, inputrec->ewald_rtol_lj);
1200     }
1201
1202     gmx_pme_t *sepPmeData = nullptr;
1203     // This reference hides the fact that PME data is owned by runner on PME-only ranks and by forcerec on other ranks
1204     GMX_ASSERT(thisRankHasDuty(cr, DUTY_PP) == (fr != nullptr), "Double-checking that only PME-only ranks have no forcerec");
1205     gmx_pme_t * &pmedata = fr ? fr->pmedata : sepPmeData;
1206
1207     /* Initiate PME if necessary,
1208      * either on all nodes or on dedicated PME nodes only. */
1209     if (EEL_PME(inputrec->coulombtype) || EVDW_PME(inputrec->vdwtype))
1210     {
1211         if (mdAtoms && mdAtoms->mdatoms())
1212         {
1213             nChargePerturbed = mdAtoms->mdatoms()->nChargePerturbed;
1214             if (EVDW_PME(inputrec->vdwtype))
1215             {
1216                 nTypePerturbed   = mdAtoms->mdatoms()->nTypePerturbed;
1217             }
1218         }
1219         if (cr->npmenodes > 0)
1220         {
1221             /* The PME only nodes need to know nChargePerturbed(FEP on Q) and nTypePerturbed(FEP on LJ)*/
1222             gmx_bcast_sim(sizeof(nChargePerturbed), &nChargePerturbed, cr);
1223             gmx_bcast_sim(sizeof(nTypePerturbed), &nTypePerturbed, cr);
1224         }
1225
1226         if (thisRankHasDuty(cr, DUTY_PME))
1227         {
1228             try
1229             {
1230                 pmedata = gmx_pme_init(cr,
1231                                        getNumPmeDomains(cr->dd),
1232                                        inputrec,
1233                                        mtop.natoms, nChargePerturbed, nTypePerturbed,
1234                                        mdrunOptions.reproducible,
1235                                        ewaldcoeff_q, ewaldcoeff_lj,
1236                                        nthreads_pme,
1237                                        pmeRunMode, nullptr,
1238                                        pmeDeviceInfo, pmeGpuProgram.get(), mdlog);
1239             }
1240             GMX_CATCH_ALL_AND_EXIT_WITH_FATAL_ERROR;
1241         }
1242     }
1243
1244
1245     if (EI_DYNAMICS(inputrec->eI))
1246     {
1247         /* Turn on signal handling on all nodes */
1248         /*
1249          * (A user signal from the PME nodes (if any)
1250          * is communicated to the PP nodes.
1251          */
1252         signal_handler_install();
1253     }
1254
1255     if (thisRankHasDuty(cr, DUTY_PP))
1256     {
1257         /* Assumes uniform use of the number of OpenMP threads */
1258         walltime_accounting = walltime_accounting_init(gmx_omp_nthreads_get(emntDefault));
1259
1260         if (inputrec->bPull)
1261         {
1262             /* Initialize pull code */
1263             inputrec->pull_work =
1264                 init_pull(fplog, inputrec->pull, inputrec,
1265                           &mtop, cr, &atomSets, inputrec->fepvals->init_lambda);
1266             if (EI_DYNAMICS(inputrec->eI) && MASTER(cr))
1267             {
1268                 init_pull_output_files(inputrec->pull_work,
1269                                        nfile, fnm, oenv,
1270                                        continuationOptions);
1271             }
1272         }
1273
1274         std::unique_ptr<EnforcedRotation> enforcedRotation;
1275         if (inputrec->bRot)
1276         {
1277             /* Initialize enforced rotation code */
1278             enforcedRotation = init_rot(fplog, inputrec, nfile, fnm, cr, globalState.get(), &mtop, oenv, mdrunOptions);
1279         }
1280
1281         if (inputrec->eSwapCoords != eswapNO)
1282         {
1283             /* Initialize ion swapping code */
1284             init_swapcoords(fplog, inputrec, opt2fn_master("-swap", nfile, fnm, cr),
1285                             &mtop, globalState.get(), &observablesHistory,
1286                             cr, &atomSets, oenv, mdrunOptions);
1287         }
1288
1289         /* Let makeConstraints know whether we have essential dynamics constraints.
1290          * TODO: inputrec should tell us whether we use an algorithm, not a file option or the checkpoint
1291          */
1292         bool doEssentialDynamics = (opt2fn_null("-ei", nfile, fnm) != nullptr || observablesHistory.edsamHistory);
1293         auto constr              = makeConstraints(mtop, *inputrec, doEssentialDynamics,
1294                                                    fplog, *mdAtoms->mdatoms(),
1295                                                    cr, *ms, nrnb, wcycle, fr->bMolPBC);
1296
1297         if (DOMAINDECOMP(cr))
1298         {
1299             GMX_RELEASE_ASSERT(fr, "fr was NULL while cr->duty was DUTY_PP");
1300             /* This call is not included in init_domain_decomposition mainly
1301              * because fr->cginfo_mb is set later.
1302              */
1303             dd_init_bondeds(fplog, cr->dd, &mtop, vsite, inputrec,
1304                             domdecOptions.checkBondedInteractions,
1305                             fr->cginfo_mb);
1306         }
1307
1308         /* Now do whatever the user wants us to do (how flexible...) */
1309         Integrator integrator {
1310             fplog, cr, ms, mdlog, nfile, fnm,
1311             oenv,
1312             mdrunOptions,
1313             vsite, constr.get(),
1314             enforcedRotation ? enforcedRotation->getLegacyEnfrot() : nullptr,
1315             deform.get(),
1316             mdModules->outputProvider(),
1317             inputrec, &mtop,
1318             fcd,
1319             globalState.get(),
1320             &observablesHistory,
1321             mdAtoms.get(), nrnb, wcycle, fr,
1322             replExParams,
1323             membed,
1324             walltime_accounting
1325         };
1326         integrator.run(inputrec->eI);
1327
1328         if (inputrec->bPull)
1329         {
1330             finish_pull(inputrec->pull_work);
1331         }
1332
1333     }
1334     else
1335     {
1336         GMX_RELEASE_ASSERT(pmedata, "pmedata was NULL while cr->duty was not DUTY_PP");
1337         /* do PME only */
1338         walltime_accounting = walltime_accounting_init(gmx_omp_nthreads_get(emntPME));
1339         gmx_pmeonly(pmedata, cr, nrnb, wcycle, walltime_accounting, inputrec, pmeRunMode);
1340     }
1341
1342     wallcycle_stop(wcycle, ewcRUN);
1343
1344     /* Finish up, write some stuff
1345      * if rerunMD, don't write last frame again
1346      */
1347     finish_run(fplog, mdlog, cr,
1348                inputrec, nrnb, wcycle, walltime_accounting,
1349                fr ? fr->nbv : nullptr,
1350                pmedata,
1351                EI_DYNAMICS(inputrec->eI) && !isMultiSim(ms));
1352
1353     // Free PME data
1354     if (pmedata)
1355     {
1356         gmx_pme_destroy(pmedata);
1357         pmedata = nullptr;
1358     }
1359
1360     // FIXME: this is only here to manually unpin mdAtoms->chargeA_ and state->x,
1361     // before we destroy the GPU context(s) in free_gpu_resources().
1362     // Pinned buffers are associated with contexts in CUDA.
1363     // As soon as we destroy GPU contexts after mdrunner() exits, these lines should go.
1364     mdAtoms.reset(nullptr);
1365     globalState.reset(nullptr);
1366     mdModules.reset(nullptr);   // destruct force providers here as they might also use the GPU
1367
1368     /* Free GPU memory and set a physical node tMPI barrier (which should eventually go away) */
1369     free_gpu_resources(fr, physicalNodeComm);
1370     free_gpu(nonbondedDeviceInfo);
1371     free_gpu(pmeDeviceInfo);
1372     done_forcerec(fr, mtop.molblock.size(), mtop.groups.grps[egcENER].nr);
1373     sfree(fcd);
1374
1375     if (doMembed)
1376     {
1377         free_membed(membed);
1378     }
1379
1380     gmx_hardware_info_free();
1381
1382     /* Does what it says */
1383     print_date_and_time(fplog, cr->nodeid, "Finished mdrun", gmx_gettime());
1384     walltime_accounting_destroy(walltime_accounting);
1385     sfree(nrnb);
1386
1387     /* Close logfile already here if we were appending to it */
1388     if (MASTER(cr) && continuationOptions.appendFiles)
1389     {
1390         gmx_log_close(fplog);
1391         fplog = nullptr;
1392     }
1393
1394     /* Reset FPEs (important for unit tests) by disabling them. Assumes no
1395      * exceptions were enabled before function was called. */
1396     if (bEnableFPE)
1397     {
1398         gmx_fedisableexcept();
1399     }
1400
1401     rc = static_cast<int>(gmx_get_stop_condition());
1402
1403 #if GMX_THREAD_MPI
1404     /* we need to join all threads. The sub-threads join when they
1405        exit this function, but the master thread needs to be told to
1406        wait for that. */
1407     if (PAR(cr) && MASTER(cr))
1408     {
1409         done_commrec(cr);
1410         tMPI_Finalize();
1411     }
1412 #endif
1413
1414     return rc;
1415 }
1416
1417 } // namespace gmx