qiskit.opflow.converters.AbelianGrouper

class AbelianGrouper(traverse=True)

The AbelianGrouper converts SummedOps into a sum of Abelian sums.

Meaning, it will traverse the Operator, and when it finds a SummedOp, it will evaluate which of the summed sub-Operators commute with one another. It will then convert each of the groups of commuting Operators into their own SummedOps, and return the sum-of-commuting-SummedOps. This is particularly useful for cases where mutually commuting groups can be handled similarly, as in the case of Pauli Expectations, where commuting Paulis have the same diagonalizing circuit rotation, or Pauli Evolutions, where commuting Paulis can be diagonalized together.

パラメータ

traverse (bool) – Whether to convert only the Operator passed to convert, or traverse down that Operator.

__init__(traverse=True)

パラメータ

traverse (bool) – Whether to convert only the Operator passed to convert, or traverse down that Operator.

Methods

__init__([traverse])	type traverse bool
convert(operator)	Check if operator is a SummedOp, in which case covert it into a sum of mutually commuting sums, or if the Operator contains sub-Operators and traverse is True, attempt to convert any sub-Operators.
group_subops(list_op)	Given a ListOp, attempt to group into Abelian ListOps of the same type.

convert(operator)

Check if operator is a SummedOp, in which case covert it into a sum of mutually commuting sums, or if the Operator contains sub-Operators and traverse is True, attempt to convert any sub-Operators.

パラメータ

operator (OperatorBase) – The Operator to attempt to convert.

戻り値の型

OperatorBase

戻り値

The converted Operator.

classmethod group_subops(list_op)

Given a ListOp, attempt to group into Abelian ListOps of the same type.

パラメータ

list_op (Union[ListOp, PauliSumOp]) – The Operator to group into Abelian groups

戻り値の型

ListOp

戻り値

The grouped Operator.

例外

OpflowError – If any of list_op’s sub-ops is not PauliOp.