z i% >SrSSKrSSKJr SSKJr "SS\5rg)z6A container class for counts from a circuit execution.N) postprocess) exceptionsc|^\rSrSrSr\R "S5rS U4SjjrSr Sr Sr \ S5r S rS rU=r$) Countsz:A class to store a counts result from a circuit execution.z ^[01\s]+$c>Sn[U5nU(d0Ul0Ul0nGO&[[ UR 555n[ U[5(aFXlURR5VVs0sHupx[U5U_M snnUlGO[ U[5(GaURS5(aGXlURR5VVs0sHupx[US5U_M snnUlGO6URS5(atUR5VVs0sHupx[US5U_M snnUlURR5VVs0sHupx[U5U_M snnUlOU(dU(dSUlSUlUnO0n 0n UR5H]upURRU 5(d[R"S5eUR!U 5n XU 'X[U 5'M_ XlXlO [#S5e0n X0lUR$(aUR$U S'X@lUR&(aUR&U S'U(d[(R*"URU S 9n[,TU]]U5 X lgs snnfs snnfs snnfs snnf) aWBuild a counts object Args: data (dict): The dictionary input for the counts. Where the keys represent a measured classical value and the value is an integer the number of shots with that result. The keys can be one of several formats: * A hexadecimal string of the form ``'0x4a'`` * A bit string prefixed with ``0b`` for example ``'0b1011'`` * A bit string formatted across register and memory slots. For example, ``'00 10'``. * A dit string, for example ``'02'``. Note for objects created with dit strings the ``creg_sizes`` and ``memory_slots`` kwargs don't work and :meth:`hex_outcomes` and :meth:`int_outcomes` also do not work. time_taken (float): The duration of the experiment that generated the counts in seconds. creg_sizes (list): a nested list where the inner element is a list of tuples containing both the classical register name and classical register size. For example, ``[('c_reg', 2), ('my_creg', 4)]``. memory_slots (int): The number of total ``memory_slots`` in the experiment. Raises: TypeError: If the input key type is not an ``int`` or ``str``. QiskitError: If a dit string key is input with ``creg_sizes`` and/or ``memory_slots``. N0xr0bztCounts objects with dit strings do not currently support dit string formatting parameters creg_sizes or memory_slotszgInvalid input key type %s, must be either an int key or string key with hexadecimal value or bit string creg_sizes memory_slots)header)dictint_rawhex_rawnextiterkeys isinstanceintitemshexstr startswithbitstring_regexsearchr QiskitError_remove_space_underscore TypeErrorr r r format_countssuper__init__ time_taken)selfdatar"r r bin_data first_keykeyvaluehex_dictint_dict bitstringint_keyr __class__s N/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/result/counts.pyr!Counts.__init__ se>DzDLDLHT$))+./I)S))# BF,,BTBTBVWBVJCC%BVW Is++''--#'LIMI[I[I]#^I]:3CQK$6I]#^DL))$//IM#V:3CQK$6#VDLFJllFXFXFZ#[FZ CHeOFZ#[DL%l'+ '+ #'#%#%04 ,I#'#7#7#>#>y#I#I&0&<&<%A'"!" '+&C&CI&NG05W-5:S\21=(0 '/ M$ ??#'??F< (   %)%6%6F> ""00fMH "$W X$_#V#[sK4KK$K*cJU(d[R"S5e[UR55nUR 5Vs/sHo"SU:XdM USPM nn[ U5S:wa([R"SSR U535eUS$s snf)zReturn the most frequent count Returns: str: The bit string for the most frequent result Raises: QiskitError: when there is >1 count with the same max counts, or an empty object. z7Can not return a most frequent count on an empty objectrz.Multiple values have the same maximum counts: ,)rrmaxvaluesrlenjoin)r# max_valuexmax_values_countss r. most_frequentCounts.most_frequentvs(()bc c & +/::<MURR5VVs0sHupUR5U_M snn$0nUR5HYupBURR U5(d[ R "S5eURU5nX#[U5'M[ U$s snnf)zReturn a counts dictionary with hexadecimal string keys Returns: dict: A dictionary with the keys as hexadecimal strings instead of bitstrings Raises: QiskitError: If the Counts object contains counts for dit strings zRCounts objects with dit strings do not currently support conversion to hexadecimal) rrlowerrrrrrr)r#r'r(out_dictr+r,s r. hex_outcomesCounts.hex_outcomess <<9=9K9K9MN9M:3CIIK&9MN NH$(JJL ++229==$00F77 B).W&%1OOsCc UR(a UR$0nUR5HPup#URRU5(d[R "S5eUR U5nX1U'MR U$)zBuild a counts dictionary with integer keys instead of count strings Returns: dict: A dictionary with the keys as integers instead of bitstrings Raises: QiskitError: If the Counts object contains counts for dit strings zNCounts objects with dit strings do not currently support conversion to integer)rrrrrrr)r#r>r+r(r,s r. int_outcomesCounts.int_outcomess~ <<<< H$(JJL ++229==$00B77 B$)!%1OcZ[URSS5RSS5S5$)z1Removes all spaces and underscores from bitstring _)rreplace)r+s r.rCounts._remove_space_underscores+9$$S"-55c2>BBrDc4[UR55$)zReturn the number of shots)sumr4)r#s r.shots Counts.shotss4;;=!!rD)r rrr r")NNN)__name__ __module__ __qualname____firstlineno____doc__recompilerr!r:r?rB staticmethodrrN__static_attributes__ __classcell__)r-s@r.rrsJDjj.OT%l$&.,CC""rDr)rTrU qiskit.resultrqiskitrrrrDr.r]s!= %b"Tb"rD