Parametric2RDM - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


QuantumChemistry

  

Parametric2RDM

  

compute the ground-state energy of a molecule as a parametric functional of the two-electron reduced density matrix (2-RDM)

 

Calling Sequence
Description
Options

Outputs
References
Examples

Calling Sequence

Parametric2RDM(molecule, options)

Parameters

molecule

-

list of lists; each list has 4 elements, the string of an atom's symbol and atom's x, y, and z coordinates

options

-

(optional) equation(s) of the form option = value where option is one of functional, nuclear_gradient, return_rdm, return_t2t1, populations, symmetry, unit, frozen, conv_tol, max_memory, max_cycle, conv_tol_hf, diis_hf, diis_space_hf, diis_start_cycle_hf, direct_scf_hf, direct_scf_tol_hf, level_shift_hf, max_cycle_hf, nuclear_gradient_hf, populations_hf

Description

• 

The parametric 2-RDM method computes the ground-state energy of a molecule as a parametric functional of the two-electron reduced density matrix (2-RDM).  The parametrization approximately enforces N-representability conditions, which are necessary constraints for the 2-RDM to represent an N-electron density matrix.

• 

Energies and properties from the parametric 2-RDM method typically have an accuracy between those from coupled cluster with single and double excitations (CCSD) and those from coupled cluster with single, double, and perturbative triple excitations [CCSD(T)].

• 

The optional functional keyword controls the parametric functional employed in the calculation.  It can be set to the following strings: "CEPA", "K", and "M" (default).

• 

The optional return_rdm keyword controls whether or not the spin-free 1- and/or 2-RDMs are returned.  If set to "rdm1" (default), the 1-RDM is returned, if set to "rdm1_and_rdm2", the 1- and 2-RDMs are returned, and if set to "none", RDMs are not returned.

• 

The optional frozen keyword can be provided to prevent some orbitals from being correlated.  The keyword can be assigned to a set {} containing the indices of the molecular orbitals to be treated as frozen.  If the frozen keyword is not assigned, then all of the molecular orbitals are considered active, and a parametric 2-RDM calculation with all orbitals is performed.

Outputs

The table of following contents:

te_tot

-

float -- total electronic energy of the system

te_corr

-

float -- the difference between the variational 2-RDM method's energy and the Hartree-Fock energy

tmo_coeff

-

Matrix -- coefficients expressing natural molecular orbitals (columns) in terms of atomic orbitals (rows)

tmo_occ

-

Vector -- molecular (natural) orbital occupations

tgroup

-

string -- name of the molecule's point group symmetry

taolabels

-

Vector -- string label for each atomic orbital consisting of the atomic symbol and the orbital name

tactive_orbitals

-

list -- list of integers and/or integer ranges indicating the molecular orbitals that are active for correlation

trdm1

-

Matrix -- one-particle reduced density matrix (1-RDM) in molecular-orbital (MO) representation

trdm2

-

Matrix -- two-particle reduced density matrix (2-RDM) in molecular-orbital (MO) representation

tdipole

-

Vector -- dipole moment according to its x, y and z components

tpopulations

-

Matrix -- atomic-orbital populations

tcharges

-

Vector -- atomic charges from the populations

tnuclear_gradient

-

Matrix -- analytical nuclear gradient

tt2t1

-

Vector -- one- and two-electron transition amplitudes

tt2t1_indices

-

Matrix -- the first 4 indices of each row give the indices of either t2 (or t1 if the last two integers are 0)

The 5th integer indicates the spin block.  For t2: 2 = αα, 1 = αβ, 0 = ββ; for t1: 1 = α, 0 = β. 

Options

• 

basis = string -- name of the basis set.  See Basis for a list of available basis sets.  Default is "sto-3g".

• 

spin = nonnegint -- twice the total spin S (= 2S). Default is 0.

• 

charge = nonnegint -- net charge of the molecule. Default is 0.

• 

symmetry = string/boolean -- is the Schoenflies symbol of the abelian point-group symmetry which can be one of the following:  D2h, C2h, C2v, D2, Cs, Ci, C2, C1. true (default) finds the appropriate symmetry while false does not use symmetry.

• 

unit = string -- "Angstrom" or "Bohr". Default is "Angstrom".

• 

ghost = list of lists -- each list has the string of an atom's symbol and the atom's x, y, and z coordinates.  See Ghost Atoms.

• 

functional = string -- "CEPA", "K", or "M". Default is "M".

• 

frozen = set -- set of orbitals to be frozen.

• 

return_rdm = string -- options to return the 1-RDM and/or 2-RDM: "none", "rdm1", "rdm1_and_rdm2". Default is "rdm1".

• 

return_t2t1 = boolean -- option to return the one- and two-electron transition amplitudes.  Default is false.

• 

populations = string -- atomic-orbital population analysis: "Mulliken" and "Mulliken/meta-Lowdin". Default is "Mulliken".

• 

nuclear_gradient = boolean -- option to return the analytical nuclear gradient if available. Default is false.

• 

conv_tol = float -- converge threshold. Default is 5*105.

• 

max_memory = posint/boolean -- allowed memory in MB. Default is 4000.

• 

verbose = posint -- positive integer between 1 and 5 that controls printing. Default is 1.

• 

Attributes for Hartree Fock:

• 

conv_tol_hf = float -- converge threshold. Default is 1010.

• 

diis_hf = boolean -- whether to do diis. Default is true.

• 

diis_space_hf = posinut -- diis's space size. By default, 8 Fock matrices and errors vector are stored.

• 

diis_start_cycle_hf = posint -- the step to start diis. Default is 1.

• 

direct_scf_hf = boolean -- direct SCF in which integrals are recomputed is used by default.

• 

direct_scf_tol_hf = float -- direct SCF cutoff threshold. Default is 1013.

• 

level_shift_hf = float/int -- level shift (in a.u.) for virtual space. Default is 0.

• 

max_cycle_hf = posint -- max number of iterations. Default is 50.

• 

nuclear_gradient_hf = boolean -- option to return the analytical nuclear gradient. Default is false.

• 

populations_hf = string -- atomic-orbital population analysis: "Mulliken" and "Mulliken/meta-Lowdin". Default is "Mulliken".

References

1. 

D. A. Mazziotti, Phys. Rev. Lett. 101, 253002 (2008). "Parametrization of the two-electron reduced density matrix for its direct calculation without the many-electron wave function"

2. 

D. A. Mazziotti, Phys. Rev. A 81, 062515 (2010). "Parametrization of the two-electron reduced density matrix for its direct calculation without the many-electron wave function: Generalizations and applications"

3. 

J. J. Foley IV and D. A. Mazziotti, J.Phys. Chem. A 117, 6712 (2013). "Cage versus prism: electronic energies of the water hexamer"

4. 

A. J. Valentine and D. A. Mazziotti, J. Phys. Chem. A 117, 9746 (2013). "Theoretical prediction of the structures and energies of olympicene and its isomers"

Examples

withQuantumChemistry:

A parametric 2-RDM calculation of the hydrogen fluoride HF molecule

molecule  H,0,0,0,F,0,0,0.95;

moleculeH,0,0,0,F,0,0,0.95000000

(1)

output_hf  Parametric2RDMmolecule, basis=dz;

See Also

QuantumChemistry
HartreeFock
Variational2RDM
CoupledCluster
MP2
ContractedSchrodinger