Calculating the chemical shieldings: Difference between revisions

From VASP Wiki
 
(143 intermediate revisions by the same user not shown)
Line 1: Line 1:
Considerations for NMR calculations.
The chemical shielding tensor ''σ'' is the relation between the induced and external magnetic fields and describes how much the electrons shield the nuclei from an external field. The absolute chemical shielding is calculated by linear response using {{TAG|LCHIMAG}} {{Cite|pickard:prb:2001}}{{Cite|yates:prb:2007}}. The chemical shielding is directly related to the chemical shift ''δ'' recorded in nuclear magnetic resonance (NMR), cf. [[:Category:NMR|NMR category page]] and {{TAG|LCHIMAG}} page for details, and, indirectly, to the resonance frequency. The theory is covered in the [[:Category:NMR|NMR category page]] and {{TAG|LCHIMAG}} page.
{{NB|warning|The chemical shifts are calculated from the orbital magnetic response under the assumption that the system is an insulator. Smearing schemes intended for metals can generate nonsense.}}


There are several different options available to calculate NMR properties. It is possible to calculate the [[LCHIMAG|chemical shielding]], the [[LLRAUG|two-center contributions]], the [[LEFG|electric field gradient]], and the [[LHYPERFINE|hyperfine coupling constant]]. The theory is already covered in [[:Category:NMR|NMR category page]] and corresponding pages, so it will not be reiterated here.
==Step-by-step instructions==


For all of the tags used here, tighter convergence settings than is typical for a structure relaxation are required. No additional files are required beyond the four standard {{FILE|POSCAR}}, {{FILE|POTCAR}}, {{FILE|INCAR}}, and {{FILE|KPOINTS}}, unless specifically mentioned. It is important to have a well-converged structure. All of these calculations described below can be very sensitive to structure. For each of the following calculations, the NMR property is calculated post-SCF.
The chemical shielding is calculated post-self-consistent field (post-SCF) using {{TAG|LCHIMAG}}. A well-converged SCF calculation is therefore crucial. The chemical shielding is very sensitive to several input parameters that must all be independently tested.  


'''Step 1 (optional):''' Calculate the chemical shielding using a previously converged calculation


Since the chemical shielding is calculated post-SCF, you can use a previously converged {{FILE|WAVECAR}} with {{TAG|ISTART}} = 1 and {{TAG|NELM}} = 1. The corresponding density, {{TAG|CHGCAR}} is calculated from the {{FILE|WAVECAR}} file before the first elementary step so it need not be included.


*Write a concise introduction that states the aim and mentions the main keywords (link them).
'''Step 2 (optional):''' Determine a suitable energetic break value
*Write a section titled Step-by-step instructions that states all related tags and explains, e.g., how to set up a calculation. If there is a quantity specific to that calculation or specific output to the OUTCAR, this should be explained here.
*Write a section titled Recommendations and advice.
*If you can, separate the article further into sections with meaningful headings.
*Do not dive into theory!


The break condition for the self-consistency step {{TAG|EDIFF}} strongly influences the chemical shielding. A setting of {{TAG|EDIFF}} = 1E-8 eV is generally recommended. Convergence is taken to be within 0.1 ppm.


'''Step 3:''' Converge the plane-wave basis


A large plane-wave energy cutoff is required to fully converge the chemical shieldings. Perform multiple calculations while increasing the basis set size, as defined in {{TAG|ENCUT}}, incrementally (e.g., by 100 eV intervals). Convergence should be aimed to be within 0.1 ppm, although this will not be feasible for heavier elements.


==Chemical shielding==
'''Step 4:''' Converge the '''k''' point mesh


The chemical shielding tensor ''σ'' is calculated by linear response using {{TAG|LCHIMAG}}.
Similar to the basis, the '''k''' point mesh can strongly influence the chemical shielding. The '''k''' point mesh should be increased incrementally, i.e., 1x1x1, 2x2x2, 3x3x3, until convergence within 0.1 ppm is achieved. It is only necessary to converge the '''k''' point mesh for crystals, gas-phase molecules should use the Γ-point only.


A typical {{FILE|INCAR}} file requires a few specific settings:
'''Step 5:''' Compare to experiment
* A larger {{TAG|ENCUT}} value than is usually required, generally much higher than the value given by ENMAX in the {{FILE|POTCAR}} file.
* A small {{TAG|EDIFF}} is typically required to provide converged chemical shifts, e.g. <code>1E-8</code> eV.
* Tighter precision, e.g. {{TAG|PREC}} = Accurate.
* Non-spherical contributions to the gradient of the density inside PAW spheres, i.e. {{TAG|LASPH}} = .TRUE.


Two additional tags are unique to NMR calculations:
The purpose of these calculations is to compare to experiment. However, the calculated absolute chemical shieldings are not directly comparable to the measured chemical shift due to the lack of a reference. To avoid bias from any single calculation, a series of calculated and their corresponding experimental values are used. The experimental chemical shifts are plotted against the calculated chemical shieldings as is found in Fig. 3 of Ref. {{Cite|dewijs:laskowski:jcp:2017}}.
* {{TAG|LNMR_SYM_RED}} which ensure that all symmetry operations for the k-space derivatives are consistent when calculating chemical shifts.
* {{TAG|NLSPLINE}} which constructs PAW projectors in reciprocal space to ensure that they are k-deriviable.  


An example {{FILE|INCAR}} file is given below:
==Recommendations and advice==
Calculating the chemical shielding requires tightly converged settings. As described in the step-wise introduction above, converging with respect to {{TAG|EDIFF}}, {{TAG|ENCUT}}, and the '''k''' point mesh is very important. There are a few additional settings that should be considered.


<pre>
===PAW pseudopotentials===
ENCUT = 400              # Plane-wave energy cutoff in eV
The standard PAW pseudopotentials {{FILE|POTCAR}} used are sufficient for calculating the chemical shielding. The GIPAW is applied using the projector functions and partial waves that are stored in the regular {{FILE|POTCAR}} files. The completeness of these projector functions and partial waves determines the quality of the results. Using slightly different types of {{FILE|POTCAR}}, e.g., GW (''*_GW'') or with additional valence (''*_sv'', ''*_pv''), can change the calculated shielding by a few ppm for the first and second row ''sp''-bonded elements (except for H).  
ISMEAR = 0; SIGMA = 0.01 # Defines the type of smearing; smearing width in eV
EDIFF = 1E-8            # Energy cutoff criterion for the SCF loop, in eV
PREC = Accurate          # Sets the "precision" mode
LASPH = .TRUE.          # Non-spherical contributions to the gradient of the density in the PAW spheres
LCHIMAG = .TRUE.        # Turns on linear response for chemical shifts
LNMR_SYM_RED = .TRUE.   # Consistent symmetry with star and k-space derivatives
NLSPLINE = .TRUE.       # Differentiable projectors in reciprocal space
</pre>


For each system, it is important to test that the chemical shieldings calculated are converged with respect to {{TAG|ENCUT}}, {{TAG|EDIFF}}, and {{FILE|KPOINTS}} mesh. Convergence is typically to within 0.1 ppm.  
The PAW reconstruction with all-electron partial waves is crucial for calculating the field on the nucleus. It is therefore important to use a consistent exchange-correlation functional and so {{TAG|LEXCH}} in the {{FILE|POTCAR}} should not be overwritten with an explicit {{TAG|GGA}} tag in the {{FILE|INCAR}} if possible.


Something about output?
===Insufficient memory===
For calculating the chemical shieldings, speed had been favored over saving memory, resulting in insufficient memory occasionally. Since the linear response calculation is parallel over '''k''' points, this can be used to economize on memory by performing a regular SCF calculation at high accuracy on the full '''k''' point mesh and saving the {{FILE|CHGCAR}} file. Using <code>{{TAGBL|ICHARG}} = 11</code> start a chemical shielding calculation for each individual '''k''' point in the first Brillouin zone (IBZ) separately, starting from {{FILE|CHGCAR}}. The shieldings can then be calculated as a '''k''' point weighted average of the symmetrized shieldings of the individual '''k''' points.


== Electric field gradient ==
===Additional tags===
To ensure tight precision, the precision should be set to <code>{{TAGBL|PREC}} = Accurate</code>, rather than <code>Normal</code>.


The electric field gradient is calculated using {{TAG|LEFG}}. The same tight settings for chemical shielding are required, alongside a stronger dependence on the structure and the chosen {{FILE|POTCAR}} used:
Several additional {{FILE|INCAR}} tags should be considered. Specifically, {{TAG|LASPH}} should be set to <code>.TRUE.</code>, turning on the non-spherical contributions to the gradient of the density inside the PAW spheres. Occasionally, e.g. for systems containing H or first-row elements, and short bonds, the two-center contributions to the augmentation currents in the PAW spheres are important. In this case, {{TAG|LLRAUG}} = .TRUE. should be used {{Cite|dewijs:jcp:2013}}{{Cite|dewijs:jcp:2021}}.
{{NB|important|The treatment of the orbital magnetism is non-relativistic. This is suitable for light nuclei.
The standard POTCARs are scalar-relativistic and account partially for relativistic effects.
The accuracy can be improved using {{TAG|LBONE}}, which restores the small B-component of the wave function inside the PAW spheres.
Spin-orbit coupling is not implemented for chemical shift calculations.}}


* The structure is extremely important, so the experimental structure may sometimes be preferable to be used.  
=Example scripts for convergence tests=
* The use of PAW potentials has a strong influence. GW {{FILE|POTCAR}} files often improve.  
Several tests are necessary to obtain various NMR parameters. Make sure to change the example {{FILE|INCAR}} files to include the tags for your desired calculation. We provide some example scripts below:


There is one additional keyword that must be defined:
==Energetic break criterion tests==
* {{TAG|QUAD_EFG}} defines the isotope-specific quadrupole moment for each species in your {{FILE|POSCAR}} file.
For converging the energetic break criterion for a single ionic step ({{TAG|EDIFF}}), start with the 1E-4 and then increase by orders of magnitude:


A typical {{FILE|INCAR}} file is given below:
Energetic break criterion:
'''INCAR.nmr'''
{{TAGBL|PREC}} = Accurate       
{{TAGBL|ENCUT}} = 400.0         
{{TAGBL|EDIFF}} = 1E-4         
{{TAGBL|ISMEAR}} = 0; {{TAGBL|SIGMA}} = 0.1
{{TAGBL|LREAL}} = A            
{{TAGBL|LCHIMAG}} = .TRUE.     
{{TAGBL|DQ}} = 0.001           
{{TAGBL|ICHIBARE}} = 1         
{{TAGBL|LNMR_SYM_RED}} = .TRUE. 
{{TAGBL|NLSPLINE}} = .TRUE.     


Script to loop through {{TAG|EDIFF}} from 1E-4 eV to 1E-8 eV:
<pre>
<pre>
ENCUT = 400              # Plane-wave energy cutoff in eV
for a in 4 5 6 7 8
ISMEAR = 0; SIGMA = 0.01 # Defines the type of smearing; smearing width in eV
do
cp INCAR.nmr INCAR
sed -i "s/1E-4/1E-$a/g" INCAR


EDIFF = 1E-8            # Energy cutoff criterion for the SCF loop, in eV
mpirun -np 4 $PATH_TO_EXECUTABLE/vasp_std
PREC = Accurate          # Sets the "precision" mode
LASPH = .TRUE.          # Non-spherical contributions to the gradient of the density in the PAW spheres


LEFG = .TRUE.            # Electric field gradient calculations
cp OUTCAR OUTCAR.$a
QUAD_EFG = 0. -696. 20.44 0. 2.860  # Nuclear quadrupolar moments for Pb I N O D
done
</pre>
</pre>


Something about output?
=='''k'''-points tests==
For converging '''k''' points, start with the &Gamma;-point and increase the '''k'''-point mesh incrementally:


==Hyperfine coupling==
Initial &Gamma;-only mesh:
 
'''KPOINTS.nmr'''
Distinct from the chemical shielding and EFG, the hyperfine constant is less dependent on {{TAG|EDIFF}} and {{TAG|ENCUT}}, generally converging relatively quickly with respect to both. However, it is extremely strongly influenced by the method used. HSE06 was foud to give values close to experiment of molecular systems {{Cite|szasz:prb:2013}}.
<pre>
 
C
Make sure to define the nuclear gyromagnetic ratios for each element in your {{FILE|POSCAR}} file using {{TAG|NGYROMAG}}. The defaults are set to 1, which will return meaningless results for most systems. Reasonable values may be found [https://en.wikipedia.org/wiki/Gyromagnetic_ratio#For_a_nucleus here] .
0
G
1 1 1
0 0 0
</pre>


Script to go through '''k'''-point meshes from &Gamma;-only to 8x8x8:
<pre>
<pre>
ENCUT = 500              # Plane-wave energy cutoff in eV
for a in 1 2 4 6 8
ISMEAR = 0; SIGMA = 0.01 # Defines the type of smearing; smearing width in eV
do
cp KPOINTS.nmr KPOINTS
sed -i "s/1 1 1/$a $a $a/g" KPOINTS


EDIFF = 1E-8            # Energy cutoff criterion for the SCF loop, in eV
mpirun -np 4 $PATH_TO_EXECUTABLE/vasp_std
PREC = Accurate          # Sets the "precision" mode


LHYPERFINE = .TRUE.      # Turns on calculating the hyperfine coupling tensor
cp OUTCAR OUTCAR.$a
NGYROMAG = 10.7084 42.577478461 # Specifies the nuclear gyromagnetic ratios for the ions - C and H in this case
done
ISPIN = 2                # Turns on spin-polarization - noncollinear can also be used
</pre>
</pre>


===Output===
==Energy cutoff tests==
For converging the energy cutoff, start with the value of ENMAX given in the {{FILE|POTCAR}} file and then increase incrementally in steps of 100 eV:


You can find the output for the hyperfine calculation in the {{FILE|OUTCAR}} file after the SCF cycle finishes. The total magnetic moment is listed, then the Fermi contact term, the dipolar hyperfine coupling parameter, and finally the total hyperfine coupling parameter:
Initial {{TAGBL|INCAR}}:
'''INCAR.nmr'''
{{TAGBL|PREC}} = Accurate       
{{TAGBL|ENCUT}} = 400.0         
{{TAGBL|EDIFF}} = 1E-8         
{{TAGBL|ISMEAR}} = 0; {{TAGBL|SIGMA}} = 0.1
{{TAGBL|LREAL}} = A             
{{TAGBL|LCHIMAG}} = .TRUE.      
{{TAGBL|DQ}} = 0.001           
{{TAGBL|ICHIBARE}} = 1         
{{TAGBL|LNMR_SYM_RED}} = .TRUE. 
{{TAGBL|NLSPLINE}} = .TRUE. 


Script to loop through {{TAG|ENCUT}} from 400 eV to 800 eV:
<pre>
<pre>
Total magnetic moment S=    1.0000000
for a in 400 500 600 700 800
 
do
Fermi contact (isotropic) hyperfine coupling parameter (MHz)
cp INCAR.nmr INCAR
-------------------------------------------------------------
sed -i "s/400/$a/g" INCAR
  ion      A_pw      A_1PS    A_1AE    A_1c      A_tot
-------------------------------------------------------------
  1        -        -        -        -        -
  2        -        -        -        -        -
-------------------------------------------------------------
 
 
Dipolar hyperfine coupling parameters (MHz)
---------------------------------------------------------------------
  ion      A_xx      A_yy      A_zz      A_xy      A_xz      A_yz
---------------------------------------------------------------------
  1        -        -        -        -        -        -
  2        -        -        -        -        -        -
---------------------------------------------------------------------


mpirun -np 4 $PATH_TO_EXECUTABLE/vasp_std


Total hyperfine coupling parameters after diagonalization (MHz)
cp OUTCAR OUTCAR.$a
(convention: |A_zz| > |A_xx| > |A_yy|)
done
----------------------------------------------------------------------
  ion      A_xx      A_yy      A_zz    asymmetry (A_yy - A_xx)/ A_zz
----------------------------------------------------------------------
  1        -        -        -              -       
  2        -        -        -              -         
---------------------------------------------------------------------
</pre>
</pre>
==Chemical shielding==
Each nuclear isotope has a different gyromagnetic ratio. Even with the same isotope, the frequency can subtly differ based on the chemical environment. Electrons are also charged and so their movement in atoms, i.e. the electronic current, generates a magnetic field opposed to '''B'''<sub>ext</sub>. This induced magnetic field '''B'''<sub>ind</sub> reduces the magnetic field at the nucleus, decreasing the frequency measured in NMR. In this way, the electrons ''shield'' the nucleus from '''B'''<sub>ext</sub>. Since the electron density of a molecule or crystal is determined by its molecular orbitals, its chemical environment can be probed by these subtle differences in frequency. This shielding relation between '''B'''<sub>ext</sub> and '''B'''<sub>ind</sub> is described by the ''chemical shielding'' tensor ''&sigma;''<sub>ij</sub>:
<math>\textbf{B}_{ind}(\textbf{R}) = -\sigma(\textbf{R}) \textbf{B}_{ext}</math>
The chemical shielding itself cannot be measured in experiment, instead, it must be taken relative to a standard reference {{Cite|harris:pac:2008}}, which results in the ''chemical shift'' ''&delta;''<sub>ij</sub>:
<math>
\delta_{ij}(\mathbf{R}) = \sigma_{ij}^{\mathrm{ref}} - \sigma_{ij}(\mathbf{R})
</math>
where ''i'' and ''j'' are Cartesian axes.
The chemical shift  (in ppm) is measurable and is related to the measured frequency ''&omega;''<sub>sample</sub> via the following equation:
<math>
\delta = \frac{\omega_{ref} - \omega_{sample}}{\omega_{sample}} \times 10^6
</math>
The chemical shielding tensor may be calculated by means of linear response:
<math>
\sigma_{ij}(\textbf{R}) = - \frac{\partial B^{\mathrm{ind}}_i(\mathbf{R})}{\partial B^{\mathrm{ext}}_j}
</math>
{{TAG|LCHIMAG}} calculates the chemical shieldings. These are for individual atoms and exclude the contribution due to the augmentation currents in other PAW spheres. If two-center terms are important, e.g. for H, then they may be included using {{TAG|LLRAUG}}.
==Quadrupolar nuclei==
Nuclei with '''I''' > &#177; &frac12; have an electronic quadrupolar moment. This means that, at the nucleus, there is a non-zero electric field gradient (EFG), i.e. the rate of change of the electric field with respect to position:
<math>
V_{ij} = \frac{\partial^2 V}{\partial x_i \partial x_j}
</math>
This comes from the quadrupolar nuclei being non-spherical an so having a non-uniform electric charge distribution. The electric quadrupolar moment couples with the EFG and so the chemical enviornment of the nucleus may be probed using nuclear quadrupole resonance (NQR) {{Cite|nqr:web}}. The EFG is not directly measurable but the nuclear quadrupolar coupling constant C<sub>q</sub> is, defined as:
<math>
C_q = \frac{eQV_{zz}}{h}
</math>
where ''e'' is the charge of an electron, ''Q'' is the isotope-specific quadrupole moment, and ''h'' is the Planck constant.
The EFG can be calculated using {{TAG|LEFG}}, which also calculates ''C<sub>q</sub>'' so long as ''Q'' are defined using {{TAG|QUAD_EFG}}.
==Hyperfine coupling==
As well as the nuclei, electrons also have spin. Analogously to the nuclei, this may couple with '''B'''<sub>ext</sub> to provide information about its environment. The interaction between internally generated magnetic fields and the magnetic dipole moment of the nucleus split otherwise degenerate energy levels. This splitting is known as hyperfine splitting.
In most stable systems, all electrons are paired together, spin-up and spin-down, resulting in overall no spin. If a system has unpaired electrons, e.g. radicals, metal oxides, defects, then these systems can be investigated, e.g. using electron paramagnetic resonance (EPR) {{Cite|weil:bolton:2007}}.
The hyperfine tensor ''A<sup>I</sup>'' describes the interaction between a nuclear spin ''S<sup>I</sup>'' and the electronic spin distribution ''S<sup>e</sup>'' (in most cases associated with a paramagnetic defect state):
:<math>
E=\sum_{ij} S^e_i A^I_{ij} S^I_j
</math>
The hyperfine tensor can be calculated using {{TAG|LHYPERFINE}}.
== How to ==
*Chemical shift tensors: {{TAG|LCHIMAG}}.
*Electric field gradient tensors: {{TAG|Electric Field Gradient}}. The main tags are:
**{{TAG|LEFG}} to switch on the field gradient tensor calculation,
**{{TAG|QUAD_EFG}} to specify the input nuclear quadrupole moments.
*Hyperfine tensors: {{TAG|LHYPERFINE}}.


==References==
==References==


<!-- [[Category:Howto]][[Category:NMR]][[Category:Linear response]] --!>
<!-- [[Category:Howto]][[Category:NMR]][[Category:Linear response]][[Category:Chemical shifts]] --!>

Latest revision as of 09:31, 10 March 2025

The chemical shielding tensor σ is the relation between the induced and external magnetic fields and describes how much the electrons shield the nuclei from an external field. The absolute chemical shielding is calculated by linear response using LCHIMAG [1][2]. The chemical shielding is directly related to the chemical shift δ recorded in nuclear magnetic resonance (NMR), cf. NMR category page and LCHIMAG page for details, and, indirectly, to the resonance frequency. The theory is covered in the NMR category page and LCHIMAG page.

Warning: The chemical shifts are calculated from the orbital magnetic response under the assumption that the system is an insulator. Smearing schemes intended for metals can generate nonsense.

Step-by-step instructions

The chemical shielding is calculated post-self-consistent field (post-SCF) using LCHIMAG. A well-converged SCF calculation is therefore crucial. The chemical shielding is very sensitive to several input parameters that must all be independently tested.

Step 1 (optional): Calculate the chemical shielding using a previously converged calculation

Since the chemical shielding is calculated post-SCF, you can use a previously converged WAVECAR with ISTART = 1 and NELM = 1. The corresponding density, CHGCAR is calculated from the WAVECAR file before the first elementary step so it need not be included.

Step 2 (optional): Determine a suitable energetic break value

The break condition for the self-consistency step EDIFF strongly influences the chemical shielding. A setting of EDIFF = 1E-8 eV is generally recommended. Convergence is taken to be within 0.1 ppm.

Step 3: Converge the plane-wave basis

A large plane-wave energy cutoff is required to fully converge the chemical shieldings. Perform multiple calculations while increasing the basis set size, as defined in ENCUT, incrementally (e.g., by 100 eV intervals). Convergence should be aimed to be within 0.1 ppm, although this will not be feasible for heavier elements.

Step 4: Converge the k point mesh

Similar to the basis, the k point mesh can strongly influence the chemical shielding. The k point mesh should be increased incrementally, i.e., 1x1x1, 2x2x2, 3x3x3, until convergence within 0.1 ppm is achieved. It is only necessary to converge the k point mesh for crystals, gas-phase molecules should use the Γ-point only.

Step 5: Compare to experiment

The purpose of these calculations is to compare to experiment. However, the calculated absolute chemical shieldings are not directly comparable to the measured chemical shift due to the lack of a reference. To avoid bias from any single calculation, a series of calculated and their corresponding experimental values are used. The experimental chemical shifts are plotted against the calculated chemical shieldings as is found in Fig. 3 of Ref. [3].

Recommendations and advice

Calculating the chemical shielding requires tightly converged settings. As described in the step-wise introduction above, converging with respect to EDIFF, ENCUT, and the k point mesh is very important. There are a few additional settings that should be considered.

PAW pseudopotentials

The standard PAW pseudopotentials POTCAR used are sufficient for calculating the chemical shielding. The GIPAW is applied using the projector functions and partial waves that are stored in the regular POTCAR files. The completeness of these projector functions and partial waves determines the quality of the results. Using slightly different types of POTCAR, e.g., GW (*_GW) or with additional valence (*_sv, *_pv), can change the calculated shielding by a few ppm for the first and second row sp-bonded elements (except for H).

The PAW reconstruction with all-electron partial waves is crucial for calculating the field on the nucleus. It is therefore important to use a consistent exchange-correlation functional and so LEXCH in the POTCAR should not be overwritten with an explicit GGA tag in the INCAR if possible.

Insufficient memory

For calculating the chemical shieldings, speed had been favored over saving memory, resulting in insufficient memory occasionally. Since the linear response calculation is parallel over k points, this can be used to economize on memory by performing a regular SCF calculation at high accuracy on the full k point mesh and saving the CHGCAR file. Using ICHARG = 11 start a chemical shielding calculation for each individual k point in the first Brillouin zone (IBZ) separately, starting from CHGCAR. The shieldings can then be calculated as a k point weighted average of the symmetrized shieldings of the individual k points.

Additional tags

To ensure tight precision, the precision should be set to PREC = Accurate, rather than Normal.

Several additional INCAR tags should be considered. Specifically, LASPH should be set to .TRUE., turning on the non-spherical contributions to the gradient of the density inside the PAW spheres. Occasionally, e.g. for systems containing H or first-row elements, and short bonds, the two-center contributions to the augmentation currents in the PAW spheres are important. In this case, LLRAUG = .TRUE. should be used [4][5].

Important: The treatment of the orbital magnetism is non-relativistic. This is suitable for light nuclei.

The standard POTCARs are scalar-relativistic and account partially for relativistic effects. The accuracy can be improved using LBONE, which restores the small B-component of the wave function inside the PAW spheres. Spin-orbit coupling is not implemented for chemical shift calculations.

Example scripts for convergence tests

Several tests are necessary to obtain various NMR parameters. Make sure to change the example INCAR files to include the tags for your desired calculation. We provide some example scripts below:

Energetic break criterion tests

For converging the energetic break criterion for a single ionic step (EDIFF), start with the 1E-4 and then increase by orders of magnitude:

Energetic break criterion: INCAR.nmr

PREC = Accurate        
ENCUT = 400.0          
EDIFF = 1E-4          
ISMEAR = 0; SIGMA = 0.1 
LREAL = A              
LCHIMAG = .TRUE.       
DQ = 0.001             
ICHIBARE = 1           
LNMR_SYM_RED = .TRUE.  
NLSPLINE = .TRUE.      

Script to loop through EDIFF from 1E-4 eV to 1E-8 eV:

for a in 4 5 6 7 8
do
cp INCAR.nmr INCAR
sed -i "s/1E-4/1E-$a/g" INCAR

mpirun -np 4 $PATH_TO_EXECUTABLE/vasp_std

cp OUTCAR OUTCAR.$a
done

k-points tests

For converging k points, start with the Γ-point and increase the k-point mesh incrementally:

Initial Γ-only mesh: KPOINTS.nmr

C
0
G
 1 1 1
 0 0 0

Script to go through k-point meshes from Γ-only to 8x8x8:

for a in 1 2 4 6 8
do
cp KPOINTS.nmr KPOINTS
sed -i "s/1 1 1/$a $a $a/g" KPOINTS

mpirun -np 4 $PATH_TO_EXECUTABLE/vasp_std

cp OUTCAR OUTCAR.$a
done

Energy cutoff tests

For converging the energy cutoff, start with the value of ENMAX given in the POTCAR file and then increase incrementally in steps of 100 eV:

Initial INCAR: INCAR.nmr

PREC = Accurate        
ENCUT = 400.0          
EDIFF = 1E-8           
ISMEAR = 0; SIGMA = 0.1 
LREAL = A              
LCHIMAG = .TRUE.       
DQ = 0.001             
ICHIBARE = 1           
LNMR_SYM_RED = .TRUE.  
NLSPLINE = .TRUE.  

Script to loop through ENCUT from 400 eV to 800 eV:

for a in 400 500 600 700 800
do
cp INCAR.nmr INCAR
sed -i "s/400/$a/g" INCAR

mpirun -np 4 $PATH_TO_EXECUTABLE/vasp_std

cp OUTCAR OUTCAR.$a
done

References