The model maps sentences & paragraphs to a 768 dimensional dense vector space. This vector can be used for tasks like clustering and semantic search. Below we give some examples on how to use the model. The easiest way is to simply measure the cosine distance between two sentences. Sentences that are close to each other in meaning, will have a small cosine distance and a similarity close to 1. The model is trained in such a way that similar sentences in different languages should also be close to each other. Ideally, an English-Norwegian sentence pair should have high similarity.
Embeddings and Sentence Similarity (Sentence-Transformers)
As seen above, using the library sentence-transformers makes the use of these models quite convenient:
pip install -U sentence-transformers
Then you can use the model like this:
python
1from sentence_transformers import SentenceTransformer, util
2sentences =["This is a Norwegian boy","Dette er en norsk gutt"]34model = SentenceTransformer('NbAiLab/nb-sbert-base')5embeddings = model.encode(sentences)6print(embeddings)78# Compute cosine-similarities with sentence transformers9cosine_scores = util.cos_sim(embeddings[0],embeddings[1])10print(cosine_scores)1112# Compute cosine-similarities with SciPy13from scipy import spatial
14scipy_cosine_scores =1- spatial.distance.cosine(embeddings[0],embeddings[1])15print(scipy_cosine_scores)1617# Both should give 0.8250 in the example above.18
Embeddings and Sentence Similarity (HuggingFace Transformers)
Without sentence-transformers, you can still use the model. First, you pass in your input through the transformer model, then you have to apply the right pooling-operation on top of the contextualized word embeddings.
python
1from transformers import AutoTokenizer, AutoModel
2import torch
345#Mean Pooling - Take attention mask into account for correct averaging6defmean_pooling(model_output, attention_mask):7 token_embeddings = model_output[0]#First element of model_output contains all token embeddings8 input_mask_expanded = attention_mask.unsqueeze(-1).expand(token_embeddings.size()).float()9return torch.sum(token_embeddings * input_mask_expanded,1)/ torch.clamp(input_mask_expanded.sum(1),min=1e-9)101112# Sentences we want sentence embeddings for13sentences =["This is a Norwegian boy","Dette er en norsk gutt"]1415# Load model from HuggingFace Hub16tokenizer = AutoTokenizer.from_pretrained('NbAiLab/nb-sbert-base')17model = AutoModel.from_pretrained('NbAiLab/nb-sbert-base')1819# Tokenize sentences20encoded_input = tokenizer(sentences, padding=True, truncation=True, return_tensors='pt')2122# Compute token embeddings23with torch.no_grad():24 model_output = model(**encoded_input)2526# Perform pooling. In this case, mean pooling.27embeddings = mean_pooling(model_output, encoded_input['attention_mask'])2829print(embeddings)3031# Compute cosine-similarities with SciPy32from scipy import spatial
33scipy_cosine_scores =1- spatial.distance.cosine(embeddings[0],embeddings[1])34print(scipy_cosine_scores)3536# This should give 0.8250 in the example above.37
SetFit - Few Shot Classification
SetFit is a method for using sentence-transformers to solve one of major problem that all NLP researchers are facing: Too few labeled training examples. The 'nb-sbert-base' can be plugged directly into the SetFit library. Please see this tutorial for how to use this technique.
Keyword Extraction
The model can be used for extracting keywords from text. The basic technique is to find the words that are most similar to the document. There are various frameworks for doing this. An easy way is to use KeyBERT. This example shows how this can be done.
pip install keybert
python
1from keybert import KeyBERT
2from sentence_transformers import SentenceTransformer
3sentence_model = SentenceTransformer("NbAiLab/nb-sbert-base")4kw_model = KeyBERT(model=sentence_model)56doc ="""
7De første nasjonale bibliotek har sin opprinnelse i kongelige samlinger eller en annen framstående myndighet eller statsoverhode.
8Et av de første planene for et nasjonalbibliotek i England ble fremmet av den walisiske matematikeren og mystikeren John Dee som
9i 1556 presenterte en visjonær plan om et nasjonalt bibliotek for gamle bøker, manuskripter og opptegnelser for dronning Maria I
10av England. Hans forslag ble ikke tatt til følge.
11"""12kw_model.extract_keywords(doc, stop_words=None)1314# [('nasjonalbibliotek', 0.5242), ('bibliotek', 0.4342), ('samlinger', 0.3334), ('statsoverhode', 0.33), ('manuskripter', 0.3061)]
The KeyBERT homepage provides other several interesting examples: combining KeyBERT with stop words, extracting longer phrases, or directly producing highlighted text.
Topic Modeling
To analyse a group of documents and determine the topics, has a lot of use cases. BERTopic combines the power of sentence transformers with c-TF-IDF to create clusters for easily interpretable topics.
It would take too much time to explain topic modeling here. Instead we recommend that you take a look at the link above, as well as the documentation. The main adaptation you would need to do to use the Norwegian nb-sbert-base, is to add the following:
Another common use case for a SentenceTransformers model is to find relevant documents or passages of documents given a certain query text. In this scenario, it is pretty common to have a vector database that stores the embedding vectors for all our documents. Then, at runtime, an embedding for the query text is generated and compared efficiently against the vector database.
While production vector databases exist, a quick way to experiment with them is by using autofaiss:
pip install autofaiss sentence-transformers
python
1from autofaiss import build_index
2import numpy as np
34from sentence_transformers import SentenceTransformer, util
5sentences =["This is a Norwegian boy","Dette er en norsk gutt","A red house"]67model = SentenceTransformer('NbAiLab/nb-sbert-base')8embeddings = model.encode(sentences)9index, index_infos = build_index(embeddings, save_on_disk=False)1011# Search for the closest matches12query = model.encode(["A young boy"])13_, index_matches = index.search(query,1)14print(index_matches)
Evaluation and Parameters
Evaluation
Evaluation results on the sts-test dataset:
Pearson
Spearman
Cosine Similarity
0.8275
0.8245
Manhattan Distance
0.8193
0.8182
Euclidean Distance
0.8190
0.8180
Dot Product Similarity
0.8039
0.7951
Training
The model was trained with the parameters:
DataLoader:
sentence_transformers.datasets.NoDuplicatesDataLoader.NoDuplicatesDataLoader of length 16471 with parameters:
{'batch_size': 32}
Loss:
sentence_transformers.losses.MultipleNegativesRankingLoss.MultipleNegativesRankingLoss with parameters:
The model was trained by Rolv-Arild Braaten and Per Egil Kummervold. Documentation written by Javier de la Rosa, Rov-Arild Braaten and Per Egil Kummervold.