Class/Object

com.twitter.algebird

MinHasher

Related Docs: object MinHasher | package algebird

Permalink

abstract class MinHasher[H] extends Monoid[MinHashSignature]

Instances of MinHasher can create, combine, and compare fixed-sized signatures of arbitrarily sized sets.

A signature is represented by a byte array of approx maxBytes size. You can initialize a signature with a single element, usually a Long or String. You can combine any two set's signatures to produce the signature of their union. You can compare any two set's signatures to estimate their Jaccard similarity. You can use a set's signature to estimate the number of distinct values in the set. You can also use a combination of the above to estimate the size of the intersection of two sets from their signatures. The more bytes in the signature, the more accurate all of the above will be.

You can also use these signatures to quickly find similar sets without doing n^2 comparisons. Each signature is assigned to several buckets; sets whose signatures end up in the same bucket are likely to be similar. The targetThreshold controls the desired level of similarity - the higher the threshold, the more efficiently you can find all the similar sets.

This abstract superclass is generic with regards to the size of the hash used. Depending on the number of unique values in the domain of the sets, you may want a MinHasher16, a MinHasher32, or a new custom subclass.

This implementation is modeled after Chapter 3 of Ullman and Rajaraman's Mining of Massive Datasets: http://infolab.stanford.edu/~ullman/mmds/ch3a.pdf

Source
MinHasher.scala
Linear Supertypes
Monoid[MinHashSignature], Semigroup[MinHashSignature], Serializable, AnyRef, Any
Known Subclasses
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. MinHasher
  2. Monoid
  3. Semigroup
  4. Serializable
  5. AnyRef
  6. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new MinHasher(numHashes: Int, numBands: Int)(implicit n: Numeric[H])

    Permalink

Abstract Value Members

  1. abstract def buildArray(left: Array[Byte], right: Array[Byte])(fn: (H, H) ⇒ H): Array[Byte]

    Permalink

    Decode two signatures into hash values, combine them somehow, and produce a new array

    Decode two signatures into hash values, combine them somehow, and produce a new array

    Attributes
    protected
  2. abstract def buildArray(fn: ⇒ H): Array[Byte]

    Permalink

    Initialize a byte array by generating hash values

    Initialize a byte array by generating hash values

    Attributes
    protected
  3. abstract def hashSize: Int

    Permalink

    The number of bytes used for each hash in the signature

  4. abstract def maxHash: H

    Permalink

    Maximum value the hash can take on (not 2*hashSize because of signed types)

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  5. def assertNotZero(v: MinHashSignature): Unit

    Permalink
    Definition Classes
    Monoid
  6. def buckets(sig: MinHashSignature): List[Long]

    Permalink

    Bucket keys to use for quickly finding other similar items via locality sensitive hashing

  7. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  8. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  9. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  10. val estimatedThreshold: Double

    Permalink

    Useful for understanding the effects of numBands and numRows

  11. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  12. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  13. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  14. def init(fn: (MurmurHash128) ⇒ (Long, Long)): MinHashSignature

    Permalink

    Create a signature for an arbitrary value

  15. def init(value: String): MinHashSignature

    Permalink

    Create a signature for a single String value

  16. def init(value: Long): MinHashSignature

    Permalink

    Create a signature for a single Long value

  17. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  18. def isNonZero(v: MinHashSignature): Boolean

    Permalink
    Definition Classes
    Monoid
  19. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  20. def nonZeroOption(v: MinHashSignature): Option[MinHashSignature]

    Permalink
    Definition Classes
    Monoid
  21. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  22. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  23. val numBands: Int

    Permalink
  24. val numBytes: Int

    Permalink

    For explanation of the "bands" and "rows" see Ullman and Rajaraman

  25. val numHashes: Int

    Permalink
  26. val numRows: Int

    Permalink
  27. def plus(left: MinHashSignature, right: MinHashSignature): MinHashSignature

    Permalink

    Set union

    Set union

    returns

    result of combining l and r

    Definition Classes
    MinHasherSemigroup
  28. def probabilityOfInclusion(sim: Double): Double

    Permalink

    Useful for understanding the effects of numBands and numRows

  29. def similarity(left: MinHashSignature, right: MinHashSignature): Double

    Permalink

    Esimate Jaccard similarity (size of union / size of intersection)

  30. def sum(vs: TraversableOnce[MinHashSignature]): MinHashSignature

    Permalink
    Definition Classes
    Monoid
  31. def sumOption(iter: TraversableOnce[MinHashSignature]): Option[MinHashSignature]

    Permalink

    Returns an instance of T calculated by summing all instances in iter in one pass.

    Returns an instance of T calculated by summing all instances in iter in one pass. Returns None if iter is empty, else Some[T].

    iter

    instances of T to be combined

    returns

    None if iter is empty, else an option value containing the summed T

    Definition Classes
    Semigroup
    Note

    Override if there is a faster way to compute this sum than iter.reduceLeftOption using plus.

  32. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  33. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  34. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  35. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  36. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  37. val zero: MinHashSignature

    Permalink

    Signature for empty set, needed to be a proper Monoid

    Signature for empty set, needed to be a proper Monoid

    Definition Classes
    MinHasherMonoid

Inherited from Monoid[MinHashSignature]

Inherited from Semigroup[MinHashSignature]

Inherited from Serializable

Inherited from AnyRef

Inherited from Any

Ungrouped