qiskit-documentation/docs/api/qiskit/0.32/qiskit.chemistry.MP2Info.mdx

113 lines
3.3 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: MP2Info
description: API reference for qiskit.chemistry.MP2Info
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.chemistry.MP2Info
---
# MP2Info
<Class id="qiskit.chemistry.MP2Info" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-aqua/tree/stable/0.9/qiskit/chemistry/mp2info.py" signature="MP2Info(qmolecule, threshold=1e-12)" modifiers="class">
Bases: `object`
A utility class for Moller-Plesset 2nd order (MP2) information
Each double excitation given by \[i,a,j,b] has a coefficient computed using
coeff = -(2 \* Tiajb - Tibja)/(oe\[b] + oe\[a] - oe\[i] - oe\[j])
where oe\[] is the orbital energy
and an energy delta given by
e\_delta = coeff \* Tiajb
All the computations are done using the molecule orbitals but the indexes used in the excitation information passed in and out are in the block spin orbital numbering as normally used by the chemistry module.
A utility class for MP2 info
**Parameters**
* **qmolecule** ([*QMolecule*](qiskit.chemistry.QMolecule "qiskit.chemistry.QMolecule")) QMolecule from chemistry driver
* **threshold** (*float*) Computed coefficients and energy deltas will be set to zero if their value is below this threshold
## Methods
### mp2\_get\_term\_info
<Function id="qiskit.chemistry.MP2Info.mp2_get_term_info" signature="MP2Info.mp2_get_term_info(excitation_list, freeze_core=False, orbital_reduction=None)">
With a reduced active space the set of used excitations can be less than allowing all available excitations. Given a (sub)set of excitations in the space this will return a list of correlation coefficients and a list of correlation energies ordered as per the excitation list provided.
**Parameters**
* **excitation\_list** (*list*) A list of excitations for which to get the coeff and e\_delta
* **freeze\_core** (*bool*) Whether core orbitals are frozen or not
* **orbital\_reduction** (*list*) An optional list of ints indicating removed orbitals
**Returns**
List of coefficients and list of energy deltas
**Return type**
Tuple(list, list)
**Raises**
**ValueError** Excitation not present in mp2 terms
</Function>
### mp2\_terms
<Function id="qiskit.chemistry.MP2Info.mp2_terms" signature="MP2Info.mp2_terms(freeze_core=False, orbital_reduction=None)">
Gets the set of MP2 terms for the molecule taking into account index adjustments due to frozen core and/or other orbital reduction
**Parameters**
* **freeze\_core** (*bool*) Whether core orbitals are frozen or not
* **orbital\_reduction** (*list*) An optional list of ints indicating removed orbitals
**Returns**
**A dictionary of excitations where the key is a string in the form**
from\_to\_from\_to e.g. 0\_4\_6\_10 and the value is a tuple of (coeff, e\_delta)
**Return type**
dict
</Function>
## Attributes
### mp2\_delta
<Attribute id="qiskit.chemistry.MP2Info.mp2_delta">
Get the MP2 delta energy correction for the molecule
**Returns**
The MP2 delta energy
**Return type**
float
</Attribute>
### mp2\_energy
<Attribute id="qiskit.chemistry.MP2Info.mp2_energy">
Get the MP2 energy for the molecule
**Returns**
The MP2 energy
**Return type**
float
</Attribute>
</Class>