qp.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’sgraph_decompositioncompilation 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 exampleexclude_decomps={qp.CRX: ["to_h_crz"]}. Uselist_decomps()to inspect the available rules.