qp.transforms.decompose

decompose(qnode, gate_set, fixed_decomps=None, exclude_decomps=None)

Decompose a quantum circuit toward a target gate set via Catalyst’s graph-decomposition pass.

Warning

This transform must be applied within a workflow compiled with qjit(). It is a frontend for Catalyst’s graph_decomposition compilation pass. For tape-based (non-compiled) decomposition, use _tape_decompose().

Parameters:
  • gate_set (Iterable[type | str] | dict[type | str, float]) – Target gate set after decomposition. A mapping may supply relative costs used by the graph solver.

  • fixed_decomps (dict | None) – Map operators to specific decomposition rule names to guarantee a specific rule is used for each operator.

  • exclude_decomps (dict | None) – Map operators to lists of decomposition rule names to exclude from this pass’s graph. Rules are specified by name. Excluded rules remain available to subsequent passes.

Example

@qp.qjit(capture=True)
@qp.decompose(gate_set={"RX", "RY", "RZ", "CNOT", "GlobalPhase"})
@qp.qnode(qp.device("lightning.qubit", wires=2))
def circuit():
    qp.Hadamard(0)
    qp.CNOT([0, 1])
    return qp.expval(qp.Z(0))

To exclude a registered rule from this pass, supply its name or callable in exclude_decomps, for example exclude_decomps={qp.CRX: ["to_h_crz"]}. Use list_decomps() to inspect the available rules.