task_categories:text-retrieval language:ha language:so language:sw language:yo license:apache-2.0 region:us
This dataset consists of the queries and relevance judgements in the CIRAL test collection.
---
license: apache-2.0

language:
- ha
- so
- sw
- yo

task_categories:
- text-retrieval

mutilinguality:
- multilingual

viewer: true
---


# Dataset Summary

CIRAL is a collection for cross-lingual information retrieval research across four (4) African languages. The collection comprises English queries and query-passage relevance judgements for passages in the African languages.
This dataset repo contains only the queries and relevance judgements. The corpus collection can be found here [here](https://huggingface.co/datasets/CIRAL/ciral-corpus)


# Dataset Structure
1. To download the files: The queries can be found under `ciral-{lang}/topics` and are in `.tsv` formats with each line in the form:

   ```
    qid\tquery
   ```
   while the judgements are in the folder `ciral-{lang}/qrels`, with each file in the standard TREC format:

   ```
    qid Q0 docid relevance
   ```
2. To access the dataset via `datasets`:
   
   ```
   ciral_dataset = load_dataset("ciral/ciral", "hausa") #or swahili, somali, yoruba

   for data in ciral_data['train']:  # or 'test'
      query_id = data['query_id']
      query = data['query']
      pos_qrels = data['positive_passages']
      neg_qrels = data['negative_passages']

      for qrel in pos_qrels:
         docid = qrel['docid']
         text = qrel['text']
   ```



   
## Citation

...
