Mila::Data::BpeTrainer Class Reference

Corpus accumulator and trainer for BPE vocabularies. More...

Public Member Functions
	BpeTrainer (const BpeVocabularyConfig &config=BpeVocabularyConfig{})
	Construct with a vocabulary configuration.
void	addCorpusFromFile (const std::filesystem::path &path)
	Append corpus text from a file.
void	addCorpusFromStream (std::istream &stream)
	Append corpus text from a stream.
void	clearCorpus ()
const BpeVocabularyConfig &	getConfig () const
size_t	getCorpusSize () const
BpeVocabulary	train ()
	Train a BPE vocabulary on the accumulated corpus.

Detailed Description

Corpus accumulator and trainer for BPE vocabularies.

Typical usage:

BpeTrainer trainer( BpeVocabularyConfig()
    .withVocabSize( 32000 )
    .withByteLevel( true )
    .withPreTokenization( PreTokenizationMode::Gpt2Regex )
    .withPreTokenizationPattern( GPT2_PRETOKENIZATION_PATTERN ) );
 
trainer.addCorpusFromFile( "corpus.txt" );
BpeVocabulary vocab = trainer.train();
vocab.save( "my_vocab.bin" );

Constructor & Destructor Documentation

BpeTrainer()

Mila::Data::BpeTrainer::BpeTrainer ( const BpeVocabularyConfig & config = BpeVocabularyConfig{} )

inlineexplicit

Construct with a vocabulary configuration.

validate() is called immediately so misconfigured trainers fail at construction rather than at train() time.

Parameters

config

BPE vocabulary configuration.

Exceptions

std::invalid_argument

if config fails validation.

Member Function Documentation

addCorpusFromFile()

void Mila::Data::BpeTrainer::addCorpusFromFile ( const std::filesystem::path & path )

inline

Append corpus text from a file.

Parameters

path	Path to a UTF-8 text file.

Exceptions

std::runtime_error

if the file cannot be opened.

addCorpusFromStream()

void Mila::Data::BpeTrainer::addCorpusFromStream ( std::istream & stream )

inline

Append corpus text from a stream.

May be called multiple times to accumulate text from different sources before a single train() call.

Parameters

stream

Input stream containing UTF-8 text.

train()

BpeVocabulary Mila::Data::BpeTrainer::train ( )

inline

Train a BPE vocabulary on the accumulated corpus.

Delegates to BpeVocabulary::train() and clears the accumulated corpus afterwards to release memory. The returned vocabulary can be saved via BpeVocabulary::save() and later reloaded with BpeVocabulary::load().

Returns

Trained BpeVocabulary instance.

Exceptions

std::runtime_error

if no corpus has been accumulated.

---

The documentation for this class was generated from the following file:

• Mila/Src/Data/Tokenizers/Bpe/BpeTrainer.ixx