tomaarsen/mpnet-base-nq-prompts-repro

MPNet base trained on Natural Questions pairs

This is a sentence-transformers model finetuned from microsoft/mpnet-base on the natural-questions dataset. It maps sentences & paragraphs to a 768-dimensional dense vector space and can be used for semantic textual similarity, semantic search, paraphrase mining, text classification, clustering, and more.

Model Details

Model Description

• Model Type: Sentence Transformer
• Base model: microsoft/mpnet-base
• Maximum Sequence Length: 512 tokens
• Output Dimensionality: 768 dimensions
• Similarity Function: Cosine Similarity
• Training Dataset:
  • natural-questions
• Language: en
• License: apache-2.0

Model Sources

• Documentation: Sentence Transformers Documentation
• Repository: Sentence Transformers on GitHub
• Hugging Face: Sentence Transformers on Hugging Face

Full Model Architecture

SentenceTransformer(
  (0): Transformer({'max_seq_length': 512, 'do_lower_case': False, 'architecture': 'MPNetModel'})
  (1): Pooling({'word_embedding_dimension': 768, 'pooling_mode_cls_token': False, 'pooling_mode_mean_tokens': True, 'pooling_mode_max_tokens': False, 'pooling_mode_mean_sqrt_len_tokens': False, 'pooling_mode_weightedmean_tokens': False, 'pooling_mode_lasttoken': False, 'include_prompt': True})
)

Usage

Direct Usage (Sentence Transformers)

First install the Sentence Transformers library:

pip install -U sentence-transformers

Then you can load this model and run inference.

from sentence_transformers import SentenceTransformer

# Download from the 🤗 Hub
model = SentenceTransformer("tomaarsen/mpnet-base-nq-prompts-repro")
# Run inference
queries = [
    "where does the last name francisco come from",
]
documents = [
    'Francisco Francisco is the Spanish and Portuguese form of the masculine given name Franciscus (corresponding to English Francis).',
    'Book of Esther The Book of Esther, also known in Hebrew as "the Scroll" (Megillah), is a book in the third section (Ketuvim, "Writings") of the Jewish Tanakh (the Hebrew Bible) and in the Christian Old Testament. It is one of the five Scrolls (Megillot) in the Hebrew Bible. It relates the story of a Hebrew woman in Persia, born as Hadassah but known as Esther, who becomes queen of Persia and thwarts a genocide of her people. The story forms the core of the Jewish festival of Purim, during which it is read aloud twice: once in the evening and again the following morning. The books of Esther and Song of Songs are the only books in the Hebrew Bible that do not explicitly mention God.[2]',
    'Times Square Times Square is a major commercial intersection, tourist destination, entertainment center and neighborhood in the Midtown Manhattan section of New York City at the junction of Broadway and Seventh Avenue. It stretches from West 42nd to West 47th Streets.[1] Brightly adorned with billboards and advertisements, Times Square is sometimes referred to as "The Crossroads of the World",[2] "The Center of the Universe",[3] "the heart of The Great White Way",[4][5][6] and the "heart of the world".[7] One of the world\'s busiest pedestrian areas,[8] it is also the hub of the Broadway Theater District[9] and a major center of the world\'s entertainment industry.[10] Times Square is one of the world\'s most visited tourist attractions, drawing an estimated 50 million visitors annually.[11] Approximately 330,000 people pass through Times Square daily,[12] many of them tourists,[13] while over 460,000 pedestrians walk through Times Square on its busiest days.[7]',
]
query_embeddings = model.encode_query(queries)
document_embeddings = model.encode_document(documents)
print(query_embeddings.shape, document_embeddings.shape)
# [1, 768] [3, 768]

# Get the similarity scores for the embeddings
similarities = model.similarity(query_embeddings, document_embeddings)
print(similarities)
# tensor([[     0.7532,     -0.0007,      0.0170]])

Evaluation

Metrics

Information Retrieval

• Datasets: NanoMSMARCO and NanoNQ
• Evaluated with InformationRetrievalEvaluator with these parameters:

  {
      "query_prompt": "query: ",
      "corpus_prompt": "document: "
  }
  

Metric	NanoMSMARCO	NanoNQ
cosine_accuracy@1	0.28	0.38
cosine_accuracy@3	0.56	0.6
cosine_accuracy@5	0.72	0.74
cosine_accuracy@10	0.76	0.76
cosine_precision@1	0.28	0.38
cosine_precision@3	0.1867	0.2067
cosine_precision@5	0.144	0.156
cosine_precision@10	0.076	0.08
cosine_recall@1	0.28	0.36
cosine_recall@3	0.56	0.58
cosine_recall@5	0.72	0.71
cosine_recall@10	0.76	0.73
cosine_ndcg@10	0.5258	0.5697
cosine_mrr@10	0.4494	0.5262
cosine_map@100	0.4607	0.5211

Nano BEIR

• Dataset: NanoBEIR_mean
• Evaluated with NanoBEIREvaluator with these parameters:

  {
      "dataset_names": [
          "msmarco",
          "nq"
      ],
      "query_prompts": {
          "msmarco": "query: ",
          "nq": "query: "
      },
      "corpus_prompts": {
          "msmarco": "document: ",
          "nq": "document: "
      }
  }
  

Metric	Value
cosine_accuracy@1	0.33
cosine_accuracy@3	0.58
cosine_accuracy@5	0.73
cosine_accuracy@10	0.76
cosine_precision@1	0.33
cosine_precision@3	0.1967
cosine_precision@5	0.15
cosine_precision@10	0.078
cosine_recall@1	0.32
cosine_recall@3	0.57
cosine_recall@5	0.715
cosine_recall@10	0.745
cosine_ndcg@10	0.5478
cosine_mrr@10	0.4878
cosine_map@100	0.4909

Training Details

Training Dataset

natural-questions

• Dataset: natural-questions at f9e894e
• Size: 99,231 training samples
• Columns: query and answer
• Approximate statistics based on the first 1000 samples:

  	query	answer
  type	string	string
  details	min: 10 tokens mean: 11.74 tokens max: 24 tokens	min: 15 tokens mean: 137.2 tokens max: 508 tokens

• Samples:

  query	answer
  who is required to report according to the hmda	Home Mortgage Disclosure Act US financial institutions must report HMDA data to their regulator if they meet certain criteria, such as having assets above a specific threshold. The criteria is different for depository and non-depository institutions and are available on the FFIEC website.[4] In 2012, there were 7,400 institutions that reported a total of 18.7 million HMDA records.[5]
  what is the definition of endoplasmic reticulum in biology	Endoplasmic reticulum The endoplasmic reticulum (ER) is a type of organelle in eukaryotic cells that forms an interconnected network of flattened, membrane-enclosed sacs or tube-like structures known as cisternae. The membranes of the ER are continuous with the outer nuclear membrane. The endoplasmic reticulum occurs in most types of eukaryotic cells, but is absent from red blood cells and spermatozoa. There are two types of endoplasmic reticulum: rough and smooth. The outer (cytosolic) face of the rough endoplasmic reticulum is studded with ribosomes that are the sites of protein synthesis. The rough endoplasmic reticulum is especially prominent in cells such as hepatocytes. The smooth endoplasmic reticulum lacks ribosomes and functions in lipid manufacture and metabolism, the production of steroid hormones, and detoxification.[1] The smooth ER is especially abundant in mammalian liver and gonad cells. The lacy membranes of the endoplasmic reticulum were first seen in 1945 using elect...
  what does the ski mean in polish names	Polish name Since the High Middle Ages, Polish-sounding surnames ending with the masculine -ski suffix, including -cki and -dzki, and the corresponding feminine suffix -ska/-cka/-dzka were associated with the nobility (Polish szlachta), which alone, in the early years, had such suffix distinctions.[1] They are widely popular today.

• Loss: CachedMultipleNegativesRankingLoss with these parameters:

  {
      "scale": 20.0,
      "similarity_fct": "cos_sim",
      "mini_batch_size": 16
  }
  

Evaluation Dataset

natural-questions

• Dataset: natural-questions at f9e894e
• Size: 1,000 evaluation samples
• Columns: query and answer
• Approximate statistics based on the first 1000 samples:

  	query	answer
  type	string	string
  details	min: 10 tokens mean: 11.78 tokens max: 22 tokens	min: 11 tokens mean: 135.64 tokens max: 512 tokens

• Samples:

  query	answer
  difference between russian blue and british blue cat	Russian Blue The coat is known as a "double coat", with the undercoat being soft, downy and equal in length to the guard hairs, which are an even blue with silver tips. However, the tail may have a few very dull, almost unnoticeable stripes. The coat is described as thick, plush and soft to the touch. The feeling is softer than the softest silk. The silver tips give the coat a shimmering appearance. Its eyes are almost always a dark and vivid green. Any white patches of fur or yellow eyes in adulthood are seen as flaws in show cats.[3] Russian Blues should not be confused with British Blues (which are not a distinct breed, but rather a British Shorthair with a blue coat as the British Shorthair breed itself comes in a wide variety of colors and patterns), nor the Chartreux or Korat which are two other naturally occurring breeds of blue cats, although they have similar traits.
  who played the little girl on mrs doubtfire	Mara Wilson Mara Elizabeth Wilson[2] (born July 24, 1987) is an American writer and former child actress. She is known for playing Natalie Hillard in Mrs. Doubtfire (1993), Susan Walker in Miracle on 34th Street (1994), Matilda Wormwood in Matilda (1996) and Lily Stone in Thomas and the Magic Railroad (2000). Since retiring from film acting, Wilson has focused on writing.
  what year did the movie the sound of music come out	The Sound of Music (film) The film was released on March 2, 1965 in the United States, initially as a limited roadshow theatrical release. Although critical response to the film was widely mixed, the film was a major commercial success, becoming the number one box office movie after four weeks, and the highest-grossing film of 1965. By November 1966, The Sound of Music had become the highest-grossing film of all-time—surpassing Gone with the Wind—and held that distinction for five years. The film was just as popular throughout the world, breaking previous box-office records in twenty-nine countries. Following an initial theatrical release that lasted four and a half years, and two successful re-releases, the film sold 283 million admissions worldwide and earned a total worldwide gross of $286,000,000.

• Loss: CachedMultipleNegativesRankingLoss with these parameters:

  {
      "scale": 20.0,
      "similarity_fct": "cos_sim",
      "mini_batch_size": 16
  }
  

Training Hyperparameters

Non-Default Hyperparameters

• eval_strategy: steps
• per_device_train_batch_size: 256
• per_device_eval_batch_size: 256
• learning_rate: 2e-05
• num_train_epochs: 1
• warmup_ratio: 0.1
• seed: 12
• bf16: True
• prompts: {'query': 'query: ', 'answer': 'document: '}
• batch_sampler: no_duplicates

All Hyperparameters

Click to expand

• overwrite_output_dir: False
• do_predict: False
• eval_strategy: steps
• prediction_loss_only: True
• per_device_train_batch_size: 256
• per_device_eval_batch_size: 256
• per_gpu_train_batch_size: None
• per_gpu_eval_batch_size: None
• gradient_accumulation_steps: 1
• eval_accumulation_steps: None
• torch_empty_cache_steps: None
• learning_rate: 2e-05
• weight_decay: 0.0
• adam_beta1: 0.9
• adam_beta2: 0.999
• adam_epsilon: 1e-08
• max_grad_norm: 1.0
• num_train_epochs: 1
• max_steps: -1
• lr_scheduler_type: linear
• lr_scheduler_kwargs: {}
• warmup_ratio: 0.1
• warmup_steps: 0
• log_level: passive
• log_level_replica: warning
• log_on_each_node: True
• logging_nan_inf_filter: True
• save_safetensors: True
• save_on_each_node: False
• save_only_model: False
• restore_callback_states_from_checkpoint: False
• no_cuda: False
• use_cpu: False
• use_mps_device: False
• seed: 12
• data_seed: None
• jit_mode_eval: False
• use_ipex: False
• bf16: True
• fp16: False
• fp16_opt_level: O1
• half_precision_backend: auto
• bf16_full_eval: False
• fp16_full_eval: False
• tf32: None
• local_rank: 0
• ddp_backend: None
• tpu_num_cores: None
• tpu_metrics_debug: False
• debug: []
• dataloader_drop_last: False
• dataloader_num_workers: 0
• dataloader_prefetch_factor: None
• past_index: -1
• disable_tqdm: False
• remove_unused_columns: True
• label_names: None
• load_best_model_at_end: False
• ignore_data_skip: False
• fsdp: []
• fsdp_min_num_params: 0
• fsdp_config: {'min_num_params': 0, 'xla': False, 'xla_fsdp_v2': False, 'xla_fsdp_grad_ckpt': False}
• fsdp_transformer_layer_cls_to_wrap: None
• accelerator_config: {'split_batches': False, 'dispatch_batches': None, 'even_batches': True, 'use_seedable_sampler': True, 'non_blocking': False, 'gradient_accumulation_kwargs': None}
• deepspeed: None
• label_smoothing_factor: 0.0
• optim: adamw_torch
• optim_args: None
• adafactor: False
• group_by_length: False
• length_column_name: length
• ddp_find_unused_parameters: None
• ddp_bucket_cap_mb: None
• ddp_broadcast_buffers: False
• dataloader_pin_memory: True
• dataloader_persistent_workers: False
• skip_memory_metrics: True
• use_legacy_prediction_loop: False
• push_to_hub: False
• resume_from_checkpoint: None
• hub_model_id: None
• hub_strategy: every_save
• hub_private_repo: None
• hub_always_push: False
• gradient_checkpointing: False
• gradient_checkpointing_kwargs: None
• include_inputs_for_metrics: False
• include_for_metrics: []
• eval_do_concat_batches: True
• fp16_backend: auto
• push_to_hub_model_id: None
• push_to_hub_organization: None
• mp_parameters:
• auto_find_batch_size: False
• full_determinism: False
• torchdynamo: None
• ray_scope: last
• ddp_timeout: 1800
• torch_compile: False
• torch_compile_backend: None
• torch_compile_mode: None
• include_tokens_per_second: False
• include_num_input_tokens_seen: False
• neftune_noise_alpha: None
• optim_target_modules: None
• batch_eval_metrics: False
• eval_on_start: False
• use_liger_kernel: False
• eval_use_gather_object: False
• average_tokens_across_devices: False
• prompts: {'query': 'query: ', 'answer': 'document: '}
• batch_sampler: no_duplicates
• multi_dataset_batch_sampler: proportional
• router_mapping: {}
• learning_rate_mapping: {}

Training Logs

Epoch	Step	Training Loss	Validation Loss	NanoMSMARCO_cosine_ndcg@10	NanoNQ_cosine_ndcg@10	NanoBEIR_mean_cosine_ndcg@10
-1	-1	-	-	0.0708	0.0331	0.0519
0.0026	1	5.0637	-	-	-	-
0.0129	5	4.8975	-	-	-	-
0.0258	10	4.677	-	-	-	-
0.0387	15	4.1051	-	-	-	-
0.0515	20	2.8666	-	-	-	-
0.0644	25	1.5737	-	-	-	-
0.0773	30	0.9778	-	-	-	-
0.0902	35	0.6523	-	-	-	-
0.1031	40	0.4542	-	-	-	-
0.1160	45	0.3663	-	-	-	-
0.1289	50	0.2954	0.2123	0.4528	0.4334	0.4431
0.1418	55	0.23	-	-	-	-
0.1546	60	0.2482	-	-	-	-
0.1675	65	0.2464	-	-	-	-
0.1804	70	0.2181	-	-	-	-
0.1933	75	0.168	-	-	-	-
0.2062	80	0.2015	-	-	-	-
0.2191	85	0.1976	-	-	-	-
0.2320	90	0.1831	-	-	-	-
0.2448	95	0.1471	-	-	-	-
0.2577	100	0.1485	0.1212	0.5073	0.5045	0.5059
0.2706	105	0.1638	-	-	-	-
0.2835	110	0.1791	-	-	-	-
0.2964	115	0.1464	-	-	-	-
0.3093	120	0.1579	-	-	-	-
0.3222	125	0.1631	-	-	-	-
0.3351	130	0.1292	-	-	-	-
0.3479	135	0.1377	-	-	-	-
0.3608	140	0.1503	-	-	-	-
0.3737	145	0.1453	-	-	-	-
0.3866	150	0.1201	0.1002	0.5206	0.5081	0.5143
0.3995	155	0.1629	-	-	-	-
0.4124	160	0.1626	-	-	-	-
0.4253	165	0.1247	-	-	-	-
0.4381	170	0.1218	-	-	-	-
0.4510	175	0.1327	-	-	-	-
0.4639	180	0.1202	-	-	-	-
0.4768	185	0.1173	-	-	-	-
0.4897	190	0.109	-	-	-	-
0.5026	195	0.12	-	-	-	-
0.5155	200	0.1309	0.0939	0.5177	0.5235	0.5206
0.5284	205	0.1257	-	-	-	-
0.5412	210	0.1301	-	-	-	-
0.5541	215	0.104	-	-	-	-
0.5670	220	0.1034	-	-	-	-
0.5799	225	0.1093	-	-	-	-
0.5928	230	0.1301	-	-	-	-
0.6057	235	0.1259	-	-	-	-
0.6186	240	0.1084	-	-	-	-
0.6314	245	0.1034	-	-	-	-
0.6443	250	0.1298	0.0829	0.5181	0.5577	0.5379
0.6572	255	0.0963	-	-	-	-
0.6701	260	0.1318	-	-	-	-
0.6830	265	0.1224	-	-	-	-
0.6959	270	0.1086	-	-	-	-
0.7088	275	0.1299	-	-	-	-
0.7216	280	0.1111	-	-	-	-
0.7345	285	0.1236	-	-	-	-
0.7474	290	0.1082	-	-	-	-
0.7603	295	0.1255	-	-	-	-
0.7732	300	0.1058	0.0800	0.5355	0.5475	0.5415
0.7861	305	0.1377	-	-	-	-
0.7990	310	0.1368	-	-	-	-
0.8119	315	0.0966	-	-	-	-
0.8247	320	0.1114	-	-	-	-
0.8376	325	0.1127	-	-	-	-
0.8505	330	0.0952	-	-	-	-
0.8634	335	0.0925	-	-	-	-
0.8763	340	0.0973	-	-	-	-
0.8892	345	0.1048	-	-	-	-
0.9021	350	0.0978	0.0787	0.5249	0.5593	0.5421
0.9149	355	0.1331	-	-	-	-
0.9278	360	0.1218	-	-	-	-
0.9407	365	0.1315	-	-	-	-
0.9536	370	0.1098	-	-	-	-
0.9665	375	0.1051	-	-	-	-
0.9794	380	0.1035	-	-	-	-
0.9923	385	0.0946	-	-	-	-
-1	-1	-	-	0.5258	0.5697	0.5478

Environmental Impact

Carbon emissions were measured using CodeCarbon.

• Energy Consumed: 0.307 kWh
• Carbon Emitted: 0.119 kg of CO2
• Hours Used: 0.791 hours

Training Hardware

• On Cloud: No
• GPU Model: 1 x NVIDIA GeForce RTX 3090
• CPU Model: 13th Gen Intel(R) Core(TM) i7-13700K
• RAM Size: 31.78 GB

Framework Versions

• Python: 3.11.6
• Sentence Transformers: 4.2.0.dev0
• Transformers: 4.52.4
• PyTorch: 2.7.1+cu126
• Accelerate: 1.5.1
• Datasets: 2.21.0
• Tokenizers: 0.21.1

Citation

BibTeX

Sentence Transformers

@inproceedings{reimers-2019-sentence-bert,
    title = "Sentence-BERT: Sentence Embeddings using Siamese BERT-Networks",
    author = "Reimers, Nils and Gurevych, Iryna",
    booktitle = "Proceedings of the 2019 Conference on Empirical Methods in Natural Language Processing",
    month = "11",
    year = "2019",
    publisher = "Association for Computational Linguistics",
    url = "https://arxiv.org/abs/1908.10084",
}

CachedMultipleNegativesRankingLoss

@misc{gao2021scaling,
    title={Scaling Deep Contrastive Learning Batch Size under Memory Limited Setup},
    author={Luyu Gao and Yunyi Zhang and Jiawei Han and Jamie Callan},
    year={2021},
    eprint={2101.06983},
    archivePrefix={arXiv},
    primaryClass={cs.LG}
}