**PROPERTIES

This section allows for the evaluation of a large number of molecular properties. Available properties include:

• Expectation values (e.g. dipole moment and electric field gradients).

• Linear response properties (e.g. polarizability and NMR parameters).

• Quadratic response properties (e.g. hyperpolarizabilities).

For convenience some common properties can be specified directly in this section, which means that the user in principle does not need to know how they are calculated. Note, however, that response functions are by default static, but frequencies can be added in the relevant subsections.

Properties which are not predefined must be specified in detail in the relevant input section (see One-electron operators).

By default no properties are calculated.

General control statements

.PRINT

Print level.

Default:

.PRINT
 0

.ABUNDANCIES

For properties that make reference to isotopes, give threshold level (in % abundance) for isotopes to print.

Default:

.ABUNDANCIES
 1.0

.RKBIMP

Import coefficients calculated with restricted kinetic balance (RKB) in a calculation using unrestricted kinetic balance (UKB). This option is a simple way to generated restricted magnetic balance for the calculation of NMR shieldings. This option works in the general SO case, but not in the spinfree case since spinfree calculations are not possible with UKB.

.NOPCTR

In two-component infinite-order relativistic calculations (with .X2C) take only LL block of four-component property operators to avoid the picture change transformation. Experimental option, use with care.

.RDCCDENS

Activates the reading of the file CCDENS obtained from a previous CC calculation with either the .RELCCSD or with .EXACC modules. It is not necessary to use this keyword in runs in which the correlated and property modules are both activated.

CCDENS is not saved by pam, so unless the scratch directory from the previous calculation is kept (see –keep_scratch in pam), you should retrieve it after a correlated calculation, e.g.

pam --get=CCDENS ...

and then copy it back for the property calculation e.g.

pam --put=CCDENS ...

Predefined electric properties

.DIPOLE

Evaluate the electronic electric dipole moment

Expectation values: $⟨{\hat{\mu }}_{\alpha }⟩=-e⟨r_{\alpha }⟩$

.QUADRUPOLE

Evaluate the electronic traceless electric quadrupole moment

Expectation values: $⟨{\mathrm{\Theta }}_{\alpha \beta }⟩=-e\frac{3}{2}⟨r_{\alpha }{r}_{\beta }-\frac{1}{3}{\delta }_{\alpha \beta }{r}^2⟩$)

.EFG

Evaluate electric field gradients at nuclear positions, see [Visscher_JCP1998] .

Electronic contribution to center $K$ (expectation values) :

$${\varphi }_{\alpha \beta }^{[2]el}({\mathbf{R}}_K)=\frac{-e}{4\pi {\epsilon }_0}⟨\frac{3r_{K;\alpha }{r}_{K;\beta }-{\delta }_{\alpha \beta }{r}_K^2}{r_K^5}⟩$$

Nuclear contributions to center $K$ :

$${\varphi }_{\alpha \beta }^{[2]nuc}({\mathbf{R}}_K)=\sum _{A\ne K}\frac{Z_{A}e}{4\pi {\epsilon }_0}\left[\frac{3r_{KA;\alpha }{r}_{KA;\beta }-{\delta }_{\alpha \beta }{r}_{KA}^2}{r_{KA}^5}\right]$$

Results are also reported with respect to a principal axis system for each center.

Atomic centers may be restricted with .SELECT under **INTEGRALS.

.NQCC

Evaluate nuclear quadrupole coupling constants (NQCC) (expectation values). The NQCC is formally defined as

$$\frac{e^{2}qQ}{h}$$

where $Q$ is the electric quadrupole moment of the nucleus and $q={\varphi }_{zz}^{[2]}/e$ (in the principal axis system) is the field gradient. The NQCC may be extracted from experiment, whereas electronic structure calculations may provide the field gradient $q$. The two quantities are related as

$$\text{NQCC [in MHz] }=234.9647\times Q\text{ [in b] }\times q\text{ [in atomic units }{E}_h/e{a}_0^2\text{ ]}$$

The calculations proceed similar to .EFG. The total electric field gradients for each center are transformed to a principal axis system for which

$$|{\varphi }_{zz}^{[2]}|\ge |{\varphi }_{yy}^{[2]}|\ge |{\varphi }_{xx}^{[2]}|$$

DIRAC reports the more general expressions

$${\text{NQCC}}_{\alpha \alpha }\text{ [in MHz] }=234.9647\times Q\text{ [in b] }\times {\varphi }_{\alpha \alpha }^{[2]}/e\text{ [in atomic units }{E}_h/e{a}_0^2\text{ ]}$$

The asymmetry factor is defined as

$$\eta =\frac{{\varphi }_{xx}^{[2]}-{\varphi }_{yy}^{[2]}}{{\varphi }_{zz}^{[2]}}$$

Atomic centers may be restricted with .SELECT under **INTEGRALS.

.POLARIZABILITY

Evaluate the electronic dipole polarizability tensor, see [Saue2003] (HF) and [Salek2005] (DFT).

Linear response function: ${\alpha }_{\alpha \beta }(-\omega ;\omega )=⟨⟨{\hat{\mu }}_{\alpha };{\hat{\mu }}_{\beta }⟩{⟩}_{\omega }$

.FIRST ORDER HYPERPOLARIZABILITY

Evaluate static electronic dipole first-order hyperpolarizability tensor, see [Norman_JCP2004] (HF) and [Henriksson:2008] (DFT).

Quadratic response function: ${\beta }_{\alpha \beta \gamma }(-{\omega }_{\sigma };{\omega }_1,{\omega }_2)=⟨⟨{\hat{\mu }}_{\alpha };{\hat{\mu }}_{\beta },{\hat{\mu }}_{\gamma }⟩{⟩}_{{\omega }_1,{\omega }_2}$

Results are also given for the static electronic dipole polarizability.

.TWO-PHOTON

Evaluate two-photon absorption cross sections [Henriksson:2005], obtained as a first-order residue of the first-order hyperpolarizability. Give the number of desired states in each boson symmetry. Cannot be specified in combination with other quadratic response calculations.

Example: Point group with four boson irreps, (e.g. $C_{2v}$)

.TWO-PHOTON
 5 5 5 0

Predefined magnetic properties

.NMR

Evaluate nuclear magnetic shieldings and indirect spin-spin couplings (linear response functions), see [Visscher_jcc1999] and [Ilias2009].

Atomic centers may be restricted with .SELECT under **INTEGRALS.

See below for advice on calculation of diamagnetic terms.

.SHIELDING

Evaluate nuclear magnetic shieldings (linear response), see [Visscher_jcc1999] and [Ilias2009] .

Elements of the shielding tensor for center $K$ are given by

$${\sigma }_{K;\mu \nu }=\frac{{\partial }^2}{\partial m_{K;\mu }\partial B_{0;\nu }}⟨⟨{\hat{h}}_K^{hfs};{\hat{h}}^Z⟩{⟩}_0$$

where appears the relativistic hyperfine operator

$${\hat{h}}_K^{hfs}=-\sum _i{\mathbf{m}}_K\cdot {\hat{\mathbf{B}}}_K^{el}(i);{\mathbf{B}}_K^{el}(i)=-\frac{1}{4\pi {\epsilon }_0{c}^2}\frac{{\mathbf{r}}_{iK}\times ec\mathit{\alpha }}{r_{iK}^3},$$

expressed in terms of the nuclear magnetic dipole ${\mathbf{m}}_K$ and the operator ${\hat{\mathbf{B}}}_K^{el}$ giving the magnetic field due to the electrons at the nuclear position, and the relativistic Zeeman operator

$${\hat{h}}^Z=-{\hat{\mathbf{m}}}_e^{[1]}\cdot {\mathbf{B}}_0;{\hat{\mathbf{m}}}_e^{[1]}=-\sum _i\frac{e}{2}({\mathbf{r}}_{iG}\times c\mathit{\alpha }(i)),$$

expressed in terms of the operator ${\hat{\mathbf{m}}}_e^{[1]}$ associated with the magnetic dipole moment of the electrons and the external magnetic field ${\mathbf{B}}_0$. Note reference to the gauge origin $G$.

Note that .PRINT 2 gives the full tensor and longer output. The .PRINT 4 gives the raw values in symmetry coordinates as well.

Atomic centers may be restricted with .SELECT under **INTEGRALS.

.MAGNET

Evaluate the (static) magnetizablity tensor [Ilias2013]

Lineare response function

$${\xi }_{K;\alpha \beta }=-\frac{{\partial }^2}{\partial B_{\alpha }\partial B_{\beta }}⟨⟨{\hat{h}}^Z;{\hat{h}}^Z⟩{⟩}_0$$

where appears the relativistic Zeeman operator

$${\hat{h}}^Z=-{\hat{\mathbf{m}}}_e^{[1]}\cdot {\mathbf{B}}_0;{\hat{\mathbf{m}}}_e^{[1]}=-\sum _i\frac{e}{2}({\mathbf{r}}_{iG}\times c\mathit{\alpha }(i)),$$

expressed in terms of the operator ${\hat{\mathbf{m}}}_e^{[1]}$ associated with the magnetic dipole moment of the electrons and the external magnetic field ${\mathbf{B}}_0$. Note reference to the gauge origin $G$.

.ROTG

Evaluate rotational g-tensors: linear response and nuclear contributions, see [Aucar_JCP2014].

Elements of the rotational g-tensor are given by

$$g_{\mu \nu }=g_{\mu \nu }^{nuc}+g_{\mu \nu }^{elec}$$

with

$$g_{\mu \nu }^{elec}=-\frac{2m_p}{e}\frac{{\partial }^2}{\partial L_{\mu }\partial B_{0;\nu }}⟨⟨{\hat{h}}^{BO};{\hat{h}}^Z⟩{⟩}_0$$

where appears the first order correction to the Born-Oppenheimer (BO) approximation

$${\hat{h}}^{BO}=-\mathit{\omega }\cdot {\hat{\mathbf{J}}}_e;\mathit{\omega }=\mathbf{L}\otimes {\mathbf{I}}^{-1},$$

expressed in terms of the angular velocity $\mathit{\omega }$ associated with the total angular momentum of the electrons ${\hat{\mathbf{J}}}_e={\hat{\mathbf{L}}}_e+{\hat{\mathbf{S}}}_e$, and the relativistic Zeeman operator

$${\hat{h}}^Z=-{\hat{\mathbf{m}}}_e^{[1]}\cdot {\mathbf{B}}_0;{\hat{\mathbf{m}}}_e^{[1]}=-\sum _i\frac{e}{2}({\mathbf{r}}_{iG}\times c\mathit{\alpha }(i)),$$

expressed in terms of the operator ${\hat{\mathbf{m}}}_e^{[1]}$ associated with the magnetic dipole moment of the electrons and the external magnetic field ${\mathbf{B}}_0$. Note reference to the gauge origin $G$.

Results are dimensionless.

The total g-tensor, as well as its linear response and nuclear contributions are always given separately.

Using .PRINT 1, the paramagnetic (e-e) and diamagnetic (e-p) parts of the linear response contributions are given separately, together with results for the $\mathbf{L}$ and $\mathbf{S}$ parts of the linear response.

.SPIN-SPIN COUPLING

Evaluate indirect spin-spin couplings [Visscher_jcc1999] . The indirect spin-spin tensor $J_{KL}$ associated with nuclei $K$ and $L$ may be expressed as

$$2\pi J_{KL}={\gamma }_K{\gamma }_L{K}_{KL}$$

where appears gyromagnetic ratios ${\gamma }_K$. The elements of the reduced tensor $K_{KL}$ are expressed in terms of linear response functions as

$$K_{KL:\mu \nu }=\frac{{\partial }^2}{\partial m_{K;\mu }\partial m_{L;\nu }}⟨⟨{\hat{h}}_{K,\mathrm{rel}}^{\mathrm{h}\mathrm{f}\mathrm{s}};{\hat{h}}_{L,\mathrm{rel}}^{\mathrm{h}\mathrm{f}\mathrm{s}}⟩{⟩}_0$$

where appears the relativistic hyperfine operator

$${\hat{h}}_K^{hfs}=-\sum _i{\mathbf{m}}_K\cdot {\hat{\mathbf{B}}}_K^{el}(i);{\mathbf{B}}_K^{el}(i)=-\frac{1}{4\pi {\epsilon }_0{c}^2}\frac{{\mathbf{r}}_{iK}\times ec\mathit{\alpha }}{r_{iK}^3},$$

expressed in terms of the nuclear magnetic dipole ${\mathbf{m}}_K$ and the operator ${\hat{\mathbf{B}}}_K^{el}$ giving the magnetic field due to the electrons at the nuclear position.

Atomic centers may be restricted with .SELECT under **INTEGRALS.

The default is to calculate the diamagnetic term via occupied positive energy to virtual negative energy orbital rotations (also called electron-positron rotations), see [Aucar1999] for the theory. The quality of this is very basis set dependent. It is generally more accurate to use the non-relativistic expectation value expression for the diamagnetic term, activated with keyword .DSO in this section. You must also add .SKIPEP under *LINEAR RESPONSE to exclude the diamagnetic term from the linear response calculation.

.DSO

Evaluate the diamagnetic contribution to indirect spin-spin couplings as an expectation value of the non-relativistic DSO operator.

Atomic centers may be restricted with .SELECT under **INTEGRALS.

.NSTDIAMAGNETIC

Evaluate the diamagnetic contribution to nuclear magnetic shielding tensor as an expectation value of the non-relativistic operator.

Atomic centers may be restricted with .SELECT under **INTEGRALS.

Mixed electric and magnetic properties

.OPTROT

Calculate optical rotation. The most common experimental setup uses light with a frequency corresponding to the sodium D-line (589.29 nm). The optical rotation is reported as the number of degrees of rotation of the plane of polarization per mole of sample for a sample cell of length 1~dm, and at a temperature of ${25}^{\circ }\mathrm{C}$

$${\left[\alpha \right]}_D^{25}=-288\cdot {10}^{-30}\frac{{\pi }^2\mathcal{N}{a}_0^4\omega }{3M}\sum _{\alpha }{G}_{\alpha \alpha }^{\prime };G_{\alpha \beta }^{\prime }(-\omega ;\omega )=-\text{Im}⟨⟨{\hat{\mu }}_{\alpha };{\hat{m}}_{\beta }⟩{⟩}_{\omega }$$

where $M$ is the molecular mass in g ${\text{mol}}^{-1}$ and $\mathcal{N}$ is the number density.

.VERDET

Evaluate Verdet constants [Ekstrom2005] for a dynamic electric field corresponding to Ruby laser wavelength of 694 nm and a static magnetic field along the propagation direction of the light beam (in this case, the default frequencies of the quadratic response function thus become ω_*B* = 0.0656 and ω_*C* = 0.0).

The Verdet constant is given in terms of quadratic response functions

$$V(\omega )=\omega C{ϵ}_{\alpha \beta \gamma }\text{Im}⟨⟨{\hat{\mu }}_{\alpha };{\hat{\mu }}_{\beta },{\hat{m}}_{\gamma }⟩{⟩}_{\omega ,0}$$

where $C=eN/(24c_0{ϵ}_0{m}_e$ and $N$ is the number density of the gas. A Verdet calculation cannot be specified in combination with other quadratic response calculations.

The frequencies can be changed using .B FREQ in *QUADRATIC RESPONSE.

Other predefined properties

.MOLGRD

Evaluate the molecular gradient, i.e.

$$\frac{\partial E}{\partial {\mathbf{X}}_A}$$

where ${\mathbf{X}}_A$ are the coordinates of the nuclei. This is an expectation value of one- and two-electron operators. Normally the molecular gradient evaluation is not invoked explicitly with this keyword but rather implicitly in the geometry optimization module.

.PVC

Calculate matrix elements over the nuclear spin-independent parity-violating operator, e.g. calculate energy differences between enantiomers, see [Laerdahl1999] and [Bast2011] .

The parity violating energy is calculated as an expectation value

$$E_{\text{PV}}=\sum _A⟨H_{\text{PV}}^A⟩;H_{\text{PV}}^A=\frac{G_{\text{F}}}{2\sqrt{2}}{Q}_{\text{w}}^A\sum _i{\gamma }_5(i){\rho }^A({\mathbf{r}}_i)$$

where appears appears the normalized nuclear charge densities ${\rho }^A$ and the the Fermi coupling constant $G_F=2.22255\times {10}^{-14}{E}_h{a}_0^3$. The weak nuclear charge

$$Q_{\text{w}}^A=Z^A{C}_V^{\text{p}}+N^A{C}_V^{\text{n}}=Z^A(1-4{\sin }^2{\theta }_{\text{W}})-N^A,$$

given in terms of the number of protons and neutrons — $Z^A$ and $N^A$ – in nucleus $A$ and the Weinberg angle ${\theta }_{\text{W}}$ which describes the rotation of $B^0$ and $W^0$ bosons by spontaneous symmetry breaking to form photons and $Z^0$ bosons (DIRAC uses ${\sin }^2{\theta }_{\text{W}}=0.2319$).

.PVCNMR

Calculate parity-violating contribution to the NMR shielding tensor, see [Bast:2006]. Elements of the parity-violating contribution to the shielding tensor for center $K$ are given by

$${\sigma }_{K;\mu \nu }^{PV}=\frac{{\partial }^2}{\partial m_{K;\mu }\partial B_{0;\nu }}⟨⟨h_{\text{PV2}}^K;{\hat{h}}^Z⟩{⟩}_0$$

where appears the nuclear spin-dependent parity-violating operator

$$h_{\text{PV2}}^K=-\frac{G_{\text{F}}(1-4{\sin }^2{\theta }_{\text{W}})}{\sqrt{2}}\sum _i\frac{1}{{\gamma }_K}\mathit{\alpha }\cdot {\mathbf{M}}_K{\rho }_K({\mathbf{r}}_i)$$

where appears the Fermi coupling constant $G_F=2.22255\times {10}^{-14}{E}_h{a}_0^3$, the gyromagnetic ratio ${\gamma }_K$, the nuclear magnetic dipole moment ${\mathbf{M}}_K={\gamma }_K{\mathbf{I}}_K$ and the normalized nuclear charge density ${\rho }_K$.

The relativistic Zeeman operator

$${\hat{h}}^Z=-{\hat{\mathbf{m}}}_e^{[1]}\cdot {\mathbf{B}}_0;{\hat{\mathbf{m}}}_e^{[1]}=-\sum _i\frac{e}{2}({\mathbf{r}}_{iG}\times c\mathit{\alpha }(i)),$$

is expressed in terms of the operator ${\hat{\mathbf{m}}}_e^{[1]}$ associated with the magnetic dipole moment of the electrons and the external magnetic field ${\mathbf{B}}_0$. Note reference to the gauge origin $G$.

.RHONUC

Calculate electronic density at the nuclear positions, also known as the contact density [Knecht2011] and [Almoukhalalati:2016b].

It is formally an expectation value

$${\rho }_e^K=-e⟨{\delta }^3(\mathbf{r}-{\mathbf{R}}_K)⟩,$$

an important observation in view of picture change effects, see [Knecht2011] .

Atomic centers may be restricted with .SELECT under **INTEGRALS.

.EFFDEN

Calculate effective electronic density associated with nuclei, see [Knecht2011]. This quantity appears in expressions for the Mössbauer isomer shift. Starting from the electrostatic electron-nucleus interaction

$$E^{el}\left(R\right)=\int {\rho }_e(\mathbf{r}){\varphi }_n(\mathbf{r};R){\mathrm{d}}^3\mathbf{r},$$

we consider the change in the electrostatic energy upon a change of nuclear radius. If we ignore any change in the electronic density ${\rho }_e$, we may express this as

$$\mathrm{\Delta }{E}_{\gamma }={\frac{\partial E^{el}}{\partial R}|}_{R=R_0}\mathrm{\Delta }R={[\int {\rho }_e(\mathbf{r})\frac{\partial {\varphi }_n(\mathbf{r})}{\partial R}{\mathrm{d}}^3\mathbf{r}]}_{R=R_0}\mathrm{\Delta }R={\overline{\rho }}_e\int {\left[\frac{\partial {\varphi }_n(\mathbf{r})}{\partial R}{\mathrm{d}}^3\mathbf{r}\right]}_{R=R_0}\mathrm{\Delta }R$$

where the effective density ${\overline{\rho }}_e$ is introduced in the last step. It is often approximated by the contact density, see .RHONUC , but this is discouraged since it may introduce errors on the order of 10%.

Atomic centers may be restricted with .SELECT under **INTEGRALS.

.SPIN-ROTATION

Evaluate nuclear spin-rotation constants: linear response, expectation value and nuclear contributions, see [Aucar_JCP2012] and [AucarChap2019].

Elements of the nuclear spin-rotation tensor for center $K$ in a molecule in equilibrium are given by

$$M_{K;\mu \nu }=M_{K;\mu \nu }^{nuc}+M_{K;\mu \nu }^{elec}$$

with

$$M_{K;\mu \nu }^{elec}=-{\hslash }^2\frac{{\partial }^2}{\partial I_{K;\mu }\partial L_{\nu }}⟨⟨{\hat{h}}_K^{hfs};{\hat{h}}^{BO}⟩{⟩}_0$$

where appears the relativistic hyperfine operator

$${\hat{h}}_K^{hfs}=-\sum _i{\mathbf{m}}_K\cdot {\hat{\mathbf{B}}}_K^{el}(i);{\mathbf{B}}_K^{el}(i)=-\frac{1}{4\pi {\epsilon }_0{c}^2}\frac{{\mathbf{r}}_{iK}\times ec\mathit{\alpha }}{r_{iK}^3},$$

expressed in terms of the nuclear magnetic dipole ${\mathbf{m}}_K=\hslash {\gamma }_K{\mathbf{I}}_K$ and the operator ${\hat{\mathbf{B}}}_K^{el}$ giving the magnetic field due to the electrons at the nuclear position, and the first order correction to the Born-Oppenheimer (BO) approximation

$${\hat{h}}^{BO}=-\mathit{\omega }\cdot {\hat{\mathbf{J}}}_e;\mathit{\omega }=\mathbf{L}\otimes {\mathbf{I}}^{-1},$$

expressed in terms of the angular velocity $\mathit{\omega }$ associated with the total angular momentum of the electrons ${\hat{\mathbf{J}}}_e={\hat{\mathbf{L}}}_e+{\hat{\mathbf{S}}}_e$. Note that the origin of the orbital angular momentum is the molecular center of mass.

Note

The current implementation gives by default (.PRINT values up to 3) results only for molecules in equilibrium.

Results are given in kHz, but for particular .PRINT values they could also be given in ppm (to compare results with .SHIELDING).

The total spin-rotation tensors, as well as their electronic (linear response) and nuclear contributions are always given separately.

Using .PRINT 0 or 1, results are only given in kHz, whereas employing .PRINT 2 or 3 they are also shown in ppm.

In addition, when .PRINT 1 or 3 are used, the paramagnetic-like (e-e) and diamagnetic-like (e-p) parts of the linear response contributions are given separately, together with results for the $\mathbf{L}$ and $\mathbf{S}$ parts of the linear response.

Finally, employing .PRINT 4 expectation value and nuclear contributions are given separately, with the inclusion of Thomas precesion effects, in order to properly include contributions to nuclear spin-rotations out of the equilibrium geometry of the molecular system.

For more details, the user is welcome to see the Tutorial Section.

Atomic centers may be restricted with .SELECT under **INTEGRALS.