**************************************** * CHARMM/POLYRATE INTERFACE * **************************************** CHARMMRATE: A Module for Calculating Enzymatic Reaction Rate Constants with POLYRATE and CHARMM CHARMMRATE is an interface of CHARMM and POLYRATE to include quantum mechanical effects in enzyme kinetics. Although CHARMMRATE allows execution of POLYRATE with all existing capabilities, the present implementation is primarily intended for predicting reaction rates in enzyme-catalyzed reactions. CHARMMRATE can be combined with semiempirical combined QM/MM potentials with numerical second derivatives that are computed by the POLYRATE interface programs. The rate constant for an enzymatic reaction depends on the transition state theory free energy of activation and on an overall transmission coefficient. Quantum effects on the degrees of freedom perpendicular to the reaction coordinate can be incorporated by means of a correction for quantum mechanical vibrational free energy, DeltaW_vib. As described by M. Garcia-Viloca, C. Alhambra, D. G. Truhlar, and J. Gao, in J. Chem. Phys. 114, 9953-9958 (2001), such a correction is calculated by carrying out projected instantaneous normal mode analysis at several configurations along a reaction coordinate as sampled by the umbrella sampling technique (or by any other suitable method) in molecular dynamics simulations with CHARMM. Note that projected instantaneous normal mode analysis involves projecting out the reaction coordinate of the potential of mean force (i.e., the coordinate along which umbrella sampling was carried out); thus it yields different frequencies and modes than would be obtained by ordinary instantaneous normal mode analysis. The correction for quantized vibrational free energy in modes normal to the PMF reaction coordinate is calculated from the average frequencies of the projected instantaneous normal mode analysis and is added to the classical potential of mean force. The quantum effects on the reaction coordinate are represented by an averaged transmission coefficient obtained by carrying out variational transition state theory (VTST) calculations for individual members (configurations) of the transition state ensemble. These calculations involve a partition of the system into a frozen bath region and a dynamics region that is used in the dynamics calculation. CHARMMRATE has been used to determine the rate constants for the proton transfer reactions catalyzed by enolase and methylamine dehydrogenase and for the hydride transfer reactions catalyzed by alcohol dehydrogenase, xylose isomerase, and dihydrofolate reductase. These studies have demonstrated that inclusion of quantum effects is essential to calculate primary and secondary kinetic isotopic effects (KIEs) for hydrogen transfer reactions. The method used in these studies has evolved to its definitive form that includes free energy simulation to determine the free energy of activation and calculation of the transmission coefficient. Putting all the elements together yields a method that is called ensemble-averaged VTST with multidimensional tunneling (EA-VTST/MT),the formalism of which is presented in detail in the following recent papers: C. Alhambra, J. C. Corchado, M. L. Sanchez, M. Garcia-Viloca J. Gao, and D. G. Truhlar J. Phys. Chem. B. 105, 11326-11340 (2001). D. G. Truhlar, J. Gao, C. Alhambra, M. Garcia-Viloca, J. Corchado, M. L. Sanchez, and Jordi Villa, Acc. Chem. Res. 35, 341-349 (2002). M. Garcia-Viloca, C. Alhambra, D. G. Truhlar, and J. Gao, J. Comput. Chem. 2002, in press. This documentation contains a short version and a long, detailed version following the short CHARMM-command description. Users are encouraged to read both parts. * Menu: * Description:: Description of the POLYRATE driver in CHARMM * Usage:: How to run POLYRATE in CHARMM * Installation:: How to install POLYRATE in CHARMM * Status:: Status of the interface code
**************************************************** * Syntax for the CHARMMRATE Method * **************************************************** POLYRATE is initiated with the POLYrate command. [Syntax POLYrate] POLYrate [ atom-selection] [RUNIT int] [PUNIT int] [TSUNit int] [OPUNit int] [PMFZpe ] [ATMA int ] [ATMB int] [ATMC int] [POLYRATE commands] .... [*finish] atom-spec::= {residue-number atom-name} {segid resid atom-name} {BYNUm atom-number} RUNIt int: Unit specification for input of initial coordinates of the reactant species. The current limitation is that only CHARMM format is allowed for the coordinate file. PUNIt int: Unit specification for input of initial coordinates of the product species. The current limitation is that only CHARMM format is allowed for the coordinate file. TSUNit int: Unit specification for input of initial coordinates of the transition state. The current limitation is that only CHARMM format is allowed for the coordinate file. OPUNit int: Unit to write out coordinates of the optimized structures, of any of the reactant, product, and TS, depending on the species being optimized. The current limitation is that only CHARMM format is used. PMFZpe ATMA int ATMB int ATMC int: this command switches on the projection operator that is used to project the reaction coordinate out of the Hessian matrix of the system. This is used for projected instantaneous normal mode analysis. The reaction coordinate is defined as the difference in bond distance between the breaking and making bonds. ATMA int: atom number for the donor atom following the numbering in the general section of POLYRATE commands (see below). ATMB int: atom number for the transferring atom following the numbering in the general section of POLYRATE commands (see below). ATMC int: atom number for the acceptor atom following the numbering in the general section of POLYRATE commands (see below). [POLYRATE commands] This section contains standard POLYRATE commands. They must follow immediately after the [POLYrate] command in the CHARMM input stream. This section is terminated by the key word [*finish], lower case with a star in the beginning. For details of the POLYRATE commands, see the POLYRATE documentation.
Note: The version number of CHARMMRATE is 2.0/C28b3-P9.0. This means that CHARMMRATE-version 2.0 is based on POLYRATE-version 9.0 and CHARMM-version c28b3. The version number may be abbreviated to 2.0 when no confusion will result. CHARMMRATE is a module of CHARMM for interfacing it with POLYRATE; the POLYRATE main program becomes a subprogram of CHARMM. POLYRATE can be called to carry out projected instantaneous normal mode analysis and variational transition state theory calculations with semiclassical multidimensional tunneling contributions. When POLYRATE needs the value or gradient of the potential energy surface, it calls a set of interface routines called hooks. The hooks in turn call CHARMM routines for energies and gradients calculated by molecular mechanics or QM/MM methods. The current version has not been parallelized. Referencing for CHARMMRATE: "The rate constant (or reaction path or geometry optimization, etc.) calculations were carried out using the CHARMMRATE program[1-3]". [1] M. Garcia-Viloca, C. Alhambra, J. C. Corchado, M. L. Sanchez, J. Villa, J. Gao, and D. G. Truhlar, CHARMMRATE-version 2.0, University of Minnesota, Minneapolis, 2002, a module of CHARMM (Ref. 2) for interfacing it with POLYRATE (Ref. 3). [2] Chemistry at HARvard Macromolecular Mechanics (CHARMM) computer program, as described in B. R. Brooks, R. E. Bruccoleri, B. D. Olafson , D. J. States, S. Swaminathan, and M. Karplus, J. Comput. Chem. 4, 187 (1983). [3] J. C. Corchado, Y.-Y. Chuang, P. L. Fast, J. Villa, W.-P. Hu, Y.-P. Liu, G. C. Lynch, K. A. Nguyen, C. F. Jackels, V. S. Melissas, B.J. Lynch, I. Rossi, E. L. Coitino, A. Fernandez-Ramos, J. Pu, and T. V. Albu, R. Steckler, B. C. Garrett, A. D. Isaacson, and D. G. Truhlar, POLYRATE-version 9.0, University of Minnesota, Minneapolis, 2002.
**************************************************** * Availability of CHARMMRATE * **************************************************** CHARMMRATE-version 2.0/C28b3-P9.0 is a module of CHARMM-version c28b3 for interfacing it with POLYRATE-version 9.0. An earlier version, CHARMMRATE-version 1.0, was distributed as part of the CHARMM program beginning with version 28b1 of CHARMM and was used to interface previous versions of CHARMM and POLYRATE. CHARMMRATE-2.0/C28b3-P9.0 will be distributed beginning with version c28b3 of CHARMM. The user will also require the CRATE utility for modifying POLYRATE to make it compatible with CHARMM. CRATE-version 8.11 corresponds to CHARMMRATE-1.0, and CRATE-version 9.0 corresponds to CHARMMRATE-2.0. CRATE-version 9.0 corresponds to interfacing POLYRATE-version 9.0. The prospective user of CHARMMRATE should obtain a valid license for CHARMM from an authorized CHARMM licenser and valid licenses for POLYRATE and CRATE from the University of Minnesota (http://comp.chem.umn.edu).
1. INTRODUCTION CHARMMRATE is an interface of CHARMM and POLYRATE to include quantum mechanical effects in enzyme kinetics. Although CHARMMRATE allows execution of POLYRATE with all existing capabilities for reactions with only one reactant and only one product, the present implementation is primarily intended for prediction of the reaction rates of enzyme-catalyzed reactions. Any CHARMMRATE calculation involves the partition of the system into a primary subsystem (or primary-zone atoms), which contains the subset of atoms involved in the reaction, and the rest of the system (secondary-zone atoms). Only the coordinates of the primary-zone atoms are passed from CHARMM to POLYRATE for both projected instantaneous normal mode analysis and dynamics calculations. Consequently, the quantum mechanical vibrational correction and the dynamics effects are calculated for the primary subsystem in the field of the secondary subsystem. 1.A. Capabilities added to CHARMM by CHARMMRATE and references for methods POLYRATE includes a very large number of options and has multiple capabilities. The user of CHARMMRATE is encouraged to read the POLYRATE manual to learn more about these capabilities. The present section summarizes a few of the capabilities that are liable to be of most interest to CHARMMRATE users. 1.A.1. Transition state optimization Saddle point geometry optimizations for the primary (dynamic) zone in the frozen protein-plus-solvent bath may be performed in various ways; the default option is the Newton-Raphson method with Brent line minimization as described in W. H. Press, S. P. Flannery, S. A. Teukolsky, and W. T. Vetterling, Numerical Recipes (Cambridge University Press, Cambridge, 1986), p.254. The default option for optimization of the stationary points for reactants and products is to use the BFGS method that has been implemented in POLYRATE. See the POLYRATE manual for further information about the optimization methods available in POLYRATE. 1.A.2. Reaction path In general, reaction paths (RPs) may be defined in various ways. The simplest general method that is reasonably sure to give physically meaningful vibrational frequencies for motions transverse to the reaction path (and hence also physically meaningful free energy of activation profiles) is the steepest descents path in isoinertial coordinates. (An isoinertial coordinates system is one in which the kinetic energy is a sum of square terms and the coordinates are scaled or weighted so that each kinetic energy term has the same reduced mass. All isoinertial coordinate systems are related to each other by orthogonal transformations, and steepest descents paths are invariant under orthogonal transformations.) A steepest descents path is also called a minimum energy path (MEP). The signed distance from the saddle point along the reaction path is called the reaction coordinate, usually denoted s. (This reaction coordinate, s, should not be confused with the reaction coordinate used for umbrella sampling, which is called z.) The isoinertial MEP is sometimes just called the MEP, or it may just be called the RP; other workers prefer to append the word intrinsic, e.g., intrinsic MEP, intrinsic reaction path, intrinsic reaction coordinate, etc. In CHARMMRATE, the reaction path refers to a multidimensional path for the primary-zone (dynamic) atoms in the presence of the secondary- zone (frozen) atoms. CHARMMRATE may be used to calculate the isoinertial minimum energy path (MEP) as described in B. C. Garrett, M. J. Redmon, R. Steckler, D. G. Truhlar, K. K. Baldridge, D. Bartol, M. W. Schmidt, M. S. Gordon, J. Phys. Chem. 92, 1476-1488 (1988). 1.A.3. Free energy of activation profile and variational transition state theory Vibrational partition functions and generalized free energies of activation (which are free energies of activation for tentative transition states that are not necessarily associated with either a saddle point or with the final variational transition state) are computed along the reaction path by using the quantum mechanical harmonic oscillator approximation in 3N1 - 1 degrees of freedom, where N1 is the number of atoms in the primary zone, and the reaction coordinate is projected out. This kind of calculation is described in S. E. Wonchoba, and D. G. Truhlar, J. Chem. Phys. 99, 9637- 9651 (1993). The generalized free energy of activation as a function of the reaction coordinate (which is the signed distance along the MEP) is called the free energy of activation profile, and it may be used to calculate reaction rate constants by variational transition state theory (VTST) as described in D. G. Truhlar and B. C. Garrett, Acc. Chem. Res. 13 , 440-448 (1980). A procedure like this was used in C. Alhambra, J. Gao, J. C. Corchado, J. Villa, and D. G. Truhlar, J. Am. Chem. Soc. 121, 2253-2258 (1999), but it is now recommended to use the more complete EA-VTST/MT method, in which this quantity is used to compute a transmission coefficient rather than a rate constant. VTST for a canonical ensemble (i.e., a system at a fixed temperature) is also called canonical variation theory (CVT). In the EA-VTST/MT method (described in Section 2), this step is carried out for several members of the transition state ensemble, and it is used for the quasiclassical part of the ensemble-averaged transmission coefficient. 1.A.4. Transmission coefficient In CHARMMRATE the EA-VTST/MT transmission coefficient has two parts: a quasiclassical dynamical recrossing part (Section 1.A.3) and a part that accounts for tunneling (transmission through the barrier at energies below the top) and non-classical reflection (reflection caused by diffraction from the barrier top even when the energy is above the barrier); often we just refer to the combination of tunneling and non-classical reflection effects as tunneling (the tunneling is more important than the non- classical reflection because the energies where tunneling occurs have larger Boltzmann factors than the energies where non-classical reflection occurs). CHARMMRATE can calculate the tunneling part of the transmission coefficient in various ways. The most complete method is the microcanonical optimized multidimensional tunneling (muOMT) approximation as described in Y.-P. Liu, D.-h. Lu, A. Gonzalez-Lafont, D. G. Truhlar, and B. C. Garrett, J. Am. Chem. Soc. 115, 7806-7817 (1993). In this calculation, tunneling and non-classical reflection along the reaction path are included by calculating both the large-curvature tunneling (LCT) approximation and the small-curvature tunneling (SCT) approximation and, at each tunneling energy, accepting whichever tunneling approximation yields the larger tunneling probability. This is a poor man's version of a more complete search for the semiclassical tunneling paths that minimize the imaginary action integrals, and it has been extensively validated as summarized by T. C. Allison and D. G. Truhlar, in Modern Methods for Multidimensional Dynamics Computations in Chemistry, edited by D. L. Thompson (World Scientific, Singapore, 1998), pp. 618-712. One may also limit the calculation to just the LCT or SCT approximation or to the zero-curvature tunneling approximation (ZCT) or even the Wigner approximation. The muOMT, LCT, SCT, and ZCT approximations are multidimensional, whereas the Wigner approximation is one-dimensional. The ZCT approximation calculates tunneling along the isoinertial MEP, whereas the muOMT, LCT, and SCT approximations include various amounts of corner cutting, i.e., tunneling on the concave side of the isoinertial MEP, with the amount and nature of the corner cutting depending on the curvature of the reaction path. The computational cost decreases in the following order: muOMT, LCT, SCT, ZCT, Wigner. When tunneling is included, the EA-VTST/MT rate constant is written as k(T) = gamma(T) kTST(T) where kTST(T) is the TST rate constant that is determined by the free energy simulation of of stage 1 (including the quantum mechanical correction of step 2 of stage 1), and gamma(T) is the transmission coefficient that accounts for classical recrossing (the quasiclassical part of section 1.A.3) and for tunneling and non-classical reflection. Background for the calculation of KIEs by VTST with multidimensional tunneling approximations is given in D.G. Truhlar, D.-h. Lu, S.C. Tucker , X.G. Zhao, A. Gonzalez-Lafont, T.N. Truong, D. Maurice, Y-.P. Liu, and G.C. Lynch, in Isotope Effects in Chemical Reactions and Photodissociation Processes, edited by J. A. Kaye (American Chemical Society Symposium Series 502, Washington, DC, 1992), pp. 16-36. 1.B. CHARMMRATE capabilities that are not included either in POLYRATE or in prior versions of CHARMM: Projected instantaneous normal mode analysis Two source files of POLYRATE (see the CRATE manual) are modified by the CRATE utility version-9.0 to carry out projected instantaneous normal mode analysis. With these routines quantum mechanical harmonic frequencies of the vibrational modes of the primary subsystem orthogonal to the reaction coordinate may be calculated for a given configuration of the system. This calculation is used in the second step of the first stage of the EA-VTST/MT method (described in Section 2) to include quantum effects on the 3N-7 highest-frequency vibrational modes of the primary zone in a hypersurface orthogonal to the reaction coordinate that is used for umbrella sampling in the first step of stage 1. The constraint that the modes obtained are orthogonal to the reaction coordinate is achieved by a projection operator described in C. Alhambra , J. C. Corchado, M. L. Sanchez, M. Garcia-Viloca, J. Gao, and D. G. Truhlar J. Phys. Chem. B 105, 11326-11340 (2001). 1.C. CHARMM options that are of particular interest for use with CHARMMRATE. CHARMMRATE is of particular interest for calculations of rate constants for enzymatic reactions. Although the program would allow the use of pure molecular mechanics (the CHARMM22 force field) for such calculations, combined quantum mechanical and molecular mechanical (QM/MM) potentials are much more realistic than pure molecular mechanics for chemical reactions. Using CHARMM, QM/MM calculations can now be performed at the ab initio level using GAMESS (B. Brooks and M. Hodoscek, unpublished results), at the density functional level using CADPAC (P. D. Lyne, M. Hodoscek, and M. Karplus, J. Phys. Chem. A 103, 3462-3471 (1999)), and at semiempirical molecular orbital levels (AM1 and PM3, with general parameters or with specific reaction parameters) with MOPAC (M. J. Field, P. A. Bash, and M. Karplus, J. Comput. Chem. 11 700-733 (1990)). There is more than one choice for joining the QM subsystem to the MM one. The first choice is to use "link atoms" to saturate the valence of the fragment; this requires that certain atomic charges in the MM fragment that are close to the QM region be deleted to avoid artificial polarization of the quantum subsystem. One possibility to avoid these problems is to use the generalized hybrid orbital (GHO) method described in J. Gao, P. Amara, C. Alhambra, and M. Field, J. Phys. Chem. A 102, 4714-4721 (1998). The GHO method is currently available for semiempirical calculations with the AM1 and PM3 methods, and it is being extended (work in progress) to ab initio and DFT methods. Another way to correct the link atom artifacts in the original formulation is proposed in C. Alhambra, L. Wu, Z.-Y. Zhang, and J. Gao, J. Am. Chem. Soc. 120, 3858-3866 (1998). Molecular dynamics simulations of an enzyme-solvent system can be carried out on a QM/MM potential energy surface either using periodic boundary conditions or using stochastic boundary conditions; for the periodic boundary conditions see M. P. Allen and D. J. Tildesley, Computer Simulation of Liquids, (Oxford University Press, New York, 1987), Ch. 1, and for the stochastic boundary conditions see C. L. Brooks, A. Brunger, and M. Karplus, Biopolymers 24, 843-865 (1985). Free energy perturbation and umbrella sampling techniques can be used to determine the potential of mean force or classical free energy profile for the enzymatic reaction (see C. Alhambra, L. Wu, Z.-Y. Zhang, J. Gao, J. Am. Chem. Soc. 120, 3858-3866 (1998)). 2. THEORETICAL BACKGROUND: Ensemble-averaged variational transition state theory with multidimensional tunneling (EA-VTST/MT). This section of the manual summarizes the theoretical framework and the practical procedure for the EA-VTST/MT method developed in C. Alhambra, J. C. Corchado, M. L. Sanchez, M. Garcia-Viloca, J. Gao, and D. G. Truhlar J. Phys. Chem. 105, 11326-11340 (2001). The capabilities added to CHARMM by CHARMMRATE allow the user to calculate the rate constant for an enzymatic reaction with the EA-VTST/MT procedure. The rate constant for an enzymatic reaction, which is a unimolecular process, is obtained by combining free energy simulations and variational transition state theory (VTST) with microcanonical optimized multidimensional tunneling contributions (muOMT), both in the presence of the protein environment. The potential energy surface (PES) is modeled by a QM/MM method, for example by a semiempirical MO method combined with the CHARMM force field and with the generalized hybrid orbital method (GHO) to treat the boundary between the QM and the MM parts of the system. In addition, a semiempirical term (see quantum.doc LEPS command) or specific reaction parameters (SRP) may be used to improve the accuracy of the PES. The rate constant is expressed as a function of the free energy of activation, DeltaGCVTact, calculated by variational transition state theory free energy molecular dynamics simulations, and the transmission coefficient, gamma. There are two versions of the method that differ in the approximation used to evaluate gamma, in particular a 2-stage version and a three-stage version. The procedure for the former approximation, which has been applied in the study of five hydrogen transfer reactions, has the following two stages: 1) In stage 1 of the calculation, the free energy of activation, including the quantum mechanical vibrational free energy, is computed. This involves the following calculations: Step 1 - Calculation of the classical mechanical (CM) or transition state theory free energy of activation by computing the potential of mean force (PMF) along a distinguished reaction coordinate. For a reaction AB + C -> A + BC, the reaction coordinate, z, may be defined as: z = rAB - rBC The CM PMF can be evaluated by carrying out classical molecular dynamics on a QM/MM potential energy surface with the umbrella sampling technique implemented in CHARMM (see umbrel.doc) or free energy perturbation theory. Note, for the discussion below that umbrella sampling involves a sequence of overlapping windows (whose centers are separated by about 0.1-0.2 angstroms), each of which is later divided into 50-100 bins. The bins are typically 0.01 angstroms wide. (These specific numerical values are just given as examples; none of these quantities is restricted to lie within those limits.) Step 2 - Calculation of the quantum mechanical vibrational free energy correction, DeltaW_vib, which is the difference between the quantal vibrational free energy and the classical vibrational free energy. The addition of DeltaW_vib to the CM PMF gives the quasi-classical (QC) PMF. DeltaW_vib may be evaluated by carrying out projected instantaneous normal mode analysis for the primary-zone atoms for many configurations (100-400 per window) obtained in the umbrella sampling step (see Section 1.B). The projected instantaneous normal mode frequencies obtained for the different configurations in a given bin may be averaged and the averaged value used to determine DeltaW_vib. Strictly speaking, one might argue that one should average the squared frequencies or some Boltzmann factors, but in initial applications it has been found sufficient to average the frequencies themselves. After these two steps, the value of z with highest QC free energy is called z*, and the bin containing z* (or a small set of bins centered on this bin) defines the ensemble of configurations that are representative of the transition state of the enzymatic reaction. 2) Stage 2 has the objective of computing the transmission coefficient, gamma (T), that is the average over transition state configurations i of the product of two factors, Gamma_i and kappa_i. The first factor, Gamma_i, which is the the quasiclassical transmission factor, corrects the rate constant for classical mechanical dynamical recrossing. The second factor, kappa_i, is the semiclassical transmission coefficient that accounts mainly for tunneling, that is, the quantum mechanical effect on the reaction coordinate, which is missing in the calculation of the QC rate constant. The averaged transmission coefficient is: gamma = <Gamma_i kappa_i>, where the brackets indicate average over configurations i. That is, a number of configurations (5-20 for the enzymatic reactions studied so far) within the range z = z* Deltaz ( Deltaz = 0.05-0.01 angstroms), are chosen as representative of the transition state ensemble. For each of them a CHARMMRATE dynamics calculation is carried out to calculate Gamma_i and kappa_i. As mentioned above, in such stage-2 calculation the system is divided into a set of primary-zone atoms, which are allowed to move, and the rest of the system, which is fixed at the transition state configurations. For each configuration, the saddle point and the reactant and product structures are optimized. We optimize the saddle point and we calculate an isoinertial MEP in both directions, i.e., toward the reactant and toward the product. The reactant and the product calculations are used only to determine the minimum energy at which tunneling is allowed. The effective potential used to calculate the tunneling part, kappa_i, of the transmission coefficient (see Section 1.A) involves the zero-point- inclusive energy along this MEP. The user should see test run 2 for an example of how to use a typical solvent configuration. The approximation described here to obtain the transmission coefficients is called static secondary-zone approximation (SSZ). The product of the averaged transmission coefficient obtained in this way and the quasiclassical rate constant of stage 1 results in the SSZ version of the EA-VTST/MT rate constant. The results obtained in five studies of enzymatic hydrogen transfer reactions demonstrate that the SSZ rate constant is accurate enough to reproduce experimental KIEs. The SSZ result may be improved by carrying out a further step that has been called stage 3. In stage 3, the free energy of the secondary zone is calculated by free energy perturbation theory along the minimum- energy paths of stage 2. This allows us to include the secondary-zone free energy in the transmission coefficient. This is called the equilibrium-secondary-zone (ESZ) approximation. The EA-VTST/MT method is described in: C. Alhambra, J. C. Corchado, M. L. Sanchez, M. Garcia-Viloca, J. Gao, and D. G. Truhlar J. Phys. Chem. B 105, 11326-11340 (2001), and in D. G. Truhlar, J. Gao, C. Alhambra, M. Garcia-Viloca, J. Corchado, M. L. Sanchez, and J. Villa, Acc. Chem. Res. 35, 341-349 (2002). A complete description of an application study is provided in M. Garcia-Viloca, C. Alhambra, D. G. Truhlar, and J. Gao, J. Comput. Chem. 2002, in press. 3. PROGRAM STRUCTURE 3.A. Overall design The CHARMMRATE interface for CHARMM and POLYRATE takes advantage of the modular nature of both programs, and, consequently, minimal modifications of CHARMM and POLYRATE were required. The CHARMM program is the main driver of the integrated program, which makes a FORTRAN call to the interface subprogram, CHARMMRATE, to initiate calculations by POLYRATE. The energy and energy gradients for the primary-zone atoms required by POLYRATE are determined by CHARMM through the interface subprogram and are supplied to POLYRATE through a set of subroutines called the POLYRATE hooks. 3.B. Modifications and additions to CHARMM Only two modifications have been made in the CHARMM program: (1) addition of a one-line keyword processing command in the charmm_main.src module to initiate the subroutine call to CHARMMRATE; (2) addition of the CHARMMRATE module. 3.C. Modifications and additions to POLYRATE Specific modifications of the original POLYRATE program have been made primarily for efficient transfer of information between CHARMM and POLYRATE and to eliminate conflicts and other problems during compilation. These modifications are described in the CRATE manual, available at http://comp.chem.umn.edu/crate. 4. INSTALLATION OF charmmrate AND ITS USE 4.A. Program distribution CHARMMRATE-version 2.0/C28b2-P9.0 is distributed as a module in CHARMM. CHARMM is a copyrighted program distributed by Professor Martin Karplus's research group at Harvard University and by Accelrys, Inc. In addition to CHARMM,which includes the CHARMMRATE module, users also need to obtain the POLYRATE program, which is a copyrighted program distributed by the University of Minnesota (http://comp.chem.umn.edu) and the CRATE utility, also available from Minnesota. The CRATE utility will make the changes to the source code of POLYRATE to allow the interface between the two programs. When the CHARMM program (which, beginning with version 28, automatically includes the CHARMMRATE module), the POLYRATE program and the CRATE utility have been obtained, integration of the codes into a single executable file is straightforward as described below. 4.B. Installation The user should carry out the following steps: 1. Install CHARMM. 2. Store the tar file polyrate9.0.tar.Z (obtained from the University of Minnesota, http://comp.chem.umn.edu) in the directory chmroot/source/prate and untar it with this command: tar xvf polyrate9.0.tar 3. Set an environmental variable, called pr, to the absolute path name of the directory where the polyrate program is stored. Example: C shell % setenv pr /home/chmroot/source/prate/polyrate9.0 Bourne shell $ pr = /home/chmroot/source/prate/polyrate9.0 $ export pr 4. Store the tar file crate9.0.tar.Z (obtained from the University of Minnesota, http://comp.chem.umn.edu) in the directory chmroot/source/prate and untar it with this command: tar xvf crate9.0.tar The directory crate9.0 will then contain the files required to prepare POLYRATE for use with the CHARMMRATE module of CHARMM. These files are described in the CRATE manual. Change the dimensions specified in the param.inc file located in the newly created directory, crate9.0, in order to make them large enough for the system(s) to be studied, but small enough to run in the memory available on the computer chosen to carry out the work. Or use the param.inc file distributed as part of CRATE. See the POLYRATE manual for further discussion of the dimensions in in POLYRATE. 5. Set an environmental variable, crate, to the absolute path name of the directory where the CRATE package is stored. Example: C shell % setenv crate /home/chmroot/source/prate/crate9.0 Bourne shell $ crate = /home/chmroot/source/prate/crate9.0 $ export crate 6. Go to the /build directory of CHARMM, i.e. cd /home/chmroot/build/'chm_host', and edit the file pref.dat. Add the CHARMMRATE module to the list. 7. If CHARMM has been compiled previously without POLYRATE, remove all the object files in home/chmroot/lib/'chm_host' 8. Go to the CHARMM directory chmroot and type the command: install.com 'chm_host' (small/medium/large) POLYR > & log & (see install.doc in the CHARMM documentation directory). This step will execute the script install_cr.com, which will put the CHARMMRATE source code in the directory /home/chmroot/source/prate. Any modifications desired should be done here. 9. You do not need to run the script install_cr.com (described in the CRATE manual) in any further compilations. Therefore it is recommended to comment the following line in the file /home/chmroot/install.com: $crate/install_cr.com 10. After compilation, you will have a new executable in: /home/chmroot/exec/'chm_host' NOTE: In order to run projected instantaneous normal mode analysis with CHARMMRATE-version 2.0 it is necessary to do small changes in two of the files located in the directory /home/chmroot/source/prate after the compilation process described above. Instructions for these changes are provided in the README file contained in the crate9.0 directory of the CRATE package. 5. DESCRIPTION OF INPUT CHARMMRATE is run from the CHARMM main input stream. The syntax to execute polyrate from charmm's input stream for a reaction with only one reactant (e.g., an enzyme-substrate precursor complex) and only one product (e.g., an enzyme-substrate successor complex) is: POLYrate SELEction { atom-spec } end [RUNIt int] [PUNIt int] [TSUNit int] [OPUNit int] [ PMFZpe ] [ATMA int ] [ATMB int] [ATMC int] _polyrate_input_ *finish We note the use of the CHARMM convention by which one needs to enter only the first four letters of POLYrate and other words with the first four letters capitalized. Furthermore the parts in brackets are optional. The meanings of the various keywords are: SELEction { atom-spec } specifies the primary-zone atoms in POLYRATE: atom-spec = { residue-number atom-name } { segid resid atom-name } { BYNUm atom-number } RUNit int: Unit specification for input of initial coordinates of the reactant species. The current limitation is that only CHARMM format is allowed for the coordinate file. PUNit int: Unit specification for input of initial coordinates of the product species. The current limitation is that only CHARMM format is allowed for the coordinate file. TSUNit int: Unit specification for input of initial coordinates of the transition state. The current limitation is that only CHARMM format is allowed for the coordinate file. OPUNit int: Unit to write out coordinates of the optimized structures of the reactant, product, or TS, depending upon which of these is requested (elsewhere) to be written. The current limitation is that only CHARMM format is used. The coordinate files assigned to these units must be in the CARD format (see CHARMM documentation for details). PMFZpe ATMA int ATMB int ATMC int: this command switch on the projection of the reaction coordinate out of the Hessian matrix of the system. It is used for projected instantaneous normal mode analysis. The reaction coordinate is defined as the difference in bond distance between the breaking and making bonds. ATMA int: atom number for the donor atom following the numbering in the general section of POLYRATE commands (see below). ATMB int: atom number for the transferring atom following the numbering in the general section of POLYRATE commands (see below). ATMC int: atom number for the acceptor atom following the numbering in the general section of POLYRATE commands (see below). _polyrate_input_: This section contains a standard POLYRATE fu5 input file. It must follow immediately after the POLYrate command in the CHARMM input stream. For details of POLYRATE input, see the POLYRATE documentation. The initial coordinates have already been setup through the POLYrate command; therefore the GEOM record in the POLYRATE fu5 input file may be omitted. If, however, the GEOM record is present, the Cartesian coordinates given in this record will replace the data set up through the POLYrate command. This is not recommended. *finish The last record to be read by POLYRATE from the CHARMM main input stream. This will terminate I/O operations from unit 5 by POLYRATE, and POLYRATE calculations will proceed. 6. TEST RUNS This section describes two test runs. Each test job includes a full input file, initial coordinates and parameter files. They are located in: /home/chmroot/test/cquantumtest. 6.1. Test Job 1 - Direct dynamics of chorismate to prephenate in the gas phase This test job reads in three initial guess coordinates for the reactant state, product state, and transition state, optimizes their geometries, and performs a CVT calculation to yield the predicted rate constants at various temperatures. This test job takes roughly 3 hours on an SGI Octane 2 computer running under the Irix 6.5 operating system. (Test Job 2 is a shorter test run.) 6.1.A. Input files The cr01.inp file contains the CHARMM input stream for a direct dynamics calculation of the chorismate to prephenate rearrangement reaction. Similar calculations can be carried out for the substrate in the enzyme active site, provided that appropriate boundary conditions are set up in he CHARMM input. The charmm22.top and charmm22.par files are the CHARMM topology and parameter files. They are required for all CHARMM calculations. Three coordinate files are provided for this test job, corresponding to the initial guess coordinates for the reactant (gs.crd), product (prod.crd), and transition state (ts.crd) for the dynamics calculation with POLYRATE. 6.1.B. Description of the CHARMM input stream The majority of the CHARMM commands are straightforward. The three initial guess coordinate files must be opened as formatted files in the CHARMM input stream before the POLYrate command is initiated. Certain FORTRAN unit numbers are default file choices in POLYRATE. Therefore, these numbers should not be used in the CHARMM input file unless the POLYRATE defaults are changed. Please consult the POLYRATE documentation for a full list and description of these files. Five (5) FORTRAN files will be used by POLYRATE to write out the computational results. They are files with unit numbers 14, 25, 26, 27, and 61, which should be opened in the CHARMM input stream before CHARMMRATE calculations. Section 6.1.C summarizes the contents of these files. All input instructions immediately following the POLYrate command are those of POLYRATE. A full description of these commands can be found in the POLYRATE documentation. 6.1.C. Description of CHARMMRATE output cr0114.out - computed reaction rates at various temperatures using the TST and CVT methods. cr0125.out - potential energy along the reaction coordinate s, which measures distance along the minimum energy path (MEP), and computed transmission coefficient, if requested. Since the test run is for a CVT calculation, no multidimensional tunneling is included in the test run. cr0126.out - computed vibrational frequencies that hgave been requested for printing out along s. cr0127.out - coordinates along s. cr0161.out - optimized geometries, energies, vibrational frequencies and the Hessian for the reactant, product, and transition state. 6.2. Test Job 2 - Geometry optimization of chorismate in a water bath This test job performs geometry optimization of chorismate in the presence of a frozen water bath, arbitrarily taken from the trajectory of a molecular dynamics simulation of chorismate in water. The cr02.inp file is the CHARMM input stream command file. In addition to the CHARMM topology and parameter files, the cr02.crd file is required; it contains the instantaneous (initial) coordinates of chorismate in water from a molecular dynamics simulation. The file optcr02.crd contains the optimized coordinates of chorismate in water.
NIH/DCRT/Laboratory for Structural Biology
FDA/CBER/OVRR Biophysics Laboratory
Modified, updated and generalized by C.L. Brooks, III
The Scripps Research Institute