# Minimizers

### Minimizers

One way to partition the space of all possible \$k\$-mers is by minimal \$l\$-mer, where \$l < k\$. For example, the minimal 2-mer in the string `ABC` is `AB` and the minimal 4-mer in the string `abracadabra` is `abra`. In this context, the minimal \$l\$-mer is called a minimizer, and we'll call such a partitioning scheme a \$k, l\$-minimizing scheme.

``````

In :

def string_to_kmers(s, length):
return [s[i:i+length] for i in range(len(s)-length+1)]

def minimizer(k, l):
""" Given k-mer, return its minimal l-mer """
assert l <= len(k)
return min(string_to_kmers(k, l))

``````
``````

In :

minimizer('ABC', 2)

``````
``````

Out:

'AB'

``````
``````

In :

``````
``````

Out:

'abra'

``````

But if our goal is to partition the space of \$k\$-mers, couldn't we use a hash function instead? Say \$k\$ is 10 and \$l\$ is 4. A 10,4-minimizing scheme is a way for dividing the space of \$4^{10}\$ 10-mers (a million or so) into \$4^4 = 256\$ partitions. We can accomplish this with a hash function that maps \$k\$-mers to integers in \$[0, 255]\$. Why would we prefer minimizers over hash functions?

The answer is that two strings that share long substrings tend to have the same minimizer, but not the same hash value. For example, the strings `abracadabr` and `bracadabra` have the substring `bracadabr` in common, and they have the same minimal 4-mer:

``````

In :

``````
``````

Out:

('abra', 'abra')

``````

But their hash values (modulo 256) are not the same:

``````

In :

# you might need to 'pip install mmh3' first
import mmh3

``````
``````

Out:

(26, 224)

``````

#### Partition size distribution

A feature of hash functions is that they divide the 10-mers quite uniformly (evenly) among the 256 buckets. 10,4-minimzers divide them much less uniformly. This becomes clear when you consider that, given a random 10-mer, the 4-mer `TTTT` is very unlikely to be its minimizer, whereas the 4-mer `AAAA` is much more likely.

We can also show this empirically by partitioning a collection of random 10-mers:

``````

In :

import random
random.seed(629)

def random_kmer(k):
return ''.join([random.choice('ACGT') for _ in range(k)])

``````
``````

In :

%matplotlib inline
import matplotlib.pyplot as plt

def plot_counts(counter, title=None):
idx = range(256)
cnts = list(map(lambda x: counter.get(x, 0), idx))
plt.bar(idx, cnts, ec='none')
plt.xlim(0, 256)
plt.ylim(0, 35)
if title is not None:
plt.title(title)
plt.show()

``````
``````

In :

from collections import Counter
# hash 1000 random 10-mers
cnt = Counter([mmh3.hash(s) % 256 for s in [random_kmer(10) for _ in range(1000)]])
plot_counts(cnt, 'Frequency of partitions using hash mod 256')

``````
``````

``````
``````

In :

def lmer_to_int(mer):
""" Maps AAAA to 0, AAAC to 1, etc.  Works for any length argument. """
cum = 0
charmap = {'A':0, 'C':1, 'G':2, 'T':3}
for c in mer:
cum *= 4
cum += charmap[c]
return cum

``````
``````

In :

# get minimal 4-mers from 1000 random 10-mers
cnt = Counter([lmer_to_int(minimizer(s, 4)) for s in [random_kmer(10) for _ in range(1000)]])
plot_counts(cnt, 'Frequency of partitions using minimal 4-mer; AAAA at left, TTTT at right')

``````
``````

``````