Counts

class Counts(data, time_taken=None, creg_sizes=None, memory_slots=None)[source]

A class to store a counts result from a circuit execution.

Build a counts object

Parameters
  • 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 hexademical 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 hex_outcomes() and int_outcomes() also do not work.

  • time_taken (float) – The duration of the experiment that generated the counts

  • 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 string

  • QiskitError – If a dit string key is input with creg_sizes and/or memory_slots

Methods

Counts.__getitem__

x.__getitem__(y) <==> x[y]

Counts.__len__()

Return len(self).

Counts.clear()

Counts.copy()

Counts.fromkeys([value])

Create a new dictionary with keys from iterable and values set to value.

Counts.get(key[, default])

Return the value for key if key is in the dictionary, else default.

Counts.hex_outcomes()

Return a counts dictionary with hexademical string keys

Counts.int_outcomes()

Build a counts dictionary with integer keys instead of count strings

Counts.items()

Counts.keys()

Counts.most_frequent()

Return the most frequent count

Counts.pop(k[,d])

If key is not found, d is returned if given, otherwise KeyError is raised

Counts.popitem()

Remove and return a (key, value) pair as a 2-tuple.

Counts.setdefault(key[, default])

Insert key with a value of default if key is not in the dictionary.

Counts.update([E, ]**F)

If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]

Counts.values()

Counts.__getitem__

x.__getitem__(y) <==> x[y]

Counts.__len__()

Return len(self).