**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.
.RDCCDM¶
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: \(\langle\hat{\mu}_\alpha\rangle=-e\langle r_\alpha\rangle\)
Note: for charged molecules the total electric dipole moment will depend on the gauge origin. It is possible to set the nuclei charge barycenter as the gauge origin so that the computed (total) dipole magnitude is representative for the electronic system as the nuclei electric dipole moment is constrained to vanish. Check for USEBC under *NMR.
.QUADRUPOLE¶
Evaluate the electronic traceless electric quadrupole moment
Expectation values: \(\langle\Theta_{\alpha\beta}\rangle=-e\frac {3}{2}\langle r_\alpha r_\beta-\frac{1}{3}\delta_{\alpha\beta}r^2\rangle\))
.EFG¶
Evaluate electric field gradients at nuclear positions, see [Visscher_JCP1998] .
Electronic contribution to center \(K\) (expectation values) :
Nuclear contributions to center \(K\) :
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
where \(Q\) is the electric quadrupole moment of the nucleus and \(q=\phi^{[2]}_{zz}/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
The calculations proceed similar to .EFG. The total electric field gradients for each center are transformed to a principal axis system for which
DIRAC reports the more general expressions
The asymmetry factor is defined as
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: \(\quad\alpha_{\alpha\beta}(-\omega;\omega)=\langle\langle\hat{\mu}_{\alpha};\hat{\mu}_{\beta}\rangle\rangle_{\omega}\)
.FIRST ORDER HYPERPOLARIZABILITY¶
Evaluate static electronic dipole first-order hyperpolarizability tensor, see [Norman_JCP2004] (HF) and [Henriksson:2008] (DFT).
Quadratic response function: \(\quad\beta_{\alpha\beta\gamma}(-\omega_\sigma;\omega_1,\omega_2)=\langle\langle\hat{\mu}_{\alpha};\hat{\mu}_{\beta},\hat{\mu}_{\gamma}\rangle\rangle_{\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
where appears the relativistic hyperfine operator
expressed in terms of the nuclear magnetic dipole \(\mathbf{m}_K\) and the operator \(\hat{\mathbf{B}}^{el}_{K}\) giving the magnetic field due to the electrons at the nuclear position, and the relativistic Zeeman operator
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
where appears the relativistic Zeeman operator
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
with
where appears the first order correction to the Born-Oppenheimer (BO) approximation
expressed in terms of the angular velocity \(\boldsymbol{\boldsymbol{\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
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
where appears gyromagnetic ratios \(\gamma_K\). The elements of the reduced tensor \(K_{KL}\) are expressed in terms of linear response functions as
where appears the relativistic hyperfine operator
expressed in terms of the nuclear magnetic dipole \(\mathbf{m}_K\) and the operator \(\hat{\mathbf{B}}^{el}_{K}\) 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{\rm C}\)
where \(M\) is the molecular mass in g \(\mbox{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
where \(C=eN/(24c_0\epsilon_0m_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.
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
where appears appears the normalized nuclear charge densities \(\rho^A\) and the the Fermi coupling constant \(G_F=2.222 55\times 10^{-14}E_ha_0^3\). The weak nuclear charge
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\)).
.PVCSHI¶
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
where appears the nuclear spin-dependent parity-violating operator
where appears the Fermi coupling constant \(G_F=2.222516\times 10^{-14}E_ha_0^3\) (this value corresponds to CODATA 2018, but it can change if you use other CODATA set), 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
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\).
Results are given in ppm.
Using .PRINT 1, the paramagnetic-like (e-e) and diamagnetic-like (e-p) parts of the linear response are given separately.
Atomic centers may be restricted with .SELECT under **INTEGRALS.
.PVCSR¶
Calculate parity-violating contribution to the nuclear spin-rotation tensor, see [Aucar_JCP2021]. Elements of the parity-violating contribution to the nuclear spin-rotation tensor for center \(K\) are given by
where appears the nuclear spin-dependent parity-violating operator
expressed in terms of the Fermi coupling constant \(G_F=2.222516\times 10^{-14}E_ha_0^3\) (this value corresponds to CODATA 2018, but it can change if you use other CODATA set), the nuclear spin \(\mathbf{I}_K\) and the normalized nuclear charge density \(\rho_K\) (in units of the inverse of cube distances), and the first order correction to the Born-Oppenheimer (BO) approximation
expressed in terms of the angular velocity \(\boldsymbol{\boldsymbol{\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.
Results are given in Hz.
Using .PRINT 1, the paramagnetic-like (e-e) and diamagnetic-like (e-p) parts of the linear response are given separately, together with results for the \(\mathbf{L}\) and \(\mathbf{S}\) parts of the linear response.
For more details, the user is welcome to see the Tutorial Section.
Atomic centers may be restricted with .SELECT under **INTEGRALS.
.RHONUC¶
Calculate electronic density at the nuclear positions, also known as the contact density [Knecht2011] and [Almoukhalalati:2016b].
It is formally an expectation value
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
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
where the effective density \(\bar\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
with
where appears the relativistic hyperfine operator
expressed in terms of the nuclear magnetic dipole \(\mathbf{m}_K= \gamma_K \mathbf{I}_K\) and the operator \(\hat{\mathbf{B}}^{el}_{K}\) giving the magnetic field due to the electrons at the nuclear position, and the first order correction to the Born-Oppenheimer (BO) approximation
expressed in terms of the angular velocity \(\boldsymbol{\boldsymbol{\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.