gedZddlmZddlmZddlZddlmZddlm Z ddl m Z ddl m Z d d lmZejrdd lmZd ZGd de ZdS)z8 Initialize qubit registers to desired arbitrary state. ) annotations)SequenceN)QuantumCircuit)QuantumRegister) Instruction)Isometry)StatePreparation) Statevectorg|=cveZdZdZ ddfd Zd ZddZedZej ddZdZ xZ S) InitializeaComplex 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 `__. NFparams+Statevector | Sequence[complex] | str | int num_qubits int | None normalizeboolreturnNonect||||_td|jjd|jjdS)a 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. )r initializerN)r _stateprepsuper__init__rr)selfrrr __class__s i/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/library/data_preparation/initializer.pyrzInitialize.__init__2sI2+6:SSS t'A1doF\]]]]]ct|jd}t|d}||||j|||_dS)Nqinit_def)name)rrrresetappendr definition)rr initialize_circuits r_definezInitialize._defineOs] DOS 1 1+AJ???  ###!!$/1555,rrcVt|jdd}|S)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_uncomputezInitialize.gates_to_uncomputeVs) Q**'')))rc|jjS)zReturn initialize params.rr)rs rrzInitialize.params`s%%r parametersc||j_dS)zSet initialize params.Nr-)rr.s rrzInitialize.paramses",rc8|j||S)N)rbroadcast_arguments)rqargscargss rr1zInitialize.broadcast_argumentsjs225%@@@r)NF)rrrrrrrr)rr)r.rrr) __name__ __module__ __qualname____doc__rr'r+propertyrsetterr1 __classcell__)rs@rr r !s&"& ^^^^^^^:---****&&X& ],,,],AAAAAAArr )r7 __future__rcollections.abcrtypingqiskit.circuit.quantumcircuitrqiskit.circuit.quantumregisterrqiskit.circuit.instructionr(qiskit.circuit.library.generalized_gatesrstate_preparationr TYPE_CHECKING&qiskit.quantum_info.states.statevectorr _EPSr rrrGs#"""""$$$$$$ 888888::::::222222======////// CBBBBBB JAJAJAJAJAJAJAJAJAJAr