Update instructions in containers.rst
[gromacs.git] / src / gromacs / domdec / mdsetup.cpp
blob90f28d18a77bc64e8ea5fcc0c6f6c39caf8e47a0
1 /*
2 * This file is part of the GROMACS molecular simulation package.
4 * Copyright (c) 2016,2017,2018,2019,2020, 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.
35 #include "gmxpre.h"
37 #include "mdsetup.h"
39 #include "gromacs/domdec/domdec.h"
40 #include "gromacs/domdec/domdec_struct.h"
41 #include "gromacs/ewald/pme.h"
42 #include "gromacs/listed_forces/listed_forces.h"
43 #include "gromacs/mdlib/constr.h"
44 #include "gromacs/mdlib/mdatoms.h"
45 #include "gromacs/mdlib/vsite.h"
46 #include "gromacs/mdtypes/commrec.h"
47 #include "gromacs/mdtypes/forcebuffers.h"
48 #include "gromacs/mdtypes/forcerec.h"
49 #include "gromacs/mdtypes/inputrec.h"
50 #include "gromacs/mdtypes/interaction_const.h"
51 #include "gromacs/mdtypes/mdatom.h"
52 #include "gromacs/pbcutil/pbc.h"
53 #include "gromacs/topology/mtop_util.h"
54 #include "gromacs/topology/topology.h"
55 #include "gromacs/utility/gmxassert.h"
56 #include "gromacs/utility/smalloc.h"
58 namespace gmx
61 /* TODO: Add a routine that collects the initial setup of the algorithms.
63 * The final solution should be an MD algorithm base class with methods
64 * for initialization and atom-data setup.
66 void mdAlgorithmsSetupAtomData(const t_commrec* cr,
67 const t_inputrec* ir,
68 const gmx_mtop_t& top_global,
69 gmx_localtop_t* top,
70 t_forcerec* fr,
71 ForceBuffers* force,
72 MDAtoms* mdAtoms,
73 Constraints* constr,
74 VirtualSitesHandler* vsite,
75 gmx_shellfc_t* shellfc)
77 bool usingDomDec = DOMAINDECOMP(cr);
79 int numAtomIndex;
80 int numHomeAtoms;
81 int numTotalAtoms;
83 if (usingDomDec)
85 numAtomIndex = dd_natoms_mdatoms(cr->dd);
86 numHomeAtoms = dd_numHomeAtoms(*cr->dd);
87 numTotalAtoms = dd_natoms_mdatoms(cr->dd);
89 else
91 numAtomIndex = -1;
92 numHomeAtoms = top_global.natoms;
93 numTotalAtoms = top_global.natoms;
96 if (force != nullptr)
98 force->resize(numTotalAtoms);
101 atoms2md(&top_global, ir, numAtomIndex,
102 usingDomDec ? cr->dd->globalAtomIndices : std::vector<int>(), numHomeAtoms, mdAtoms);
104 auto mdatoms = mdAtoms->mdatoms();
105 if (usingDomDec)
107 dd_sort_local_top(cr->dd, mdatoms, top);
109 else
111 gmx_mtop_generate_local_top(top_global, top, ir->efep != efepNO);
114 if (vsite)
116 vsite->setVirtualSites(top->idef.il, *mdatoms);
119 /* Note that with DD only flexible constraints, not shells, are supported
120 * and these don't require setup in make_local_shells().
122 * TODO: This should only happen in ShellFCElement (it is called directly by the modular
123 * simulator ShellFCElement already, but still used here by legacy simulators)
125 if (!usingDomDec && shellfc)
127 make_local_shells(cr, mdatoms, shellfc);
130 for (auto& listedForces : fr->listedForces)
132 listedForces.setup(top->idef, fr->natoms_force, fr->gpuBonded != nullptr);
135 if (EEL_PME(fr->ic->eeltype) && (cr->duty & DUTY_PME))
137 /* This handles the PP+PME rank case where fr->pmedata is valid.
138 * For PME-only ranks, gmx_pmeonly() has its own call to gmx_pme_reinit_atoms().
140 const int numPmeAtoms = numHomeAtoms - fr->n_tpi;
141 gmx_pme_reinit_atoms(fr->pmedata, numPmeAtoms, mdatoms->chargeA, mdatoms->chargeB);
144 if (constr)
146 constr->setConstraints(top, mdatoms->nr, mdatoms->homenr, mdatoms->massT, mdatoms->invmass,
147 mdatoms->nMassPerturbed != 0, mdatoms->lambda, mdatoms->cFREEZE);
151 } // namespace gmx