qiskit-documentation/docs/api/qiskit/0.30/qiskit.chemistry.algorithms...

122 lines
4.8 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: QEomEE
description: API reference for qiskit.chemistry.algorithms.QEomEE
in_page_toc_min_heading_level: 1
python_api_type: class
python_api_name: qiskit.chemistry.algorithms.QEomEE
---
# QEomEE
<Class id="qiskit.chemistry.algorithms.QEomEE" isDedicatedPage={true} github="https://github.com/qiskit-community/qiskit-aqua/tree/stable/0.9/qiskit/chemistry/algorithms/eigen_solvers/q_eom_ee.py" signature="QEomEE(operator, num_orbitals, num_particles, qubit_mapping='parity', two_qubit_reduction=True, active_occupied=None, active_unoccupied=None, is_eom_matrix_symmetric=True, se_list=None, de_list=None, z2_symmetries=None, untapered_op=None, aux_operators=None)" modifiers="class">
Bases: `qiskit.aqua.algorithms.minimum_eigen_solvers.numpy_minimum_eigen_solver.NumPyMinimumEigensolver`
QEomEE algorithm (classical)
**Parameters**
* **operator** (`LegacyBaseOperator`) qubit operator
* **num\_orbitals** (`int`) total number of spin orbitals, has a min. value of 1.
* **num\_particles** (`Union`\[`List`\[`int`], `int`]) number of particles, if it is a list, the first number is alpha and the second number if beta.
* **qubit\_mapping** (`str`) qubit mapping type
* **two\_qubit\_reduction** (`bool`) two qubit reduction is applied or not
* **active\_occupied** (`Optional`\[`List`\[`int`]]) list of occupied orbitals to include, indices are 0 to n where n is num particles // 2
* **active\_unoccupied** (`Optional`\[`List`\[`int`]]) list of unoccupied orbitals to include, indices are 0 to m where m is (num\_orbitals - num particles) // 2
* **is\_eom\_matrix\_symmetric** (`bool`) is EoM matrix symmetric
* **se\_list** (`Optional`\[`List`\[`List`\[`int`]]]) single excitation list, overwrite the setting in active space
* **de\_list** (`Optional`\[`List`\[`List`\[`int`]]]) double excitation list, overwrite the setting in active space
* **z2\_symmetries** (`Optional`\[`Z2Symmetries`]) represent the Z2 symmetries
* **untapered\_op** (`Optional`\[`LegacyBaseOperator`]) if the operator is tapered, we need untapered operator to build element of EoM matrix
* **aux\_operators** (`Optional`\[`List`\[`LegacyBaseOperator`]]) Auxiliary operators to be evaluated at each eigenvalue
**Raises**
**ValueError** invalid parameter
## Methods
### compute\_minimum\_eigenvalue
<Function id="qiskit.chemistry.algorithms.QEomEE.compute_minimum_eigenvalue" signature="QEomEE.compute_minimum_eigenvalue(operator=None, aux_operators=None)">
Computes minimum eigenvalue. Operator and aux\_operators can be supplied here and if not None will override any already set into algorithm so it can be reused with different operators. While an operator is required by algorithms, aux\_operators are optional. To remove a previous aux\_operators array use an empty list here.
**Parameters**
* **operator** (`Union`\[`OperatorBase`, `LegacyBaseOperator`, `None`]) If not None replaces operator in algorithm
* **aux\_operators** (`Optional`\[`List`\[`Union`\[`OperatorBase`, `LegacyBaseOperator`, `None`]]]) If not None replaces aux\_operators in algorithm
**Return type**
`MinimumEigensolverResult`
**Returns**
MinimumEigensolverResult
</Function>
### run
<Function id="qiskit.chemistry.algorithms.QEomEE.run" signature="QEomEE.run()">
Execute the classical algorithm.
**Returns**
results of an algorithm.
**Return type**
dict
</Function>
### supports\_aux\_operators
<Function id="qiskit.chemistry.algorithms.QEomEE.supports_aux_operators" signature="QEomEE.supports_aux_operators()" modifiers="classmethod">
Whether computing the expectation value of auxiliary operators is supported.
If the minimum eigensolver computes an eigenstate of the main operator then it can compute the expectation value of the aux\_operators for that state. Otherwise they will be ignored.
**Return type**
`bool`
**Returns**
True if aux\_operator expectations can be evaluated, False otherwise
</Function>
## Attributes
### aux\_operators
<Attribute id="qiskit.chemistry.algorithms.QEomEE.aux_operators">
**Return type**
`Optional`\[`List`\[`Optional`\[`OperatorBase`]]]
</Attribute>
### filter\_criterion
<Attribute id="qiskit.chemistry.algorithms.QEomEE.filter_criterion">
returns the filter criterion if set
**Return type**
`Optional`\[`Callable`\[\[`Union`\[`List`, `ndarray`], `float`, `Optional`\[`List`\[`float`]]], `bool`]]
</Attribute>
### operator
<Attribute id="qiskit.chemistry.algorithms.QEomEE.operator">
**Return type**
`Optional`\[`OperatorBase`]
</Attribute>
### random
<Attribute id="qiskit.chemistry.algorithms.QEomEE.random">
Return a numpy random.
</Attribute>
</Class>