qiskit.chemistry.BosonicOperator

class BosonicOperator(h, basis)

A set of functions to map bosonic Hamiltonians to qubit Hamiltonians.

References:

• Veis Libor, et al., International Journal of Quantum Chemistry 116.18 (2016): 1328-1336.

• McArdle Sam, et al., Chemical science 10.22 (2019): 5725-5735.

• Ollitrault Pauline J., Chemical science 11 (2020): 6842-6855.

The Bosonic operator in this class is written in the n-mode second quantization format (Eq. 10 in Ref. Ollitrault Pauline J., Chemical science 11 (2020): 6842-6855.) The second quantization operators act on a given modal in a given mode. self._degree is the truncation degree of the expansion (n).

パラメータ

• h (List[List[Tuple[List[List[int]], float]]]) – Matrix elements for the n-body expansion. The format is as follows: h is a self._degree (n) dimensional array. For each degree n, h[n] contains the list [[indices, coeff]_0, [indices, coeff]_1, …] where the indices is a n-entry list and each entry is of the shape [mode, modal1, modal2] which define the indices of the corresponding raising (mode, modal1) and lowering (mode, modal2) operators.

• basis (List[int]) – Is a list defining the number of modals per mode. E.g. for a 3 modes system with 4 modals per mode basis = [4,4,4].

__init__(h, basis)

The Bosonic operator in this class is written in the n-mode second quantization format (Eq. 10 in Ref. Ollitrault Pauline J., Chemical science 11 (2020): 6842-6855.) The second quantization operators act on a given modal in a given mode. self._degree is the truncation degree of the expansion (n).

パラメータ

• h (List[List[Tuple[List[List[int]], float]]]) – Matrix elements for the n-body expansion. The format is as follows: h is a self._degree (n) dimensional array. For each degree n, h[n] contains the list [[indices, coeff]_0, [indices, coeff]_1, …] where the indices is a n-entry list and each entry is of the shape [mode, modal1, modal2] which define the indices of the corresponding raising (mode, modal1) and lowering (mode, modal2) operators.

• basis (List[int]) – Is a list defining the number of modals per mode. E.g. for a 3 modes system with 4 modals per mode basis = [4,4,4].

Methods

__init__(h, basis)	The Bosonic operator in this class is written in the n-mode second quantization format (Eq.
direct_mapping_filtering_criterion(state, value)	Filters out the states of irrelevant symmetries
mapping([qubit_mapping, threshold])	Maps a bosonic operator into a qubit operator.
number_occupied_modals_per_mode(mode)	A bosonic operator which can be used to evaluate the number of occupied modals in a given mode

direct_mapping_filtering_criterion(state, value, aux_values=None)

Filters out the states of irrelevant symmetries

パラメータ

• state (Union[List, ndarray]) – the statevector

• value (float) – the energy

• aux_values (Optional[List[float]]) – the auxiliary energies

戻り値の型

bool

戻り値

True if the state is has one and only one modal occupied per mode meaning that the direct mapping symmetries are respected and False otherwise

mapping(qubit_mapping='direct', threshold=1e-08)

Maps a bosonic operator into a qubit operator.

パラメータ

• qubit_mapping (str) – a string giving the type of mapping (only the 『direct』 mapping is implemented at this point)

• threshold (float) – threshold to chop the low contribution paulis

戻り値の型

WeightedPauliOperator

戻り値

A qubit operator

例外

ValueError – If requested mapping is not supported

number_occupied_modals_per_mode(mode)

A bosonic operator which can be used to evaluate the number of occupied modals in a given mode

パラメータ

mode (int) – the index of the mode

戻り値

the corresponding bosonic operator

戻り値の型

BosonicOperator