Lexically Grounded Subword Segmentation: Experimental Code

This repository accompanies the paper "Lexically Grounded Subword Segmentation" by Jindřich Libovický and Jindřich Helcl. If you find yourself inspired by this, please cite the following paper:

@inproceedings{libovicky-helcl-2024-lexically,
    title = "Lexically Grounded Subword Segmentation",
    author = "Libovick{\'y}, Jind{\v{r}}ich and Helcl, Jind{\v{r}}ich",
    editor = "Al-Onaizan, Yaser  and Bansal, Mohit  and Chen, Yun-Nung",
    booktitle = "Proceedings of the 2024 Conference on Empirical Methods in Natural Language Processing",
    month = nov,
    year = "2024",
    address = "Miami, Florida, USA",
    publisher = "Association for Computational Linguistics",
    url = "https://aclanthology.org/2024.emnlp-main.421/",
    doi = "10.18653/v1/2024.emnlp-main.421",
    pages = "7403--7420",
}

Steps to reproduce

Here follow the instructions for the replication of the paper results.

First off, clone the repository and submodules:

git clone https://github.com/ufal/legros-paper
cd legros-paper
git submodule update --init --recursive

If you are going to use your own SentencePiece, you can skip the following step. Otherwise, build SentencePiece as follows. (Note that you should first install any SentencePiece prerequisites such as cmake and a C++ compiler.

cd 3rd_party/sentencepiece
mkdir build
cd build
cmake ..
make -j $(nproc)

Prerequisites

For all experiments, we use Python version 3.10.7. If you are using a virtual environment, consider running pip install -U setuptools before installing the prerequisites.

In order to do everything like us, make sure you have the following tools installed:

• SentencePiece - if you don't want to use your own SentencePiece (which means editing multiple files with the right location), go to 3rd_party/sentencepiece and build the tool inside the build subfolder. The spm_* executables will be located in 3rd_party/sentencepiece/build/src in the end.

• Snakemake (installed via pip)

• Pigz - can be replaced with gzip/gunzip in the Snakefiles.