Skip to main content

A library for efficient computation of ABX discriminability

Project description

Fast ABX evaluation

fastabx is a Python package for efficient computation of ABX discriminability.

The ABX discriminability measures how well categories of interest are separated in the representation space by determining whether tokens from the same category are closer to each other than to those from a different category. While ABX has been mostly used to evaluate speech representations, it is a generic framework that can be applied to other domains of representation learning.

This package provides a simple interface that can be adapted to any ABX conditions, and to any input modality.

Check out the documentation for more information: https://docs.cognitive-ml.fr/fastabx

Install

Install the pre-built package in your environment:

pip install fastabx

It requires Python 3.12 or later, and depends on PyTorch 2.10.0 or later, NumPy, Polars, tqdm, and torchdtw.

Citation

A preprint is available on arXiv: https://arxiv.org/abs/2505.02692
If you use fastabx in your work, please cite it:

@misc{fastabx,
  title={fastabx: A library for efficient computation of ABX discriminability},
  author={Maxime Poli and Emmanuel Chemla and Emmanuel Dupoux},
  year={2025},
  eprint={2505.02692},
  archivePrefix={arXiv},
  primaryClass={cs.CL},
  url={https://arxiv.org/abs/2505.02692},
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastabx-0.7.2.tar.gz (411.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fastabx-0.7.2-py3-none-any.whl (25.0 kB view details)

Uploaded Python 3

File details

Details for the file fastabx-0.7.2.tar.gz.

File metadata

  • Download URL: fastabx-0.7.2.tar.gz
  • Upload date:
  • Size: 411.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fastabx-0.7.2.tar.gz
Algorithm Hash digest
SHA256 dd845752b378b10dd5535fcbbf01238bba50ad07de7c9cfdfea75f5e43616226
MD5 090ed639e2e06019ce09cfc2528ed86c
BLAKE2b-256 cca703733a4546c53dea84969ce74876c68b0fde501c6835d71a9ac3ca714f1b

See more details on using hashes here.

File details

Details for the file fastabx-0.7.2-py3-none-any.whl.

File metadata

  • Download URL: fastabx-0.7.2-py3-none-any.whl
  • Upload date:
  • Size: 25.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fastabx-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e26f57bbb035d108b81c0a2fb4cb971ebaafc186196e410e9c5fe794d919f6d0
MD5 80877f0c016820bdfa79eab8dfeb7ff1
BLAKE2b-256 a9db11a9ba086a95fa58f16053dff3e052614ccf1b1742a2e89cfafefc6ab1fc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page