Awesome

OSIRRC Docker Image for Galago

Michael Zarozinski

This is the docker image for Galago v3.15 conforming to the OSIRRC jig for the Open-Source IR Replicability Challenge (OSIRRC) at SIGIR 2019. This image is available on Docker Hub.

This image is based on the Indri image by Claudia Hauff (https://github.com/osirrc/indri-docker)

• Supported test collections: robust04
• Supported hooks: index, search

Quick Start

First, clone the jig and follow its setup instructions - in particular, do not forget to also clone and install trec_eval inside the jig directory.

The following jig command can be used to index TREC disks 4/5 for robust04:

python run.py prepare \
  --repo osirrc2019/galago \
  --tag v0.0.2 \
  --collections robust04=/path/to/disk45=trectext

The following jig command can be used to perform a retrieval run on the collection with the robust04 test collection.

python run.py search \
  --repo osirrc2019/galago \
  --tag v0.0.2 \
  --output ./output \
  --top_k 1000 \
  --qrels qrels/qrels.robust04.txt \
  --topic topics/topics.robust04.txt \
  --collection robust04 \
  --opts out_file_name="output_robust04.txt" 

Passing Parameters to Galago

Since both the jig and Galago specify parameters using a double dash, we can't use the double dash when specifying a Galago parameter because the jig will think it's a jig parameter. We also can't use an equal sign when specifying a Galago parameter value due to the way the jig parses key/value pairs. So, to specify a Galago parameter we use the search_options field of the --opts parameter. For example, if you wanted to change the default value of mu when running Galago outside of the jig you would specify --mu=1000. Using the jig, you would specify --opts search_options="mu:1000".

Retrieval Methods

The Galago image supports the following retrieval method:

• QL : Query likelihood with Dirichlet smoothing.

  • Parameters :
    • mu : default 1500.

• BM25 :

  • Parameters :
    • b : Controls degree of length normalization (values 0..1; default 0.75).
    • k : Normalization parameter for document length (default 1.2).
    • w : Custom weight for term (default 1.0).

• SDM : Sequential Dependence Model with Dirichlet smoothing.

  • Parameters :
    • uniw : Unigram query component weight (default 0.8).
    • odw : Ordered window query component weight (default 0.15).
    • uww : Unordered window query component weight (default 0.05).
    • windowLimit : Window proximity limit (default 2).
    • fast : Faster operators (true/false) (bigram/ubigram operators).
    • sdm.od.op : Ordered window operator (default "ordered").
    • sdm.uw.op : Unordered window operator (default "unordered").
    • sdm.od.width : Window width (default 1).
    • sdm.uw.width : Window width (default 4).

Expected Results

robust04