g% FdZddlZddlmZddlmZGddeZdS)z6A container class for counts from a circuit execution.N) postprocess) exceptionscreZdZdZejdZd fd ZdZdZ dZ e dZ d Z xZS) Countsz:A class to store a counts result from a circuit execution.z ^[01\s]+$Ncd}t|}|si|_i|_i}ntt |}t |tr1||_d|jD|_nht |trC| dr1||_d|jD|_n | drLd|D|_d|jD|_n|s|sd|_d|_|}ni}i}|D]_\} } |j | stjd|| } | || <| |t!| <`||_||_nt#d i} ||_|jr |j| d <||_|jr |j| d <|st)j|j| }t-|||_dS) a'Build 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``. Nc4i|]\}}t||Shex.0keyvalues J/granary/edev/quantum/lib/python3.11/site-packages/qiskit/result/counts.py z#Counts.__init__..Is$WWWJCC%WWW0xc6i|]\}}t|d|Srintr s rrz#Counts.__init__..Ms&#^#^#^:3CQKK#^#^#^r0bc6i|]\}}t|d|Srrr s rrz#Counts.__init__..Os&#V#V#V:3CQKK#V#V#Vrc4i|]\}}t||Sr r r s rrz#Counts.__init__..Ps$#[#[#[ UCHHe#[#[#[rztCounts 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 isinstanceritemsstr startswithbitstring_regexsearchr QiskitError_remove_space_underscorer TypeErrorrrr format_countssuper__init__ time_taken)selfdatar0rrbin_data first_keyhex_dictint_dict bitstringrint_keyr __class__s rr/zCounts.__init__ s>Dzz( DLDLHHT$))++..//I)S))" # WW$,BTBTBVBVWWW Is++ ''--0#'DL#^#^I[I[I]I]#^#^#^DLL))$//0#V#V#V#V#VDL#[#[dlFXFXFZFZ#[#[#[DLL%0l0'+ '+ #'#%#%04 ; ;,Iu#'#7#>#>y#I#I"&0&<%A'"'"!" '+&C&CI&N&NG05HW-5:HS\\22'/ '/ M$ ? 3#'?F< (   7%)%6F> " N"0fMMMH """$rc<|stjdt|fd|D}t |dkr*tjdd||dS)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 objectc8g|]}|dk|dS)rr )r x max_values r z(Counts.most_frequent..s+MMMa1Q49;L;LQqT;L;L;Lrr<z.Multiple values have the same maximum counts: ,r)rr*maxvaluesr%lenjoin)r1max_values_countsr>s @r most_frequentzCounts.most_frequentvs d()bcc c && MMMM4::<<MMM  ! !Q & &(^J[A\A\^^ !##rc<|jr#d|jDSi}|D]Z\}}|j|st jd||}||t|<[|S)aReturn 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 c>i|]\}}||Sr )lowerr s rrz'Counts.hex_outcomes..s&NNN:3CIIKKNNNrzRCounts objects with dit strings do not currently support conversion to hexadecimal)r r%r(r)rr*r+r r1out_dictr7rr8s r hex_outcomeszCounts.hex_outcomess < NN9K9K9M9MNNN NH$(JJLL / / 5+229==$0F77 BB).W&&Orc|jr|jSi}|D]M\}}|j|st jd||}|||<N|S)a Build 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)rr%r(r)rr*r+rJs r int_outcomeszCounts.int_outcomess < < H$(JJLL * * 5+229==$0B77 BB$)!!Orcrt|dddddS)z1Removes all spaces and underscores from bitstring _)rreplace)r7s rr+zCounts._remove_space_underscores49$$S"--55c2>>BBBrcDt|S)zReturn the number of shots)sumrB)r1s rshotsz Counts.shotss4;;==!!!r)NNN)__name__ __module__ __qualname____doc__recompiler(r/rFrLrN staticmethodr+rW __classcell__)r9s@rrrsDD bj..OT%T%T%T%T%T%l$$$&.,CC\C"""""""rr)r[r\ qiskit.resultrqiskitrrrr rrrbsx=< %%%%%%b"b"b"b"b"Tb"b"b"b"b"r