mmh3 is a Python wrapper for MurmurHash (MurmurHash3), a set of fast and robust non-cryptographic hash functions invented by Austin Appleby.
Combined with probabilistic techniques like a Bloom filter, MinHash, and feature hashing, mmh3 allows you to develop high-performance systems in fields such as data mining, machine learning, and natural language processing.
pip install mmh3 # for macOS, use "pip3 install mmh3" and python3
>> import mmh3 >> mmh3.hash("foo") # returns a 32-bit signed int -156908512 >> mmh3.hash("foo", 42) # uses 42 as a seed -1322301282 >> mmh3.hash("foo", signed=False) # returns a 32-bit unsigned int 4138058784
>> mmh3.hash64("foo") # two 64 bit signed ints (by using the 128-bit algorithm as its backend) (-2129773440516405919, 9128664383759220103) >> mmh3.hash64("foo", signed=False) # two 64 bit unsigned ints (16316970633193145697, 9128664383759220103) >> mmh3.hash128("foo", 42) # 128 bit unsigned int 215966891540331383248189432718888555506 >> mmh3.hash128("foo", 42, signed=True) # 128 bit signed int -124315475380607080215185174712879655950 >> mmh3.hash_bytes("foo") # 128 bit value as bytes 'aE\xf5\x01W\x86q\xe2\x87}\xba+\xe4\x87\xaf~' >> import numpy as np >> a = np.zeros(2 ** 32, dtype=np.int8) >> mmh3.hash_bytes(a) b'V\x8f}\xad\x8eNM\xa84\x07FU\x9c\xc4\xcc\x8e'
hash64 returns two values, because it uses the 128-bit version of MurmurHash3 as its backend.
hash_from_buffer hashes byte-likes without memory copying. The method is suitable when you hash a large memory-view such as
>> mmh3.hash_from_buffer(numpy.random.rand(100)) -2137204694 >> mmh3.hash_from_buffer(numpy.random.rand(100), signed=False) 3812874078
hash_bytes have the third argument for architecture optimization. Use True for x64 and False for x86 (default: True):
>> mmh3.hash64("foo", 42, True) (-840311307571801102, -6739155424061121879)
hash_bytes. Thanks doozr!
hash_from_buffer. Thanks Dimitri Vorona!
hash128, which returns a 128-bit signed integer.
The first two commits are from Derek Wilson. Thanks!
__version__constant. Check if it exists when the following revision matters for your application.
Beware that due to this revision, the result of 32-bit version of 2.1 is NOT the same as that of 2.0. E.g.,:
>> mmh3.hash("foo") # in mmh3 2.0 -292180858 >> mmh3.hash("foo") # in mmh3 2.1 -156908512
The results of hash64 and hash_bytes remain unchanged. Austin Appleby, the author of Murmurhash, ensured this revision was the final modification to MurmurHash3's results and any future changes would be to improve performance only.
By default, mmh3 returns signed values for 32-bit and 64-bit versions and unsigned values for
hash128, due to historical reasons. Please use the keyword argument
signed to obtain a desired result.
For compatibility with Google Guava (Java), see https://stackoverflow.com/questions/29932956/murmur3-hash-different-result-between-python-and-java-implementation
Version 2.4 changed the type of seeds from signed 32-bit int to unsigned 32-bit int. The resulting values with signed seeds still remain the same as before, as long as they are 32-bit.
>> mmh3.hash("aaaa", -1756908916) # signed representation for 0x9747b28c 1519878282 >> mmh3.hash("aaaa", 2538058380) # unsigned representation for 0x9747b28c 1519878282
Be careful so that these seeds do not exceed 32-bit. Unexpected results may happen with invalid values.
>> mmh3.hash("foo", 2 ** 33) -156908512 >> mmh3.hash("foo", 2 ** 34) -156908512
MurmurHash3 was originally developed by Austin Appleby and distributed under public domain.
Ported and modified for Python by Hajime Senuma.
The following textbooks and tutorials are great sources to learn how to use mmh3 (and other hash algorithms in general) for high-performance computing.