One-electron operators
Syntax for specifying one-electron operators
In DIRAC, a general one-electron 4-component operator is generated from linear combinations of operators having the basic form
where
One thing to notice is that
Another important aspect to note is that DIRAC does not use the
Operator specification
Operators are specified by the keyword .OPERATOR with the following arguments:
.OPERATOR
'user defined operator name'
operator type keyword
one-electron scalar operator label for each component
CMULT
FACTORS
factor for each component
COMFACTOR
common factor for all components
Note that the arguments following the keyword .OPERATOR must start with a blank.
The arguments are optional, except for the one-electron scalar operator label. If no operator type keyword is given, DIRAC assumes the operator type to be FACTORS
, as well as the common factor under the keyword COMFACTOR
, are all equal to one if not specified.
The keyword CMULT
assures multiplication of the individual factors (or common factor) by the speed of light in vacuum, CMULT
follows any user-specified modification of the speed of light, as provided by .CVALUE.
Operator type keywords
There are 22 basic operator types implemented in DIRAC. They are listed in the following Table, containing their keywords, operator forms, associated number of factors (NF), and time-reversal symmetry (TRS) without imaginary phase:
Keyword |
Operator form |
NF |
TRS (without i) |
---|---|---|---|
DIAGONAL |
1 |
Symmetric |
|
BETA |
1 |
Symmetric |
|
GAMMA5 |
1 |
Symmetric |
|
BETAGAMM |
1 |
Symmetric |
|
XALPHA |
1 |
Antisymmetric |
|
YALPHA |
1 |
Antisymmetric |
|
ZALPHA |
1 |
Antisymmetric |
|
XAVECTOR |
2 |
Antisymmetric |
|
YAVECTOR |
2 |
Antisymmetric |
|
ZAVECTOR |
2 |
Antisymmetric |
|
ALPHADOT |
3 |
Antisymmetric |
|
XBETAALP |
1 |
Antisymmetric |
|
YBETAALP |
1 |
Antisymmetric |
|
ZBETAALP |
1 |
Antisymmetric |
|
XSIGMA |
1 |
Antisymmetric |
|
YSIGMA |
1 |
Antisymmetric |
|
ZSIGMA |
1 |
Antisymmetric |
|
SIGMADOT |
1 |
Antisymmetric |
|
XBETASIG |
1 |
Antisymmetric |
|
YBETASIG |
1 |
Antisymmetric |
|
ZBETASIG |
1 |
Antisymmetric |
|
iBETAGAM |
1 |
Antisymmetric |
Note for advanced users: iBETAGAM corresponds to the time-reversal symmetric operator
One-electron scalar operator labels
Operator label |
Integral description |
Components |
Operators |
---|---|---|---|
KINENER |
NR kinetic energy |
KINENER |
|
MOLFIELD |
Nuclear attraction |
MOLFIELD |
|
OVERLAP |
Overlap |
OVERLAP |
|
FERMI C |
One-electron Fermi contact |
FC NAMab |
|
ANGMOM |
Orbital angular momentum around CM |
XANGMOM |
|
YANGMOM |
|||
ZANGMOM |
|||
DIPLEN |
Dipole length |
XDIPLEN |
|
YDIPLEN |
|||
ZDIPLEN |
|||
DIPVEL |
Dipole velocity |
XDIPVEL |
|
YDIPVEL |
|||
ZDIPVEL |
|||
QUADRUP |
Quadrupole moment |
XXQUADRU |
|
XYQUADRU |
|||
XZQUADRU |
|||
YYQUADRU |
|||
YZQUADRU |
|||
ZZQUADRU |
|||
SECMOM |
Second moment |
XXSECMOM |
|
XYSECMOM |
|||
XZSECMOM |
|||
YYSECMOM |
|||
YZSECMOM |
|||
ZZSECMOM |
|||
THETA |
Traceless quadrupole |
XXTHETA |
|
XYTHETA |
|||
XZTHETA |
|||
YYTHETA |
|||
YZTHETA |
|||
ZZTHETA |
|||
SEFGMG |
Magnetic term of Flambaum-Ginges self-energy potential |
XSEFGMG |
|
YSEFGMG |
|||
ZSEFGMG |
where
Note that in the one-electron Fermi-contact integrals
Other one-electron operator labels are:
Keyword |
Description |
---|---|
ANGLON |
Angular momentum around the nuclei |
CARMOM |
Cartesian moments (symmetric) |
CM1 |
First order magnetic field derivatives of electric field |
CM2 |
Second order magnetic field derivatives of electric field |
DARWIN |
Darwin-type integrals |
DIASUS |
Angular London orbital contribution to diamagnetic susceptibility |
DSO |
Diamagnetic spin-orbit integrals |
DSUSCGO |
Diamagnetic susceptibility with common gauge origin |
DSUSLH |
Angular London orbital contribution to diamagnetic susceptibility |
DSUSNOL |
Diamagnetic susceptibility without London contribution |
ELFGRDC |
Electric field gradient at the individual nuclei, cartesian |
ELFGRDS |
Electric field gradient at the individual nuclei, spherical |
EXPIKR |
Cosine and sine |
HBDO |
Half B-differentiated overlap matrix |
HDO |
Half-derivative overlap integrals |
HDOBR |
Ket-differentiation of HDO-integrals with respect to magnetic field |
LONMOM |
London orbital contribution to angular momentum |
MAGMOM |
One-electron contributions to magnetic moment |
MASSVEL |
Mass velocity |
NEFIELD |
Electric field at the individual nuclei |
NSTCGO |
Nuclear shielding with common gauge origin |
NUCPOT |
Potential energy of the interaction of electrons with individual nuclei, divided by the nuclear charge |
NUCSHI |
Nuclear shielding tensor |
NUCSLO |
London orbital contribution to nuclear shielding tensor |
NUCSNLO |
Nuclear shielding integrals without London orbital contribution |
PSO |
Paramagnetic spin-orbit |
S1MAG |
Second order contribution from overlap matrix to magnetic properties |
S1MAGL |
Bra-differentiation of overlap matrix with respect to magnetic field |
S1MAGR |
Ket-differentiation of overlap matrix with respect to magnetic field |
SDFC |
Spin-dipole + Fermi contact |
SOLVENT |
Electronic solvent integrals |
SPHMOM |
Spherical moments (real combinations), symmetric, ( |
SPIN-DI |
Spin-dipole integrals |
SPNORB |
Spatial spin-orbit |
SQHDO |
Half-derivative overlap integrals not to be antisymmetrized |
SQHDOR |
Half-derivative overlap integrals not to be anti-symmetrized |
SQOVLAP |
Second order derivatives overlap integrals |
UEHLING |
Uehling potential |
SEFGLF |
Low-frequency term of Flambaum-Ginges self-energy potential |
SEFGHF |
High-frequency term of Flambaum-Ginges self-energy potential |
SEPZ |
Pyykko-Zhao self-energy model potential |
Examples of using various operators
We give here several concrete examples on how to construct operators for various properties.
Kinetic part of the Dirac Hamiltonian
The kinetic part of the electronic Dirac Hamiltonian is given (in a.u.) by
This operator may be specified by:
.OPERATOR
'Kin energy'
ALPHADOT
XDIPVEL
YDIPVEL
ZDIPVEL
COMFACTOR
-137.03599926085
where 137.03599926085 is the CODATA22 value for
The speed of light
.OPERATOR
'Kin energy'
ALPHADOT
XDIPVEL
YDIPVEL
ZDIPVEL
CMULT
COMFACTOR
-1
Magnetic interactions
Another example is the operator that describes the electromagnetic interaction between electrons and a uniform external magnetic field:
The operator to use in this case is
.OPERATOR
'B_x'
XAVECTOR
ZDIPLEN
YDIPLEN
CMULT
COMFACTOR
-0.5
The program will assume all operators to be Hermitian. The operator XAVECTOR
is defined as ZDIPLEN
and YDIPLEN
in One-electron scalar operator labels). Additionally,
The imaginary phase
Diagonal operators
If no other argument is given, the program assumes the operator to be diagonal and expects the operator name to be the component label, for instance:
.OPERATOR
OVERLAP
Finite-field perturbation: Electric dipole moment
Another example is a finite-perturbation calculation where the perturbed Hamiltonian operator arising from the interaction between the electrons and a uniform external electric field oriented along the
If we take
**HAMILTONIAN
.OPERATOR
ZDIPLEN
COMFACTOR
0.01
Note: Don’t forget to decrease the symmetry of your system.
Fermi-contact integrals
Here is an example where the Fermi-contact (FC) integrals for a certain nucleus
Let’s assume we are looking at a PbX dimer (order in the .mol file: 1. Pb, 2. X) and we want to add (under **HAMILTONIAN) the FC interaction for the Pb nucleus to the unperturbed Hamiltonian
The FC integrals are called using the label 'FC NAMab'
(see One-electron scalar operator labels), and the total perturbed Hamiltonian
**HAMILTONIAN
.OPERATOR
'Density at Pb nucleus'
DIAGONAL
'FC Pb 01'
FACTORS
0.000000001
Important note: The values obtained after the fit of the finite-field energies need to be scaled by
The next example shows how to calculate the electronic density at the different nuclei in the molecule, as the expectation values
**DIRAC
.WAVE FUNCTION
.PROPERTIES
**HAMILTONIAN
**WAVE FUNCTION
.SCF
**PROPERTIES
.RHONUC
*EXPECTATION
.ORBANA
*END OF
For further details, see .RHONUC.
Cartesian moment expectation value
In the following example we calculate the cartesian multipole moment expectation value
**DIRAC
.WAVE FUNCTION
.PROPERTIES
**HAMILTONIAN
.LEVY-LEBLOND
**WAVE FUNCTION
.SCF
**PROPERTIES
*EXPECTATION
.OPERATOR
CM010203
*END OF
Quaternion algebra and time-reversal symmetry
The sixteen
Here we will use the notation
It can be seen that all these matrices can be written as the Kronecker product of two
The individual matrix elements of
where
In the DIRAC code, the structure of the Dirac equation with respect to time-reversal symmetry is displayed by using reordered Dirac 4-spinors, where the components are grouped on spin labels (
The same reordering applies to all the matrices
However, after reordering one clearly has the transformed matrices, which satisfy
In other words,
Additionally, following the arguments given in Ref. [Saue1999], it is possible to make the following mapping involving the quaternion units:
or, in a general way,
Thus, any linear combination of the 16 reordered matrices
To make the proposed discussion clearer, in the following we will discuss two examples. In first place, we will transform
As a second example, we take
The relationship between
It is important to note that although the time-reversal antisymmetric operators
For further details on the quaternion symmetry scheme used in DIRAC, see Ref. [Saue1999].
Note: For complete consistency, the names of the operators related to XiALPHA
, YiALPHA
, ZiALPHA
, XiAVECTOR
, YiAVECTOR
, ZiAVECTOR
, iALPHADOT
, XiBETAALP
, YiBETAALP
, ZiBETAALP
, XiSIGMA
, YiSIGMA
, ZiSIGMA
, XiBETASIG
, YiBETASIG
, ZiBETASIG
, and iSIGMADOT
(see Operator type keywords). However, due to historical reasons, this convention is not used in DIRAC.
Note for advanced users: The operator iBETAGAM is implemented in the code just as