src/gromacs/gmxpreprocess/topdirs.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) 2013,2014,2015,2017,2018,2019, 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 #include "gmxpre.h"
  38
  39 #include "topdirs.h"
  40
  41 #include <cstdarg>
  42 #include <cstdio>
  43
  44 #include <algorithm>
  45
  46 #include "gromacs/topology/idef.h"
  47 #include "gromacs/utility/cstringutil.h"
  48 #include "gromacs/utility/enumerationhelpers.h"
  49 #include "gromacs/utility/fatalerror.h"
  50 #include "gromacs/utility/smalloc.h"
  51
  52 /* Must correspond to the Directive enum in grompp_impl.h */
  53 static gmx::EnumerationArray<Directive, const char *> directive_names
  54     = { {
  55             "defaults",
  56             "atomtypes",
  57             "bondtypes",
  58             "constrainttypes",
  59             "pairtypes",
  60             "angletypes",
  61             "dihedraltypes",
  62             "nonbond_params",
  63             "implicit_genborn_params",
  64             "implicit_surface_params",
  65             "cmaptypes",
  66             /* All the directives above can not appear after moleculetype */
  67             "moleculetype",
  68             "atoms",
  69             "virtual_sites2",
  70             "virtual_sites3",
  71             "virtual_sites4",
  72             "virtual_sitesn",
  73             "bonds",
  74             "exclusions",
  75             "pairs",
  76             "pairs_nb",
  77             "angles",
  78             "dihedrals",
  79             "constraints",
  80             "settles",
  81             "polarization",
  82             "water_polarization",
  83             "thole_polarization",
  84             "system",
  85             "molecules",
  86             "position_restraints",
  87             "angle_restraints",
  88             "angle_restraints_z",
  89             "distance_restraints",
  90             "orientation_restraints",
  91             "dihedral_restraints",
  92             "cmap",
  93             "intermolecular_interactions",
  94             "maxdirs",
  95             "invalid",
  96             "none"
  97         }};
  98
  99 int ifunc_index(Directive d, int type)
 100 {
 101     switch (d)
 102     {
 103         case Directive::d_bondtypes:
 104         case Directive::d_bonds:
 105             switch (type)
 106             {
 107                 case 1:
 108                     return F_BONDS;
 109                 case 2:
 110                     return F_G96BONDS;
 111                 case 3:
 112                     return F_MORSE;
 113                 case 4:
 114                     return F_CUBICBONDS;
 115                 case 5:
 116                     return F_CONNBONDS;
 117                 case 6:
 118                     return F_HARMONIC;
 119                 case 7:
 120                     return F_FENEBONDS;
 121                 case 8:
 122                     return F_TABBONDS;
 123                 case 9:
 124                     return F_TABBONDSNC;
 125                 case 10:
 126                     return F_RESTRBONDS;
 127                 default:
 128                     gmx_fatal(FARGS, "Invalid bond type %d", type);
 129             }
 130         case Directive::d_angles:
 131         case Directive::d_angletypes:
 132             switch (type)
 133             {
 134                 case 1:
 135                     return F_ANGLES;
 136                 case 2:
 137                     return F_G96ANGLES;
 138                 case 3:
 139                     return F_CROSS_BOND_BONDS;
 140                 case 4:
 141                     return F_CROSS_BOND_ANGLES;
 142                 case 5:
 143                     return F_UREY_BRADLEY;
 144                 case 6:
 145                     return F_QUARTIC_ANGLES;
 146                 case 8:
 147                     return F_TABANGLES;
 148                 case 9:
 149                     return F_LINEAR_ANGLES;
 150                 case 10:
 151                     return F_RESTRANGLES;
 152                 default:
 153                     gmx_fatal(FARGS, "Invalid angle type %d", type);
 154             }
 155         case Directive::d_pairs:
 156         case Directive::d_pairtypes:
 157             if (type == 1 || (d == Directive::d_pairtypes && type == 2))
 158             {
 159                 return F_LJ14;
 160             }
 161             else if (type == 2)
 162             {
 163                 return F_LJC14_Q;
 164             }
 165             else
 166             {
 167                 gmx_fatal(FARGS, "Invalid pairs type %d", type);
 168             }
 169         case Directive::d_pairs_nb:
 170             return F_LJC_PAIRS_NB;
 171         case Directive::d_dihedrals:
 172         case Directive::d_dihedraltypes:
 173             switch (type)
 174             {
 175                 case 1:
 176                     return F_PDIHS;
 177                 case 2:
 178                     return F_IDIHS;
 179                 case 3:
 180                     return F_RBDIHS;
 181                 case 4:
 182                     return F_PIDIHS;
 183                 case 5:
 184                     return F_FOURDIHS;
 185                 case 8:
 186                     return F_TABDIHS;
 187                 case 9:
 188                     return F_PDIHS; /* proper dihedrals where we allow multiple terms over single bond */
 189                 case 10:
 190                     return F_RESTRDIHS;
 191                 case 11:
 192                     return F_CBTDIHS;
 193                 default:
 194                     gmx_fatal(FARGS, "Invalid dihedral type %d", type);
 195             }
 196         case Directive::d_cmaptypes:
 197         case Directive::d_cmap:
 198             return F_CMAP;
 199
 200         case Directive::d_nonbond_params:
 201             if (type == 1)
 202             {
 203                 return F_LJ;
 204             }
 205             else
 206             {
 207                 return F_BHAM;
 208             }
 209         case Directive::d_vsites2:
 210             return F_VSITE2;
 211         case Directive::d_vsites3:
 212             switch (type)
 213             {
 214                 case 1:
 215                     return F_VSITE3;
 216                 case 2:
 217                     return F_VSITE3FD;
 218                 case 3:
 219                     return F_VSITE3FAD;
 220                 case 4:
 221                     return F_VSITE3OUT;
 222                 default:
 223                     gmx_fatal(FARGS, "Invalid vsites3 type %d", type);
 224             }
 225         case Directive::d_vsites4:
 226             switch (type)
 227             {
 228                 case 1:
 229                     return F_VSITE4FD;
 230                 case 2:
 231                     return F_VSITE4FDN;
 232                 default:
 233                     gmx_fatal(FARGS, "Invalid vsites4 type %d", type);
 234             }
 235         case Directive::d_vsitesn:
 236             return F_VSITEN;
 237         case Directive::d_constraints:
 238         case Directive::d_constrainttypes:
 239             switch (type)
 240             {
 241                 case 1:
 242                     return F_CONSTR;
 243                 case 2:
 244                     return F_CONSTRNC;
 245                 default:
 246                     gmx_fatal(FARGS, "Invalid constraints type %d", type);
 247             }
 248         case Directive::d_settles:
 249             return F_SETTLE;
 250         case Directive::d_position_restraints:
 251             switch (type)
 252             {
 253                 case 1:
 254                     return F_POSRES;
 255                 case 2:
 256                     return F_FBPOSRES;
 257                 default:
 258                     gmx_fatal(FARGS, "Invalid position restraint type %d", type);
 259             }
 260         case Directive::d_polarization:
 261             switch (type)
 262             {
 263                 case 1:
 264                     return F_POLARIZATION;
 265                 case 2:
 266                     return F_ANHARM_POL;
 267                 default:
 268                     gmx_fatal(FARGS, "Invalid polarization type %d", type);
 269             }
 270         case Directive::d_thole_polarization:
 271             return F_THOLE_POL;
 272         case Directive::d_water_polarization:
 273             return F_WATER_POL;
 274         case Directive::d_angle_restraints:
 275             return F_ANGRES;
 276         case Directive::d_angle_restraints_z:
 277             return F_ANGRESZ;
 278         case Directive::d_distance_restraints:
 279             return F_DISRES;
 280         case Directive::d_orientation_restraints:
 281             return F_ORIRES;
 282         case Directive::d_dihedral_restraints:
 283             return F_DIHRES;
 284         default:
 285             gmx_fatal(FARGS, "invalid directive %s in ifunc_index (%s:%d)",
 286                       dir2str(d), __FILE__, __LINE__);
 287     }
 288 }
 289
 290 const char *dir2str (Directive d)
 291 {
 292     int index = static_cast<int>(d);
 293     return directive_names[index];
 294 }
 295
 296 Directive str2dir (char *dstr)
 297 {
 298     char buf[STRLEN], *ptr;
 299
 300     /* Hack to be able to read old topologies */
 301     if (gmx_strncasecmp_min(dstr, "dummies", 7) == 0)
 302     {
 303         sprintf(buf, "virtual_sites%s", dstr+7);
 304         ptr = buf;
 305     }
 306     else
 307     {
 308         ptr = dstr;
 309     }
 310
 311     for (auto d : gmx::EnumerationWrapper<Directive>())
 312     {
 313         if (gmx_strcasecmp_min(ptr, dir2str(static_cast<Directive>(d))) == 0)
 314         {
 315             return static_cast<Directive>(d);
 316         }
 317     }
 318
 319     return Directive::d_invalid;
 320 }
 321
 322 static gmx::EnumerationArray<Directive, Directive *> necessary = {{ nullptr }};
 323
 324 static void set_nec(Directive **n, ...)
 325 /* Must always have at least one extra argument */
 326 {
 327     va_list   ap;
 328     int       ind = 0;
 329     Directive d;
 330
 331     va_start(ap, n);
 332     do
 333     {
 334         d = static_cast<Directive>(va_arg(ap, int));
 335         srenew(*n, ++ind);
 336         (*n)[ind-1] = d;
 337     }
 338     while (d != Directive::d_none);
 339     va_end(ap);
 340 }
 341
 342 void DS_Init(DirStack **DS)
 343 {
 344     if (necessary[0] == nullptr)
 345     {
 346         set_nec(&(necessary[Directive::d_defaults]), Directive::d_none);
 347         set_nec(&(necessary[Directive::d_atomtypes]), Directive::d_defaults, Directive::d_none);
 348         set_nec(&(necessary[Directive::d_bondtypes]), Directive::d_atomtypes, Directive::d_none);
 349         set_nec(&(necessary[Directive::d_constrainttypes]), Directive::d_atomtypes, Directive::d_none);
 350         set_nec(&(necessary[Directive::d_pairtypes]), Directive::d_atomtypes, Directive::d_none);
 351         set_nec(&(necessary[Directive::d_angletypes]), Directive::d_atomtypes, Directive::d_none);
 352         set_nec(&(necessary[Directive::d_dihedraltypes]), Directive::d_atomtypes, Directive::d_none);
 353         set_nec(&(necessary[Directive::d_nonbond_params]), Directive::d_atomtypes, Directive::d_none);
 354         // Note that the content of the next two directives are
 355         // ignored, but if grompp reads them in old force field files,
 356         // it still needs to understand that they are in a valid place
 357         // in the .top structure. It doesn't have to require them to
 358         // be in the same place that was valid in old versions (ie. child
 359         // directive of [atomtypes]) but any relevant case will
 360         // satisfy that.
 361         set_nec(&(necessary[Directive::d_implicit_genborn_params]), Directive::d_atomtypes, Directive::d_none);
 362         set_nec(&(necessary[Directive::d_implicit_surface_params]), Directive::d_atomtypes, Directive::d_none);
 363         set_nec(&(necessary[Directive::d_cmaptypes]), Directive::d_atomtypes, Directive::d_none);
 364         set_nec(&(necessary[Directive::d_moleculetype]), Directive::d_atomtypes, Directive::d_none);
 365         set_nec(&(necessary[Directive::d_atoms]), Directive::d_moleculetype, Directive::d_none);
 366         set_nec(&(necessary[Directive::d_vsites2]), Directive::d_atoms, Directive::d_none);
 367         set_nec(&(necessary[Directive::d_vsites3]), Directive::d_atoms, Directive::d_none);
 368         set_nec(&(necessary[Directive::d_vsites4]), Directive::d_atoms, Directive::d_none);
 369         set_nec(&(necessary[Directive::d_vsitesn]), Directive::d_atoms, Directive::d_none);
 370         set_nec(&(necessary[Directive::d_bonds]), Directive::d_atoms, Directive::d_none);
 371         set_nec(&(necessary[Directive::d_exclusions]), Directive::d_bonds, Directive::d_constraints, Directive::d_settles, Directive::d_none);
 372         set_nec(&(necessary[Directive::d_pairs]), Directive::d_atoms, Directive::d_none);
 373         set_nec(&(necessary[Directive::d_pairs_nb]), Directive::d_atoms, Directive::d_none);
 374         set_nec(&(necessary[Directive::d_angles]), Directive::d_atoms, Directive::d_none);
 375         set_nec(&(necessary[Directive::d_polarization]), Directive::d_atoms, Directive::d_none);
 376         set_nec(&(necessary[Directive::d_water_polarization]), Directive::d_atoms, Directive::d_none);
 377         set_nec(&(necessary[Directive::d_thole_polarization]), Directive::d_atoms, Directive::d_none);
 378         set_nec(&(necessary[Directive::d_dihedrals]), Directive::d_atoms, Directive::d_none);
 379         set_nec(&(necessary[Directive::d_constraints]), Directive::d_atoms, Directive::d_none);
 380         set_nec(&(necessary[Directive::d_settles]), Directive::d_atoms, Directive::d_none);
 381         set_nec(&(necessary[Directive::d_system]), Directive::d_moleculetype, Directive::d_none);
 382         set_nec(&(necessary[Directive::d_molecules]), Directive::d_system, Directive::d_none);
 383         set_nec(&(necessary[Directive::d_position_restraints]), Directive::d_atoms, Directive::d_none);
 384         set_nec(&(necessary[Directive::d_angle_restraints]), Directive::d_atoms, Directive::d_none);
 385         set_nec(&(necessary[Directive::d_angle_restraints_z]), Directive::d_atoms, Directive::d_none);
 386         set_nec(&(necessary[Directive::d_distance_restraints]), Directive::d_atoms, Directive::d_none);
 387         set_nec(&(necessary[Directive::d_orientation_restraints]), Directive::d_atoms, Directive::d_none);
 388         set_nec(&(necessary[Directive::d_dihedral_restraints]), Directive::d_atoms, Directive::d_none);
 389         set_nec(&(necessary[Directive::d_cmap]), Directive::d_atoms, Directive::d_none);
 390         set_nec(&(necessary[Directive::d_intermolecular_interactions]), Directive::d_molecules, Directive::d_none);
 391     }
 392     *DS = nullptr;
 393
 394 }
 395
 396 void DS_Done (DirStack **DS)
 397 {
 398     DirStack *D;
 399
 400     while (*DS != nullptr)
 401     {
 402         D   = *DS;
 403         *DS = (*DS)->prev;
 404         sfree (D);
 405     }
 406 }
 407
 408 void DS_Push (DirStack **DS, Directive d)
 409 {
 410     DirStack *D;
 411
 412     snew(D, 1);
 413     D->d    = d;
 414     D->prev = *DS;
 415     *DS     = D;
 416 }
 417
 418 int DS_Search(DirStack *DS, Directive d)
 419 {
 420     DirStack *D;
 421
 422     D = DS;
 423     while ((D != nullptr) && (D->d != d))
 424     {
 425         D = D->prev;
 426     }
 427
 428     return static_cast<int>(D != nullptr);
 429 }
 430
 431 int DS_Check_Order(DirStack *DS, Directive d)
 432 {
 433     Directive d0;
 434     int       i = 0;
 435
 436     /* Check if parameter definitions appear after a moleculetype directive */
 437     if (d < Directive::d_moleculetype && DS_Search(DS, Directive::d_moleculetype))
 438     {
 439         return FALSE;
 440     }
 441
 442     /* Check if all the necessary directives have appeared before directive d */
 443     if (necessary[d][0] == Directive::d_none)
 444     {
 445         return TRUE;
 446     }
 447     else
 448     {
 449         do
 450         {
 451             d0 = necessary[d][i++];
 452             if (DS_Search(DS, d0))
 453             {
 454                 return TRUE;
 455             }
 456         }
 457         while (d0 != Directive::d_none);
 458     }
 459     return FALSE;
 460 }