[][src]Module rust_bert::albert

ALBERT: A Lite BERT for Self-supervised Learning of Language Representations (Lan et al.)

Implementation of the ALBERT language model (https://arxiv.org/abs/1909.11942 Lan, Chen, Goodman, Gimpel, Sharma, Soricut, 2019). This model offers a greatly reduced memory footprint for similar effective size (number and size of layers). The computational cost remains however similar to the original BERT model. The base model is implemented in the albert::AlbertModel struct. Several language model heads have also been implemented, including:

  • Masked language model: albert::AlbertForMaskedLM
  • Multiple choices: albert:AlbertForMultipleChoice
  • Question answering: albert::AlbertForQuestionAnswering
  • Sequence classification: albert::AlbertForSequenceClassification
  • Token classification (e.g. NER, POS tagging): albert::AlbertForTokenClassification

Model set-up and pre-trained weights loading

A full working example is provided in examples/albert.rs, run with cargo run --example albert. The example below illustrate a Masked language model example, the structure is similar for other models. All models expect the following resources:

  • Configuration file expected to have a structure following the Transformers library
  • Model weights are expected to have a structure and parameter names following the Transformers library. A conversion using the Python utility scripts is required to convert the .bin weights to the .ot format.
  • BertTokenizer using a vocab.txt vocabulary Pretrained models are available and can be downloaded using RemoteResources.
use rust_tokenizers::AlbertTokenizer;
use tch::{nn, Device};
use rust_bert::albert::{AlbertConfig, AlbertForMaskedLM};
use rust_bert::resources::{download_resource, LocalResource, Resource};
use rust_bert::Config;

let config_resource = Resource::Local(LocalResource {
    local_path: PathBuf::from("path/to/config.json"),
});
let vocab_resource = Resource::Local(LocalResource {
    local_path: PathBuf::from("path/to/vocab.txt"),
});
let weights_resource = Resource::Local(LocalResource {
    local_path: PathBuf::from("path/to/model.ot"),
});
let config_path = download_resource(&config_resource)?;
let vocab_path = download_resource(&vocab_resource)?;
let weights_path = download_resource(&weights_resource)?;
let device = Device::cuda_if_available();
let mut vs = nn::VarStore::new(device);
let tokenizer: AlbertTokenizer =
    AlbertTokenizer::from_file(vocab_path.to_str().unwrap(), true, true);
let config = AlbertConfig::from_file(config_path);
let bert_model = AlbertForMaskedLM::new(&vs.root(), &config);
vs.load(weights_path)?;

Structs

AlbertConfig

ALBERT model configuration

AlbertConfigResources

ALBERT Pretrained model config files

AlbertForMaskedLM

ALBERT for masked language model

AlbertForMultipleChoice

ALBERT for multiple choices

AlbertForQuestionAnswering

ALBERT for question answering

AlbertForSequenceClassification

ALBERT for sequence classification

AlbertForTokenClassification

ALBERT for token classification (e.g. NER, POS)

AlbertModel

ALBERT Base model

AlbertModelResources

ALBERT Pretrained model weight files

AlbertVocabResources

ALBERT Pretrained model vocab files