"""This module defines an ASE interface to NWchem
https://nwchemgit.github.io
"""
import os
from pathlib import Path
import numpy as np
from ase import io
from ase.calculators.calculator import FileIOCalculator
from ase.spectrum.band_structure import BandStructure
from ase.units import Hartree
[docs]class NWChem(FileIOCalculator):
implemented_properties = ['energy', 'free_energy',
'forces', 'stress', 'dipole']
_legacy_default_command = 'nwchem PREFIX.nwi > PREFIX.nwo'
accepts_bandpath_keyword = True
discard_results_on_any_change = True
fileio_rules = FileIOCalculator.ruleset(
extend_argv=['{prefix}.nwi'],
stdout_name='{prefix}.nwo')
def __init__(self, restart=None,
ignore_bad_restart_file=FileIOCalculator._deprecated,
label='nwchem', atoms=None, command=None, **kwargs):
"""
NWChem keywords are specified using (potentially nested)
dictionaries. Consider the following input file block::
dft
odft
mult 2
convergence energy 1e-9 density 1e-7 gradient 5e-6
end
This can be generated by the NWChem calculator by using the
following settings:
>>> from ase.calculators.nwchem import NWChem
>>> calc = NWChem(dft={'odft': None,
... 'mult': 2,
... 'convergence': {'energy': 1e-9,
... 'density': 1e-7,
... 'gradient': 5e-6,
... },
... },
... )
In addition, the calculator supports several special keywords:
theory: str
Which NWChem module should be used to calculate the
energies and forces. Supported values are ``'dft'``,
``'scf'``, ``'mp2'``, ``'ccsd'``, ``'tce'``, ``'tddft'``,
``'pspw'``, ``'band'``, and ``'paw'``. If not provided, the
calculator will attempt to guess which theory to use based
on the keywords provided by the user.
xc: str
The exchange-correlation functional to use. Only relevant
for DFT calculations.
task: str
What type of calculation is to be performed, e.g.
``'energy'``, ``'gradient'``, ``'optimize'``, etc. When
using ``'SocketIOCalculator'``, ``task`` should be set
to ``'optimize'``. In most other circumstances, ``task``
should not be set manually.
basis: str or dict
Which basis set to use for gaussian-type orbital
calculations. Set to a string to use the same basis for all
elements. To use a different basis for different elements,
provide a dict of the form:
>>> calc = NWChem(...,
... basis={'O': '3-21G',
... 'Si': '6-31g'})
basispar: str
Additional keywords to put in the NWChem ``basis`` block,
e.g. ``'rel'`` for relativistic bases.
symmetry: int or str
The point group (for gaussian-type orbital calculations) or
space group (for plane-wave calculations) of the system.
Supports both group names (e.g. ``'c2v'``, ``'Fm3m'``) and
numbers (e.g. ``225``).
autosym: bool
Whether NWChem should automatically determine the symmetry
of the structure (defaults to ``False``).
center: bool
Whether NWChem should automatically center the structure
(defaults to ``False``). Enable at your own risk.
autoz: bool
Whether NWChem should automatically construct a Z-matrix
for your molecular system (defaults to ``False``).
geompar: str
Additional keywords to put in the NWChem `geometry` block,
e.g. ``'nucleus finite'`` for gaussian-shaped nuclear
charges. Do not set ``'autosym'``, ``'center'``, or
``'autoz'`` in this way; instead, use the appropriate
keyword described above for these settings.
set: dict
Used to manually create or modify entries in the NWChem
rtdb. For example, the following settings enable
pseudopotential filtering for plane-wave calculations::
set nwpw:kbpp_ray .true.
set nwpw:kbpp_filter .true.
These settings are generated by the NWChem calculator by
passing the arguments:
>>> calc = NWChem(...,
>>> set={'nwpw:kbpp_ray': True,
>>> 'nwpw:kbpp_filter': True})
kpts: (int, int, int), or dict
Indicates which k-point mesh to use. Supported syntax is
similar to that of GPAW. Implies ``theory='band'``.
bandpath: BandPath object
The band path to use for a band structure calculation.
Implies ``theory='band'``.
pretasks: list of dict
Tasks used to produce a better initial guess
for the wavefunction.
These task typically use a cheaper level of theory
or smaller basis set (but not both).
The output energy and forces should remain unchanged
regardless of the number of tasks or their parameters,
but the runtime may be significantly improved.
For example, a MP2 calculation preceded by guesses at the
DFT and HF levels would be
>>> calc = NWChem(theory='mp2', basis='aug-cc-pvdz',
>>> pretasks=[
>>> {'dft': {'xc': 'hfexch'},
>>> 'set': {'lindep:n_dep': 0}},
>>> {'theory': 'scf', 'set': {'lindep:n_dep': 0}},
>>> ])
Each dictionary could contain any of the other parameters,
except those which pertain to global configurations
(e.g., geometry details, scratch dir).
The default basis set is that of the final step in the calculation,
or that of the previous step that which defines a basis set.
For example, all steps in the example will use aug-cc-pvdz
because the last step is the only one which defines a basis.
Steps which change basis set must use the same theory.
The following specification would perform SCF using the 3-21G
basis set first, then B3LYP//3-21g, and then B3LYP//6-31G(2df,p)
>>> calc = NWChem(theory='dft', xc='b3lyp', basis='6-31g(2df,p)',
>>> pretasks=[
>>> {'theory': 'scf', 'basis': '3-21g',
>>> 'set': {'lindep:n_dep': 0}},
>>> {'dft': {'xc': 'b3lyp'}},
>>> ])
The :code:`'set': {'lindep:n_dep': 0}` option is highly suggested
as a way to avoid errors relating to symmetry changes between tasks.
The calculator will configure appropriate options for saving
and loading intermediate wavefunctions, and
place an "ignore" task directive between each step so that
convergence errors in intermediate steps do not halt execution.
"""
FileIOCalculator.__init__(self, restart, ignore_bad_restart_file,
label, atoms, command, **kwargs)
self.calc = None
def input_filename(self):
return f'{self.prefix}.nwi'
def output_filename(self):
return f'{self.prefix}.nwo'
def write_input(self, atoms, properties=None, system_changes=None):
FileIOCalculator.write_input(self, atoms, properties, system_changes)
# Prepare perm and scratch directories
perm = os.path.abspath(self.parameters.get('perm', self.label))
scratch = os.path.abspath(self.parameters.get('scratch', self.label))
os.makedirs(perm, exist_ok=True)
os.makedirs(scratch, exist_ok=True)
io.write(Path(self.directory) / self.input_filename(),
atoms, properties=properties,
label=self.label, **self.parameters)
def read_results(self):
output = io.read(self.output_filename())
self.calc = output.calc
self.results = output.calc.results
def band_structure(self):
self.calculate()
perm = self.parameters.get('perm', self.label)
if self.calc.get_spin_polarized():
alpha = np.loadtxt(os.path.join(perm, self.label + '.alpha_band'))
beta = np.loadtxt(os.path.join(perm, self.label + '.beta_band'))
energies = np.array([alpha[:, 1:], beta[:, 1:]]) * Hartree
else:
data = np.loadtxt(os.path.join(perm,
self.label + '.restricted_band'))
energies = data[np.newaxis, :, 1:] * Hartree
eref = self.calc.get_fermi_level()
if eref is None:
eref = 0.
return BandStructure(self.parameters.bandpath, energies, eref)