This is the runbook for TREC 2018 submissions by the "Anserini" group. Note that Anserini (the system) was used by another group ("h2oloo") for a completely different set of runs.
In total, the Anserini group participated in three tracks:
- Common Core Track
- News Track
- CENTRE Track
Note that this document is specifically a runbook and does not encode regression experiments. Runbooks are designed to help us (i.e., TREC participants) document the steps taken to generate a run. They are primarily designed to make experiments repeatable (i.e., by ourselves), although they might be helpful for others who wish to reproduce our runs.
However, we concede that repeatability of the runs (even by us) is challenging, since the codebase is always evolving, and by the time we add proper documentation, it might be several months later. See details below... but we try our best...
Building the index:
nohup target/appassembler/bin/IndexCollection \
-collection WashingtonPostCollection \
-input WashingtonPost.v2/data/ -generator WapoGenerator \
-index lucene-index.core18.pos+docvectors+rawdocs \
-threads 36 -storePositions -storeDocvectors -storeRawDocs &> \
log.core18.pos+docvectors+rawdocs &
Topics and qrels are stored in tools/topics-and-qrels/.
Commands to reproduce submitted runs:
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -bm25 -hits 10000 -runtag anserini_bm25 -output core18.anserini_bm25.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -bm25 -hits 10000 -runtag anserini_sdm -sdm -output core18.anserini_sdm.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -bm25 -hits 10000 -runtag anserini_rm3 -rm3 -output core18.anserini_rm3.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -bm25 -hits 10000 -runtag anserini_ax -axiom -axiom.deterministic -rerankCutoff 20 -output core18.anserini_ax.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -bm25 -hits 10000 -runtag anserini_ax17 -axiom -axiom.deterministic -rerankCutoff 0 -axiom.index lucene-index.core17.pos+docvectors+rawdocs -output core18.anserini_ax17.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -ql -hits 10000 -runtag anserini_ql -output core18.anserini_ql.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -ql -hits 10000 -runtag anserini_qlsdm -sdm -output core18.anserini_qlsdm.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -ql -hits 10000 -runtag anserini_qlrm3 -rm3 -output core18.anserini_qlrm3.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -ql -hits 10000 -runtag anserini_qlax -axiom -axiom.deterministic -rerankCutoff 20 -output core18.anserini_qlax.txt
target/appassembler/bin/SearchCollection -index lucene-index.core18.pos+docvectors+rawdocs -topicReader Trec -topics tools/topics-and-qrels/topics.core18.txt -ql -hits 10000 -runtag anserini_qlax17 -axiom -axiom.deterministic -rerankCutoff 0 -axiom.index lucene-index.core17.pos+docvectors+rawdocs -output core18.anserini_qlax17.txt
Evaluation can be performed using trec_eval:
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_bm25.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_sdm.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_rm3.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_ax.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_ax17.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_ql.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_qlsdm.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_qlrm3.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_qlax.txt
eval/trec_eval.9.0.4/trec_eval -c -M1000 -m map -m ndcg -m P.10 tools/topics-and-qrels/qrels.core18.txt core18.anserini_qlax17.txt
The above describes how the Anserini team generated runs for TREC 2018.
However, after the submission of the runs, the Anserini codebase continued to evolved, and as of commit 3114507d863b9aadcc6660fe8257fc4d1ab6e1f4 (Wed Dec 12 12:59:25 2018 -0800), running the above commands unfortunately yields different effectiveness numbers.
In the table below, we compare the effectiveness of our submitted runs, marked with * (e.g., AP*), and the effectiveness of the generated runs at the commit point referenced above, marked with + (e.g., AP+).
| Metric | AP* | AP+ | NDCG* | NDCG+ | P10* | P10+ |
|---|---|---|---|---|---|---|
anserini_bm25 |
0.2284 | 0.2487 | 0.5064 | 0.5322 | 0.4500 | 0.4660 |
anserini_sdm |
0.2364 | 0.2570 | 0.5127 | 0.5382 | 0.4860 | 0.4960 |
anserini_rm3 |
0.2680 | 0.2911 | 0.5422 | 0.5732 | 0.4680 | 0.4860 |
anserini_ax |
0.2734 | 0.2919 | 0.5582 | 0.5724 | 0.4960 | 0.4920 |
anserini_ax17 |
0.2059 | 0.2195 | 0.4942 | 0.5158 | 0.4060 | 0.4200 |
anserini_ql |
0.2294 | 0.2504 | 0.5059 | 0.5302 | 0.4660 | 0.4760 |
anserini_qlsdm |
0.2326 | 0.2535 | 0.5071 | 0.5324 | 0.4740 | 0.4920 |
anserini_qlrm3 |
0.2501 | 0.2754 | 0.5359 | 0.5615 | 0.4660 | 0.4900 |
anserini_qlax |
0.2749 | 0.2976 | 0.5484 | 0.5697 | 0.4780 | 0.4920 |
anserini_qlax17 |
0.2039 | 0.2180 | 0.4875 | 0.5072 | 0.4280 | 0.4160 |
The same as Core Track
We participated in the Background Linking Task, which uses the same collection and index as the Common Core Track. To generate submitted runs:
target/appassembler/bin/SearchCollection -searchnewsbackground -index lucene-index.core18.pos+docvectors+rawdocs -topicReader NewsBackgroundLinking -topics ~/newsir18-background-linking-topics.v2.xml -bm25 -hits 100 -backgroundlinking.k 1000 -backgroundlinking.weighted -runtag anserini_1000w -output tfidf_1000_weighted_bm25.txt
target/appassembler/bin/SearchCollection -searchnewsbackground -index lucene-index.core18.pos+docvectors+rawdocs -topicReader NewsBackgroundLinking -topics ~/newsir18-background-linking-topics.v2.xml -bm25 -axiom -axiom.deterministic -axiom.top 1000 -hits 100 -backgroundlinking.k 100 -runtag anserini_nax -output unweighted_bm25_ax_1000.txt
target/appassembler/bin/SearchCollection -searchnewsbackground -index lucene-index.core18.pos+docvectors+rawdocs -topicReader NewsBackgroundLinking -topics ~/newsir18-background-linking-topics.v2.xml -bm25 -sdm -hits 100 -backgroundlinking.k 1000 -runtag anserini_nsdm -output unweighted_bm25_sdm_1000.txt
target/appassembler/bin/SearchCollection -searchnewsbackground -index lucene-index.core18.pos+docvectors+rawdocs -topicReader NewsBackgroundLinking -topics ~/newsir18-background-linking-topics.v2.xml -bm25 -sdm -hits 100 -backgroundlinking.k 1000 -backgroundlinking.paragraph -runtag anserini_sdmp -output unweighted_bm25_sdm_paragraph.txt
target/appassembler/bin/SearchCollection -searchnewsbackground -index lucene-index.core18.pos+docvectors+rawdocs -topicReader NewsBackgroundLinking -topics ~/newsir18-background-linking-topics.v2.xml -bm25 -axiom -axiom.deterministic -axiom.top 1000 -hits 100 -backgroundlinking.k 1000 -backgroundlinking.paragraph -runtag anserini_axp -output unweighted_bm25_ax_paragraph.txt
We participated in "Task 2: Web Track 2013". Steps to generate our runs:
In addition to the Anserini repo, the following repo is needed:
git clone https://github.com/castorini/Anserini-data.git
First, build the various indexes, as follows.
Index of ClueWeb12:
nohup sh Anserini/target/appassembler/bin/IndexCollection -collection ClueWeb12Collection \
-generator JsoupGenerator -threads 44 -input /path/to/cw12 -index lucene-index.cw12.pos+docvectors+rawdocs \
-storePositions -storeDocvectors -storeRawDocs >& log.cw12.pos+docvectors+rawdocs &
Index of CW12Lite2013:
(Option 1): If you already have the ClubWeb12 full index (above) with -storeRawDocs option enabled when indexing:
nohup Anserini/target/appassembler/bin/IndexUtils -index lucene-index.cw12.pos+docvectors+rawdocs \
-dumpRawDocs Anserini-data/TREC2018/CENTRE/task2/cw12lite2013_docids &
This will generate a file about 19GB in raw size.
nohup Anserini/target/appassembler/bin/IndexCollection -collection HtmlCollection \
-input cw12lite2013_docids_rawdocs.dump -index lucene-index.cw12lite2013.pos+docvectors+rawdocs \
-generator JsoupGenerator -threads 44 -storePositions -storeDocvectors -storeRawDocs -optimize \
>& log.cw12lite2013.pos+docvectors+rawdocs &
This will generate an index about 8.3GB in size.
(Option 2): If you would like to build the index from scratch (e.g. you do not have ClueWeb12 full index):
nohup sh Anserini/target/appassembler/bin/IndexCollection -collection ClueWeb12Collection \
-generator JsoupGenerator -threads 44 -input /path/to/cw12 -index \
lucene-index.cw12lite2013.pos+docvectors+rawdocs -storePositions -storeDocvectors -storeRawDocs \
-whitelist Anserini-data/TREC2018/CENTRE/task2/cw12lite2013_docids >& log.cw12lite2013.pos+docvectors+rawdocs &
Index of CW12Lite2018:
(Option 1): If you already have the ClubWeb12 Full index with -storeRawDocs option enabled when indexing:
nohup Anserini/target/appassembler/bin/IndexUtils -index lucene-index.cw12.pos+docvectors+rawdocs \
-dumpRawDocs Anserini-data/TREC2018/CENTRE/task2/cw12lite2018_docids &
This will gnereate a file about 28GB in raw size.
nohup Anserini/target/appassembler/bin/IndexCollection -collection HtmlCollection \
-input cw12lite2018_docids_rawdocs.dump -index lucene-index.cw12lite2018.pos+docvectors+rawdocs \
-generator JsoupGenerator -threads 44 -storePositions -storeDocvectors -storeRawDocs \
-optimize >& log.cw12lite2018.pos+docvectors+rawdocs &
This will generate an index about 12GB in size.
(Option 2): If you would like to build the index from scratch (e.g. you do not have clueweb12 full index):
nohup sh Anserini/target/appassembler/bin/IndexCollection -collection ClueWeb12Collection \
-generator JsoupGenerator -threads 44 -input /path/to/cw12 -index \
lucene-index.cw12lite2018.pos+docvectors+rawdocs -storePositions -storeDocvectors -storeRawDocs \
-whitelist Anserini-data/TREC2018/CENTRE/task2/cw12lite2013_docids >& log.cw12lite2018.pos+docvectors+rawdocs &
Index of snippets 2013
nohup sh Anserini/target/appassembler/bin/IndexCollection -input \
Anserini-data/TREC2018/CENTRE/task2/searchengine_snippets/snippets2013_anserini/ \
-collection JsonCollection -index lucene-index.snippets2013.pos+docvectors+rawdocs \
-generator JsoupGenerator -threads 8 -uniqueDocid -storePositions -storeDocvectors \
-storeRawDocs -optimize >& log.snippets2013.pos+docvectors+rawdocs &
Index of snippets 2018
nohup sh Anserini/target/appassembler/bin/IndexCollection -input \
Anserini-data/TREC2018/CENTRE/task2/searchengine_snippets/snippets2018_anserini/ \
-collection JsonCollection -index lucene-index.snippets2018.pos+docvectors+rawdocs \
-generator JsoupGenerator -threads 8 -uniqueDocid -storePositions -storeDocvectors \
-storeRawDocs -optimize >& log.snippets2018.pos+docvectors+rawdocs &
Index of Wikipedia dump (optional):
curl -O https://dumps.wikimedia.org/enwiki/20180620/enwiki-20180620-pages-articles.xml.bz2
For verification, md5 bca0ceb72e000105cc97fb54fef70cc3
nohup sh Anserini/target/appassembler/bin/IndexCollection -collection WikipediaCollection \
-generator JsoupGenerator -threads 16 -input enwiki-20180620-pages-articles.xml.bz2 -index \
lucene-index.wiki.pos+docvectors -storePositions -storeDocvectors >& log.wiki.pos+docvectors &
python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12lite2018.pos+docvectors+rawdocs --expansion_index lucene-index.cw12lite2018.pos+docvectors+rawdocs --retrieval
python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12lite2018.pos+docvectors+rawdocs --expansion_index lucene-index.snippets2018.pos+docvectors+rawdocs --retrieval
python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12lite2013.pos+docvectors+rawdocs --expansion_index lucene-index.cw12lite2013.pos+docvectors+rawdocs --retrieval
python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12lite2013.pos+docvectors+rawdocs --expansion_index lucene-index.snippets2013.pos+docvectors+rawdocs --retrieval
python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12.pos+docvectors+rawdocs --expansion_index lucene-index.cw12.pos+docvectors+rawdocs --retrieval
python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12.pos+docvectors+rawdocs --expansion_index lucene-index.snippets2013.pos+docvectors+rawdocs --retrieval
python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12.pos+docvectors+rawdocs --expansion_index lucene-index.snippets2018.pos+docvectors+rawdocs --retrieval
(Optional)python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12lite2018.pos+docvectors+rawdocs --expansion_index lucene-index.wiki.pos+docvectors+rawdocs --retrieval
(Optional)python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12lite2013.pos+docvectors+rawdocs --expansion_index lucene-index.wiki.pos+docvectors+rawdocs --retrieval
(Optional) python src/main/python/trec2018/centre/task2/main.py --target_index lucene-index.cw12.pos+docvectors+rawdocs --expansion_index lucene-index.wiki.pos+docvectors+rawdocs --retrieval
python src/main/python/trec2018/centre/task2/main.py --eval --plot
The above commands generate ALL results we have put in the notebook paper. To reproduce the submitted runs ONLY:
target/appassembler/bin/SearchCollection -index lucene-index.cw12.pos+docvectors+rawdocs -topicReader Webxml -topics tools/topics-and-qrels/topics.web.201-250.txt -bm25 -rerankCutoff 20 -axiom -axiom.deterministic -axiom.beta 0.5 -runtag Anserini-UDInfolabWEB1-1 -output Anserini-UDInfolabWEB1-1.txt
target/appassembler/bin/SearchCollection -index lucene-index.cw12.pos+docvectors+rawdocs -topicReader Webxml -topics tools/topics-and-qrels/topics.web.201-250.txt -bm25 -rerankCutoff 20 -axiom -axiom.deterministic -axiom.beta 0.5 -axiom.index lucene-index.snippets2018.pos+docvectors+rawdocs -runtag Anserini-UDInfolabWEB1-2 -output Anserini-UDInfolabWEB1-2.txt
target/appassembler/bin/SearchCollection -index lucene-index.cw12.pos+docvectors+rawdocs -topicReader Webxml -topics tools/topics-and-qrels/topics.web.201-250.txt -bm25 -rerankCutoff 20 -axiom -axiom.deterministic -axiom.beta 0.5 -axiom.index lucene-index.wiki.pos+docvectors -runtag Anserini-UDInfolabWEB1-3 -output Anserini-UDInfolabWEB1-3.txt
target/appassembler/bin/SearchCollection -index lucene-index.cw12lite2013.pos+docvectors+rawdocs -topicReader Webxml -topics tools/topics-and-qrels/topics.web.201-250.txt -ql -rerankCutoff 20 -axiom -axiom.deterministic -axiom.beta 1.7 -runtag Anserini-UDInfolabWEB2-1 -output Anserini-UDInfolabWEB2-1.txt
target/appassembler/bin/SearchCollection -index lucene-index.cw12lite2018.pos+docvectors+rawdocs -topicReader Webxml -topics tools/topics-and-qrels/topics.web.201-250.txt -ql -rerankCutoff 20 -axiom -axiom.deterministic -axiom.beta 1.7 -runtag Anserini-UDInfolabWEB2-2 -output Anserini-UDInfolabWEB2-2.txt
target/appassembler/bin/SearchCollection -index lucene-index.cw12lite2018.pos+docvectors+rawdocs -topicReader Webxml -topics tools/topics-and-qrels/topics.web.201-250.txt -bm25 -rerankCutoff 20 -axiom -axiom.deterministic -axiom.beta 0.5 -axiom.index lucene-index.wiki.pos+docvectors -runtag Anserini-UDInfolabWEB2-3 -output Anserini-UDInfolabWEB2-3.txt
NOTE: Topics and qrels are currently available only to TREC 2018 participants.
Users will need to download the topics and qrels directly from the NIST website and put them at tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt.
These files will be checked into the repo after NIST publishes them publicly.
Evaluation can be performed using trec_eval and gdeval.pl:
eval/trec_eval.9.0.4/trec_eval -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB1-1.txt
eval/trec_eval.9.0.4/trec_eval -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB1-2.txt
eval/trec_eval.9.0.4/trec_eval -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB1-3.txt
eval/trec_eval.9.0.4/trec_eval -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB2-1.txt
eval/trec_eval.9.0.4/trec_eval -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB2-2.txt
eval/trec_eval.9.0.4/trec_eval -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB2-3.txt
eval/gdeval.pl tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB1-1.txt
eval/gdeval.pl -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB1-2.txt
eval/gdeval.pl -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB1-3.txt
eval/gdeval.pl -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB2-1.txt
eval/gdeval.pl -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB2-2.txt
eval/gdeval.pl -m map -m P.30 tools/topics-and-qrels/qrels.web.201-250.new.pruned.txt Anserini-UDInfolabWEB2-3.txt
These are the effectiveness scores derived from our official TREC runs submitted to NIST, with "old" and "new" qrels:
| MAP | old | new |
|---|---|---|
Anserini-UDInfolabWEB1-1 |
0.1029 | 0.0910 |
Anserini-UDInfolabWEB1-2 |
0.1772 | 0.1929 |
Anserini-UDInfolabWEB1-3 |
0.0645 | 0.1079 |
Anserini-UDInfolabWEB2-1 |
0.0920 | 0.0774 |
Anserini-UDInfolabWEB2-2 |
0.0592 | 0.1333 |
Anserini-UDInfolabWEB2-3 |
0.0583 | 0.1000 |
| P30 | old | new |
|---|---|---|
Anserini-UDInfolabWEB1-1 |
0.1940 | 0.2667 |
Anserini-UDInfolabWEB1-2 |
0.3007 | 0.4520 |
Anserini-UDInfolabWEB1-3 |
0.1400 | 0.3400 |
Anserini-UDInfolabWEB2-1 |
0.2427 | 0.2960 |
Anserini-UDInfolabWEB2-2 |
0.2293 | 0.2293 |
Anserini-UDInfolabWEB2-3 |
0.1407 | 0.3467 |
| NDCG20 | old | new |
|---|---|---|
Anserini-UDInfolabWEB1-1 |
0.16760 | 0.11223 |
Anserini-UDInfolabWEB1-2 |
0.25233 | 0.20426 |
Anserini-UDInfolabWEB1-3 |
0.11001 | 0.16492 |
Anserini-UDInfolabWEB2-1 |
0.19950 | 0.10746 |
Anserini-UDInfolabWEB2-2 |
0.12996 | 0.10144 |
Anserini-UDInfolabWEB2-3 |
0.10229 | 0.14627 |
| ERR20 | old | new |
|---|---|---|
Anserini-UDInfolabWEB1-1 |
0.10018 | 0.12962 |
Anserini-UDInfolabWEB1-2 |
0.13991 | 0.17499 |
Anserini-UDInfolabWEB1-3 |
0.06524 | 0.15344 |
Anserini-UDInfolabWEB2-1 |
0.12447 | 0.08373 |
Anserini-UDInfolabWEB2-2 |
0.09758 | 0.12700 |
Anserini-UDInfolabWEB2-3 |
0.06108 | 0.15017 |