arguana_neomme_260m_li

Multi-vector (late-interaction) embeddings of BEIR arguana (beir/arguana), encoded with Hcompany/NeoMME-260M-Retriever-ST-late at revision 023be2a8ab9d797f5aa76f5bf8b5dde78d819659.

Source data: ir_datasets beir/arguana (ir_datasets 0.6.3), which downloads arguana.zip (md5 8ad3e3c2a5867cdced806d6503f29b99). BEIR also publishes this corpus on the Hub as BeIR/arguana, whose card gives this dataset's license; the data here was loaded through ir_datasets, 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 (the gt_top*.tsv files, and the row order of every .npy file) refer to the order of doc_ids.npy and queries_ids.npy. Reordering either file invalidates the ground truth.

Statistics

Encoding

Ground truth: gt_top1000.tsv and gt_top100.tsv

Exact brute-force MaxSim top-1000 per query over the full corpus, from the vectors in this repo. gt_top100.tsv holds the first 100 ranks per query of the same lists (the original layout of these exports).

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.

Self-matches are included. 1,298 of 1,406 queries are themselves corpus documents under the same id; 1,298 of them retrieve that document within gt_top1000.tsv (1,292 at rank 1). This is the raw nearest-neighbour list. This dataset's evaluation drops such pairs (BEIR's ignore_identical_ids), and so do the numbers below; drop them before scoring against qrels.

Retrieval quality

Sanity check of the vectors, not a leaderboard number: gt_top1000.tsv (exact MaxSim over the full corpus) scored against qrels.test.tsv with ir_measures, with query-id == doc-id pairs dropped as this dataset's evaluation does.

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, 1042, 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 (1687416, 128)
• ✅ doclens.npy dtype/shape — <i4 (8674,)
• ✅ doc_ids.npy is a string array — <U47 (8674,)
• ✅ queries.npy dtype/shape — <f4 (1406, 1042, 128)
• ✅ query_lens.npy dtype/shape — <i4 (1406,)
• ✅ queries_ids.npy is a string array — <U41 (1406,)
• ✅ sum(doclens) == n_tokens — 1687416 vs 1687416
• ✅ no empty documents — min doclen 2
• ✅ len(doc_ids) == len(doclens) == corpus size — 8674, 8674, 8674
• ✅ doc_ids unique
• ✅ query arrays aligned — 1406, 1406, 1406
• ✅ doc and query dim agree — 128 / 128
• ✅ token_ids.npy dtype/shape — <u4 (1687416,)
• ✅ document vectors unit-norm (100k sample) — norm range [0.9995, 1.0005]
• ✅ query vectors unit-norm — norm range [1.000000, 1.000000]
• ✅ all vectors finite
• ✅ gt_top100.tsv has k rows per query — 140600 rows, k=100
• ✅ gt_top100.tsv rows grouped by qidx with ranks 1..k and descending scores
• ✅ gt_top100.tsv indices in range
• ✅ gt_top1000.tsv has k rows per query — 1406000 rows, k=1000
• ✅ gt_top1000.tsv rows grouped by qidx with ranks 1..k and descending scores
• ✅ gt_top1000.tsv indices in range
• ✅ gt_top100.tsv is the first 100 ranks of gt_top1000.tsv

Provenance