g.PdZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZdd lmZdd lmZdd lmZeZGd dZdS)z$Model for schema-conformant Results.)IterableN)QuantumCircuit)Schedule) QiskitError) statevector)ExperimentResult) postprocess)Counts) MeasLevel) QobjHeaderc~eZdZdZiZdddddZdZdZdZe dZ dd Z dd Z dd Z dd Zdd ZddZdS)ResultaModel for Results. .. deprecated:: 1.4 The use of positional arguments in the constructor of :class:`.Result` is deprecated as of Qiskit 1.4, and will be disabled in Qiskit 2.0. Please set all arguments using kwarg syntax, i.e: ``Result(backend_name="name", ....)``. In addition to this, the ``qobj_id`` argument is deprecated and will no longer be used in Qiskit 2.0. It will, however, still be possible to set ``qobj_id`` as a generic kwarg, which will land in the metadata field with the other generic kwargs. Args: backend_name (str): (REQUIRED) backend name. backend_version (str): (REQUIRED) backend version, in the form X.Y.Z. qobj_id (str): (REQUIRED) user-generated Qobj id. job_id (str): (REQUIRED) unique execution id from the backend. success (bool): (REQUIRED) True if complete input qobj executed correctly. (Implies each experiment success) results (list[ExperimentResult]): (REQUIRED) corresponding results for array of experiments of the input qobj date (str): (OPTIONAL) date of the experiment header(dict): (OPTIONAL)experiment header kwargs: generic keyword arguments. (OPTIONAL) These will be stored in the metadata field. N)datestatusheaderctttttttd}i}|D]\}} ||vr| ||<| ||<gd} d} g} t| D]\} } || } | ||<|dkr$tjd|d|dt dn#tjd|d|d t da#t $r:||turd |D} n|dkrd } YnwxYwt| d kr"td t| d| t| d krtd| d| rtjdt di|_ |d|_ |d|_ |d|_ |d|_ |d|_t|dt s |dgn|d|_||_||_||_|j |dS)N) backend_namebackend_versionqobj_idjob_idsuccessresultsFrzThe use of positional arguments in `qiskit.result.result.Result.__init__()` is deprecated as of Qiskit 1.4, and will be disabled in Qiskit 2.0. Please set this value using kwarg syntax, i.e: `Result(...,=z_value)`. The `qobj_id` argument will no longer be used in Qiskit 2.0, but it will still be possible to set as a kwarg that will land in the metadata field.)category stacklevelz _value)`. c*g|]\}}|tu|S)_MISSING).0keyvalues J/granary/edev/quantum/lib/python3.11/site-packages/qiskit/result/result.py z#Result.__init__..vs.$$$ ,eRZIZIZIZIZIZTzResult.__init__() missing z required arguments: z/Result.__init__() missing a required argument: rzThe `qobj_id` argument will no longer be used in Qiskit 2.0, but it will still be possible to set as a kwarg that will land in the metadata field.rrrrr)ritems enumeratewarningswarnDeprecationWarning IndexErrorlen TypeError _metadatarrrrr isinstancerrrrrupdate)selfrrrargskwargs required_args true_kwargsr!r" index_map raise_qobj missing_argsindexnames r#__init__zResult.__init__;s)%'     ,,.. ) )JCm##%* c""#( C  bbb   $Y//" " KE4! U &+ d#9$$MO-1OO48OOO"4#$     MD-1DD48DDD"4#$     &(22$$0=0C0C0E0E$$$LLY&&!%J  |  q cS->->ccUacc  |   ! !_l[\o__`` `   MG,     ).9,->?$Y/ #H- $Y/ mI6AA *]9 % & &y)     k*****s0AC  ADDc Xd|jd|jd|jd|jd|jd|j }|d|jd|jd |jz }|j D];\}}t|trd |d }nt|}|d |d |z }<|d z }|S)NzResult(backend_name='z', backend_version='z ', qobj_id='z ', job_id='z ', success=z , results=z, date=z , status=z , header=', r))rrrrrrrrrr/r'r0strrepr)r2outr!r" value_strs r#__repr__zResult.__repr__s  'D$5 ' '4K_ ' ' ' '26+ ' 'JN, ' '  ' ' PPPT[PP4;PPP...00 * *JC%%% ((LLL  KK )))i)) )CC s  r%c |j|j|j|jdn|j|j|j|j|jd|j Dd }| |j |S)zReturn a dictionary format representation of the Result Returns: dict: The dictionary form of the Result Nc6g|]}|Sr)to_dictr xs r#r$z"Result.to_dict..s ::: :::r%) rrrrrrrrr) rrrrrHrrrrrr1r/)r2out_dicts r#rHzResult.to_dicts!-#3I"k1ddt{7J7J7L7L|kk|::T\:::    '''r%cj |j|S#t$r}td|d|d}~wwxYw)Nz Attribute z is not defined)r/KeyErrorAttributeError)r2r;exs r# __getattr__zResult.__getattr__sT M>$' ' M M M !Cd!C!C!CDD" L Ms  2-2ctj|}d|dD|d<|dqtj5tjdt dtj|d|d<dddn #1swxYwY|di|S) aaCreate a new ExperimentResultData object from a dictionary. Args: data (dict): A dictionary representing the Result to create. It will be in the same format as output by :meth:`to_dict`. Returns: Result: The ``Result`` object from the input dictionary. c6g|]}tj|Sr)r from_dictrIs r#r$z$Result.from_dict..s$\\\.8;;\\\r%rrNignoreqiskit)rmoduler) copypopgetr)catch_warningsfilterwarningsr+r rS)clsdatain_datas r#rSzResult.from_dicts )D//\\W[[QZE[E[\\\  ;;x ,(** P P';MV^____$.$8X9N9N$O$O! P P P P P P P P P P P P P P Ps~~W~~sAB22B69B6c ||jS#ttf$r&}t dt |d|d}~wwxYw)a Get the raw data for an experiment. Note this data will be a single classical and quantum register and in a format required by the results schema. We recommend that most users use the get_xxx method, and the data will be post-processed for the data type. Args: experiment (str or QuantumCircuit or Schedule or int or None): the index of the experiment. Several types are accepted for convenience:: * str: the name of the experiment. * QuantumCircuit: the name of the circuit instance will be used. * Schedule: the name of the schedule instance will be used. * int: the position of the experiment. * None: if there is only one experiment, returns it. Returns: dict: A dictionary of results data for an experiment. The data depends on the backend it ran on and the settings of `meas_level`, `meas_return` and `memory`. OpenQASM backends return a dictionary of dictionary with the key 'counts' and with the counts, with the second dictionary keys containing a string in hex format (``0x123``) and values equal to the number of times this outcome was measured. Statevector backends return a dictionary with key 'statevector' and values being a list[list[complex components]] list of 2^num_qubits complex amplitudes. Where each complex number is represented as a 2 entry list for each component. For example, a list of [0.5+1j, 0-1j] would be represented as [[0.5, 1], [0, -1]]. Unitary backends return a dictionary with key 'unitary' and values being a list[list[list[complex components]]] list of 2^num_qubits x 2^num_qubits complex amplitudes in a two entry list for each component. For example if the amplitude is [[0.5+0j, 0-1j], ...] the value returned will be [[[0.5, 0], [0, -1]], ...]. The simulator backends also have an optional key 'snapshots' which returns a dict of snapshots specified by the simulator backend. The value is of the form dict[slot: dict[str: array]] where the keys are the requested snapshot slots, and the values are a dictionary of the snapshots. Raises: QiskitError: if data for the experiment could not be retrieved. zNo data for experiment ""N)_get_experimentr]rHrMr.rrB)r2 experimentrOs r#r]z Result.datasy` V'' 338@@BB B)$ V V VLj9I9ILLLMMSU U Vs+.A%!A  A%c@||} |j}n#ttf$rd}YnwxYw|j}||d}|tjkrtj ||S|tj krtj |S|tj krtj|St d|d#t$r&}t dt!|d|d}~wwxYw)aGet the sequence of memory states (readouts) for each shot The data from the experiment is a list of format ['00000', '01000', '10100', '10100', '11101', '11100', '00101', ..., '01010'] Args: experiment (str or QuantumCircuit or Schedule or int or None): the index of the experiment, as specified by ``data()``. Returns: List[str] or np.ndarray: Either the list of each outcome, formatted according to registers in circuit or a complex numpy np.ndarray with shape: ============ ============= ===== `meas_level` `meas_return` shape ============ ============= ===== 0 `single` np.ndarray[shots, memory_slots, memory_slot_size] 0 `avg` np.ndarray[memory_slots, memory_slot_size] 1 `single` np.ndarray[shots, memory_slots] 1 `avg` np.ndarray[memory_slots] 2 `memory=True` list ============ ============= ===== Raises: QiskitError: if there is no memory data for the circuit. NmemoryzMeasurement level z is not supportedzNo memory for experiment "z". Please verify that you either ran a measurement level 2 job with the memory flag set, eg., "memory=True", or a measurement level 0/1 job.)rarrHrNr meas_levelr]r CLASSIFIEDr format_level_2_memoryKERNELEDformat_level_1_memoryRAWformat_level_0_memoryrMrB)r2rb exp_resultrrerdrOs r# get_memoryzResult.get_memorysL4))*55   #*2244"K0    $.JYYz**84FY111"8HHHy111"8@@@y},,"8@@@!"Tz"T"T"TUUU   2T*-=-=222    sE2C-AC-AA C-#C-6#C-C-- D7!DDc|"tt|j}n|g}g}|D]}||} |j}n#t tf$rd}YnwxYwd|| vr]|rd| D}ni}| t||dfi|d|| vrjtj||d}| tj|detdt%|dt|d kr|d S|S) aGet the histogram data of an experiment. Args: experiment (str or QuantumCircuit or Schedule or int or None): the index of the experiment, as specified by ``data([experiment])``. Returns: dict[str, int] or list[dict[str, int]]: a dictionary or a list of dictionaries. A dictionary has the counts for each qubit with the keys containing a string in binary format and separated according to the registers in circuit (e.g. ``0100 1110``). The string is little-endian (cr[0] on the right hand side). Raises: QiskitError: if there are no counts for the experiment. Ncountsc"i|] \}}|dv || S)> creg_sizes time_taken memory_slotsr)r kvs r# z%Result.get_counts..is4%%% Aq LLL1LLLr%rdecimalszNo counts for experiment "r`r&r)ranger-rrarrHrNrr]keysr'appendr r format_statevectorr Statevectorprobabilities_dictrB) r2rbexp_keys dict_listr!expr counts_headervecs r# get_countszResult.get_countsIs"  S..//HH"|H  M MC&&s++C ++--"K0    499S>>..0000'%%$*LLNN%%%MM %'M   #x(@!R!RM!R!RSSSS$))C.."5"5"7"777!4TYYs^^M5RSS  !8!=!=!P!PZ\!P!]!]^^^^!"KtCyy"K"K"KLLL y>>Q  Q<  sAA54A5c tj||d|S#t$r&}t dt |d|d}~wwxYw)aGet the final statevector of an experiment. Args: experiment (str or QuantumCircuit or Schedule or int or None): the index of the experiment, as specified by ``data()``. decimals (int): the number of decimals in the statevector. If None, does not round. Returns: list[complex]: list of 2^num_qubits complex amplitudes. Raises: QiskitError: if there is no statevector for the experiment. rrxzNo statevector for experiment "r`N)r r}r]rMrrBr2rbryrOs r#get_statevectorzResult.get_statevector}s ]1 *%%m4x  ] ] ]SZ@P@PSSSTTZ\ \ ].1 A!!AA!c tj||d|S#t$r&}t dt |d|d}~wwxYw)aGet the final unitary of an experiment. Args: experiment (str or QuantumCircuit or Schedule or int or None): the index of the experiment, as specified by ``data()``. decimals (int): the number of decimals in the unitary. If None, does not round. Returns: list[list[complex]]: list of 2^num_qubits x 2^num_qubits complex amplitudes. Raises: QiskitError: if there is no unitary for the experiment. unitaryrxzNo unitary for experiment "r`N)r format_unitaryr]rMrrBrs r# get_unitaryzResult.get_unitarysx  Y-dii .C.CI.NYabbb b Y Y YOD.sF768T::FBGG3NNNNNr%zData for experiment "z8Result object contained multiple results matching name "z_", only first match will be returned. Use an integer index to retrieve results for all entries.rFrzResult was not successfulzExperiment was not successfulr?) r-rrr0rrr;intr,r)r*r)r2r!rrO result_status exp_statuss ` r#razResult._get_experiments ;4<  A%%!dC cNH5 6 6 (C c3    `l3' ` ` `!"VC"V"V"VWW]__ `"lC 3xx1}}!"T#"T"T"TUUU3xx1}}!f 8s888 !f 3 5 ) ) Jh0KLL S(,KLL -z:::s& A44 B>BB)N)NN)__name__ __module__ __qualname____doc__r/r<rErHrP classmethodrSr]rmrrrrarr%r#rr s!0I  b+b+b+b+b+H (MMM [(3V3V3V3Vj4444l2222h]]]],YYYY*9;9;9;9;9;9;r%r)rcollections.abcrrWr)qiskit.circuit.quantumcircuitrqiskit.pulse.schedulerqiskit.exceptionsrqiskit.quantum_info.statesrqiskit.result.modelsr qiskit.resultr qiskit.result.countsr qiskit.qobj.utilsr qiskit.qobjr objectrrrr%r#rs+*$$$$$$ 888888******))))))222222111111%%%%%%''''''''''''"""""" 688A;A;A;A;A;A;A;A;A;A;r%