- class qiskit.circuit.WhileLoopOp(condition, body, label=None)#
A circuit operation which repeatedly executes a subcircuit (
body) until a condition (
condition) evaluates as False.
condition (tuple[ClassicalRegister, int] | tuple[Clbit, int] | expr.Expr) – A condition to be checked prior to executing
body. Can be specified as either a tuple of a
ClassicalRegisterto be tested for equality with a given
int, or as a tuple of a
Clbitto be compared to either a
body (QuantumCircuit) – The loop body to be repeatedly executed.
label (str | None) – An optional label for identifying the instruction.
The classical bits used in
conditionmust be a subset of those attached to
┌─────────────┐ q_0: ┤0 ├ │ │ q_1: ┤1 ├ │ while_loop │ q_2: ┤2 ├ │ │ c_0: ╡0 ╞ └─────────────┘
Create a new instruction.
name (str) – instruction name
num_qubits (int) – instruction’s qubit width
num_clbits (int) – instruction’s clbit width
unit (str) – time unit of duration
label (str or None) – An optional label for identifying the instruction.
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.
Get the time unit of duration.
Add a decomposition of the instruction to the SessionEquivalenceLibrary.
Assemble a QasmQobjInstruction
- broadcast_arguments(qargs, cargs)#
Validation of the arguments.
qargs (List) – List of quantum bit arguments.
cargs (List) – List of classical bit arguments.
Tuple(List, List) – A tuple with single arguments.
CircuitError – If the input is not valid. For example, the number of arguments does not match the gate expectation.
- c_if(classical, val)#
Set a classical equality condition on this instruction between the register or cbit
This is a setter method, not an additive one. Calling this multiple times will silently override any previously set condition; it does not stack.
Copy of the instruction.
Invert this instruction.
If the instruction is composite (i.e. has a definition), then its definition will be recursively inverted.
Special instructions inheriting from Instruction can implement their own inverse (e.g. T and Tdg, Barrier, etc.)
Return True .IFF. instruction is parameterized else False
Return a default OpenQASM string for the instruction.
Derived instructions may override this to print in a different format (e.g. measure q -> c;).
Deprecated since version 0.25.0: The method
qiskit.circuit.instruction.Instruction.qasm()is deprecated as of qiskit-terra 0.25.0. It will be removed no earlier than 3 months after the release date. Correct exporting to OpenQASM 2 is the responsibility of a larger exporter; it cannot safely be done on an object-by-object basis without context. No replacement will be provided, because the premise is wrong.
Creates an instruction with gate repeated n amount of times.
Replace blocks and return new instruction. :param blocks: Tuple of QuantumCircuits to replace in instruction.
New ControlFlowOp with replaced blocks.
For a composite instruction, reverse the order of sub-instructions.
This is done by recursively reversing all sub-instructions. It does not invert any gate.
- a new instruction with
- Return type:
Soft comparison between gates. Their names, number of qubits, and classical bit numbers must match. The number of parameters must match. Each parameter is compared. If one is a ParameterExpression then it is not taken into account.
other (instruction) – other instruction.
are self and other equal up to parameter expressions.
- Return type:
Instruction parameters has no validation or normalization.