# Tutorial: Python’s Counter Class and Probability Mass Functions

##
The Python Counter Class

The Counter class in Python is part of the collections module. Counter provides a fast way to count up the number of unique items that exist in a list. The Counter class can also be extended to represent probability mass functions and suites of bayesian hypotheses. A counter is a map from values to their frequencies. If you initialize a counter with a string, you get a map from each letter to the number of times it appears. If two words are anagrams, they yield equal Counters, so you can use Counters to test anagrams in linear time. This lesson is based on a Jupyter notebook by Allen Downey.

```
from collections import Counter
def is_anagram(word1, word2):
"""
Checks whether the words are anagrams.
word1: string
word2: string
returns: boolean
"""
return Counter(word1) == Counter(word2)
print(is_anagram('tachymetric', 'mccarthyite'))
print(is_anagram('banana', 'peach'))
```

```
True
False
```

##
Multisets

A Counter is a natural representation of a multiset, which is a set where the elements can appear more than once. You can extend Counter with set operations like is_subset: You could use `is_subset`

in a game like Scrabble to see if a given set of tiles can be used to spell a given word.

```
class Multiset(Counter):
"""A multiset is a set where elements can appear more than once."""
def is_subset(self, other):
"""Checks whether self is a subset of other.
other: Multiset
returns: boolean
"""
for char, count in self.items():
if other[char] < count:
return False
return True
# map the <= operator to is_subset
__le__ = is_subset
def can_spell(word, tiles):
"""Checks whether a set of tiles can spell a word.
word: string
tiles: string
returns: boolean
"""
return Multiset(word) <= Multiset(tiles)
print(can_spell('SYZYGY', 'AGSYYYZ'))
```

`True`

##
Probability Mass Functions

You can also extend Counter to represent a probability mass function (PMF). `normalize`

computes the total of the frequencies and divides through, yielding probabilities that add to 1. `__add__`

enumerates all pairs of value and returns a new Pmf that represents the distribution of the sum. `__hash__`

and `__id__`

make Pmfs hashable; this is not the best way to do it, because they are mutable. So this implementation comes with a warning that if you use a Pmf as a key, you should not modify it. A better alternative would be to define a frozen Pmf. `render`

returns the values and probabilities in a form ready for plotting:

```
class Pmf(Counter):
"""A Counter with probabilities."""
def normalize(self):
"""Normalizes the PMF so the probabilities add to 1."""
total = float(sum(self.values()))
for key in self:
self[key] /= total
def __add__(self, other):
"""Adds two distributions.
The result is the distribution of sums of values from the
two distributions.
other: Pmf
returns: new Pmf
"""
pmf = Pmf()
for key1, prob1 in self.items():
for key2, prob2 in other.items():
pmf[key1 + key2] += prob1 * prob2
return pmf
def __hash__(self):
"""Returns an integer hash value."""
return id(self)
def __eq__(self, other):
return self is other
def render(self):
"""Returns values and their probabilities, suitable for plotting."""
return zip(*sorted(self.items()))
```

##
Using the Pmf object

As an example, we can make a Pmf object that represents a 6-sided die.

```
d6 = Pmf([1,2,3,4,5,6])
d6.normalize()
d6.name = 'one die'
print(d6)
```

`Pmf({1: 0.16666666666666666, 2: 0.16666666666666666, 3: 0.16666666666666666, 4: 0.16666666666666666, 5: 0.16666666666666666, 6: 0.16666666666666666})`

##
Add operator

Using the add operator, we can compute the distribution for the sum of two dice.

```
d6_twice = d6 + d6
d6_twice.name = 'two dice'
for key, prob in d6_twice.items():
print(key, prob)
```

```
2 0.027777777777777776
3 0.05555555555555555
4 0.08333333333333333
5 0.1111111111111111
6 0.1388888888888889
7 0.16666666666666669
8 0.1388888888888889
9 0.1111111111111111
10 0.08333333333333333
11 0.05555555555555555
12 0.027777777777777776
```

##
Computing the distribution

Using numpy.sum, we can compute the distribution for the sum of three dice. And then plot the results (using Pmf.render)

```
pmf_ident = Pmf([0])
d6_thrice = sum([d6]*3, pmf_ident)
d6_thrice.name = 'three dice'
for die in [d6, d6_twice, d6_thrice]:
xs, ys = die.render()
plt.plot(xs, ys, label=die.name, linewidth=3, alpha=0.5)
plt.xlabel('Total')
plt.ylabel('Probability')
plt.legend()
plt.show()
```

##
Bayesian statistics

A Suite is a Pmf that represents a set of hypotheses and their probabilities; it provides `bayesian_update`

, which updates the probability of the hypotheses based on new data. Suite is an abstract parent class; child classes should provide a likelihood method that evaluates the likelihood of the data under a given hypothesis. `bayesian_update`

loops through the hypothesis, evaluates the likelihood of the data under each hypothesis, and updates the probabilities accordingly. Then it re-normalizes the PMF.

```
class Suite(Pmf):
"""Map from hypothesis to probability."""
def bayesian_update(self, data):
"""Performs a Bayesian update.
Note: called bayesian_update to avoid overriding dict.update
data: result of a die roll
"""
for hypo in self:
like = self.likelihood(data, hypo)
self[hypo] *= like
self.normalize()
```

##
Suite example

As an example, I’ll use Suite to solve the “Dice Problem,” from Chapter 3 of *Think Bayes*:

“Suppose I have a box of dice that contains a 4-sided die, a 6-sided die, an 8-sided die, a 12-sided die, and a 20-sided die. If you have ever played Dungeons & Dragons, you know what I am talking about. Suppose I select a die from the box at random, roll it, and get a 6. What is the probability that I rolled each die?”

I’ll start by making a list of Pmfs to represent the dice:

```
def make_die(num_sides):
die = Pmf(range(1, num_sides+1))
die.name = 'd%d' % num_sides
die.normalize()
return die
dice = [make_die(x) for x in [4, 6, 8, 12, 20]]
print(dice)
```

##
DiceSuite

Next I’ll define DiceSuite, which inherits `bayesian_update`

from Suite and provides `likelihood`

. `data`

is the observed die roll, 6 in the example. `hypo`

is the hypothetical die I might have rolled; to get the likelihood of the data, I select, from the given die, the probability of the given value.

```
class DiceSuite(Suite):
def likelihood(self, data, hypo):
"""Computes the likelihood of the data under the hypothesis.
data: result of a die roll
hypo: Die object
"""
return hypo[data]
```

##
Updating the distribution

Finally, I use the list of dice to instantiate a Suite that maps from each die to its prior probability. By default, all dice have the same prior. Then I update the distribution with the given value and print the results:

```
dice_suite = DiceSuite(dice)
dice_suite.bayesian_update(6)
for die, prob in dice_suite.items():
print(die.name)
print(prob)
```

##
Another Update

As expected, the 4-sided die has been eliminated; it now has 0 probability. The 6-sided die is the most likely, but the 8-sided die is still quite possible. Now suppose I roll the die again and get an 8. We can update the Suite again with the new data. Now the 6-sided die has been eliminated, the 8-sided die is most likely, and there is less than a 10% chance that I am rolling a 20-sided die. These examples demonstrate the versatility of the Counter class, one of Python’s underused data structures.

```
dice_suite.bayesian_update(8)
for die, prob in dice_suite.items():
print(die.name)
print(prob)
```

##
Next Steps

For more on Python’s Counter class, you can check out our interactive tutorial

.