Functions to compute probabilistic relevance scores from PHOC embeddings

# prob-phoc PyTorch functions to compute meaningful probabilistic relevance scores from PHOC (Pyramid of Histograms of Characters) embeddings. Although they are called Pyramid of Histograms of Characters, in practice they are a Pyramid of Bag of Characters. At the end, each word is represented by a high-dimensional binary vector.

See the wiki for additional details.

## Usage

The library provides two functions: cphoc and pphoc, which are similar to SciPy's cdist and pdist:

Both functions can operate with PHOC embeddings in the probability space (where each dimension is a real number in the range [0, 1]), or in the log-probability space (where each dimension is the logarithm of a probability). These are also sometimes refered to as the Real and Log semirings.

import torch
from prob_phoc import cphoc, pphoc

x = torch.Tensor(...)
y = torch.Tensor(...)

# Compute the log-relevance scores between all pairs of rows in x, y.
# Note: x and y must have the PHOC log-probabilities.
logprob = cphoc(x, y)

# This is equivalent to:
logprob = cphoc(x, y, method="sum_prod_log")

# If your matrices have probabilities instead of log-probabilities, use:
prob = cphoc(x, y, method="sum_prob_real")

# Compute the log-relevance scores between all pairs of distinct rows in x.
# Note: The output is a vector with N * (N - 1) / 2 elements.
logprob = pphoc(x)


## Installation

The easiest way is to install the package from PyPI:

pip install prob-phoc


If you want to install the latest version from the repository, clone it and use the setup.py script to compile and install the library.

python setup.py install


You will need a C++11 compiler (tested with GCC 4.9). If you want to compile with CUDA support, you will also need to install the CUDA Toolkit (tested with versions 8.0, 9.0 and 10.0)

## Tests and benchmarks

After the installation, you can run the tests to ensure that everything is working fine.

python -m prob_phoc.test


I have also some benchmarks to compare CPU vs. CUDA, for different matrix sizes and float precision. These take quite a long to run, so don't hold your breath.

python -m prob_phoc.benchmark


## Release history Release notifications | RSS feed

This version 0.2.0

### Source Distribution

prob_phoc-0.2.0.tar.gz (10.2 kB view hashes)

Uploaded source

### Built Distributions

prob_phoc-0.2.0-cp37-cp37m-manylinux1_x86_64.whl (1.3 MB view hashes)

Uploaded cp37

prob_phoc-0.2.0-cp36-cp36m-manylinux1_x86_64.whl (1.3 MB view hashes)

Uploaded cp36

prob_phoc-0.2.0-cp35-cp35m-manylinux1_x86_64.whl (1.3 MB view hashes)

Uploaded cp35

prob_phoc-0.2.0-cp27-cp27mu-manylinux1_x86_64.whl (1.3 MB view hashes)

Uploaded cp27