*EXCITATION ENERGIES

Calculate excitation energies using time dependent Hartree-Fock or DFT. The excitation energies are found as the lowest generalized eigenvalues of the electronic Hessian. DIRAC supports TDDFT kernels from all ground state functionals included in the code. Currently the iterative eigenvalue solver may fail to converge more than about twenty roots per symmetry.

Define excitations and transition moments

.EXCITA

.EXCITA
SYM N

Number of excitation energies N calculated in boson symmetry no. SYM. This keyword can be repeated if you want excitation energies in more than one boson symmetry.

.OPERATOR

Specification of a transition moment operator (see One-electron operators for details). This keyword can be given multiple times to add more operators.

.EPOLE

Specification of electric Cartesian multipole operators of order $n$

$${\hat{Q}}_{j_1\dots j_n}^{\left[n\right]}=-e{r}_1{r}_2\dots r_{j_n}$$

for the calculation of transition moments (note that they contribute to one order less in the wave vector). Specify order.

Example: Electric dipole operators:

.EPOLE
1

.MPOLE

Specification of magnetic Cartesian multipole operators of order $n$

$${\hat{m}}_{j_1\dots j_{n-1};j_n}^{\left[n\right]}=\frac{n}{n+1}{r}_{j_1}{r}_{j_2}\dots r_{j_{n-1}}(\mathit{r}\times \hat{\mathbf{j}}{)}_{j_n};\hat{\mathbf{j}}=-ec\mathit{\alpha }$$

for the calculation of transition moments (note that they contribute to the same order in the wave vector). Specify order.

Example: Magnetic dipole operators:

.MPOLE
1

.ANALYZE

Analyze solution vectors and show the most important excitations at the orbital level.

.INTENS

Invoke calculation of oscillator strengths to order k in the wave vector. Default order is zero, which corresponds to the widely used electric-dipole approximation. By default results are given both in the length and the velocity representation, but a selection can be made using keywords .NOLENR and .NOVELR. Only even orders contribute. For further details, see [List_JCP2020]

Example:

.INTENS
2

.BED

Invoke calculation of oscillator strengths using the full operator coupling the molecule to an electromagnetic plane wave. The oscillator strength is then given by

$$f_{n\leftarrow 0}=\frac{2\omega }{\hslash e^2}{|⟨n|T\left(\omega \right)|0⟩|}^2$$

where appears the effective interaction operator

$$T\left(\omega \right)=\frac{ec}{\omega }(\mathit{\alpha }\cdot \mathit{ϵ})e^{+i(\mathbf{k}\cdot \mathbf{r})}.$$

In the above expression $\mathbf{k}$ refers to the wave vector of length $k=\omega /c$ and direction $\mathbf{m}$, whereas the polarization of the electric component is specificed by $\mathit{ϵ}$.

Since experiment is typically carried out in an isotropic medium, rotational average is performed. Rather than rotate the molecule we shall rotate the experimental apparatus. To rotate we use the unit vectors of the spherical coordinates

$$\begin{array}{r}\begin{array}{lcl}{\mathbf{e}}_r& =& {\mathbf{e}}_x\sin \theta \cos \varphi +{\mathbf{e}}_y\sin \theta \sin \varphi +{\mathbf{e}}_z\cos \theta \\ {\mathbf{e}}_{\theta }& =& {\mathbf{e}}_x\cos \theta \cos \varphi +{\mathbf{e}}_y\cos \theta \sin \varphi -{\mathbf{e}}_z\sin \theta \\ {\mathbf{e}}_{\varphi }& =& -{\mathbf{e}}_x\sin \varphi +{\mathbf{e}}_y\cos \varphi \end{array}\end{array}$$

We now choose to align the wave vector with the ${\mathbf{e}}_r$ unit vector, that is

$$\mathbf{k}=k{\mathbf{e}}_r$$

This means that the polarization vector $\mathit{ϵ}$ is in the plane spanned by the unit vectors ${\mathbf{e}}_{\theta }$ and ${\mathbf{e}}_{\varphi }$. We therefore set

$$\mathit{ϵ}=\cos \chi {\mathbf{e}}_{\theta }+\sin \chi {\mathbf{e}}_{\varphi }$$

We see the solid angle $(\theta ,\varphi )$ gives all possible directions of the wave vector $\mathbf{k}$, wheras the angle $\chi$ provides all possible orientations of the polarization vector $\mathit{ϵ}$ in the plane perpendicular to $\mathbf{k}$.

The general expression for the rotational average will be

$${⟨f\left(\mathit{r}\right)⟩}_{\theta ,\varphi ,\chi }=\frac{1}{8{\pi }^2}{\int }_0^{2\pi }{\int }_0^{2\pi }{\int }_0^{\pi }f\left(\mathit{r}\right)\sin \theta d\theta d\varphi d\chi .$$

In our case we have

$${⟨f_{n\leftarrow 0}⟩}_{\theta ,\varphi ,\chi }=\frac{2\omega }{\hslash e^2}{⟨{ϵ}_{\alpha }{ϵ}_{\beta }⟨n|\frac{ec}{\omega }{\alpha }_{\alpha }{e}^{+i(\mathit{k}\cdot \mathit{r})}|0⟩⟨n|\frac{ec}{\omega }{\alpha }_{\beta }{e}^{+i(\mathit{k}\cdot \mathit{r})}|0{⟩}^{\ast }⟩}_{\theta ,\varphi ,\chi },$$

which simplifies to

$${⟨f_{n\leftarrow 0}⟩}_{\theta ,\varphi ,\chi }=\frac{2\omega }{\hslash e^2}{⟨{⟨{ϵ}_{\alpha }{ϵ}_{\beta }⟩}_{\chi }⟨n|\frac{ec}{\omega }{\alpha }_{\alpha }{e}^{+i(\mathit{k}\cdot \mathit{r})}|0⟩⟨n|\frac{ec}{\omega }{\alpha }_{\beta }{e}^{+i(\mathit{k}\cdot \mathit{r})}|0{⟩}^{\ast }⟩}_{\theta ,\varphi },$$

since only the polarization vectors depend on the angle $\chi$. The average over the angle $\chi$ can be expressed compactly in terms of the wave unit vector $\mathbf{m}$ ($\mathbf{k}=k\mathbf{m}$)

$${⟨{ϵ}_{\alpha }{ϵ}_{\beta }⟩}_{\chi }=\frac{1}{2}({\delta }_{\alpha \beta }-m_{\alpha }{m}_{\beta }),$$

whereas the average over angles $\theta$ and $\varphi$ is handled by Lebedev quadrature .

A full account is given in [List_JCP2020]

.ORIENT

Specify fixed experimental configuration (no rotational average). The orientation of the wave and polarization vector is given by specification of the angles $\theta$, $\varphi$ and $\chi$, see the .BED keyword for more details. For instance, to specify that the wave vector is along the $z$ -axis and the polarization vector along the $x$ - axis, we set

.ORIENT
0.0 0.0 0.0

.NROTAV

As described under the .BED keyword, Lebedev quadrature is employed for rotational average. This quadrature over the solid angles can integrate a spherical harmonic to high accuracy with a maximum angular momentum $L_{\text{max}}$. The default value of $L_{\text{max}}$ is presently 5, but can be reset with this keyword.

.BEDCON

Specification of contributions of the full light-matter interaction of order $n$ in the wave vector

$${\hat{T}}_{\mathrm{full}}^{\left[n\right]}(\omega )=\frac{k^n}{n!}\frac{d^n}{d{k}^n}{\left[\frac{e}{\omega }(c\mathit{\alpha }\cdot \mathit{ϵ})e^{+i(\mathit{k}\cdot \mathit{r})}\right]}_{k=0}=\frac{e}{\omega }\frac{i^n}{n!}(c\mathit{\alpha }\cdot \mathit{ϵ}){(\mathit{k}\cdot \mathit{r})}^n$$

.NOLENR

Deactivate length representation.

.NOVELR

Deactivate velocity representation.

Control variational parameters

.OCCUP

For each fermion ircop give an Specification of orbital strings of inactive orbitals from which excitations are allowed. By default excitations from all occupied orbitals are included in the generalized eigenvalue problem.

Example:

.OCCUP
1..3
7,8

This would include excitations from gerade orbitals 1,2,3, and ungerade orbitals 7 and 8.

.VIRTUA

For each fermion ircop give an Specification of orbital strings of virtual orbitals to which excitations are allowed. By default excitations to all virtal orbitals are included in the generalized eigenvalue problem.

.SKIPEE

Exclude all rotations between occupied positive-energy and virtual positive-energy orbitals.

.SKIPEP

Exclude all rotations between occupied positive-energy and virtual negative-energy orbitals.

Control reduced equations

.MAXITR

Maximum number of iterations.

Default:

.MAXITR
 30

.MAXRED

Maximum dimension of matrix in reduced system.

Default:

.MAXRED
 200

.THRESH

Threshold for convergence of reduced system.

Default:

.THRESH
 1.0D-5

Control integral contributions

The user is encouraged to experiment with these options since they may have an important effect on run time.

.INTFLG

Specify what two-electron integrals to include (default: .INTFLG under **HAMILTONIAN).

.CNVINT

Set threshold for convergence before adding SL and SS integrals to SCF-iterations.

2 (real) Arguments:

.CNVINT
 CNVXQR(1) CNVXQR(2)

Default: Very large numbers.

.ITRINT

Set the number of iterations before adding SL and SS integrals to SCF-iterations.

Default:

.ITRINT
 1 1

Advanced/debug flags

.E2CHEK

Generate a complete set of trial vector which implicitly allows the explicit construction of the electronic Hessian. Only to be used for small systems !

.ONLYSF

Only call FMOLI in sigmavector routine: only generate one-index transformed Fock matrix [Saue2003].

.ONLYSG

Only call FMOLI in sigmavector routine: 2-electron Fock matrices using one-index transformed densities [Saue2003].

.GNOISE

To test the robustness of property gradients to numerical noise artificial noise is added to the MO-coefficients. More precisely, the user activates noise and provides a “noise level”. Then, for each element of the coefficient array, a pseudo-random number in the interval (-1,+1] is selected, multiplied with the “noise level” and added to the element.

Example:

.GNOISE
 1.0D-10