Environment#
Localized properties#
ESP charges#
Since there is no unique definition for partial charges and no corresponding physical observable, they can be assigned in several ways, such as being derived from the quantum mechanical electrostatic potential
that can be replaced with a potential caused by the partial charges:
The Merz–Kollman scheme minimizes the squared norm difference between these two quantities evaluated on a set of grid points in the solvent-accessible region of the molecule with respect to variations in the partial charges and a constraint of a conservation of the total molecular charge – the grid points are distributed on successive layers of scaled van der Waals surfaces. This measure is referred to as the figure-of-merit
The resulting electrostatic potential (ESP) charges are obtained by solving the equation
where
and
The ESP charges are detemined with VeloxChem with use of an input file as below
@jobs
task: esp charges
@end
@method settings
basis: 6-31g
@end
@esp charges
number layers: 5
density: 10.0
@end
@molecule
charge: 0
multiplicity: 1
xyz:
...
@end
or in a Jupyter notebook according to
import veloxchem as vlx
xyz_str = """
...
"""
molecule = vlx.Molecule.read_xyz_string(xyz_str)
basis = vlx.MolecularBasis.read(molecule, '6-31g')
esp_drv = vlx.RespChargesDriver()
esp_drv.update_settings({
'number_layers': 5,
'density': 10.0,
})
esp_charges = esp_drv.compute(molecule, basis, 'esp')
In both cases, the user needs to specify the number of layers of the molecular surface as well as the surface grid point density in these layers (in units of Å\(^{-2}\)).
RESP charges#
The restrained electrostatic potential (RESP) charge model is an improvement to the Merz–Kollman scheme as the figure-of-merit is rather insensitive to variations in charges of atoms buried inside the molecule.
To avoid unphysically high magnitudes of the charges of interior atoms, a hyperbolic penalty function is added
so that the diagonal matrix elements become equal to
with a dependency on the partial charge. Consequently, RESP charges are obtained by solving the matrix equation iteratively until the charges and Lagrange multipliers become self-consistent. In addition to that, the RESP charge model allows for the introduction of constraints on charges of equivalent atoms due to symmetry operations or bond rotations.
The RESP cahrges are detemined with VeloxChem with use of an input file as below
@jobs
task: resp charges
@end
@method settings
basis: 6-31g*
@end
@resp charges
equal charges: 2 = 3 ! with reference to the atom ordering below
@end
@molecule
charge: 0
multiplicity: 1
xyz:
...
@end
or in a Jupyter notebook according to
import veloxchem as vlx
xyz_str = """
...
"""
molecule = vlx.Molecule.read_xyz_string(xyz_str)
basis = vlx.MolecularBasis.read(molecule, '6-31g*')
resp_drv = vlx.RespChargesDriver()
resp_drv.update_settings({
'equal_charges': '2 = 3'
})
resp_charges = resp_drv.compute(molecule, basis, 'resp')
LoProp charges and polarizabilities#
The LoProp approach [GLKarlstrom04] is implemented for the determination of localized (atomic) charges and polarizabilities that enter into polarizable embedding calculations of optical spectra.
@jobs
task: loprop
@end
@method settings
xcfun: b3lyp
basis: ANO-S-VDZP ! An ANO type of basis set should be used
@end
@molecule
charge: 0
multiplicity: 1
xyz:
...
@end
Polarizable embedding#
An SCF calculation with a polarizable environment is performed in VeloxChem with an input file of the form
@jobs
task: scf
@end
@method settings
basis: aug-cc-pvdz
potfile: pe.pot
@end
@molecule
charge: 0
multiplicity: 1
xyz:
...
@end
together with a potential file pe.pot
of the form
@environment
units: angstrom
xyz:
O -0.9957202 0.0160415 1.2422556 water 1
H -1.4542703 -0.5669741 1.8472817 water 1
H -0.9377950 -0.4817912 0.4267562 water 1
O -0.2432343 -1.0198566 -1.1953808 water 2
H 0.4367536 -0.3759433 -0.9973297 water 2
H -0.5031835 -0.8251492 -2.0957959 water 2
@end
@charges
O -0.67444408 water
H 0.33722206 water
H 0.33722206 water
@end
@polarizabilities
O 5.73935090 0.00000000 0.00000000 5.73935090 0.00000000 5.73935090 water
H 2.30839051 0.00000000 0.00000000 2.30839051 0.00000000 2.30839051 water
H 2.30839051 0.00000000 0.00000000 2.30839051 0.00000000 2.30839051 water
@end