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:
Important
The returned
DecompCollectionis a copy of the registered rules. Mutating it does not update the global decomposition registry; useadd_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─┤