z i#7SrSSKJrJr SSKrSSKrSSKJr SSK J r SSK J r SSK Jr SSKJr SS KJr SS KJrJr SS KJr SS KJr SS KJr Sr"SS\5r"SS\5rg)z>Prepare a quantum state from the state where all qubits are 0.)UnionOptionalN) QiskitError)QuantumCircuit)QuantumRegister)Gate)XGate)HGate)SGateSdgGate)Isometry) CircuitError) Statevectorg|=c ^\rSrSrSrSS\\\\\ 4S\ \S\ S\ \S\ 4 U4Sjjjr S r S rS rS rS rSS\ 4SjjrSrSrS\SS4SjrSrU=r$)StatePreparation#zComplex amplitude state preparation. Class that implements the (complex amplitude) state preparation of some flexible collection of qubit registers. params num_qubitsinverselabel normalizecz>XlX0lUR(aSOSUlUcUR(aSOSUlOUR(aUS3OUUl[ U[ 5(a UR n[ U[5(dUb [S5e[ U[5Ul [ U[5Ul UR(dUR(d{[RRU5nU(a'[R"U[R S9U- nO.["R$"US [&S 9(d[S US 35eUR)X!5n[ U[5(aU/OUn[*TU]YURX!URS 9 g)ai Args: params: * Statevector: Statevector to initialize to. * list: vector of complex amplitudes to initialize to. * string: labels of basis states of the Pauli eigenstates Z, X, Y. See :meth:`.Statevector.from_label`. Notice the order of the labels is reversed with respect to the qubit index to be applied to. Example label '01' initializes the qubit zero to :math:`|1\rangle` and the qubit one to :math:`|0\rangle`. * int: an integer that is used as a bitmap indicating which qubits to initialize to :math:`|1\rangle`. Example: setting params to 5 would initialize qubit 0 and qubit 2 to :math:`|1\rangle` and qubit 1 to :math:`|0\rangle`. num_qubits: This parameter is only used if params is an int. Indicates the total number of qubits in the `initialize` call. Example: `initialize` covers 5 qubits and params is 3. This allows qubits 0 and 1 to be initialized to :math:`|1\rangle` and the remaining 3 qubits to be initialized to :math:`|0\rangle`. inverse: if True, the inverse state is constructed. label: An optional label for the gate normalize (bool): Whether to normalize an input array to a unit vector. Raises: QiskitError: ``num_qubits`` parameter used when ``params`` is not an integer When a Statevector argument is passed the state is prepared based on the :class:`~.library.Isometry` synthesis described in [1]. References: [1] Iten et al., Quantum circuits for isometries (2016). `Phys. Rev. A 93, 032318 `__. state_preparation_dgstate_preparationNState Preparation DgState Preparationz DgzZThe num_qubits parameter to StatePreparation should only be used when params is an integer)dtypeg?)abs_tolz(Sum of amplitudes-squared is not 1, but .)r) _params_arg_inverse_name_label isinstancerdataintrstr _from_label _from_intnplinalgnormarray complex128mathisclose_EPS_get_num_qubitssuper__init__)selfrrrrrr, __class__s s/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/library/data_preparation/state_preparation.pyr4StatePreparation.__init__*sLT" /3}}+BU =48MM0GZDK+/==UG3-eDK fk * *[[F&#&&:+A2 &fc2#FC099>>&)D& >E\\$T:!$LTFRS"TUU))*= '44&& Zt{{KcUR(aUR5UlgUR(aUR 5UlgUR 5Ulg)N)r(_define_from_label definitionr)_define_from_int_define_synthesis_isom)r5s r7_defineStatePreparation._defineusB   "557DO ^^"335DO"99;DOr9c[URS5n[USS9n[[ UR 55GHup4US:XaUR [5X/5 M+US:XaUR [5X/5 MPUS:Xa<UR [5X/5 UR [5X/5 MUS:Xa<UR [5X/5 UR [5X/5 MUS:XdMUR [5X/5 UR [5X/5 GM UR(aUR5nU$) Nqinit_defname1+-rl) rrr enumeratereversedrappendr r r r r!r)r5rBinitialize_circuitqubitparams r7r;#StatePreparation._define_from_label}s* DOOS 1+AJ?%ht{{&;#"))%'AH:>#"))%'AH:>"))%'AH:>#"))%'AH:>"))%'AH:>#"))%'AH:>"))')ahZ@= ==!3!;!;!= !!r9c[URS5n[USS9n[[R "UR S55SURS3SSS2n[U5UR:a%[S[U5S URS 35e[U5H*upEUS :XdM UR[5X/5 M, U$) NrBrCrDr0bzStatePreparation integer has z= bits, but this exceeds the number of qubits in the circuit, rrF) rrrr&r*realrlenrrKrMr )r5rBrNintstrrObits r7r=!StatePreparation._define_from_ints DOOS 1+AJ? A/04??2C10DEttL v; (/F }=559__4EQH  $F+JEcz"))%'AH:>, "!r9c[URS5n[USS9n[URSS5nUR UR SSS9 URSLaUR5$U$)zGCalculate a subcircuit that implements this initialization via isometryrBrCrDrFT)copyinplace) rrrr rcomposer<r!r)r5rBrNisoms r7r>'StatePreparation._define_synthesis_isomsm DOOS 1+AJ? Q*""4??"M ==D %--/ /!!r9cb[U[5(a [U5nU$[U[5(a'Uc"[[R "U55S-nU$[R "[U55nUS:XdUR 5(d [S5e[U5nU$)z1Get number of qubits needed for state preparationrz5Desired statevector length not a positive power of 2.)r$r'rWr&r/log2 is_integerr)r5rrs r7r2 StatePreparation._get_num_qubitss fc " "VJ $ $! 6!23a7 3v;/JQj&;&;&=&=!"YZZZJr9 annotatedcURS;aSO URn[URUR(+US9$)z Return inverted StatePreparation)rrN)rr)r#rr r!)r5rfrs r7rStatePreparation.inverses@KK#PPDVZVaVa   0 0dmm:KSXYYr9c ## UVVs/sH o3HoDPM M nnnUR[U5:wa5[SSUR-SURS[U5S35eU/4v gs snnf7f)Nz&StatePreparation parameter vector has z elements, therefore expects z qubits. However, z were provided.)rrWr)r5qargscargssublistqarg flat_qargss r7broadcast_arguments$StatePreparation.broadcast_argumentss*/D%wGDdGd% D ??c*o -8DOO9K8L//@A$$' O#4OE  "nEsA:A4AA:c[U[5(a-US;aU$[S[U5SURS35e[U[ [ [45(a [U5$[U[R5(a[UR55$[S[U5SUR35e)zKStatePreparation instruction parameter can be str, int, float, and complex.)rSrFrGrHrJrIzinvalid param label z for instruction z&. Label should be 0, 1, +, -, l, or r zinvalid param type z for instruction ) r$r'rtyperEr&floatcomplexr*numberitem)r5 parameters r7validate_parameter#StatePreparation.validate_parameters i % %::  &tI&77H T''  i#ug!6 7 79% %  299 - -9>>+, ,!4T)_4EEWX\XaXaWbcd dr9exponentreturnrcJ[URSU3UR/S9$)N*)rErr)rrEr)r5r{s r7_return_repeatStatePreparation._return_repeats%DII;az2tWYZZr9)r)r(r!r#r"r r<)NFNF)F)__name__ __module__ __qualname____firstlineno____doc__rr'listr&rrboolr4r?r;r=r>r2rrpryrtr__static_attributes__ __classcell__r6s@r7rr#s%)# ILc4k12ILSMIL IL } IL  ILILV<"0". ""ZZ e([u[[[r9rcL^\rSrSrSrSS\S\\4U4SjjjrSrSr U=r $) UniformSuperpositionGateaImplements a uniform superposition state. This gate is used to create the uniform superposition state :math:`\frac{1}{\sqrt{M}} \sum_{j=0}^{M-1} |j\rangle` when it acts on an input state :math:`|0...0\rangle`. Note, that `M` is not required to be a power of 2, in which case the uniform superposition could be prepared by a single layer of Hadamard gates. .. note:: This class uses the Shukla-Vedula algorithm [1], which only needs :math:`O(\log_2 (M))` qubits and :math:`O(\log_2 (M))` gates, to prepare the superposition. References: [1]: A. Shukla and P. Vedula (2024), An efficient quantum algorithm for preparation of uniform quantum superposition states, `Quantum Inf Process 23, 38 `_. num_superpos_statesrc,>US::a [S5eUc4[[R"[R"U555nO:[ U[5(aU[R"U5:d [S5e[ TU]SX!/5 g)a Args: num_superpos_states (int): A positive integer M = num_superpos_states (> 1) representing the number of computational basis states with an amplitude of 1/sqrt(M) in the uniform superposition state (:math:`\frac{1}{\sqrt{M}} \sum_{j=0}^{M-1} |j\rangle`, where :math:`1< M <= 2^n`). Note that the remaining (:math:`2^n - M`) computational basis states have zero amplitudes. Here M need not be an integer power of 2. num_qubits (int): A positive integer representing the number of qubits used. If num_qubits is None or is not specified, then num_qubits is set to ceil(log2(num_superpos_states)). Raises: ValueError: num_qubits must be an integer greater than or equal to log2(num_superpos_states). rbz>num_superpos_states must be a positive integer greater than 1.NzQnum_qubits must be an integer greater than or equal to log2(num_superpos_states).USup) ValueErrorr&r/ceilrcr$r3r4)r5rrr6s r7r4!UniformSuperpositionGate.__init__s~, ! #]^ ^  TYYtyy1D'EFGJz3//Z499M`Ca5a g -BCr9c j[UR5nURSnX"S- -S:Xa@[[R "U55nUR [U55 Xlg[[R"U55Vs/sHn[U5PM nn[U5n[U5VVs/sHupxUS:XdM UPM n nnURU SU5 SU S-n S[R"[R "X- 55-n U SS:aUR [U S55 UR#XS5 UR%U S[U SU S5SS9 [S[U 5S- 5HnS[R"[R "SX-X*- - 55-n UR'XUXS-SS9 UR%XS-[XXS-5SS9 U SX--n M Xlgs snfs snnf)NrrbrjrS) ctrl_state)r _num_qubitsrr&r/rchranger<rLr* binary_reprrWrKxarccossqrtrychcry) r5qcrmrn_valuekindexrwl_valuem_current_valuethetas r7r? UniformSuperpositionGate._define/s D,, -"kk!n #: ;  DII123A DDqN O #+BNN;N,O#PQ#Pa3q6#PQ L.7.@N.@]eDAI5.@N WQq\wqz/RYYrww'LMNN 1:> DDwqz" # eQZ  gaj% GAJ7CHq#g,*+AWZ+>+PQRE FF5!*g!enF E EE'a%.% GEN"CPSE T-WZ?O ,+RNsH* H/H/)r<)rjN) rrrrrr&rr4r?rrrs@r7rrs?.$%$(D DSMDDB##r9r)rtypingrrr/numpyr*qiskit.exceptionsrqiskit.circuit.quantumcircuitrqiskit.circuitrqiskit.circuit.gater'qiskit.circuit.library.standard_gates.xr 'qiskit.circuit.library.standard_gates.hr 'qiskit.circuit.library.standard_gates.sr r (qiskit.circuit.library.generalized_gatesr qiskit.circuit.exceptionsr&qiskit.quantum_info.states.statevectorrr1rrr9r7rsZE" )8*$99B=2 R[tR[jZtZr9