qp.transforms.rz_phase_gradient¶
- rz_phase_gradient(tape, angle_wires, phase_grad_wires, work_wires)[source]¶
Quantum function transform to decompose all instances of
RZgates into additions using a phase gradient resource state.For example, an
RZgate with angle \(\phi = (0 \cdot 2^{-1} + 1 \cdot 2^{-2} + 0 \cdot 2^{-3}) 2\pi\) is translated into the following routine, where the angle is loaded onto theangle_wiresin binary by aMultiX(oneXper set bit) controlled by the target - realizing one controlled-Xper set bit, here onlyang_1- and added to aphase_grad_wiresregister semi-inplace viaSemiAdder.target: ─RZ(ϕ)─ = ─╭●────────────╭●──exp(iϕ/2)─┤ ang_0: ─│──╭SemiAdder─│─────────────┤ ang_1: ─╰X─├SemiAdder─╰X────────────┤ ang_2: ────├SemiAdder───────────────┤ phg_0: ────├SemiAdder───────────────┤ phg_1: ────├SemiAdder───────────────┤ phg_2: ────╰SemiAdder───────────────┤
For this routine to work, the provided
phase_grad_wiresneed to hold a phase gradient state \(|\nabla n\rangle = \frac{1}{\sqrt{N}} \sum_{m=0}^{N-1} e^{-2 \pi i \frac{m}{N}} |m\rangle\), where \(n\) is the number of qubits and \(N=2^n\). Because this state is not modified and can be re-used at a later stage, the transform does not prepare it but rather assumes it has been prepared on those wires at an earlier stage.Note that
SemiAdderrequires additionalwork_wires(not shown in the diagram) for the semi-in-place addition \(\text{SemiAdder}|x\rangle_\text{ang} |y\rangle_\text{phg} = |x\rangle_\text{ang} |x + y\rangle_\text{phg}\).More details can be found on page 4 in arXiv:1709.06648 and Figure 17a in arXiv:2211.15465 (a generalization to multiplexed
RZrotations is provided in Figure 4 in arXiv:2409.07332).Note that technically, this circuit realizes
PhaseShift, i.e. \(R_\phi(\phi) = R_Z(\phi) e^{i\phi/2}\). The additional global phase is taken into account in the decomposition.- Parameters:
tape (QNode or QuantumTape or Callable) – A quantum circuit containing
RZgates.angle_wires (Wires) – The qubits that conditionally load the angle \(\phi\) of the
RZgate in binary as a multiple of \(2\pi\). The length of theangle_wiresimplicitly determines the precision with which the angle is represented. E.g., \((2^{-1} + 2^{-2} + 2^{-3}) 2\pi\) is exactly represented by three bits as111.phase_grad_wires (Wires) – The catalyst qubits with a phase gradient state prepared on them. Needs to be at least the length of
angle_wiresand will only use the firstlen(angle_wires).work_wires (Wires) – Additional work wires to realize the
SemiAdderbetween theangle_wiresandphase_grad_wires. Needs to be at leastb-1wires, whereb=len(phase_grad_wires)is the precision of the angle \(\phi\).
- Returns:
The transformed circuit as described in
qp.transform.- Return type:
qnode (QNode) or quantum function (Callable) or tuple[List[QuantumTape], function]
Example
from pennylane.transforms.rz_phase_gradient import rz_phase_gradient precision = 3 phi = (1 / 2 + 1 / 4 + 1 / 8) * 2 * np.pi wire = "targ" angle_wires = [f"ang_{i}" for i in range(precision)] phase_grad_wires = [f"phg_{i}" for i in range(precision)] work_wires = [f"work_{i}" for i in range(precision - 1)] wire_order = [wire] + angle_wires + phase_grad_wires + work_wires @qp.transforms.combine_global_phases @qp.transforms._tape_decompose(gate_set=qp.gate_sets.ROTATIONS_PLUS_CNOT, max_expansion=1) @rz_phase_gradient( angle_wires=angle_wires, phase_grad_wires=phase_grad_wires, work_wires=work_wires, ) @qp.qnode(qp.device("default.qubit")) def rz_circ(phi, wire): qp.PhaseGradientStatePrep(phase_grad_wires) qp.Hadamard(wire) # transform rotation qp.RZ(phi, wire) qp.Hadamard(wire) # transform rotation return qp.probs(wire)
In this example we perform the rotation of an angle of \(\phi = (0.111)_2 2\pi\). Because phase shifts are trivial on computational basis states, we transform the \(R_Z\) rotation to \(R_X = H R_Z H\) via two
Hadamardgates.Note that for the transform to work, we needed to also prepare a phase gradient state on the
phase_grad_wiresviaphase_gradient.Overall, the full circuit looks like the following:
>>> print(qp.draw(rz_circ, wire_order=wire_order)(phi, wire)) targ: ──RZ(3.14)──RY(1.57)─╭●─────────────────────╭●───────────RZ(3.14)──RY(1.57) ··· ang_0: ─────────────────────├MultiX(M0)─╭SemiAdder─├MultiX(M0)──────────────────── ··· ang_1: ─────────────────────├MultiX(M0)─├SemiAdder─├MultiX(M0)──────────────────── ··· ang_2: ─────────────────────╰MultiX(M0)─├SemiAdder─╰MultiX(M0)──────────────────── ··· phg_0: ──H─────────Z────────────────────├SemiAdder──────────────────────────────── ··· phg_1: ──H─────────S─────────H──────────├SemiAdder──────────────────────────────── ··· phg_2: ──H─────────T─────────X──────────├SemiAdder──────────────────────────────── ··· work_0: ─────────────────────────────────├SemiAdder──────────────────────────────── ··· work_1: ─────────────────────────────────╰SemiAdder──────────────────────────────── ··· targ: ··· ─╭GlobalPhase(1.18)─┤ Probs ang_0: ··· ─├GlobalPhase(1.18)─┤ ang_1: ··· ─├GlobalPhase(1.18)─┤ ang_2: ··· ─├GlobalPhase(1.18)─┤ phg_0: ··· ─├GlobalPhase(1.18)─┤ phg_1: ··· ─├GlobalPhase(1.18)─┤ phg_2: ··· ─├GlobalPhase(1.18)─┤ work_0: ··· ─├GlobalPhase(1.18)─┤ work_1: ··· ─╰GlobalPhase(1.18)─┤ M0 = [ True True True]
The additional work wires are required by the
SemiAdder. Executing the circuit, we get the following result:>>> rz_circ(phi, wire) array([0.853..., 0.146...])
This matches the expected result of just applying a simple
RXgate:>>> np.abs(qp.RX(phi, 0).matrix()[:, 0]) ** 2 array([0.853..., 0.146...])