XLSROptions

Options & Configuration · AiDotNet.SpeechRecognition.Multilingual

Options for XLS-R: cross-lingual speech representation at scale.

Inheritance: ModelOptions → XLSROptions

For Beginners

These options configure the XLSR model. The model listens to the raw audio waveform (not a spectrogram) and outputs one character distribution per 20 ms frame.

How It Works

XLS-R (Babu et al. 2022) is the wav2vec 2.0 LARGE architecture pre-trained on 436K hours in 128 languages: the 7-layer convolutional feature encoder over raw 16 kHz audio with layer norm, the convolutional positional embedding, and a stable (pre-norm) Transformer, fine-tuned with a CTC head. The defaults are the released facebook/wav2vec2-xls-r-300m configuration.

Constructors

Constructor Summary
XLSROptions() Initializes a new instance with default values.
XLSROptions(XLSROptions other) Initializes a new instance by copying from another instance.

Properties

Property Summary
OnnxModelOptions OnnxOptions { get; set; } ONNX runtime options for the ONNX constructor.
bool FreezeFeatureEncoder { get; set; } Whether fine-tuning keeps the convolutional feature encoder frozen.
double ActivationDropout { get; set; } Dropout inside each feed-forward block.
double DropoutRate { get; set; } Dropout on the Transformer’s hidden states and attention weights.
double FeatureProjectionDropout { get; set; } Dropout after the feature projection.
double FinalDropout { get; set; } Dropout before the CTC head.
double LayerDrop { get; set; } Probability of skipping each Transformer layer during training.
double MaskTimeProbability { get; set; } SpecAugment time-mask probability during training.
int EncoderDim { get; set; } Transformer width (hidden size).
int FeedForwardDim { get; set; } Feed-forward width of each Transformer layer.
int MaxAudioLengthSeconds { get; set; } Longest audio, in seconds, a transcription reads; longer input is truncated.
int MaxTextLength { get; set; } Most tokens a transcription emits.
int NumAttentionHeads { get; set; } Attention heads per layer.
int NumEncoderLayers { get; set; } Number of Transformer layers.
int PositionalConvGroups { get; set; } Groups of the convolutional positional embedding.
int SampleRate { get; set; } Audio sample rate in Hz.
int VocabSize { get; set; } CTC vocabulary size, blank (token 0) included; tokens above 0 decode as Unicode code points.
string Language { get; set; } Language reported for a transcription when none is given.
string ModelPath { get; set; } Path of an exported ONNX model, for the ONNX constructor.