z iz!SrSSKJr SSKrSSKJrJrJrJr SSK J r SSK J r SSK Jr \(aSS KJr "S S \5r"S S 5rg)z.Circuit operation representing a ``for`` loop.) annotationsN)IterableOptionalUnion TYPE_CHECKING) Parameter) CircuitError) ControlFlowOpQuantumCircuitc^\rSrSrSrS S U4Sjjjr\S5r\RS5r\S5r Sr Sr U=r $) ForLoopOpzA circuit operation which repeatedly executes a subcircuit (``body``) parameterized by a parameter ``loop_parameter`` through the set of integer values provided in ``indexset``. cZ>URnURn[TU] SXVXU/US9 g)a) Args: indexset: A collection of integers to loop over. loop_parameter: The placeholder parameterizing ``body`` to which the values from ``indexset`` will be assigned. body: The loop body to be repeatedly executed. label: An optional label for identifying the instruction. for_looplabelN) num_qubits num_clbitssuper__init__)selfindexsetloop_parameterbodyrrr __class__s ]/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/controlflow/for_loop.pyrForLoopOp.__init__"s8__ __    40PX]  cUR$N_paramsrs rparamsForLoopOp.params7s ||r c SSKJn Uup4n[U[[ S545(d[ S[ U5S35e[XR5(d[ S[ U5S35eUR UR :wdURUR:wa@[ SUR SURSUR SURS3 5eUbSXER;aDURS UR5;a#[R"S URS 3S S 9 [U[5(aUO [U5nX4U/Ulg)Nrr zbForLoopOp expects a loop_parameter parameter to be either of type Parameter or None, but received .zNForLoopOp expects a body parameter to be of type QuantumCircuit, but received zAttempted to assign a body parameter with a num_qubits or num_clbits different than that of the ForLoopOp. ForLoopOp num_qubits/clbits: /z" Supplied body num_qubits/clbits: c38# UHoRv M g7fr")name).0ps r #ForLoopOp.params..Zs'H1szThe Parameter provided as a loop_parameter was not found on the loop body and so no binding of the indexset to loop parameter will occur. A different Parameter of the same name (zs) was found. If you intended to loop over that Parameter, please use that Parameter instance as the loop_parameter.) stacklevel)qiskit.circuitr isinstancertyper rr parametersr,warningswarnrangetupler$)rr6r rrrs rr&r';sd 2)3&$.9d4j*ABBE'(+  $//004T |1>  ??doo -DOO1S004/@$//ARS448OO3DAdooEVVWY   &oo5##'H'HH MM#''()&&   *(E::8h $7 r c"URS4$)Nr1r#r%s rblocksForLoopOp.blocksls Q!!r chUun[URSURSX RS9$)Nrr r)rr&r)rr<rs rreplace_blocksForLoopOp.replace_blocksps,QQZZPPr r#r")r Iterable[int]rzUnion[Parameter, None]rr r Optional[str]) __name__ __module__ __qualname____firstlineno____doc__rpropertyr&setterr<r?__static_attributes__ __classcell__)rs@rrrs $   /      * ]].8.8`""QQr rcR\rSrSrSrSrSrS SS.S SjjjrSrS r S r g) ForLoopContextuaA context manager for building up ``for`` loops onto circuits in a natural order, without having to construct the loop body first. Within the block, a lot of the bookkeeping is done for you; you do not need to keep track of which qubits and clbits you are using, for example, and a loop parameter will be allocated for you, if you do not supply one yourself. All normal methods of accessing the qubits on the underlying :obj:`~QuantumCircuit` will work correctly, and resolve into correct accesses within the interior block. You generally should never need to instantiate this object directly. Instead, use :obj:`.QuantumCircuit.for_loop` in its context-manager form, i.e. by not supplying a ``body`` or sets of qubits and clbits. Example usage:: import math from qiskit import QuantumCircuit qc = QuantumCircuit(2, 1) with qc.for_loop(range(5)) as i: qc.rx(i * math.pi/4, 0) qc.cx(0, 1) qc.measure(0, 0) with qc.if_test((0, True)): qc.break_loop() This context should almost invariably be created by a :meth:`.QuantumCircuit.for_loop` call, and the resulting instance is a "friend" of the calling circuit. The context will manipulate the circuit's defined scopes when it is entered (by pushing a new scope onto the stack) and exited (by popping its scope, building it, and appending the resulting :obj:`.ForLoopOp`). .. warning:: This is an internal interface and no part of it should be relied upon outside of Qiskit Terra. r)_circuit_generate_loop_parameter_loop_parameter _indexset_label_usedNrcXlUSLUlX0l[U[5(aUO [ U5UlX@lSUlg)NF) rOrPrQr4r9r:rRrSrT)rcircuitrrrs rrForLoopContext.__init__sC (6$(>%-&0%%@%@eHo  r c,UR(a [S5eSUlURR5 UR(a;[ SUR 35Ul[U5=R S- slUR$)Nz0A for-loop context manager cannot be re-entered.T_loop_i_r ) rTr rO _push_scoperPr_generated_loop_parametersrQr5r%s r __enter__ForLoopContext.__enter__sq ::QR R  !!#  ( (#,x8W8W7X-Y#ZD J 1 1Q 6 1###r c UbURR5 gURR5nURUR5UR 55nUR (aUR UR;aSnO UR nURR[URXeURS9[UR5[UR55 g)NFr) rO _pop_scopebuildqubitsclbitsrPrQr6appendrrRrSr:)rexc_typeexc_valexc_tbscoperrs r__exit__ForLoopContext.__exit__s   MM $ $ & ((*{{5<<>5<<>:  ( (T-A-A-X!N!11N  dnnn$++ N $++  $++  r )rOrPrRrSrQrTr")rVr rrArzOptional[Parameter]rrB) rCrDrErFrGr[ __slots__rr\rhrJr rrMrMus[#N"#I/3  $  ,   "$r rM)rG __future__rr7typingrrrrqiskit.circuit.parameterrqiskit.circuit.exceptionsr control_flowr r3r rrMrkr rrqsB5";;.2'-VQ VQreer