gMd4dZddlZddlZddlmZddlmZddlmZm Z ddl m Z m Z ddl mZGdd ZGd d ZGd d eZGdde ZGdde ZGddZGddZGddZdS)z8Module providing definitions of OpenQASM 2 Qobj classes.N)SimpleNamespace)ParameterExpression)PulseQobjInstructionPulseLibraryItem) QobjDictField QobjHeader)deprecate_funcceZdZdZeddd d dZdZd Zd Ze d Z d Z dS)QasmQobjInstructionzDA class representing a single instruction in an QasmQobj Experiment.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)aInstantiate a new QasmQobjInstruction object. Args: name (str): The name of the instruction params (list): The list of parameters for the gate qubits (list): A list of ``int`` representing the qubits the instruction operates on register (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. memory (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. condition (tuple): A tuple of the form ``(int, int)`` where the first ``int`` is the control register and the second ``int`` is the control value if the gate has a condition. conditional (int): The register index of the condition label (str): An optional label assigned to the instruction mask (int): For a ``bfunc`` instruction the hex value which is applied as an ``AND`` to the register bits. relation (str): Relational operator for comparing the masked register to the ``val`` kwarg. Can be either ``==`` (equals) or ``!=`` (not equals). val (int): Value to which to compare the masked register. In other words, the output of the function is ``(register AND mask)`` snapshot_type (str): For snapshot instructions the type of snapshot to use N) nameparamsqubitsregistermemory _condition conditionallabelmaskrelationval snapshot_type) selfrrrrr conditionrrrrrrs K/granary/edev/quantum/lib/python3.11/site-packages/qiskit/qobj/qasm_qobj.py__init__zQasmQobjInstruction.__init__sn   DK   DK  $DM   DK  'DO  "*D   DJ  DI  $DM ?DH  $!.D    % $c^d|ji}dD]}t||r|dkrug}tt||D]O}t |t r#|t|:||P|||<t||||<|S)zReturn a dictionary format representation of the Instruction. Returns: dict: The dictionary form of the QasmQobjInstruction. r rrrrrrrrrrrr)rhasattrlistgetattr isinstancerappendfloat)r out_dictattrrparams r"to_dictzQasmQobjInstruction.to_dictjs DI&   9 9DtT"" 98##F!%gdD&9&9!:!:11%e-@AA1"MM%,,7777"MM%0000%+HTNN%,T4%8%8HTNr$cd|jd}dD]B}t||d}|-t|tr |d|d|dz }7|d|d|z }C|dz }|S) NzQasmQobjInstruction(name=''r&, z=""=))rr)r*str)r outr.attr_vals r"__repr__zQasmQobjInstruction.__repr__s749777   2 2DtT400H#h,,23333333CC111x111C s  r$c zd|jd}dD],}t||r|d|dt||dz }-|S)Nz Instruction:  r&z z: )rr'r))r r8r.s r"__str__zQasmQobjInstruction.__str__sg+di+++   > >DtT"" >=d==gdD&9&9==== r$c>|d}||fi|S)zCreate a new QasmQobjInstruction object from a dictionary. Args: data (dict): A dictionary for the experiment config Returns: QasmQobjInstruction: The object from the input dictionary. rpop)clsdatars r" from_dictzQasmQobjInstruction.from_dicts-xxs4  4   r$ct|tr,||krdSdSNTF)r*r r0r others r"__eq__zQasmQobjInstruction.__eq__s: e0 1 1 ||~~00tur$) NNNNNNNNNNN) __name__ __module__ __qualname____doc__r r#r0r:r= classmethodrCrHr$r"r r sNN^-0  E/E/E/E/N"""H0& ! ![ !r$r cpeZdZdZedddd dZdZd Zd Ze d Z d Z dS)QasmQobjExperimentzAn OpenQASM 2 Qobj Experiment. Each instance of this class is used to represent an OpenQASM 2 experiment as part of a larger OpenQASM 2 qobj. r r rrNcl|p t|_|p t|_|pg|_dS)a-Instantiate a QasmQobjExperiment. Args: config (QasmQobjExperimentConfig): A config object for the experiment header (QasmQobjExperimentHeader): A header object for the experiment instructions (list): A list of :class:`QasmQobjInstruction` objects N)QasmQobjExperimentConfigconfigQasmQobjExperimentHeaderheader instructions)r rSrUrVs r"r#zQasmQobjExperiment.__init__s= : 8 : : : 8 : : (.Br$cd|jD}dd|zdz}dt|jdt|jd|dS) Nc,g|]}t|SrNrepr.0xs r" z/QasmQobjExperiment.__repr__..s???DGG???r$[r3]zQasmQobjExperiment(config= , header=z, instructions=r6)rVjoinrZrSrU)r instructions_strinstructions_reprs r"r:zQasmQobjExperiment.__repr__s~??T->???$)),<"="==C 2dk):): 2 2T$+EVEV 2 2. 2 2 2 r$cd}tj|j}tj|j}|d|dz }|d|dz }|jD] }|d|dz } |S)Nz OpenQASM2 Experiment: zHeader: r<zConfig: z  )pprintpformatrSr0rUrV)r r8rSrU instructions r"r=zQasmQobjExperiment.__str__s) 3 3 5 566 3 3 5 566 %6%%%% '6'''', ( (K ' ''' 'CC r$c|j|jd|jDd}|S)zReturn a dictionary format representation of the Experiment. Returns: dict: The dictionary form of the QasmQObjExperiment. c6g|]}|SrNr0r[s r"r^z.QasmQobjExperiment.to_dict..s DDDQQYY[[DDDr$)rSrUrV)rSr0rUrVr r-s r"r0zQasmQobjExperiment.to_dictsMk))++k))++DD$2CDDD   r$c2d}d|vr-t|d}d}d|vr-t|d}d}d|vrd|dD}||||S)zCreate a new QasmQobjExperiment object from a dictionary. Args: data (dict): A dictionary for the experiment config Returns: QasmQobjExperiment: The object from the input dictionary. NrSrUrVcBg|]}t|SrN)r rCr\insts r"r^z0QasmQobjExperiment.from_dict..s48<#--d33r$)rRrCr@rT)rArBrSrUrVs r"rCzQasmQobjExperiment.from_dicts t  -778J8JKKF t  -778J8JKKF T ! !@D@X@XLs66<000r$ct|tr,||krdSdSrE)r*rPr0rFs r"rHzQasmQobjExperiment.__eq__s: e/ 0 0 ||~~00tur$NNN rIrJrKrLr r#r:r=r0rMrCrHrNr$r"rPrPs ^-0 / / / /      11[1,r$rPc~eZdZdZeddd d dZdZed Zd Z dS) QasmQobjConfigz'A configuration for an OpenQASM 2 Qobj.r r rrNc z|t||_|t||_|t||_|||_|||_|||_|||_|||_ | | |_ | | |_ | | |_ | | |_ | | |_|r|j|dSdS)aModel for RunConfig. Args: shots (int): the number of shots. seed_simulator (int): the seed to use in the simulator memory (bool): whether to request memory from backend (per-shot readouts) parameter_binds (list[dict]): List of parameter bindings meas_level (int): Measurement level 0, 1, or 2 meas_return (str): For measurement level < 2, whether single or avg shots are returned memory_slots (int): The number of memory slots on the device n_qubits (int): The number of qubits on the device pulse_library (list): List of :class:`PulseLibraryItem`. calibrations (QasmExperimentCalibrations): Information required for Pulse gates. rep_delay (float): Delay between programs in sec. Only supported on certain backends (``backend.configuration().dynamic_reprate_enabled`` ). Must be from the range supplied by the backend (``backend.configuration().rep_delay_range``). Default is ``backend.configuration().default_rep_delay``. 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. kwargs: Additional free form key value fields to add to the configuration. N)intshotsseed_simulatorboolrparameter_binds meas_level meas_return memory_slotsn_qubits pulse_library calibrations rep_delay qubit_lo_freq meas_lo_freq__dict__update)r ryrzrr|r}r~rrrrrrrkwargss r"r#zQasmQobjConfig.__init__(s`  UDJ  %"%n"5"5D   v,,DK  D  !(DO  "*D   # ,D   $DM  $!.D   # ,D   &DN  $!.D   # ,D   ) M  ( ( ( ( ( ) )r$ctj|j}t|drd|jD|d<t|dr|j|d<|S)zReturn a dictionary format representation of the OpenQASM 2 Qobj config. Returns: dict: The dictionary form of the QasmQobjConfig. rc6g|]}|SrNrlr[s r"r^z*QasmQobjConfig.to_dict..s (Q(Q(Q(Q(Q(Qr$r)copyrr'rrr0rms r"r0zQasmQobjConfig.to_dictst 9T]++ 4 ) ) R(Q(Qd>P(Q(Q(QH_ % 4 ( ( C'+'8'@'@'B'BH^ $r$cd|vr&|d}d|D}||d<d|vr2|d}t||d<|di|S)zCreate a new QasmQobjConfig object from a dictionary. Args: data (dict): A dictionary for the config Returns: QasmQobjConfig: The object from the input dictionary. rc6g|]}tj|SrN)rrCr[s r"r^z,QasmQobjConfig.from_dict..s$NNNq-7::NNNr$rrNr@QasmExperimentCalibrationsrC)rArB pulse_lib pulse_lib_objrs r"rCzQasmQobjConfig.from_dicts d " "11INNINNNM$1D ! T ! !88N33L#=#G#G #U#UD s{{T{{r$ct|tr,||krdSdSrE)r*rvr0rFs r"rHzQasmQobjConfig.__eq__s9 e^ , , ||~~00tur$) NNNNNNNNNNNNN) rIrJrKrLr r#r0rMrCrHrNr$r"rvrv%s11^-0P)P)P)P)d   [(r$rvceZdZdZdS)rTz8A header for a single OpenQASM 2 experiment in the qobj.N)rIrJrKrLrNr$r"rTrTsBBDr$rTcheZdZdZedddd fd ZdZed ZxZ S) rRz=Configuration for a single OpenQASM 2 experiment in the qobj.r r rrNc p|r||_|||_|||_tjdi|dS)al Args: calibrations (QasmExperimentCalibrations): Information required for Pulse gates. 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 NrN)rrrsuperr#)r rrrr __class__s r"r#z!QasmQobjExperimentConfig.__init__sT  - ,D   $!.D   # ,D ""6"""""r$ctj|j}t|dr|j|d<|S)Nr)rrr'rr0rms r"r0z QasmQobjExperimentConfig.to_dictsD9T]++ 4 ( ( C'+'8'@'@'B'BH^ $r$c~d|vr2|d}t||d<|di|S)NrrNr)rArBrs r"rCz"QasmQobjExperimentConfig.from_dictsH T ! !88N33L#=#G#G #U#UD s{{T{{r$rs) rIrJrKrLr r#r0rMrC __classcell__)rs@r"rRrRsGG^-0######" [r$rRc\eZdZdZeddddZdZedZd S) rzhA container for any calibrations data. The gates attribute contains a list of GateCalibrations. r r rrc||_dS)zs Initialize a container for calibrations. Args: gates (list(GateCalibration)) N)gates)r rs r"r#z#QasmExperimentCalibrations.__init__s r$c`tj|j}d|jD|d<|S)zReturn a dictionary format representation of the calibrations. Returns: dict: The dictionary form of the GateCalibration. c6g|]}|SrNrlr[s r"r^z6QasmExperimentCalibrations.to_dict..s ===QQYY[[===r$r)rrrrms r"r0z"QasmExperimentCalibrations.to_dicts49T]++==$*===r$cZ|d}d|D|d<|di|S)atCreate a new GateCalibration object from a dictionary. Args: data (dict): A dictionary representing the QasmExperimentCalibrations to create. It will be in the same format as output by :func:`to_dict`. Returns: QasmExperimentCalibrations: The QasmExperimentCalibrations from the input dictionary. rcBg|]}t|SrN)GateCalibrationrCr[s r"r^z8QasmExperimentCalibrations.from_dict.. s&EEE!22155EEEr$rNr?)rArBrs r"rCz$QasmExperimentCalibrations.from_dicts>!!EEuEEEW s{{T{{r$N) rIrJrKrLr r#r0rMrCrNr$r"rrs^-0     [   r$rcbeZdZdZeddddZdZdZed Z d S) rz}Each calibration specifies a unique gate by name, qubits and params, and contains the Pulse instructions to implement it.r r rrc>||_||_||_||_dS)a Initialize a single gate calibration. Instructions may reference waveforms which should be made available in the pulse_library. Args: name (str): Gate name. qubits (list(int)): Qubits the gate applies to. params (list(complex)): Gate parameter values, if any. instructions (list(PulseQobjInstruction)): The gate implementation. N)rrrrV)r rrrrVs r"r#zGateCalibration.__init__s'&   (r$c t|jt|jt|jtd|jDfS)Nc34K|]}t|VdS)N)r7rps r" z+GateCalibration.__hash__..0s(>>Dc$ii>>>>>>r$)hashrtuplerrrV)r s r"__hash__zGateCalibration.__hash__*sU dk""dk"">>D,=>>>>>     r$c`tj|j}d|jD|d<|S)zReturn a dictionary format representation of the Gate Calibration. Returns: dict: The dictionary form of the GateCalibration. c6g|]}|SrNrlr[s r"r^z+GateCalibration.to_dict..;s #K#K#KAAIIKK#K#K#Kr$rV)rrrVrms r"r0zGateCalibration.to_dict4s5 9T]++#K#K9J#K#K#K r$cZ|d}d|D|d<|di|S)aJCreate a new GateCalibration object from a dictionary. Args: data (dict): A dictionary representing the GateCalibration to create. It will be in the same format as output by :func:`to_dict`. Returns: GateCalibration: The GateCalibration from the input dictionary. rVc6g|]}tj|SrN)rrCr[s r"r^z-GateCalibration.from_dict..Js$XXXa 4 >q A AXXXr$rNr?)rArBrVs r"rCzGateCalibration.from_dict>s?xx// XX<XXX^s{{T{{r$N) rIrJrKrLr r#rr0rMrCrNr$r"rrs88^-0)))      [   r$rcpeZdZdZedddd dZdZd Zd Ze d Z d Z dS)QasmQobjzAn OpenQASM 2 Qobj.r r rrNc|p t|_|p t|_|pg|_||_d|_d|_dS)a|Instantiate a new OpenQASM 2 Qobj Object. Each OpenQASM 2 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 OpenQASM experiments. Args: qobj_id (str): An identifier for the qobj config (QasmQobjRunConfig): A config for the entire run header (QobjHeader): A header for the entire run experiments (list): A list of lists of :class:`QasmQobjExperiment` objects representing an experiment QASMz1.3.0N)rrUrvrS experimentsqobj_idtypeschema_version)r rrSrrUs r"r#zQasmQobj.__init__QsO.,  0 0 0 &,"  %r$c d|jD}dd|zdz}d|jdt|jd|dt|jd S) Nc,g|]}t|SrNrYr[s r"r^z%QasmQobj.__repr__..ps===q477===r$r_r3r`zQasmQobj(qobj_id='z ', config=z, experiments=rar6)rrbrrZrSrU)r experiments_strexperiments_reprs r"r:zQasmQobj.__repr__os==D,<===?!;!;;cA L L Ldk9J9J L L, L L7;DK7H7H L L L r$cbd|jd}tj|j}|dt |dz }tj|j}|dt |dz }|dz }|jD]}|t |z }|S)Nz QASM Qobj: z: zConfig: r<zHeader: z Experiments: )rrgrhrSr0r7rUr)r r8rSrU experiments r"r=zQasmQobj.__str__ws-DL--- 3 3 5 566 )#f++)))) 3 3 5 566 )#f++)))) * # #J 3z?? "CC r$c|j|j|j|jdd|jDd}|S)aReturn a dictionary format representation of the OpenQASM 2 Qobj. Note this dict is not in the json wire format expected by IBM 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 IBM systems, 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 QasmQobj object rc6g|]}|SrNrlr[s r"r^z$QasmQobj.to_dict..s BBBAAIIKKBBBr$)rrUrSrrr)rrUr0rSrrrms r"r0zQasmQobj.to_dicts[8|k))++k))++"1BB1ABBB   r$cd}d|vr t|d}d}d|vrd|dD}d}d|vrtj|d}||d|||S)a.Create a new QASMQobj object from a dictionary. Args: data (dict): A dictionary representing the QasmQobj to create. It will be in the same format as output by :func:`to_dict`. Returns: QasmQobj: The QasmQobj from the input dictionary. NrSrcBg|]}t|SrN)rPrC)r\exps r"r^z&QasmQobj.from_dict..s'\\\-77<<\\\r$rUr)rrSrrU)rvrCrget)rArBrSrrUs r"rCzQasmQobj.from_dicts t  #--d8n==F D \\]H[\\\K t  )$x.99FsHHY''KX^    r$ct|tr,||krdSdSrE)r*rr0rFs r"rHzQasmQobj.__eq__s9 eX & & ||~~00tur$)NNNNrtrNr$r"rrNs^-0&&&&,      ###J  [ 0r$r)rLrrgtypesr"qiskit.circuit.parameterexpressionrqiskit.qobj.pulse_qobjrrqiskit.qobj.commonrr qiskit.utilsr r rPrvrTrRrrrrNr$r"rs?> !!!!!!BBBBBBIIIIIIII88888888''''''rrrrrrrrjUUUUUUUUpEEEEE_EEEP     }   '''''}'''T........b========@vvvvvvvvvvr$