This page presents document translation regression experiments for the TREC 2022 NeuCLIR Track, Persian, with the following configuration:
- Queries: English
- Documents: Machine-translated documents from Persian into English (corpus provided by the organizers)
- Model: SPLADE CoCondenser SelfDistil
The exact configurations for these regressions are stored in this YAML file. Note that this page is automatically generated from this template as part of Anserini's regression pipeline, so do not modify this page directly; modify the template instead.
We make available a version of the corpus that has already been encoded with SPLADE CoCondenser SelfDistil, i.e., we performed model inference on every document and stored the output sparse vectors. Thus, no neural inference is required to reproduce these experiments; see instructions below.
From one of our Waterloo servers (e.g., orca
), the following command will perform the complete regression, end to end:
python src/main/python/run_regression.py --index --verify --search --regression neuclir22-fa-dt-splade
Download the corpus and unpack into collections/
:
wget https://rgw.cs.uwaterloo.ca/pyserini/data/neuclir22-fa-en-splade.tar -P collections/
tar xvf collections/neuclir22-fa-en-splade.tar -C collections/
To confirm, neuclir22-fa-en-splade.tar
is 2.8 GB and has MD5 checksum 186d4b7025c4915cf9a33371c4ef37c5
.
With the corpus downloaded, the following command will perform the remaining steps below:
python src/main/python/run_regression.py --index --verify --search --regression neuclir22-fa-dt-splade \
--corpus-path collections/neuclir22-fa-en-splade
Typical indexing command:
target/appassembler/bin/IndexCollection \
-collection JsonVectorCollection \
-input /path/to/neuclir22-fa-en-splade \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-generator DefaultLuceneDocumentGenerator \
-threads 8 -impact -pretokenized -storeRaw \
>& logs/log.neuclir22-fa-en-splade &
For additional details, see explanation of common indexing options.
After indexing has completed, you should be able to perform retrieval as follows:
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-title.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-title.txt \
-impact -pretokenized &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-desc.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc.txt \
-impact -pretokenized &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-desc_title.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc_title.txt \
-impact -pretokenized &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-title.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-title.txt \
-impact -pretokenized -rm3 -collection JsonVectorCollection &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-desc.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc.txt \
-impact -pretokenized -rm3 -collection JsonVectorCollection &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-desc_title.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc_title.txt \
-impact -pretokenized -rm3 -collection JsonVectorCollection &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-title.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-title.txt \
-impact -pretokenized -rocchio -collection JsonVectorCollection &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-desc.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc.txt \
-impact -pretokenized -rocchio -collection JsonVectorCollection &
target/appassembler/bin/SearchCollection \
-index indexes/lucene-index.neuclir22-fa-en-splade \
-topics tools/topics-and-qrels/topics.neuclir22-en.splade.original-desc_title.txt.gz \
-topicreader TsvInt \
-output runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc_title.txt \
-impact -pretokenized -rocchio -collection JsonVectorCollection &
Evaluation can be performed using trec_eval
:
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-title.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc_title.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-title.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc_title.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rm3.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-title.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m ndcg_cut.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc_title.txt
python -m pyserini.eval.trec_eval -c -m judged.20 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m recall.1000 tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc_title.txt
tools/eval/trec_eval.9.0.4/trec_eval -c -m map tools/topics-and-qrels/qrels.neuclir22-fa.txt runs/run.neuclir22-fa-en-splade.splade+rocchio.topics.neuclir22-en.splade.original-desc_title.txt
With the above commands, you should be able to reproduce the following results:
Reproduction Log*
To add to this reproduction log, modify this template and run bin/build.sh
to rebuild the documentation.