robro612/trec-covid_mlateon

trec-covid_mlateon

Multi-vector (late-interaction) embeddings of BEIR trec-covid (beir/trec-covid), encoded with [lightonai/mLateOn](https://huggingface.co/lightonai/mLateOn) at revision edd378f99593c0ac8a15518b97ad89786b02685e.

Source data: ir_datasets beir/trec-covid (irdatasets 0.6.3), which downloads [trec-covid.zip](https://public.ukp.informatik.tu-darmstadt.de/thakur/BEIR/datasets/trec-covid.zip) (md5 `ce62140cb23feb9becf6270d0d1fe6d1`). BEIR also publishes this corpus on the Hub as [`BeIR/trec-covid`](https://huggingface.co/datasets/BeIR/trec-covid), whose card gives this dataset's license; the data here was loaded through irdatasets, not from that repo. Document, query and qrel ids are the source's own ids, unchanged.

Every document is one variable-length set of 128-d vectors; every query is one variable-length set of 128-d vectors. Documents and queries are stored at different precisions (fp16 and fp32 respectively), see Encoding.

Files

All positional indices (gt_top100.tsv, and the row order of every .npy file) refer to the order of doc_ids.npy and queries_ids.npy. Reordering either file invalidates gt_top100.tsv.

Statistics

Encoding

Ground truth: gt_top100.tsv

Exact brute-force MaxSim top-100 per query over the full corpus, from the vectors in this repo. No header; tab-separated qidx docidx rank score:

• —qidx: 0-based row into queries_ids.npy / queries.npy
• —docidx: 0-based position into doc_ids.npy / doclens.npy
• —rank: 1-based, descending score
• —score: sum over the query's query_lens[qidx] vectors of max over the document's vectors of the dot product, computed in fp32 with the fp16 document vectors upcast to fp32. Expansion vectors are included in the sum. Printed to 6 decimals.

No query id appears as a document id, so there are no self-matches.

Retrieval quality

Sanity check of the vectors, not a leaderboard number: exact MaxSim over the full corpus scored against qrels.test.tsv with ir_measures.

Loading

import numpy as np

documents = np.load("documents.npy", mmap_mode="r")      # [n_tokens, 128] float16
doclens = np.load("doclens.npy")                         # [n_docs] int32
offsets = np.concatenate([[0], np.cumsum(doclens)])
doc_ids = np.load("doc_ids.npy")                         # [n_docs] str

def document(i):
    return documents[offsets[i]:offsets[i + 1]]           # [doclens[i], 128]

queries = np.load("queries.npy")                         # [n_queries, 34, 128] float32
query_lens = np.load("query_lens.npy")                   # [n_queries] int32
query_ids = np.load("queries_ids.npy")                   # [n_queries] str

def query(j):
    return queries[j, :query_lens[j]]                     # [query_lens[j], 128]

def maxsim(q, d):
    return (q @ d.astype(np.float32).T).max(axis=1).sum()

Validation

Checks run by the exporter on the files exactly as written here:

• —✅ file set — missing=[] extra=[]
• —✅ documents.npy dtype/shape — <f2 (40023891, 128)
• —✅ doclens.npy dtype/shape — <i4 (171332,)
• —✅ doc_ids.npy is a string array — <U8 (171332,)
• —✅ queries.npy dtype/shape — <f4 (50, 34, 128)
• —✅ query_lens.npy dtype/shape — <i4 (50,)
• —✅ queries_ids.npy is a string array — <U2 (50,)
• —✅ sum(doclens) == n_tokens — 40023891 vs 40023891
• —✅ no empty documents — min doclen 3
• —✅ len(doc_ids) == len(doclens) == corpus size — 171332, 171332, 171332
• —✅ doc_ids unique
• —✅ query arrays aligned — 50, 50, 50
• —✅ doc and query dim agree — 128 / 128
• —✅ token_ids.npy dtype/shape — <u4 (40023891,)
• —✅ document vectors unit-norm (100k sample) — norm range [0.9994, 1.0006]
• —✅ query vectors unit-norm — norm range [1.000000, 1.000000]
• —✅ all vectors finite
• —✅ gt_top100.tsv has k rows per query — 5000 rows, k=100
• —✅ gt rows grouped by qidx with ranks 1..k and descending scores
• —✅ gt indices in range

Provenance