geHdZddlZddlZddlmZmZddlZddlmZddlm Z ddlm Z ddl m Z Gdd Z Gd d Zd eeeefd efdZGddeZGddZGddeZGddZGddZdS)z3Module providing definitions of Pulse Qobj classes.N)UnionList) QobjDictField) QobjHeader)QobjExperimentHeader)deprecate_funccdeZdZdZedddd dZdZed Zd Z dS) QobjMeasurementOptionz!An individual measurement option.1.2in the 2.0 releaseThe `Qobj` class and related functionality are part of the deprecated `BackendV1` workflow, and no longer necessary for `BackendV2`. If a user workflow requires `Qobj` it likely relies on deprecated functionality and should be updated to use `BackendV2`.sinceremoval_timelineadditional_msgNc*||_| ||_dSdS)zInstantiate a new QobjMeasurementOption object. Args: name (str): The name of the measurement option params (list): The parameters of the measurement option. N)nameparams)selfrrs L/granary/edev/quantum/lib/python3.11/site-packages/qiskit/qobj/pulse_qobj.py__init__zQobjMeasurementOption.__init__ s$   DKKK  cLd|ji}t|dr |j|d<|S)zReturn a dict format representation of the QobjMeasurementOption. Returns: dict: The dictionary form of the QasmMeasurementOption. rr)rhasattrrrout_dicts rto_dictzQobjMeasurementOption.to_dict3s3 DI& 4 " " -!%HX rc>|d}||fi|S)zCreate a new QobjMeasurementOption object from a dictionary. Args: data (dict): A dictionary for the experiment config Returns: QobjMeasurementOption: The object from the input dictionary. rpop)clsdatars r from_dictzQobjMeasurementOption.from_dict>s-xxs4  4   rct|tr,||krdSdSNTF) isinstancer rrothers r__eq__zQobjMeasurementOption.__eq__Ks: e2 3 3 ||~~00turN) __name__ __module__ __qualname____doc__rrr classmethodr#r)rrr r s++^-0 ! ! ! !    ! ![ !rr ceZdZdZgdZeddd ddZd Zd Zd Z e d Z d Z dS)PulseQobjInstructionzEA class representing a single instruction in an PulseQobj Experiment.) ch conditionalvalphase frequencydurationqubits memory_slot register_slotlabeltype pulse_shape parametersr r r rNc4||_||_|||_|||_|||_|||_|||_|||_|||_| | |_ | | |_ | | |_ | | |_ | | |_ |||_|||_| ||_dSdS)aInstantiate a new PulseQobjInstruction object. Args: name (str): The name of the instruction t0 (int): Pulse start time in integer **dt** units. ch (str): The channel to apply the pulse instruction. conditional (int): The register to use for a conditional for this instruction val (complex): Complex value to apply, bounded by an absolute value of 1. phase (float): if a ``fc`` instruction, the frame change phase in radians. frequency (float): if a ``sf`` instruction, the frequency in Hz. duration (int): The duration of the pulse in **dt** units. qubits (list): A list of ``int`` representing the qubits the instruction operates on memory_slot (list): If a ``measure`` instruction this is a list of ``int`` containing the list of memory slots to store the measurement results in (must be the same length as qubits). If a ``bfunc`` instruction this is a single ``int`` of the memory slot to store the boolean function result in. register_slot (list): If a ``measure`` instruction this is a list of ``int`` containing the list of register slots in which to store the measurement results (must be the same length as qubits). If a ``bfunc`` instruction this is a single ``int`` of the register slot in which to store the result. kernels (list): List of :class:`QobjMeasurementOption` objects defining the measurement kernels and set of parameters if the measurement level is 1 or 2. Only used for ``acquire`` instructions. discriminators (list): A list of :class:`QobjMeasurementOption` used to set the discriminators to be used if the measurement level is 2. Only used for ``acquire`` instructions. label (str): Label of instruction type (str): Type of instruction pulse_shape (str): The shape of the parametric pulse parameters (dict): The parameters for a parametric pulse N)rt0r3r4r5r6r7r8r9r:r;kernelsdiscriminatorsr<r=r>r?)rrrAr3r4r5r6r8r9r:r;rBrCr<r=r>r?r7s rrzPulseQobjInstruction.__init__esD  >DG  "*D  ?DH  DJ  &DN  $DM   DK  "*D   $!.D   "DL  %"0D   DJ  DI  "*D   !(DOOO " !rc|j|jd}|jD]%}t||rt ||||<&t|drd|jD|d<t|drd|jD|d<|S)zReturn a dictionary format representation of the Instruction. Returns: dict: The dictionary form of the PulseQobjInstruction. )rrArBc6g|]}|Sr0r.0xs r z0PulseQobjInstruction.to_dict..s "E"E"E1199;;"E"E"ErrCc6g|]}|Sr0rFrGs rrJz0PulseQobjInstruction.to_dict..s )S)S)S!!))++)S)S)Sr)rrA _COMMON_ATTRSrgetattrrBrC)rrattrs rrzPulseQobjInstruction.to_dicts !ITW55& 5 5DtT"" 5!(t!4!4 4 # # F"E"E "E"E"EHY  4) * * T)S)St?R)S)S)SH% &rcd|jd|j}|jD]B}t||d}|-t |t r |d|d|dz }7|d|d|z }C|dz }|S)NzPulseQobjInstruction(name="z", t0=, z=""=))rrArLrMr&str)routrNattr_vals r__repr__zPulseQobjInstruction.__repr__sFDIFFTWFF& 2 2DtT400H#h,,23333333CC111x111C s  rc d|jd}|d|jdz }|jD],}t||r|d|dt ||dz }-|S)Nz Instruction:  z t0: z z: )rrArLrrM)rrUrNs r__str__zPulseQobjInstruction.__str__s~+di+++ %$'%%%%& > >DtT"" >=d==gdD&9&9==== rcttd}ddg}i}|D]\}}||vr |dkr6|}d|vrt|d|d<|||<F||vr`t |t r,t t ||j|||<|||||<|||<||d|dfi|S)zCreate a new PulseQobjExperimentConfig object from a dictionary. Args: data (dict): A dictionary for the experiment config Returns: PulseQobjInstruction: The object from the input dictionary. )rCrBrArr?amp)r itemscopy _to_complexr&listmapr#)r!r"schemaskipin_datakeyvalueformatted_values rr#zPulseQobjInstruction.from_dicts4,  f~**,, % %JCd{{l"""'**,,O++-89O-P-POE*. f}}eT**@#'F3K,A5(I(I#J#JGCLL#)#;#8#8#?#?GCLL$ s4<d77w777rct|tr,||krdSdSr%)r&r2rr's rr)zPulseQobjInstruction.__eq__s: e1 2 2 ||~~00tur)NNNNNNNNNNNNNNN) r+r,r-r.rLrrrrWrZr/r#r)r0rrr2r2RsOOM ^-0   %Y)Y)Y)Y)v   $8$8[$8Lrr2rfreturnct|tr/t|dkrt|d|dSt|tr|St |d)zConvert the input value to type ``complex``. Args: value: Value to be converted. Returns: Input value in ``complex``. Raises: TypeError: If the input value is not in the expected format. rz) is not in a valid complex number format.)r&r`lencomplex TypeError)rfs rr_r_sj%3u::??uQxq*** E7 # # uGGG H HHrcjeZdZdZeddd d dZdZed ZdS) PulseQobjConfigz!A configuration for a Pulse Qobj.r r r rNc  B||_||_||_||_||_|||_|||_|||_| t| |_ | t| |_ | t| |_ | r|j | dSdS)avInstantiate a PulseQobjConfig object. Args: meas_level (int): The measurement level to use. meas_return (int): The level of measurement information to return. pulse_library (list): A list of :class:`PulseLibraryItem` objects which define the set of primitive pulses qubit_lo_freq (list): List of frequencies (as floats) for the qubit driver LO's in GHz. meas_lo_freq (list): List of frequencies (as floats) for the' measurement driver LO's in GHz. memory_slot_size (int): Size of each memory slot if the output is Level 0. rep_time (int): Time per program execution in sec. Must be from the list provided by the backend (``backend.configuration().rep_times``). Defaults to the first entry in ``backend.configuration().rep_times``. rep_delay (float): Delay between programs in sec. Only supported on certain backends (``backend.configuration().dynamic_reprate_enabled`` ). If supported, ``rep_delay`` will be used instead of ``rep_time`` and must be from the range supplied by the backend (``backend.configuration().rep_delay_range``). Default is ``backend.configuration().default_rep_delay``. shots (int): The number of shots seed_simulator (int): the seed to use in the simulator memory_slots (list): The number of memory slots on the device kwargs: Additional free form key value fields to add to the configuration N) meas_level meas_return pulse_library qubit_lo_freq meas_lo_freqmemory_slot_sizerep_time rep_delayintshotsseed_simulator memory_slots__dict__update) rrsrtrurvrwrxryrzr|r}r~kwargss rrzPulseQobjConfig.__init__.sd%&**(  '$4D !  $DM  &DN  UDJ  %"%n"5"5D   # #L 1 1D   ) M  ( ( ( ( ( ) )rctj|j}t|drd|jD|d<|S)zReturn a dictionary format representation of the Pulse Qobj config. Returns: dict: The dictionary form of the PulseQobjConfig. ruc6g|]}|Sr0rFrGs rrJz+PulseQobjConfig.to_dict..s (Q(Q(Q(Q(Q(Qr)r^rrrurs rrzPulseQobjConfig.to_dictwsH 9T]++ 4 ) ) R(Q(Qd>P(Q(Q(QH_ %rcfd|vr&|d}d|D}||d<|di|S)zCreate a new PulseQobjConfig object from a dictionary. Args: data (dict): A dictionary for the config Returns: PulseQobjConfig: The object from the input dictionary. rucBg|]}t|Sr0)PulseLibraryItemr#rGs rrJz-PulseQobjConfig.from_dict..s'NNNq-77::NNNrr0r)r!r" pulse_lib pulse_lib_objs rr#zPulseQobjConfig.from_dictsO d " "11INNINNNM$1D !s{{T{{r)NNNNNN) r+r,r-r.rrrr/r#r0rrrqrq+s++^-0?)?)?)?)B     [   rrqcpeZdZdZedddd dZdZd Zd Ze d Z d Z dS)PulseQobjExperimentzA Pulse Qobj Experiment. Each instance of this class is used to represent an individual Pulse experiment as part of a larger Pulse Qobj. r r r rNc8|||_|||_||_dS)a1Instantiate a PulseQobjExperiment. Args: config (PulseQobjExperimentConfig): A config object for the experiment header (PulseQobjExperimentHeader): A header object for the experiment instructions (list): A list of :class:`PulseQobjInstruction` objects N)configheader instructions)rrrrs rrzPulseQobjExperiment.__init__s,   DK   DK(rcdd|jDi}t|dr|j|d<t|dr|j|d<|S)zReturn a dictionary format representation of the Experiment. Returns: dict: The dictionary form of the PulseQobjExperiment. rc6g|]}|Sr0rFrGs rrJz/PulseQobjExperiment.to_dict..s $L$L$LQQYY[[$L$L$Lrrr)rrrrrrs rrzPulseQobjExperiment.to_dictsy #$L$L$:K$L$L$LM 4 " " 7!%!4!4!6!6HX  4 " " 7!%!4!4!6!6HX rcd|jD}dd|zdz}d}||z }t|dst|dr|dz }t|dr*|dtt |jzdzz }t|dr*|d tt |jzdzz }|d z }|S) Nc,g|]}t|Sr0reprrGs rrJz0PulseQobjExperiment.__repr__..s???DGG???r[rP]zPulseQobjExperiment(rrzconfig=zheader=rS)rjoinrrTrrr)rinstructions_strinstructions_reprrUs rrWzPulseQobjExperiment.__repr__s??T->???$)),<"="==C$    4 " " gdH&=&=  4KC 4 " " = 9s4 #4#4555< .s49=$..t44r)PulseQobjExperimentConfigr#r r)r!r"rrrs rr#zPulseQobjExperiment.from_dicts t  .88(9K9KLLF t  )3DHHX4F4FGGF T ! !AE.AYAYLs<000rct|tr,||krdSdSr%)r&rrr's rr)zPulseQobjExperiment.__eq__s: e0 1 1 ||~~00turNN) r+r,r-r.rrrrWrZr/r#r)r0rrrrs ^-0 ) ) ) )       11[1,rrcBeZdZdZedddddZdS) rz3A config for a single Pulse experiment in the qobj.r r r rNc f|||_|||_|r|j|dSdS)a?Instantiate a PulseQobjExperimentConfig object. Args: qubit_lo_freq (List[float]): List of qubit LO frequencies in GHz. meas_lo_freq (List[float]): List of meas readout LO frequencies in GHz. kwargs: Additional free form key value fields to add to the configuration N)rvrwrr)rrvrwrs rrz"PulseQobjExperimentConfig.__init__sN  $!.D   # ,D   ) M  ( ( ( ( ( ) )rr)r+r,r-r.rrr0rrrrsW==^-0 ) ) ) ) ) )rrcneZdZdZeddddZdZedZd Z d Z d Z d S) rzAn item in a pulse library.r r r rc||_t|dtr%tjd|D|_dS||_dS)zInstantiate a pulse library item. Args: name (str): A name for the pulse. samples (list[complex]): A list of complex values defining pulse shape. rcFg|]}t|d|dS)rrl)rn)rHsamples rrJz-PulseLibraryItem.__init__..*s*'\'\'\&q 6!9(E(E'\'\'\rN)rr&r`numpyarraysamples)rrrs rrzPulseLibraryItem.__init__sQ  gaj$ ' ' # ;'\'\T['\'\'\]]DLLL"DLLLrc |j|jdS)zReturn a dictionary format representation of the pulse library item. Returns: dict: The dictionary form of the PulseLibraryItem. rrrrs rrzPulseLibraryItem.to_dict.s  dl;;;rc|di|S)zCreate a new PulseLibraryItem object from a dictionary. Args: data (dict): A dictionary for the experiment config Returns: PulseLibraryItem: The object from the input dictionary. r0r0)r!r"s rr#zPulseLibraryItem.from_dict6ss{{T{{rcBd|jdt|jdS)NzPulseLibraryItem(rPrS)rrrrs rrWzPulseLibraryItem.__repr__Bs'E49EET\0B0BEEEErc&d|jd|jS)NzPulse Library Item: name: z samples: rrs rrZzPulseLibraryItem.__str__EsUtyUUt|UUUrct|tr,||krdSdSr%)r&rrr's rr)zPulseLibraryItem.__eq__Hs: e- . . ||~~00turN) r+r,r-r.rrrr/r#rWrZr)r0rrrrs%%^-0 # # #<<<  [ FFFVVVrrcpeZdZdZedddd dZdZd Zd Ze d Z d Z dS) PulseQobjz A Pulse Qobj.r r r rNcv||_||_|p t|_||_d|_d|_dS)anInstantiate a new Pulse Qobj Object. Each Pulse Qobj object is used to represent a single payload that will be passed to a Qiskit provider. It mirrors the Qobj the published `Qobj specification `_ for Pulse experiments. Args: qobj_id (str): An identifier for the qobj config (PulseQobjConfig): A config for the entire run header (QobjHeader): A header for the entire run experiments (list): A list of lists of :class:`PulseQobjExperiment` objects representing an experiment PULSEz1.2.0N)qobj_idrrr experimentsr=schema_version)rrrrrs rrzPulseQobj.__init__Rs?.  ,  & %rc d|jD}dd|zdz}d|jdt|jd|dt|jd S) Nc,g|]}t|Sr0rrGs rrJz&PulseQobj.__repr__..qs===q477===rrrPrzPulseQobj(qobj_id='z ', config=z, experiments=z , header=rS)rrrrrr)rexperiments_strexperiments_reprs rrWzPulseQobj.__repr__ps==D,<===?!;!;;cA K$, K K$t{:K:K K K+ K K6:4;6G6G K K K rcbd|jd}tj|j}|dt |dz }tj|j}|dt |dz }|dz }|jD]}|t |z }|S)Nz Pulse Qobj: z: zConfig: rYzHeader: z Experiments: )rrrrrrTrr)rrUrr experiments rrZzPulseQobj.__str__xs.T\... 3 3 5 566 )#f++)))) 3 3 5 566 )#f++)))) * # #J 3z?? "CC rc|j|j|j|j|jd|jDd}|S)aReturn a dictionary format representation of the Pulse Qobj. Note this dict is not in the json wire format expected by IBMQ and qobj specification because complex numbers are still of type complex. Also this may contain native numpy arrays. When serializing this output for use with IBMQ you can leverage a json encoder that converts these as expected. For example: .. code-block:: import json import numpy class QobjEncoder(json.JSONEncoder): def default(self, obj): if isinstance(obj, numpy.ndarray): return obj.tolist() if isinstance(obj, complex): return (obj.real, obj.imag) return json.JSONEncoder.default(self, obj) json.dumps(qobj.to_dict(), cls=QobjEncoder) Returns: dict: A dictionary representation of the PulseQobj object c6g|]}|Sr0rFrGs rrJz%PulseQobj.to_dict..s BBBAAIIKKBBBr)rrrrr=r)rrrrrr=rrs rrzPulseQobj.to_dicts]8|k))++k))++"1IBB1ABBB   rcd}d|vr t|d}d}d|vrd|dD}d}d|vrtj|d}||d|||S)a2Create a new PulseQobj object from a dictionary. Args: data (dict): A dictionary representing the PulseQobj to create. It will be in the same format as output by :func:`to_dict`. Returns: PulseQobj: The PulseQobj from the input dictionary. NrrcBg|]}t|Sr0)rr#)rHexps rrJz'PulseQobj.from_dict..s']]]#.88==]]]rrr)rrrr)rqr#rget)r!r"rrrs rr#zPulseQobj.from_dicts t  $..tH~>>F D ]]mI\]]]K t  )$x.99FsHHY''KX^    rct|tr,||krdSdSr%)r&rrr's rr)zPulseQobj.__eq__s9 eY ' ' ||~~00turr*) r+r,r-r.rrrWrZrr/r#r)r0rrrrOs^-0&&&&,      ###J  [ 0rr)r.r^rtypingrrrqiskit.qobj.commonrrr qiskit.utilsrr r2floatrnr_rqrrrrr0rrrs  :9  ,,,,,,))))))333333''''''22222222jEEEEEEEEPIuT%['12IwIIII"fffffmfffRccccccccL))))) )))677777777tvvvvvvvvvvr