qp.decomposition.list_decomps

list_decomps(op)[source]

Lists decomposition rules for an operator.

Parameters:

op (type or Operator or str) – the operator or operator type to retrieve decomposition rules for. For symbolic operators, use strings like "Adjoint(RY)", "Pow(H)", "C(RX)", etc.

Returns:

a collection of decomposition rules for the given operator.

Return type:

DecompCollection

Important

The returned DecompCollection is a copy of the registered rules. Mutating it does not update the global decomposition registry; use add_decomps() to register rules globally.

Example

>>> import pennylane as qp
>>> qp.list_decomps(qp.CRX)
DecompCollection([
    DecompositionRule(name=to_rx_cz),
    DecompositionRule(name=to_rz_ry),
    DecompositionRule(name=to_h_crz),
    DecompositionRule(name=to_paulirot)
])
>>> print(qp.list_decomps(qp.CRX))
Available Decomposition Rules:
0: to_rx_cz
1: to_rz_ry
2: to_h_crz
3: to_paulirot

Each decomposition rule can be accessed by name or by index.

>>> qp.list_decomps(qp.CRX)['to_paulirot']
DecompositionRule(name=to_paulirot)
>>> print(qp.list_decomps(qp.CRX)[0])
@register_resources(_crx_to_rx_cz_resources, name="to_rx_cz")
def _crx_to_rx_cz(phi: TensorLike, wires: WiresLike):
    qp.RX(phi / 2, wires=wires[1])
    qp.CZ(wires=wires)
    qp.RX(-phi / 2, wires=wires[1])
    qp.CZ(wires=wires)
>>> print(qp.draw(qp.list_decomps(qp.CRX)[0])(0.5, wires=[0, 1]))
0: ───────────╭●────────────╭●─┤
1: ──RX(0.25)─╰Z──RX(-0.25)─╰Z─┤