Skip to content

Commit 6da111f

Browse files
committed
beginning to merge changes
1 parent 30a12c1 commit 6da111f

File tree

3 files changed

+105
-40
lines changed

3 files changed

+105
-40
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -169,6 +169,7 @@ TSWLatexianTemp*
169169
# WinEdt
170170
*.bak
171171
*.sav
172+
.idea/
172173

173174
# Texpad
174175
.texpadtmp

paper/basic_training.bib

Lines changed: 87 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -49,13 +49,6 @@ @book{GlodsteinBook
4949
edition = "Third"
5050
}
5151

52-
@book{ReifBook,
53-
author = "Reif, Frederick",
54-
title = "Fundamentals of Statiscal and Thermal Physics",
55-
year = "2009",
56-
publisher = "Waveland Press, Inc."
57-
}
58-
5952
@book{ZemanskyBook,
6053
author = "Zemansky, Mark W. and Dittman, Richard H.",
6154
title = "Heat and Thermodynamics",
@@ -685,7 +678,7 @@ @book{Tuckerman:2010:
685678
year = {2010},
686679
}
687680

688-
@article{Minary:2003:JChemPhys:Algorithms,
681+
@article{Minary:2003:JChemPhysAlgorithms,
689682
title={Algorithms and novel applications based on the isokinetic ensemble. I. Biophysical and path integral molecular dynamics},
690683
author={Minary, Peter and Martyna, Glenn J and Tuckerman, Mark E},
691684
journal={The Journal of chemical physics},
@@ -707,7 +700,7 @@ @article{Bussi:2007:JChemPhys:Canonical
707700
publisher={AIP}
708701
}
709702

710-
@article{Braun:2018:Anomalous,
703+
@article{Braun:2018,
711704
title={Anomalous effects of velocity rescaling algorithms: the flying ice cube effect revisited},
712705
author={Braun, Efrem and Moosavi, Seyed Mohamad and Smit, Berend},
713706
journal={arXiv preprint arXiv:1805.02295},
@@ -771,11 +764,14 @@ @article{Mobley:2012:JComputAidedMolDes
771764
pages = {93-95},
772765
}
773766

774-
@book{Reif:2008:,
775-
title = {Fundamentals of {{Statistical}} and {{Thermal Physics}}},
776-
publisher = {{Waveland Press}},
777-
author = {Reif, Frederick},
778-
year = {2008}
767+
@book{Reif:2009:,
768+
address = {Long Grove, IL},
769+
author = {Reif, F.},
770+
isbn = {1-57766-612-7},
771+
pages = {651},
772+
publisher = {Waveland Press, Inc.},
773+
title = {{Fundamentals of Statistical and Thermal Physics}},
774+
year = {2009}
779775
}
780776

781777
@book{McQuarrie:2000:,
@@ -835,15 +831,15 @@ @book{Kittel:1980:
835831
}
836832

837833
@article{Fass2018,
838-
author = {Fass, Josh and Sivak, David and Crooks, Gavin E and Beauchamp, Kyle A and Leimkuhler, Benedict and Chodera, John},
839-
doi = {10.1101/266619},
840-
issn = {1099-4300},
841-
journal = {bioRxiv},
842-
number = {1},
843-
pages = {266619},
844-
title = {{Quantifying configuration-sampling error in Langevin simulations of complex molecular systems}},
845-
url = {https://www.biorxiv.org/content/early/2018/03/31/266619},
846-
year = {2018}
834+
author = {Fass, Josh and Sivak, David and Crooks, Gavin E. and Beauchamp, Kyle A. and Leimkuhler, Benedict and Chodera, John},
835+
title = {Quantifying configuration-sampling error in Langevin simulations of complex molecular systems},
836+
year = {2018},
837+
doi = {10.1101/266619},
838+
publisher = {Cold Spring Harbor Laboratory},
839+
URL = {https://www.biorxiv.org/content/early/2018/02/16/266619},
840+
eprint = {https://www.biorxiv.org/content/early/2018/02/16/266619.full.pdf},
841+
journal = {bioRxiv},
842+
pages = {266619}
847843
}
848844

849845
@article{Tuckerman:1992:,
@@ -904,3 +900,71 @@ @article{Chen:2014:Mol.Simul.
904900
keywords = {pH,molecular dynamics,algorithms,electrostatics,pKa calculation},
905901
pages = {830-838},
906902
}
903+
@article{Towns2014,
904+
author = {Towns, John and Cockerill, Timothy and Dahan, Maytal and Foster, Ian and Gaither, Kelly and Grimshaw, Andrew and Hazlewood, Victor and Lathrop, Scott and Lifka, Dave and Peterson, Gregory D. and Roskies, Ralph and Scott, J. Ray and Wilkens-Diehr, Nancy},
905+
doi = {10.1109/MCSE.2014.80},
906+
issn = {1521-9615},
907+
journal = {Comput. Sci. Eng.},
908+
number = {5},
909+
pages = {62--74},
910+
title = {{XSEDE: Accelerating Scientific Discovery}},
911+
url = {http://ieeexplore.ieee.org/lpdocs/epic03/wrapper.htm?arnumber=6866038},
912+
volume = {16},
913+
year = {2014}
914+
}
915+
@article{Kirchmair2015,
916+
author = {Kirchmair, Johannes and G{\"{o}}ller, Andreas H. and Lang, Dieter and Kunze, Jens and Testa, Bernard and Wilson, Ian D and Glen, Robert C and Schneider, Gisbert},
917+
doi = {10.1038/nrd4581},
918+
issn = {1474-1776},
919+
journal = {Nat. Rev. Drug Discov.},
920+
number = {6},
921+
pages = {387--404},
922+
publisher = {Nature Publishing Group},
923+
title = {{Predicting drug metabolism: experiment and/or computation?}},
924+
url = {http://dx.doi.org/10.1038/nrd4581},
925+
volume = {14},
926+
year = {2015}
927+
}
928+
@article{Sresht2017,
929+
author = {Sresht, Vishnu and Lewandowski, Eric P. and Blankschtein, Daniel and Jusuf, Arben},
930+
doi = {10.1021/acs.langmuir.7b01073},
931+
journal = {Langmuir},
932+
pages = {8319−8329},
933+
title = {{Combined Molecular Dynamics Simulation–Molecular-Thermodynamic Theory Framework for Predicting Surface Tensions}},
934+
url = {https://pubs.acs.org/doi/abs/10.1021/acs.langmuir.7b01073{\#}},
935+
volume = {33},
936+
year = {2017}
937+
}
938+
@article{Nussinov2014,
939+
author = {Nussinov, Ruth},
940+
doi = {10.1371/journal.pcbi.1003423},
941+
file = {:Users/hbmayes/bee/literature/MDSuccess/2014Nussinov{\_}Sig2013Nobel.pdf:pdf},
942+
journal = {PLoS Comput. Biol.},
943+
mendeley-groups = {**Mobley},
944+
number = {1},
945+
pages = {2013--2014},
946+
title = {{The Significance of the 2013 Nobel Prize in Chemistry and the Challenges Ahead}},
947+
url = {http://journals.plos.org/ploscompbiol/article?id=10.1371/journal.pcbi.1003423},
948+
volume = {10},
949+
year = {2014}
950+
}
951+
@article{Bottaro2018,
952+
author = {Bottaro, Sandro and Lindorff-Larsen, Kresten},
953+
file = {:Users/hbmayes/bee/literature/MDSuccess/2018Bottaro{\_}BioExpSim.pdf:pdf},
954+
journal = {Science (80-. ).},
955+
mendeley-groups = {Reference},
956+
pages = {355--360},
957+
title = {{Biophysical experiments and biomolecular simulations: A perfect match?}},
958+
url = {http://science.sciencemag.org/content/361/6400/355/tab-pdf},
959+
volume = {360},
960+
year = {2018}
961+
}
962+
@book{Jensen2007,
963+
address = {West Sussex, England},
964+
author = {Jensen, Frank},
965+
edition = {Second},
966+
isbn = {9780470011867},
967+
publisher = {John Wiley {\&} Sons},
968+
title = {{Introduction to Computational Chemistry}},
969+
year = {2007}
970+
}

paper/basic_training.tex

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@
3939

4040
\author[1]{Efrem Braun}
4141
\author[2]{Justin Gilmer}
42-
\author[3]{Heather Mayes}
42+
\author[3]{Heather B. Mayes}
4343
\author[4]{David L. Mobley}
4444
\author[5]{Jacob I. Monroe}
4545
\author[6]{Samarjeet Prasad}
@@ -48,7 +48,7 @@
4848
%\author[2*]{Firstname Surname}
4949
\affil[1]{University of California, Berkeley}
5050
\affil[2]{Vanderbilt University}
51-
\affil[3]{University of Michigan}
51+
\affil[3]{University of Michigan, Ann Arbor}
5252
\affil[4]{University of California, Irvine}
5353
\affil[5]{University of California, Santa Barbara}
5454
\affil[6]{National Institutes of Health}
@@ -98,23 +98,23 @@ \section{Introduction}
9898
\label{sec:intro}
9999

100100
Molecular simulation techniques play a very important role in our quest to understand and predict the properties, structure, and function of molecular systems, and are a key tool as we seek to enable predictive molecular design.
101-
Simulation methods are extremely useful for studying the structure and dynamics of complex systems that are too complicated for pen and paper theory and helping interpret experimental data in terms of molecular motions, as well as (increasingly) for quantitative prediction of properties of use in molecular design and other applications.
101+
Simulation methods are extremely useful for studying the structure and dynamics of complex systems that are too complicated for pen and paper theory and helping interpret experimental data in terms of molecular motions, as well as (increasingly) for quantitative prediction of properties of use in molecular design and other applications~\cite{Nussinov2014,Towns2014,Kirchmair2015,Sresht2017,Bottaro2018}.
102102

103-
The basic idea of any molecular simulation method is quite simple; a particle-based description of the system under investigation is constructed and then the system is propagated by either deterministic or probabilistic rules to generate a trajectory describing its evolution over the course of the simulation.
103+
The basic idea of any molecular simulation method is straightforward; a particle-based description of the system under investigation is constructed and then the system is propagated by either deterministic or probabilistic rules to generate a trajectory describing its evolution over the course of the simulation~\cite{Frenkel:2001:,2001Leach}.
104104
Relevant properties can be calculated for each ``snapshot'' (a stored configuration of the system, also called a ``frame'') and averaged over the the entire trajectory to compute estimates of desired properties.
105105

106106
Depending on how the system is propagated, molecular simulation methods can be divided into two main categories: Molecular Dynamics (MD) and Monte Carlo (MC).
107-
With MD methods, the equation of motion is numerically integrated and a dynamical trajectory of the system is generated.
107+
With MD methods, the equations of motion are numerically integrated to generate a dynamical trajectory of the system.
108108
MD simulations can be used for investigating structural, dynamic, and thermodynamic properties of the system.
109109
With MC methods, probabilistic rules are used to generate a new configuration from the present configuration and this process is repeated to generate a sequence of states that can be used to calculate structural and thermodynamic properties but not dynamical properties; indeed, MC simulations lack any concept of time.
110-
Thus, the ``dynamics'' produced by an MC method are not the temporal dynamics of the system.
110+
Thus, the ``dynamics'' produced by an MC method are not the temporal dynamics of the system, but the ensemble of configurations that reflect those that could be dynamically sampled.
111111
This foundational document will focus on the concepts needed to carry out correct MD simulations that utilize good practices.
112-
Many, but not all, of the concepts here are also useful for MC simulations and apply there as well, but MC as a whole needs its own document.
112+
Many, but not all, of the concepts here are also useful for MC simulations and apply there as well. However, there are a sufficient number of key differences, which are outside the scope of this current document.
113113

114114
Either method can be carried out with different underlying physical theories to describe the particle-based model of the system under investigation.
115-
If a quantum mechanics (QM) description of matter is used, electrons are explicitly represented in the model and interaction energy is calculated by solving the electronic structure of the molecules in the system with no (or few) empirical parameters, but with various approximations to the physics for tractability.
116-
In a classical description, the molecules are represented by particles representing atoms or groups of atoms. Each atom may be assigned an electric charge and a potential energy function with a large number of empirical parameters (fitted to experiment, QM, or other data) is used to calculate non-bonded as well bonded interactions.
117-
Classical simulations are much faster than quantum simulations, making them the methods of choice for vast majority of molecular simulation studies on biomolecular systems in the condensed phase.
115+
If a quantum mechanics (QM) description of matter is used, electrons are explicitly represented in the model and interaction energy is calculated by solving the electronic structure of the molecules in the system with no (or few) empirical parameters, but with various approximations to the physics for tractability.
116+
In a molecular mechanics (MM) description, the molecules are represented by particles representing atoms or groups of atoms. Each atom may be assigned an electric charge and a potential energy function with a large number of empirical parameters (fitted to experiment, QM, or other data) used to calculate non-bonded and bonded interactions. Unless otherwise specified, MD simulations employ MM force fields, which calculate the forces that determine the system dynamics.
117+
MM simulations are much faster than quantum simulations, making them the methods of choice for vast majority of molecular simulation studies on biomolecular systems in the condensed phase.
118118
%\todo[inline, color={red!20}]{Put in a few-sentence discussion re the size \& timescales of systems and the appropriate method; perhaps like the images often in papers; what are typical sizes and timescales that are tractable? This of course changes with time, but this is a living document so we're good. Also add in general, that the topology does not change--most FF do not allow chemical reactions}
119119

120120
Speed is a particular concern when describing condensed phase systems, as we are often interested in the properties of molecules (even biomacromolecules) in solution, meaning that systems will consist of thousands to hundreds of thousands or millions of atoms.
@@ -282,7 +282,7 @@ \subsubsection{Key concepts}
282282
The key dynamical concept to understand is embodied in the twin characteristics of timescales and rates.
283283
The two are literally reciprocals of one another.
284284
In Fig.\ \ref{landscapes}(a), assume you have started an MD simulation in basin A.
285-
The trajectory is likely to remain in that basin for a period of time -- the dwell timescale -- which increases exponentially with the barrier height according to the (reciprocal) Arrhenius factor as $\exp[(U^\ddagger - U_A)/k_B T]$; barriers many times the thermal energy $k_BT$ imply long dwells.
285+
The trajectory is likely to remain in that basin for a period of time -- the ``dwell'' timescale -- which increases exponentially with the barrier height according to the (reciprocal) Arrhenius factor as $\exp[(U^\ddagger - U_A)/k_B T]$; barriers many times the thermal energy $k_BT$ imply long dwells.
286286
The rate $k_{AB}$, which is the transition probability per unit time, exhibits reciprocal behavior -- i.e., $k_{AB} \sim \exp[-(U^\ddagger - U_A)/k_B T]$ according to the traditional Arrhenius factor.
287287
Note that all transitions occur in a random, \emph{stochastic} fashion and are not predictable except in terms of average behavior.
288288
More detailed discussions of rate constants can be found in numerous textbooks (e.g.,~\cite{DillBook, Zuckerman:2010:}).
@@ -320,7 +320,7 @@ \subsubsection{Books}
320320

321321
Books which we recommend as particularly helpful in this area include:
322322
\begin{itemize}
323-
\item Reif's ``Fundamentals of Statistical and Thermal Physics''~\ref{Reif:2008:}
323+
\item Reif's ``Fundamentals of Statistical and Thermal Physics''~\ref{Reif:2009:}
324324
\item McQuarrie ``Statistical Mechanics''~\cite{McQuarrie:2000:}
325325
\item Dill and Bromberg's ``Molecular Driving Forces''~\cite{DillBook}
326326
\item Hill's ``Statistical Mechanics: Principles and Selected Applications''~\cite{Hill:1987:}
@@ -564,7 +564,7 @@ \subsection{Main steps of a molecular dynamics simulation}
564564
\item Production
565565
\end{enumerate}
566566

567-
Additional explanations of these steps along with procedural details specific to a given simulation package and application may be found in a variety of tutorials \citep{LemkulTutorials, AmberBeginner}.
567+
Additional explanations of these steps along with procedural details specific to a given simulation package and application may be found in a variety of tutorials~\cite{LemkulTutorials,AmberBeginner}.
568568
It should be noted that these steps may be difficult to unambiguously differentiate and define in some cases.
569569
Additionally, it is assumed that prior to performing any of these steps, an appropriate amount of deliberation has been devoted to clearly defining the system and determining the appropriate simulation techniques.
570570

@@ -711,7 +711,7 @@ \subsubsection{Popular Thermostats}
711711
This is accomplished by modifying the force calculation with the form $F = F_{interaction} + F_{constraint}$, where $F_{interaction}$ is the standard interactions calculated during the course of the simulation and $F_{constraint}$ is a Lagrange multiplier that keeps the kinetic energy constant.
712712
The reasoning for the naming of this thermostat is due to its use of the Gaussian principle of least constraint to determine the smallest perturbative forces needed to maintain the instantaneous temperature\cite{thermostatAlgorithms2005}.
713713
Clearly, this thermostat does not sample the canonical distribution; it instead samples the isokinetic (constant kinetic energy) ensemble.
714-
However, the isokinetic ensemble samples the same configurational phase space as the canonical ensemble, so position-dependent (structural) equilibrium properties can be obtained equivalently with either ensemble\cite{Minary:2003:JChemPhys:Algorithms}.
714+
However, the isokinetic ensemble samples the same configurational phase space as the canonical ensemble, so position-dependent (structural) equilibrium properties can be obtained equivalently with either ensemble\cite{Minary:2003:JChemPhysAlgorithms}.
715715
However, velocity-dependent (dynamical) properties will not be equivalent between the ensembles.
716716
This thermostat is generally only used in certain advanced applications\cite{Minary:2002:JChemPhysAlgorithms}.
717717

@@ -720,14 +720,14 @@ \subsubsection{Popular Thermostats}
720720
The simple velocity rescaling thermostat is one of the easiest thermostats to implement; however, this thermostat is also one of the most non-physical thermostats.
721721
This thermostat relies on rescaling the momenta of the particles such that the simulation's instantaneous temperature exactly matches the target temperature\cite{thermostatAlgorithms2005}.
722722
Similarly to the Gaussian thermosat, simple velocity rescaling aims to sample the isokinetic ensemble rather than the canonical ensemble.
723-
However, it has been shown that the sample velocity rescaling fails to properly sample the isokinetic ensemble except in the limit of extremely small timesteps\cite{Braun:2018:arXiv:Anomalous}.
724-
Its usage can lead to simulation artifacts, so it is not recommended\cite{Harvey:1998:JCompChem,Braun:2018:arXiv:Anomalous}.
723+
However, it has been shown that the sample velocity rescaling fails to properly sample the isokinetic ensemble except in the limit of extremely small timesteps\cite{Braun:2018}.
724+
Its usage can lead to simulation artifacts, so it is not recommended\cite{Harvey:1998:JCompChem,Braun:2018}.
725725

726726
\item \textbf{Berendsen}
727727

728728
The Berendsen\cite{berendsen1984molecular} thermostat (also known as the weak coupling thermostat) is similar to the simple velocity rescaling thermostat, but instead of rescaling velocities completely and abruptly to the target kinetic energy, it includes a relaxation term to allow the system to more slowly approach the target.
729729
Although the Berendsen thermostat allows for temperature fluctuations, it samples neither the canonical distribution nor the isokinetic distribution.
730-
Its usage can lead to simulation artifacts, so it is not recommended\cite{Harvey:1998:JCompChem,Braun:2018:arXiv}.
730+
Its usage can lead to simulation artifacts, so it is not recommended\cite{Harvey:1998:JCompChem,Braun:2018}.
731731

732732
\item \textbf{Bussi-Donadio-Parrinello (Canonical Sampling through Velocity Rescaling)}
733733

0 commit comments

Comments
 (0)