UGate

class qiskit.circuit.library.UGate(theta, phi, lam, label=None)

Bases: Gate

Generic single-qubit rotation gate with 3 Euler angles.

Can be applied to a QuantumCircuit with the u() method.

Circuit symbol:

     ┌──────────┐
q_0: ┤ U(ϴ,φ,λ) ├
     └──────────┘

Matrix Representation:

\providecommand{\th}{\frac{\theta}{2}}\\\begin{split}U(\theta, \phi, \lambda) = \begin{pmatrix} \cos\left(\th\right) & -e^{i\lambda}\sin\left(\th\right) \\ e^{i\phi}\sin\left(\th\right) & e^{i(\phi+\lambda)}\cos\left(\th\right) \end{pmatrix}\end{split}

Note

The matrix representation shown here is the same as in the OpenQASM 3.0 specification, which differs from the OpenQASM 2.0 specification by a global phase of $e^{i(\phi+\lambda)/2}$ .

Examples:

U\left(\theta, -\frac{\pi}{2}, \frac{\pi}{2}\right) = RX(\theta)

U(\theta, 0, 0) = RY(\theta)

Create new U gate.

Attributes

Get Clbits in condition.

Get the decompositions of the instruction from the SessionEquivalenceLibrary.

Return definition in terms of other basic gates.

Get the duration.

Return instruction label

Return the name.

Return the number of clbits.

Return the number of qubits.

return instruction params.

Get the time unit of duration.

control(num_ctrl_qubits=1, label=None, ctrl_state=None)

Return a (multi-)controlled-U gate.

Parameters

num_ctrl_qubits (int) – number of control qubits.
label (str or None) – An optional label for the gate [Default: None]
ctrl_state (int orstr or None) – control state expressed as integer, string (e.g. ‘110’), or None. If None, use all 1s.

Returns

controlled version of this gate.

Return type

ControlledGate

inverse()

Return inverted U gate.

$U(\theta,\phi,\lambda)^{\dagger} =U(-\theta,-\lambda,-\phi)$ )

Was this page helpful?

Report a bug or request content on GitHub.