Ilia A. Solov’yov, Gennady Sushko and Andrey V. Solov’yov MBN Explorer Users’ Guide Version 3.0 Ilia A. Solov'yov Department of Physics, Chemistry and Pharmacy University of Southern Denamrk Odense, Denmark Gennady Sushko MBN Research Center gGmbH Frankfurt, Germany Andrey V. Solov'yov MBN Research Center gGmbH Frankfurt, Germany MesoBioNano Science Publishing ⃝c MBN Research Center gGmbH 2017. All rights reserved. This book is subject to a copyright agreement, where the Publisher reserves the rights of translation, copying, reprinting, advertising and reproduction of the whole book or its parts by physical, electronic or similar methodology developed by today or hereafter. The use of specic and general terms, abbreviates, descriptive and registered names, trade and service marks, included in this book does not imply that such names are exempt from the relevant protective laws and regulations and therefore free for general use. The responsibility to inquire about such possibility is with the individual customer. The information provided in this book is true and accurate to the best knowledge of the publisher and the authors at the date of the publication. The publisher and the authors do not provide any warranty with respect to the material contained in this book or for any error or omissions that may have been made. The publisher and the authors do not take responsibility for any damages related to the use of the material contained in this book. The publisher remains neutral with regard to any jurisdictional claims in published maps and institutional aliations. The registered company is MBN Research Center gGmbH. The company address is Altenhöferallee 3, 60438 Frankfurt am Main, Germany. iii Preface The MBN Explorer Users' Guide describes how to install and to run MBN Ex- plorer, the software package for advanced multiscale simulations of complex molec- ular structure and dynamics. This guide includes the description of the main features and the algorithms of the program, the manual how to use the program for specic tasks, the description of all the program commands and keywords, the specica- tion of input information, parameters, les and formats, and instructions on how to handle the program on Windows, Linux/Unix and Macintosh platforms. MesoBioNano (MBN) Explorer is a multi-purpose software package for advanced multiscale simulations of complex molecular structure and dynamics. It has many unique features and a wide range of applications in Physics, Chemistry, Biology, Materials Science, and Industry. A broad variety of algorithms and interatomic potentials implemented in the program allows simulations of structure and dynamics of a broad range of systems with the sizes from the atomic up to the mesoscopic scales. MBN Explorer is being developed and distributed by MBN Research Center, www.mbnresearch.com, which organises hands-on tutorials for the software, user's workshops and conferences. The use of MBN Explorer for non-commercial purpose is granted through low price academic licenses. This licensing agreement is restricted to Universities and Research Centers aiming for scientic publication of their results. Reference to MBN Explorer in reports, publications, or communication mentioning research results obtained with the use of MBN Explorer is required. All details about terms and conditions are available on www.mbnresearch.com Accessible individual and multi-users license agreements are also oered for com- mercial exploitation of MBN Explorer. Purchased license rights provide access to • MBN Explorer software and its updates, • MBN Explorer documentation package, • MBN Explorer user's workshops. Special packages including education, dedicated hands-on training and helpdesk are also available. Contact us or visit our website www.mbnresearch.com for more details. Contents 1 Introduction 1 1.1 Features of MBN Explorer ..................... 1 1.2 MBN Explorer functionality .................... 3 1.3 Historical remarks ............................ 5 1.4 Terms and conditions .......................... 9 1.5 Third party terms and conditions ................... 19 1.5.1 VMD molle plugin ....................... 19 1.5.2 Mersenne twister ........................ 20 1.5.3 Kiss FFT ............................ 20 2 Getting Started 23 2.1 What is needed ............................. 23 2.2 MBN Explorer task le ....................... 23 2.2.1 Task le syntax ......................... 24 2.2.2 Required parameters ...................... 24 2.3 MBN Explorer task parameters . 24 2.3.1 General parameters ....................... 24 2.3.2 Input les ............................ 26 2.3.3 Output les and related parameters . 27 2.3.4 General numerical methods for interatomic interactions . 32 2.3.5 Ewald summation method for Coulomb interactions . 35 2.3.6 Fast particle mesh Ewald algorithm . 36 2.3.7 General molecular dynamics simulation . 38 2.3.8 Temperature control ...................... 39 2.3.9 Relativistic integrator related options . 40 2.3.10 Molecular mechanics and chemical reactions . 40 2.3.11 Structure optimization ..................... 41 2.3.12 Random walk dynamics .................... 43 v vi CONTENTS 2.3.13 Radiation spectrum calculation . 46 2.3.14 Multithreading ......................... 48 2.4 Executing program ........................... 48 2.4.1 Setting a calculation ...................... 49 2.4.2 License key usage ........................ 49 2.4.3 Automated testing ....................... 49 2.4.4 Binary version number ..................... 49 3 Input and Output Files 51 3.1 Input les ................................ 51 3.1.1 MBN Explorer structure le . 53 3.1.2 PDB le ............................. 58 3.1.3 Topology le .......................... 60 3.1.4 MBN Explorer potential le . 62 3.1.5 LAMMPS tabulated potential le . 65 3.1.6 CHARMM force eld potential le . 66 3.1.7 Dissociative CHARMM molecular mechanics potential . 71 3.1.8 System manipulation le .................... 72 3.1.9 Chemical rules le ....................... 73 3.1.10 Spectrum calculation les ................... 75 3.2 Output les ............................... 76 3.2.1 Output le ........................... 78 3.2.2 Log-le .............................. 85 3.2.3 Trajectory le .......................... 86 3.2.4 Chemical statistics le ..................... 88 3.2.5 Spectrum calculation les ................... 89 4 Energy and Force Calculation 93 4.1 Pairwise potentials ........................... 94 4.1.1 Power potential ......................... 95 4.1.2 Exponential potential ...................... 96 4.1.3 Coulomb potential ....................... 97 4.1.4 Soft Coulomb potential ..................... 99 4.1.5 Lennard-Jones potential .................... 99 4.1.6 Morse potential . 100 4.1.7 Girifalco potential . 102 4.1.8 Dzugutov potential . 103 4.1.9 Quasi Sutton-Chen potential . 105 4.1.10 Yukawa potential . 106 4.1.11 Moliere potential . 108 4.1.12 Pacios potential . 109 4.2 Many-body potentials . 110 4.2.1 Sutton-Chen potential . 112 CONTENTS vii 4.2.2 Gupta potential . 113 4.2.3 Finnis-Sinclair potential . 115 4.2.4 Brenner potential . 117 4.2.5 Terso potential . 121 4.2.6 Stillinger-Weber potential . 126 4.2.7 Tabulated EAM potential . 127 4.2.8 Ziegler Biersack Littmark potential . 128 4.3 Molecular mechanics potential . 128 4.4 Rupture of valence bonds . 135 4.4.1 Rupture of covalent bonds . 136 4.4.2 Rupture of valence angles . 138 4.4.3 Rupture of dihedral interactions . 140 4.5 External potentials . 142 4.5.1 Constant electric eld . 143 4.5.2 Viscous force . 144 4.5.3 Constant gravity eld . 144 5 Molecular Dynamics Simulations 145 5.1 The equations of motion . 146 5.1.1 Newton equations . 146 5.1.2 Relativistic equations of motion . 147 5.1.3 Euler equations . 147 5.1.4 The quaternions with an application to rigid body dynamics 151 5.2 Integration algorithms . 153 5.2.1 Velocity Verlet integrator . 153 5.2.2 Leapfrog integrator . 158 5.2.3 Runge-Kutta integrator for relativistic equations of motion . 159 5.3 Setting random initial velocities . 160 5.4 Energy control ............................. 161 5.5 Temperature control . 162 5.5.1 Velocity scaling (Berendsen thermostat) . 163 5.5.2 Langevin thermostat . 163 5.6 Momentum and angular momentum control . 164 5.7 User-dened particle manipulation . 165 5.8 Irradiation Driven Molecular Dynamics . 166 5.9 Simulation of chemical reactions . 168 6 Numerical Methods for Interatomic Interactions 171 6.1 Basic interaction approach . 172 6.2 Linked cell interaction approach . 174 6.3 Boundary conditions . 177 viii CONTENTS 6.3.1 Reective boundary conditions . 177 6.3.2 Periodic boundary conditions . 181 6.3.3 Dynamic boundary conditions . 183 6.4 Calculation of Coulomb interactions . 184 6.4.1 Ewald summation for long range interactions . 186 6.4.2 Ewald summation formula . 187 6.4.3 Fast particle mesh Ewald (PME) summation algorithm . 189 7 Energy Minimization Techniques 193 7.1 Velocity quenching . 194 7.2 Conjugate gradient method . 196 8 Monte Carlo based dynamics 201 8.1 Particle random walk dynamics . 201 8.1.1 Conventional KMC algorithm . 202 8.1.2 Computational core of random walk dynamics . 202 8.1.3 Particle dynamics on a lattice . 204 8.1.4 Accounting for interparticle interactions . 204 9 Radiation spectrum calculation 209 9.1 General theory ............................. 209 9.2 Calculation of Spectral-Angular Distribution . 211 9.3 Calculation of Spectral Distribution . 213 9.4 Running calculation . 213 10 Parallel processing of computations 215 10.1 OpenMP Multithreading . 215 10.2