z iESrSSKJr SSKJr SSKrSSKJr SSKJ r SSK J r SSK J r S S KJr \R (aSS KJr S r"S S\ 5rg)z8 Initialize qubit registers to desired arbitrary state. ) annotations)SequenceN)QuantumCircuit)QuantumRegister) Instruction)Isometry)StatePreparation) Statevectorg|=c^\rSrSrSrS S U4SjjjrSrS Sjr\S5r \ RS Sj5r Sr S r U=r $) Initialize!aMComplex amplitude initialization. Class that initializes some flexible collection of qubit registers, implemented by calling the :class:`~.library.StatePreparation` class. Note that ``Initialize`` is an :class:`~.circuit.Instruction` and not a :class:`.Gate` since it contains a reset instruction, which is not unitary. The initial 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 `__. c>[XUS9Ul[TU] SURRSURR 5 g)aw Args: params: The state to initialize to, can be either of the following. * Statevector or vector of complex amplitudes to initialize to. * 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`. * 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`. normalize: Whether to normalize an input array to a unit vector. ) normalize initializerN)r _stateprepsuper__init__ num_qubitsparams)selfrrr __class__s m/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/library/data_preparation/initializer.pyrInitialize.__init__3s:2+6S t'A'A1dooF\F\]c[URS5n[USS9nURU5 UR UR U5 X lg)Nqinit_def)name)rrrresetappendr definition)rrinitialize_circuits r_defineInitialize._definePsF DOOS 1+AJ?  #!!$//15,rcP[URSS5nUR5$)zCall to create a circuit with gates that take the desired vector to zero. Returns: QuantumCircuit: circuit to take ``self.params`` vector to :math:`|{00\ldots0}\rangle` r)rr_gates_to_uncompute)risoms rgates_to_uncomputeInitialize.gates_to_uncomputeWs% Q*''))rc.URR$)zReturn initialize params.rr)rs rrInitialize.paramsas%%%rc$XRlg)zSet initialize params.Nr,)r parameterss rrr-fs",rc8URRX5$)N)rbroadcast_arguments)rqargscargss rr1Initialize.broadcast_argumentsks225@@r)rr")NF)r+Statevector | Sequence[complex] | str | intrz int | NonerboolreturnNone)r7r)r/r5r7r8)__name__ __module__ __qualname____firstlineno____doc__rr$r)propertyrsetterr1__static_attributes__ __classcell__)rs@rr r !s("& ^;^^ ^  ^^:-*&& ]],,AArr )r= __future__rcollections.abcrtypingqiskit.circuit.quantumcircuitrqiskit.circuitrqiskit.circuit.instructionr(qiskit.circuit.library.generalized_gatesrstate_preparationr TYPE_CHECKING&qiskit.quantum_info.states.statevectorr _EPSr rrrNsE#$ 8*2=/ B KAKAr