Skip to main contentIBM Quantum Documentation
You are viewing the API reference for an old version of Qiskit SDK. Switch to latest version

UGate

class UGate(theta, phi, lam, label=None)

GitHub(opens in a new tab)

Bases: qiskit.circuit.gate.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:

U(θ,ϕ,λ)=(cos(θ2)eiλsin(θ2)eiϕsin(θ2)ei(ϕ+λ)cos(θ2))\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(opens in a new tab), which differs from the OpenQASM 2.0 specification(opens in a new tab) by a global phase of ei(ϕ+λ)/2e^{i(\phi+\lambda)/2}.

Examples:

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

Create new U gate.


Methods Defined Here

control

UGate.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 or str 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

UGate.inverse()

Return inverted U gate.

U(θ,ϕ,λ)=U(θ,λ,ϕ)U(\theta,\phi,\lambda)^{\dagger} =U(-\theta,-\lambda,-\phi))


Attributes

condition_bits

Get Clbits in condition.

Return type

List[Clbit]

decompositions

Get the decompositions of the instruction from the SessionEquivalenceLibrary.

definition

Return definition in terms of other basic gates.

duration

Get the duration.

label

Return instruction label

Return type

str

name

Return the name.

num_clbits

Return the number of clbits.

num_qubits

Return the number of qubits.

params

return instruction params.

unit

Get the time unit of duration.

Was this page helpful?
Report a bug or request content on GitHub.