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.8.0.tar.gz (459.8 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.8.0-py3-none-any.whl (33.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fastabx-0.8.0.tar.gz
  • Upload date:
  • Size: 459.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","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.8.0.tar.gz
Algorithm Hash digest
SHA256 ab771f197ff9f238cf702645d6bcae8445ba8fb4743d91573ef42974d5c2a31f
MD5 bd67ea8944001d6d0875b3e143ae6fba
BLAKE2b-256 42658c3432bb4cc4e3cc6907685592a6f03f06f57a26dfe1b44b8d22fe237655

See more details on using hashes here.

File details

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

File metadata

  • Download URL: fastabx-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 33.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","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.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8aeaa6c844528170aea2d3e9be20ea8048b950776d8411ea9447cd42e864106a
MD5 52852a8232a9c287d3d7aa93e55ca667
BLAKE2b-256 9308748ddb853b71a99065396861066d11745ecf9ef083d16f24fb528a8108d9

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