qiskit.circuit.QuantumCircuit.cu¶
- QuantumCircuit.cu(theta, phi, lam, gamma, control_qubit, target_qubit, label=None, ctrl_state=None)[source]¶
Apply
CUGate.For the full matrix form of this gate, see the underlying gate documentation.
- Parameters
theta (ParameterValueType) – The \(\theta\) rotation angle of the gate.
phi (ParameterValueType) – The \(\phi\) rotation angle of the gate.
lam (ParameterValueType) – The \(\lambda\) rotation angle of the gate.
gamma (ParameterValueType) – The global phase applied of the U gate, if applied.
control_qubit (QubitSpecifier) – The qubit(s) used as the control.
target_qubit (QubitSpecifier) – The qubit(s) targeted by the gate.
label (str | None) – The string label of the gate in the circuit.
ctrl_state (str | int | None) – The control state in decimal, or as a bitstring (e.g. ‘1’). Defaults to controlling on the ‘1’ state.
- Returns
A handle to the instructions created.
- Return type