Skip to content

mynlp/pnmt

Repository files navigation

Pretrain-OpenNMT-py (PNMT): Open-Source Neural Machine Translation with Pre-train support and research friendly feature

This repository is an extension from OpenNMT-py which supports the pre-train model including BERT model or other pre-trained models. The target of this repository is to make OpenNMT a more research friendly project that support pre-train model, auto evaluation and find the best checkpoint on the test set. Before you use this package, you should refer to OpenNMT for basic usage as this repository is build on OpenNMT.

However, as this is an independent extension for OpenNMT, so I may not be able to always keep updated with OpenNMT's new release, but I will try my best. If any new feature of OpenNMT does not work in here, you should use OpenNMT instead, but if you think it is a bug in the repository, please raise an issue.

Completed Features:

Notice

The repository in now in constantly quick developing, the code might reformat in a new way in any possible new commit before a official release is announced, so please understand that your code based on this reposiotry may not always work with your previous codes, but we will keep the compatability as much as possible.

BERT as Embedding

In this feature, BERT works as an embedding layer that provide word embedding given a token. Therefore the BERT is not the encoder at this feature, the RNN or any other model supported by OpenNMT can be chosen to be the encoder.

BERT as Encoder

In this feature, BERT works an the encoder which makes it a BERT2Seq model.

Installation

This package is not available in pip as most of the code is still experimental so you should install it from source, we will upload it to the PyPi after more features are added, but at this moment, you should install it from source.

git clone https://github.com/mynlp/pnmt
cd pnmt
pip install -e .

Note: if you encounter a MemoryError during installation, try to use pip with --no-cache-dir. For other installation details, please refer to OpenNMT.

Example

BERT as Embeeding

Before you get to use Pre-train-OpenNMT, as indicated above, you should refer to OpenNMT for basic usage, the use of this repository depends on the OpenNMT, so it would be better if you are familiar with it. To use bert as embedding model, you only need to specify the embeddings_type argument in the YAML file, for example:

save_data: examples/data/example
src_vocab: examples/vocab/example.vocab.src
tgt_vocab: examples/vocab/example.vocab.tgt
overwrite: True
# Corpus opts:
data:
    corpus_1:
        path_src: examples/data/train_src.txt
        path_tgt: examples/data/train_tgt.txt
    valid:
        path_src: examples/data/valid_src.txt
        path_tgt: examples/data/valid_tgt.txt
save_model: examples/run/model
save_checkpoint_steps: 10000
train_steps: 100
valid_steps: 5
embeddings_type: bert-base-uncased
use_pre_trained_model_for_embedding: True
word_vec_size: 768
rnn_size: 384
copy_attn: True

After this YAML file is built, instead of running onmt_train -config xxx.yaml, you should use pnmt_train -config xxx.yaml instead, then you should be able to see the log ouput shows that the generation of bert embedding for both src vocab and tgt vocabulary.

In this example, you specify the embeddings_type as the bert-base-uncased and the word vector size is 768, the Pre-train-OpenNMT will autromatically load the tokenizer and model of bert-base-uncased based on the transformers package.

Then, it will generate the word embedding for both of your src and tgt vocabulary, then the pre-train model and the tokenizer will be deleted after the generation to save cuda memeory as the bert only works as embedding not encoder. Basically, Pre-train-OpenNMT works seamlessly with OpenNMT.

Since the whole bert family is supported, you could also specify bert-large-uncased or bert-base-cased or any other bert version supported by transformers package.

The dafult embedding for each word is the embedding of [CLS] token which is the embedding representation of that word.

BERT as Encoder

save_data: examples/data/example
src_vocab: examples/vocab/example.vocab.src
tgt_vocab: examples/vocab/example.vocab.tgt
overwrite: True
# Corpus opts:
data:
    corpus_1:
        path_src: examples/data/train_src.txt
        path_tgt: examples/data/train_tgt.txt
    valid:
        path_src: examples/data/valid_src.txt
        path_tgt: examples/data/valid_tgt.txt
save_model: examples/run/model
save_checkpoint_steps: 10000
train_steps: 100
valid_steps: 5
report_every: 5
encoder_type: pre_train_encoder
pre_train_encoder_type: bert-base-uncased
use_pre_trained_model_for_encoder: True
learning_rate_for_pretrained: 1e-5
learning_rate: 1e-3
word_vec_size: 768
rnn_size: 768
copy_attn: Ture

In this feature, the BERT works as the encoder so the model becomes the BERT2Seq where the decoder is LSTM by default, you could specify other possible models.

Different from a normal training configuration, you should specify a learning_rate_for_pretrained argument, this argument sets the learning rate for the pre-trained model which uses AdamW optimizer by default. The normal learning_rate will be used to as the learning rate for the RNN decoder.

To notify, you should keep the rnn_size same with the BERT embedding size which is 768 for bert-base-uncased model, future feature will support a linear transform from bert embedding size to any rnn size, but for now, you can only use the size same with BERT embedding size.

copy_attn means the copy attention, the feature can copy tokens from the source input to the generation. You could enable copy_attn by setting it to true, but to notify in advance, as the bert tokenizer uses subword tokenization, a whole word is tokenized into combination of subwords, the copy generator is only able to copy these subwords and is not able to copy a whole word, therefore if there are many complex words in you training data, you might need to use copy_attn carefully as it might copy subwords.

Train BERT2Seq with Transformer Learning Rate Scheduler

save_data: examples/data/example
src_vocab: examples/vocab/example.vocab.src
tgt_vocab: examples/vocab/example.vocab.tgt
overwrite: True
# Corpus opts:
data:
    corpus_1:
        path_src: examples/data/train_src.txt
        path_tgt: examples/data/train_tgt.txt
    valid:
        path_src: examples/data/valid_src.txt
        path_tgt: examples/data/valid_tgt.txt
save_model: examples/run/model
save_checkpoint_steps: 10000
train_steps: 100
valid_steps: 5
report_every: 5
encoder_type: pre_train_encoder
pre_train_encoder_type: bert-base-uncased
use_pre_trained_model_for_encoder: True
learning_rate_for_pretrained: 1e-5
learning_rate_scheduler: linear
#warm_up_ratio: 0.1
learning_rate: 1e-3
word_vec_size: 768
rnn_size: 768
copy_attn: Ture

You could also train the BERT with a learning rate scheduler by specifying linear in the learning_rate_scheduler, the default warm_up_ratio is 0.1 even if you don't specify it, but you can change it to other possible parameters.

We will add other possible learning rate scheduler provided by transformers package in futurue, but we only support linear at this moment.

Using PNMT as ONMT

Since we only add features to the OpenNMT and most of the code framework remains the same. Therefore, all features of ONMT are supported. In order to use like onmt, you just need to replace onmt with pnmt and use it like onmt, if it does not give an expected result, please raise an issue.

To do features:

BERT2Seq with Copy Mechanism (Done)

We support BERT2Seq with Copy Mechanism Now!

Translator (Processing)

Working on the support to make the translator avaialble, current model only supports the traning but the evaluation is not supported yet.

Traning From Checkpoint

This includes training from a BERT or other checkpoint, as the original ONMT only load checkpoint for RNN model, so we have to modify this part of code if we want to make loading checkpoint supported in PNMT.

Learning Rate Scheduler (Done)

Add BERT Learning Rate Scheduler for PNMT.

Generation Pre-trained Model

This include pre-trained models like T5 or other possible generation pre-trained models.

Parrallel Training and Inference

This feature is mainly to be research friendlym, the target is to split the test and training and then automatically find the best checkpoint.

Known Issue

There are several issues in the repository.

Possible Bugs in Training

The model's performance limit reaches 90% and stops training, stilling figuring the problem but time is limited for now.

Others

This project will be organized and re-publish as another package since OpenNMT does not consider to include pre-trained models.

Feel free to send a PR or feature request, I will reply at my best.