135 lines
5.8 KiB
Plaintext
135 lines
5.8 KiB
Plaintext
---
|
||
title: MP2Info (v0.26)
|
||
description: API reference for qiskit.chemistry.MP2Info in qiskit v0.26
|
||
in_page_toc_min_heading_level: 1
|
||
python_api_type: class
|
||
python_api_name: qiskit.chemistry.MP2Info
|
||
---
|
||
|
||
<span id="qiskit-chemistry-mp2info" />
|
||
|
||
# qiskit.chemistry.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">
|
||
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
|
||
|
||
### \_\_init\_\_
|
||
|
||
<Function id="qiskit.chemistry.MP2Info.__init__" signature="__init__(qmolecule, threshold=1e-12)">
|
||
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
|
||
</Function>
|
||
|
||
## Methods
|
||
|
||
| | |
|
||
| --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
|
||
| [`__init__`](#qiskit.chemistry.MP2Info.__init__ "qiskit.chemistry.MP2Info.__init__")(qmolecule\[, threshold]) | A utility class for MP2 info |
|
||
| [`mp2_get_term_info`](#qiskit.chemistry.MP2Info.mp2_get_term_info "qiskit.chemistry.MP2Info.mp2_get_term_info")(excitation\_list\[, …]) | With a reduced active space the set of used excitations can be less than allowing all available excitations. |
|
||
| [`mp2_terms`](#qiskit.chemistry.MP2Info.mp2_terms "qiskit.chemistry.MP2Info.mp2_terms")(\[freeze\_core, orbital\_reduction]) | Gets the set of MP2 terms for the molecule taking into account index adjustments due to frozen core and/or other orbital reduction |
|
||
|
||
## Attributes
|
||
|
||
| | |
|
||
| ------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
|
||
| [`mp2_delta`](#qiskit.chemistry.MP2Info.mp2_delta "qiskit.chemistry.MP2Info.mp2_delta") | Get the MP2 delta energy correction for the molecule |
|
||
| [`mp2_energy`](#qiskit.chemistry.MP2Info.mp2_energy "qiskit.chemistry.MP2Info.mp2_energy") | Get the MP2 energy for the molecule |
|
||
|
||
### 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>
|
||
|
||
### mp2\_get\_term\_info
|
||
|
||
<Function id="qiskit.chemistry.MP2Info.mp2_get_term_info" signature="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="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>
|
||
</Class>
|
||
|