#
MAGRES_CONV_TOL (.param)

## Keyword type

Real

## Description

This keyword controls the tolerance for accepting convergence of the first-order perturbed wavefunctions in the electronic minimizer during
an NMR calculation.

## Default

1 × 10^{-12} when MAGRES_METHOD :
crystal

1 × 10^{-9} when MAGRES_METHOD : molecular

## Example

MAGRES_CONV_TOL = 0.00007 eV

To obtain reliable shielding constants, you must ensure a high convergence of the
first-order perturbed wavefunctions. However, there are rare cases where the convergence to within the default accuracy cannot be achieved with
a reasonable number of iterations. In such situations, a warning message will report the minimal residual (largest over the
k-points) achieved by the minimizer, for example:

`Calculation of first order wavefunctions not fully converged. Minimum residual = 0.285E-11 eV`

In this case, the program does not proceed with the calculation of NMR parameters and the decision is left up to you. If the minimal
residual is still reasonably small, as in the example above, it makes sense to run the calculation to completion. To do that, you have to
change the MAGRES_CONV_TOL value by setting it in the `.param`

file to a value larger than that in the warning message.
If MAGRES_CONV_TOL has to be increased by more than one order of magnitude, it is advisable to study the dependence of the NMR
parameters on the value of this computational parameter in order to confirm that the physically relevant results are stable to variations in
MAGRES_CONV_TOL.

###### See Also:

MAGRES_METHOD

CASTEP keyword glossary

CASTEP parameters keywords

Accelrys Materials Studio 8.0 Help: Wednesday, December 17, 2014