SignWriting Evaluation
The lack of automatic SignWriting evaluation metrics is a major obstacle in the development of SignWriting transcription and translation1 models.
Goals
The primary objective of this repository is to house a suite of automatic evaluation metrics specifically tailored for SignWriting. This includes standard metrics like BLEU2, chrF3, and CLIPScore4, as well as custom-developed metrics unique to our approach. We recognize the distinct challenges in evaluating single signs versus continuous signing, and our methods reflect this differentiation.
To qualitatively demonstrate the efficacy of these evaluation metrics, we implement a nearest-neighbor search for selected signs from the SignBank corpus. The rationale is straightforward: the closer the sign is to its nearest neighbor in the corpus, the more effective the evaluation metric is in capturing the nuances of sign language transcription and translation.
Evaluation Metrics
- Tokenized BLEU - BLEU score for tokenized SignWriting FSW strings.
- chrF - chrF score for untokenized SignWriting FSW strings.
- CLIPScore - CLIPScore between SignWriting images. (Using the original CLIP model)
- Similarity - symbol distance score for SignWriting FSW strings.
- Similarity v2 - the improved, name-aware symbol distance (README).
Qualitative Evaluation
Distribution of Scores
Using a sample of the corpus, we compute the any-to-any scores for each metric. Intuitively, we expect a good metric given any two random signs to produce a bad score, since most signs are unrelated. This should be reflected in the distribution of scores, which should be skewed towards lower scores.
Nearest Neighbor Search
It is well-known that the SignBank corpus contains many forms of the sign for "hello". We carefully select some of these signs to evaluate our metrics, by looking for their closest matches in the corpus, which contains around 230k single signs.
The problems of each metric are revealed when comparing the top 10 nearest neighbors for each sign. For each sign and metric, either the first match is incorrect, or there is a more correct match further down the list. The table compares the name-aware Similarity v2, the original Similarity, Tokenized BLEU, and chrF; CLIPScore is omitted here, as encoding ~230k SignWriting images per query is prohibitively slow.
| SymbolsDistancesV2 | SymbolsDistances | TokenizedBLEU | CHRF | SymbolsDistancesV2 | SymbolsDistances | TokenizedBLEU | CHRF | SymbolsDistancesV2 | SymbolsDistances | TokenizedBLEU | CHRF | |
| 1 | ||||||||||||
| 2 | ||||||||||||
| 3 | ||||||||||||
| 4 | ||||||||||||
| 5 | ||||||||||||
| 6 | ||||||||||||
| 7 | ||||||||||||
| 8 | ||||||||||||
| 9 | ||||||||||||
| 10 | ||||||||||||
Cite
If you use our toolkit in your research or projects, please consider citing the work.
@misc{signwriting-evaluation2024,
title={SignWriting Evaluation: Metrics for Evaluating SignWriting Transcription and Translation Models},
author={Moryossef, Amit and Zilberman, Rotem and Langer, Ohad},
howpublished={\url{https://github.com/sign-language-processing/signwriting-evaluation}},
year={2024}
}
References
-
Amit Moryossef, Zifan Jiang. 2023. SignBank+: Preparing a Multilingual Sign Language Dataset for Machine Translation Using Large Language Models. ↩
-
Kishore Papineni, Salim Roukos, Todd Ward, and Wei-Jing Zhu. 2002. Bleu: a Method for Automatic Evaluation of Machine Translation. In Proceedings of the 40th Annual Meeting of the Association for Computational Linguistics, pages 311–318, Philadelphia, Pennsylvania, USA. Association for Computational Linguistics. ↩
-
Maja Popović. 2015. chrF: character n-gram F-score for automatic MT evaluation. In Proceedings of the Tenth Workshop on Statistical Machine Translation, pages 392–395, Lisbon, Portugal. Association for Computational Linguistics. ↩
-
Jack Hessel, Ari Holtzman, Maxwell Forbes, Ronan Le Bras, and Yejin Choi. 2021. CLIPScore: A Reference-free Evaluation Metric for Image Captioning. In Proceedings of the 2021 Conference on Empirical Methods in Natural Language Processing, pages 7514–7528, Online and Punta Cana, Dominican Republic. Association for Computational Linguistics. ↩
Metadata
Release files for signwriting-evaluation 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| signwriting_evaluation-0.1.0.tar.gz | 274.9 kB | With provenance | Details for signwriting_evaluation-0.1.0.tar.gz |
Built distributions (wheels)
Total release size: 3.0 MB
Release files / signwriting_evaluation-0.1.0.tar.gz
| Download URL | signwriting_evaluation-0.1.0.tar.gz |
|---|---|
| Size | 274.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4bf7d75c6b1c1320cbf5a7b3f2c2e5a4bb954e723baad31b5b47cf57789e59fc
|
|
BLAKE2b-256 checksum How to use checksums |
d510a396407c0c8a5d60c9e10017b712aa9f713226408b33111f4de65a4bcd5b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.
Transparency logRelease files / signwriting_evaluation-0.1.0-cp39-abi3-win_amd64.whl
| Download URL | signwriting_evaluation-0.1.0-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 461.1 kB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
f6a64056c5503e660ce5c0859ee027496bbd2549deca8910484ad17919440570
|
|
BLAKE2b-256 checksum How to use checksums |
a705b102023dea80b25649b63f7a3e127cb9becd5ca9bee7a265087f796ed229
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.
Transparency logRelease files / signwriting_evaluation-0.1.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | signwriting_evaluation-0.1.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 593.2 kB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
f3bf1e11e2a6d061431c8ec90acb1ef2f78b517c66f03bc846caf63c29619b93
|
|
BLAKE2b-256 checksum How to use checksums |
6cbb41c061bf97880507aa9666adba253dc2fc4393d6e38a91b62388fe4f5898
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.
Transparency logRelease files / signwriting_evaluation-0.1.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | signwriting_evaluation-0.1.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 582.9 kB |
| Tags | CPython 3.9 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
dd068fe5b10a14aec2d456f18b88f2eff7be6d4036964a71ded3fce6d3236ce1
|
|
BLAKE2b-256 checksum How to use checksums |
cb7aa7a8f3ee758ba889ff443e3507c5213e3fba512fabe7c5ac294dc61c3258
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.
Transparency logRelease files / signwriting_evaluation-0.1.0-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
| Download URL | signwriting_evaluation-0.1.0-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl |
|---|---|
| Size | 1.0 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ universal2 (ARM64, x86-64) macOS 10.12+ x86-64 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
78e83eb0737bca4d3ad32e710250bbeea208f88755803b2e5cc3fd7058535d81
|
|
BLAKE2b-256 checksum How to use checksums |
bb9c07b0a365df58a1027ca39c9e5c2423cff8bc14d6f3fb1f4417ddb8b079ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.
Transparency logSecurity for signwriting-evaluation 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 5 files in this release have been uploaded with provenance metadata.
Attestation for signwriting_evaluation-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 18, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.