Nucleophile Substitution CH3Cl - Standard MD: Difference between revisions

From VASP Wiki
 
(51 intermediate revisions by the same user not shown)
Line 41: Line 41:
  {{TAGBL|ALGO}}=VeryFast
  {{TAGBL|ALGO}}=VeryFast
  {{TAGBL|ISMEAR}}=-1
  {{TAGBL|ISMEAR}}=-1
  {{TAGBL|SIGMA}}=0.0258
  {{TAGBL|SIGMA}}=0.0516
   
   
  ############################# MD setting #####################################
  ############################# MD setting #####################################
Line 47: Line 47:
  {{TAGBL|NSW}}=1000                                          # number of steps
  {{TAGBL|NSW}}=1000                                          # number of steps
  {{TAGBL|POTIM}}=1                                            # integration step
  {{TAGBL|POTIM}}=1                                            # integration step
  {{TAGBL|TEBEG}}=300                                         # simulation temperature
  {{TAGBL|TEBEG}}=600                                         # simulation temperature
  {{TAGBL|MDALGO}}=11                                          # metaDynamics with Andersen thermostat
  {{TAGBL|MDALGO}}=11                                          # metaDynamics with Andersen thermostat
  {{TAGBL|ANDERSEN_PROB}}=0.10                                # collision probability
  {{TAGBL|ANDERSEN_PROB}}=0.10                                # collision probability
Line 54: Line 54:
*Molecular dynamics are switched on by the tag {{TAGBL|IBRION}}=0.   
*Molecular dynamics are switched on by the tag {{TAGBL|IBRION}}=0.   
*The metadynamics tag {{TAG|MDALGO}}=11 is only used to monitor the two C-Cl distances defined in the {{TAG|ICONST}} file.   
*The metadynamics tag {{TAG|MDALGO}}=11 is only used to monitor the two C-Cl distances defined in the {{TAG|ICONST}} file.   
*Simulations are carried out in the {{TAG|NVT ensemble}} at approximately room temperature ({{TAG|TEBEG}}=300) and the Anderson thermostat is used for the temperature control. The strength of the coupling is controlled by the collision probability {{TAG|ANDERSEN_PROB}}=0.10.
*Simulations are carried out in the {{TAG|NVT ensemble}} at approximately room temperature ({{TAG|TEBEG}}=300) and the {{TAG|Andersen thermostat}} is used for the temperature control. The strength of the coupling is controlled by the collision probability {{TAG|ANDERSEN_PROB}}=0.10.
*The accuracy of this calculation is kept low ({{TAG|PREC}}=Low and {{TAG|ALGO}}=VeryFast), which is completely sufficient for this tutorial. For more quantitative results this tags should be changed (of course at the cost of higher computational demand).
*The accuracy of this calculation is kept low ({{TAG|PREC}}=Low and {{TAG|ALGO}}=VeryFast), which is completely sufficient for this tutorial. For more quantitative results this tags should be investigated (of course at the cost of higher computational demand).
*A charged system (due to the "incoming" Cl<sup>-</sup>) is simulated, so the number of electrons is raised by one compared to the neutral system ({{TAG|NELECT}}=22). To compensate for the charge a positive homogeneous background charge is assumed.
*A charged system (due to the "incoming" Cl<sup>-</sup>) is simulated, so the number of electrons is raised by one compared to the neutral system ({{TAG|NELECT}}=22). To compensate for the charge a positive homogeneous background charge is assumed.
*Although very light atoms are present in the structure (hydrogen) a time step of 1 fs ({{TAG|POTIM}}=1) is safe to use. This can be achieved by setting the mass of hydrogen to that of tritium (look for the line "POMASS =    3.016" in the {{TAG|POTCAR}} file). This is unproblematic since the free energy is independent of the mass of atoms.
*Although very light atoms are present in the structure (hydrogen) a time step of 1 fs ({{TAG|POTIM}}=1) is safe to use. This can be achieved by setting the mass of hydrogen to that of tritium (look for the line "POMASS =    3.016" in the {{TAG|POTCAR}} file). This is unproblematic since the free energy is independent of the mass of atoms.
Line 67: Line 67:
*Second line: Same as the first line but interatomic distance between the first (C) and the sixth atom (Cl) in the {{TAG|POSCAR}} file is selected.
*Second line: Same as the first line but interatomic distance between the first (C) and the sixth atom (Cl) in the {{TAG|POSCAR}} file is selected.
*Third line: This line selects a linear combination (option S) of the first two coordinates where the second and fourth column specify the coefficients of the coordinates. The setting of 1 and -1 corresponds to the difference between both. The 7 at the fourth entry specifies that difference between these two distances is monitored but no constraints are applied.
*Third line: This line selects a linear combination (option S) of the first two coordinates where the second and fourth column specify the coefficients of the coordinates. The setting of 1 and -1 corresponds to the difference between both. The 7 at the fourth entry specifies that difference between these two distances is monitored but no constraints are applied.
== Calculation ==
A parameter that approximates the reaction coordinate, the difference between two C-Cl distances, will be monitored. Expected values for reactant: <math>\approx 1 \AA</math>, for product: <math>~-1 \AA</math>, for transition state: <math> 0 \AA </math>.
=== Running the calculation ===
The mass for hydrogen in this example is set 3.016 a.u. corresponding to the tritium isotope. This way larger timesteps can be chosen for the MD.
For practical reasons, we split our (pressumably long) molecular dynamics calculation into shorter runs of lengths of 1000 fs ({{TAG|NSW}}=1000 and {{TAG|POTIM}}=1). At the end of each run the {{TAG|CONTCAR}} file is copied to the {{TAG|POSCAR}} so that the simulation continues in a seamless manner. All of this is done by the script ''run'' provided with this example:
#!/bin/bash
runvasp="mpirun -np 8 executable_path/vasp_gam"
# make sure to always start with the same structure
cp POSCAR.init POSCAR
i=1
while [ $i -le 50 ]
do
  # start vasp
  $runvasp
  # use the last configuration generated in the previous
  # run as initial configuration for the next run
  cp CONTCAR POSCAR
  # backup some important files
  cp REPORT REPORT.$i
  cp vasprun.xml vasprun.xml.$i
  let i=i+1
done
*The user has to adjust the ''runvasp'' variable, which holds the command for the executable command.
*Please run this script by typing:
bash ./run
After the execution we should obtain 50 output files. Each contains a 1000 fs run totalling to a trajectory of 50 ps. It should be mentioned that this can take several hours on 8 cores so if the user has only limited time and resources available or is only interested to learn the execution of this example the number of runs (line "[ $i -le 50 ]") can be changed from 50 to a smaller value. Also the number of timesteps per run can be lowered ({{TAG|NSW}}).
=== Time evolution of distance ===
*The monitored value of the distance between the two Cl<sup>-</sup> ions defined in the {{TAG|ICONST}} file is written for each molecular dynamics run to the {{TAG|REPORT}} file written as "mc = ...". The time evolution function of this variable is monitored using the script timeEv.sh:
#!/bin/bash
if test -f "timeEvol.dat"; then
    rm timeEvol.dat
fi
i=1
while [ $i -le 1000 ]
do
    if test -f REPORT.$i
    then
      grep mc REPORT.$i |awk '{print $3 }' >>timeEvol.dat
    fi
    let i=i+1
done
To execute this script type:
bash timeEv.sh
It creates a file "timeEvol.dat" holding the value for the collective variable at every molecular dynamics step.
*After that the task is to get a histogram (or probability distribution) of the data. The user should try to write a script for itself. Otherwise the script ''probability_distribution_function.py'' can be used:
#!/usr/bin/python
import sys
import re
import math
#setting grid for histogram
xmin=0.0
xmax=5.0
nx=500
dx=(xmax-xmin)/nx
histogram=[0.0 for j in range(0,nx)]
readfile = open("timeEvol.dat","r")
line=readfile.readline()
z=0
ymin=0.0
ymax=0.0
#loop over lines in file timeEvol.dat
while (line):
  z=z+1
  line.strip()
  line=re.sub('^',' ',line)
  y=line.split()
  if (z==1):
      ymin=float(y[0])
      ymax=float(y[0])
  #calculate min max value for normalization
  if (ymin>float(y[0])):
      ymin=float(y[0])
  if (ymax<float(y[0])):
      ymax=float(y[0])
  #calculate index of argument
  ix=int(float(y[0])/float(dx)+0.5)
  #check for segmentation fault
  if (ix>=0 and ix<nx):
      histogram[ix]=histogram[ix]+1.0
  line=readfile.readline()
readfile.close
#normalizing and printing histogram
norm=z*(abs(xmax-xmin))/nx
for ix in range(0,nx):
    x=xmin+ix*dx
    pair_cor=histogram[ix]/norm
    print x, pair_cor
To execute this script type:
python probability_distribution_function.py > histogram_600K.dat
To plot the histogram the user should use his favourite program. Alternatively the histogram is plotted using gnuplot:
gnuplot -e "set terminal jpeg; set xlabel 'r(Ang)'; set ylabel 'PCF'; set style data lines; plot 'histogram_600K.dat'" > histogram_600K.jpg
The obtained histogram should look like the following:
[[File:Histogram 600K.jpg|300px]]
*The user should also calculate the mean value and variance of the Cl<sup>-</sup>-Cl<sup>-</sup> distance. It is recommended to the user to try to write an own script/program doing that. Otherwise the script ''average_and_standard_deviation.py'' can be used:
#!/usr/bin/python
import sys
import re
import math
data=[]
readfile = open("timeEvol.dat","r")
line=readfile.readline()
z=0
mean=0.0
standard_deviation=0.0
#loop over lines in file timeEvol.dat
while (line):
  z=z+1
  line.strip()
  line=re.sub('^',' ',line)
  y=line.split()
  #calculate mean
  mean=mean+float(y[0])
  #save data for later
  data.append(float(y[0]))
  line=readfile.readline()
readfile.close
#calculate mean
mean=mean/z
#calculate
for y in data:
    standard_deviation=standard_deviation+(y-mean)**2.0
standard_deviation=(standard_deviation/z)**0.5
print "Mean :",mean
print "Standard devation :",standard_deviation
To execute this script type:
python average_and_standard_deviation.py
The calculated mean value and standard deviation should be around 1.5986 <math>\AA</math> and 0.3403 <math>\AA</math>.
'''Exercise: Did the Cl<sup>-</sup> ever visit the product's region during this MD?'''
=== Higher temperature - 1000 K ===
After that we rerun the calculation at 1000 K and perform the same analysis steps as above. We should obtain a histogram at 1000 K that looks like the following:
[[File:Histogram 1000K.jpg|300px]]
The calculated mean value and standard deviation should be around 2.01023596 <math>\AA</math> and 0.664687047095 <math>\AA</math>.
'''Exercise: Explain the difference at higher temperature!'''
== Download ==
[[Media:CH3Cl_standard_Molecular_Dynamics.tgz| CH3Cl_standard_Molecular_Dynamics.tgz]]
{{Template:Molecular dynamics - Tutorial}}
[[Category:Examples]]

Latest revision as of 09:44, 14 November 2019

Task

The main task of this example is to learn how to monitor distances on the example of a nucleophile substitution of a Cl- by another Cl- in CH3Cl.

Input

POSCAR

CH3Cl                                         
   1.00000000000000     
    12.0000000000000000    0.0000000000000000    0.0000000000000000
     0.0000000000000000   12.0000000000000000    0.0000000000000000
     0.0000000000000000    0.0000000000000000   12.0000000000000000 
C H Cl
   1   3   2
cart
         5.91331371  7.11364924  5.78037960
         5.81982231  8.15982106  5.46969017
         4.92222130  6.65954232  5.88978969
         6.47810398  7.03808479  6.71586385
         4.32824726  8.75151396  7.80743202
         6.84157897  6.18713289  4.46842049
  • The starting POSCAR file for this example can be found under POSCAR.init. It will be needed for the script that runs the job (run.sh).
  • A sufficiently large cell is chosen to minimize the interactions between neighbouring cells and hence to simulate an isolated molecular reaction.

KPOINTS

Automatic
 0
Gamma
 1  1  1
 0. 0. 0.
  • For isolated atoms and molecules interactions between periodic images are negligible (in sufficiently large cells) hence no Brillouin zone sampling is necessary.

INCAR

PREC=Low
EDIFF=1e-6
LWAVE=.FALSE.
LCHARG=.FALSE.
NELECT=22
NELMIN=4
LREAL=.FALSE.
ALGO=VeryFast
ISMEAR=-1
SIGMA=0.0516

############################# MD setting #####################################
IBRION=0                                           # MD simulation
NSW=1000                                           # number of steps
POTIM=1                                            # integration step
TEBEG=600                                          # simulation temperature
MDALGO=11                                          # metaDynamics with Andersen thermostat
ANDERSEN_PROB=0.10                                 # collision probability
##############################################################################
  • Molecular dynamics are switched on by the tag IBRION=0.
  • The metadynamics tag MDALGO=11 is only used to monitor the two C-Cl distances defined in the ICONST file.
  • Simulations are carried out in the NVT ensemble at approximately room temperature (TEBEG=300) and the Andersen thermostat is used for the temperature control. The strength of the coupling is controlled by the collision probability ANDERSEN_PROB=0.10.
  • The accuracy of this calculation is kept low (PREC=Low and ALGO=VeryFast), which is completely sufficient for this tutorial. For more quantitative results this tags should be investigated (of course at the cost of higher computational demand).
  • A charged system (due to the "incoming" Cl-) is simulated, so the number of electrons is raised by one compared to the neutral system (NELECT=22). To compensate for the charge a positive homogeneous background charge is assumed.
  • Although very light atoms are present in the structure (hydrogen) a time step of 1 fs (POTIM=1) is safe to use. This can be achieved by setting the mass of hydrogen to that of tritium (look for the line "POMASS = 3.016" in the POTCAR file). This is unproblematic since the free energy is independent of the mass of atoms.

ICONST

For this example an ICONST file is used which looks like:

R 1 5 0
R 1 6 0
S 1 -1 7
  • First line: This line selects the interatomic distance (R) between the first (C) and the fifth atom (Cl) in the POSCAR file. The 0 at the fourth entry would usually specify that the distances are constrained but if the coordinates are used later for special coordinates the constraining is not applied (for further information see ICONST).
  • Second line: Same as the first line but interatomic distance between the first (C) and the sixth atom (Cl) in the POSCAR file is selected.
  • Third line: This line selects a linear combination (option S) of the first two coordinates where the second and fourth column specify the coefficients of the coordinates. The setting of 1 and -1 corresponds to the difference between both. The 7 at the fourth entry specifies that difference between these two distances is monitored but no constraints are applied.

Calculation

A parameter that approximates the reaction coordinate, the difference between two C-Cl distances, will be monitored. Expected values for reactant: , for product: , for transition state: .

Running the calculation

The mass for hydrogen in this example is set 3.016 a.u. corresponding to the tritium isotope. This way larger timesteps can be chosen for the MD. For practical reasons, we split our (pressumably long) molecular dynamics calculation into shorter runs of lengths of 1000 fs (NSW=1000 and POTIM=1). At the end of each run the CONTCAR file is copied to the POSCAR so that the simulation continues in a seamless manner. All of this is done by the script run provided with this example:

#!/bin/bash

runvasp="mpirun -np 8 executable_path/vasp_gam"

# make sure to always start with the same structure
cp POSCAR.init POSCAR

i=1

while [ $i -le 50 ] 
do
  # start vasp
  $runvasp

  # use the last configuration generated in the previous
  # run as initial configuration for the next run
  cp CONTCAR POSCAR

  # backup some important files
  cp REPORT REPORT.$i
  cp vasprun.xml vasprun.xml.$i

  let i=i+1
done
  • The user has to adjust the runvasp variable, which holds the command for the executable command.
  • Please run this script by typing:
bash ./run

After the execution we should obtain 50 output files. Each contains a 1000 fs run totalling to a trajectory of 50 ps. It should be mentioned that this can take several hours on 8 cores so if the user has only limited time and resources available or is only interested to learn the execution of this example the number of runs (line "[ $i -le 50 ]") can be changed from 50 to a smaller value. Also the number of timesteps per run can be lowered (NSW).

Time evolution of distance

  • The monitored value of the distance between the two Cl- ions defined in the ICONST file is written for each molecular dynamics run to the REPORT file written as "mc = ...". The time evolution function of this variable is monitored using the script timeEv.sh:
#!/bin/bash 

if test -f "timeEvol.dat"; then
   rm timeEvol.dat
fi

i=1
while [ $i -le 1000 ]
do
   if test -f REPORT.$i
   then
     grep mc REPORT.$i |awk '{print $3 }' >>timeEvol.dat
   fi
   let i=i+1
done

To execute this script type:

bash timeEv.sh

It creates a file "timeEvol.dat" holding the value for the collective variable at every molecular dynamics step.


  • After that the task is to get a histogram (or probability distribution) of the data. The user should try to write a script for itself. Otherwise the script probability_distribution_function.py can be used:
#!/usr/bin/python

import sys
import re
import math

#setting grid for histogram
xmin=0.0
xmax=5.0
nx=500
dx=(xmax-xmin)/nx
histogram=[0.0 for j in range(0,nx)]
readfile = open("timeEvol.dat","r")
line=readfile.readline()
z=0
ymin=0.0
ymax=0.0
#loop over lines in file timeEvol.dat
while (line):
  z=z+1
  line.strip()
  line=re.sub('^',' ',line)
  y=line.split()
  if (z==1):
     ymin=float(y[0])
     ymax=float(y[0])
  #calculate min max value for normalization
  if (ymin>float(y[0])):
     ymin=float(y[0])
  if (ymax<float(y[0])):
     ymax=float(y[0])
  #calculate index of argument
  ix=int(float(y[0])/float(dx)+0.5)
  #check for segmentation fault
  if (ix>=0 and ix<nx):
     histogram[ix]=histogram[ix]+1.0
  line=readfile.readline()
readfile.close
#normalizing and printing histogram
norm=z*(abs(xmax-xmin))/nx
for ix in range(0,nx):
   x=xmin+ix*dx
   pair_cor=histogram[ix]/norm
   print x, pair_cor

To execute this script type:

python probability_distribution_function.py > histogram_600K.dat

To plot the histogram the user should use his favourite program. Alternatively the histogram is plotted using gnuplot:

gnuplot -e "set terminal jpeg; set xlabel 'r(Ang)'; set ylabel 'PCF'; set style data lines; plot 'histogram_600K.dat'" > histogram_600K.jpg

The obtained histogram should look like the following:

  • The user should also calculate the mean value and variance of the Cl--Cl- distance. It is recommended to the user to try to write an own script/program doing that. Otherwise the script average_and_standard_deviation.py can be used:
#!/usr/bin/python

import sys
import re
import math

data=[]
readfile = open("timeEvol.dat","r")
line=readfile.readline()
z=0
mean=0.0
standard_deviation=0.0
#loop over lines in file timeEvol.dat
while (line):
  z=z+1
  line.strip()
  line=re.sub('^',' ',line)
  y=line.split()
  #calculate mean
  mean=mean+float(y[0])
  #save data for later
  data.append(float(y[0]))
  line=readfile.readline()
readfile.close
#calculate mean
mean=mean/z
#calculate 
for y in data:
   standard_deviation=standard_deviation+(y-mean)**2.0
standard_deviation=(standard_deviation/z)**0.5
print "Mean :",mean
print "Standard devation :",standard_deviation

To execute this script type:

python average_and_standard_deviation.py

The calculated mean value and standard deviation should be around 1.5986 and 0.3403 .

Exercise: Did the Cl- ever visit the product's region during this MD?

Higher temperature - 1000 K

After that we rerun the calculation at 1000 K and perform the same analysis steps as above. We should obtain a histogram at 1000 K that looks like the following:

The calculated mean value and standard deviation should be around 2.01023596 and 0.664687047095 .

Exercise: Explain the difference at higher temperature!

Download

CH3Cl_standard_Molecular_Dynamics.tgz