Skip to main content

Package for evaluating text tokenizations.

Project description

tokenization-scorer PyPI Version

Simple package for evaluating text tokenizations. The input is a text (list of files or stdin) and output a single number. The higher the number, the better the tokenization. The intended workflow is to try multiple tokenizations and select the one with the highest number.

It can be used from the command line:

pip3 install tokenization-scorer

tokenization-scorer -i en-de.tokenized_with_unigramlm.{en,de}
> 0.4826

tokenization-scorer -i en-de.tokenized_with_wordpiece.{en,de}
> 0.5047

or within Python:

import tokenization_scorer
text1 = "pick @@ed pick @@l @@ed pick @@les"
tokenization_scorer.score(text1, metric="renyi", power=2.5)
> 0.8031528501359657

text2 = "pick @@e @@d pick @@l @@e @@d pick @@l @@e @@s"
tokenization_scorer.score(text2, metric="renyi", power=2.5)
> 0.9105681923824472

Use tokenization-scorer -h to get an overview of supported metrics. This package is a side-product of the paper Tokenization and the Noiseless Channel.

@inproceedings{tokenization_noiseless, 
    title={Tokenization and the Noiseless Channel},
    author={Zouhar, Vilém and Meister, Clara and Gastaldi, Juan Luis and Sachan, Mrinmaya and Cotterell, Ryan},
    booktitle={Proceedings of the 61st Annual Meeting of the Association for Computational Linguistics},
    year={2023},
    url={https://aclanthology.org/2023.acl-long.284/},
}

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

tokenization_scorer-1.1.3.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

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

tokenization_scorer-1.1.3-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file tokenization_scorer-1.1.3.tar.gz.

File metadata

  • Download URL: tokenization_scorer-1.1.3.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.4

File hashes

Hashes for tokenization_scorer-1.1.3.tar.gz
Algorithm Hash digest
SHA256 ff47da5648c498a8859e865cbe54d7eca8048c964bef98cb1ead1ec77de8a8af
MD5 99099dc9524e5d7b1dd38163408f5763
BLAKE2b-256 3bdcb773ecb504b8f60e5051887e72e43f0791d6572cac12694dec95ad78a88e

See more details on using hashes here.

File details

Details for the file tokenization_scorer-1.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for tokenization_scorer-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 bd77e8e50cb86d413d09f13c7cb6eb5f5c3f6c4ff38e834d87d5cc68b43cd45c
MD5 4090bf98224461383d834ba8f9a5ae03
BLAKE2b-256 52e326a2613206dbada7d4ac37e51396a885a7bb050be71c6366769011699b0c

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