Struct burn_core::nn::RotaryEncoding

pub struct RotaryEncoding<B: Backend> {
    pub freq_complex: Tensor<B, 3>,
    pub max_sequence_length: usize,
    pub theta: f32,
}

A module that applies rotary positional encoding to a tensor. Rotary Position Encoding or Embedding (RoPE), is a type of position embedding which encodes absolute positional information with rotation matrix and naturally incorporates explicit relative position dependency in self-attention formulation.

Introduced in the paper: RoFormer: Enhanced Transformer with Rotary Position Embedding

Should be created using RotaryEncodingConfig.

Fields

freq_complex: Tensor<B, 3>

Frequency Tensor of shape (max_sequence_length, d_model, 2) with real and imaginary components

max_sequence_length: usize

Maximum sequence length of input

theta: f32

Scaling factor for frequency computation.

Implementations

impl<B: Backend> RotaryEncoding<B>

pub fn forward<const D: usize>(&self, x: Tensor<B, D>) -> Tensor<B, D>

Applies rotary positional encoding to a tensor of dimensions (…, seq_len, d_model)

Arguments:

• x - Input tensor of shape (…, seq_len, d_model). Accommodate both 3D and 4D tensors for (batch size, seq_len, hidden_dim) or (batch size, num_heads, seq_len, hidden_dim) respectively.

Returns:

• Output tensor with the same shape as input tensor after applying rotary encoding.

Panics if the input tensor does not have at least 2 dimensions for sequence length and hidden dimension.

pub fn apply<const D: usize>( &self, x: Tensor<B, D>, start: usize, ) -> Tensor<B, D>

Applies rotary positional encoding to a tensor of dimensions (…, seq_len, d_model)

Arguments:

• x - Input tensor of shape (…, seq_len, d_model). Accommodate both 3D and 4D tensors for (batch size, seq_len, hidden_dim) or (batch size, num_heads, seq_len, hidden_dim) respectively.
• start - Sequence start position index.

Returns:

• Output tensor with the same shape as input tensor after applying rotary encoding.

Panics if the input tensor does not have at least 2 dimensions for sequence length and hidden dimension.

Trait Implementations

impl<B> AutodiffModule<B> for RotaryEncoding<B>

where B: AutodiffBackend + Backend, <B as AutodiffBackend>::InnerBackend: Backend,

type InnerModule = RotaryEncoding<<B as AutodiffBackend>::InnerBackend>

Inner module without auto-differentiation.

fn valid(&self) -> Self::InnerModule

Get the same module, but on the inner backend without auto-differentiation.

impl<B: Backend> Clone for RotaryEncoding<B>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<B: Debug + Backend> Debug for RotaryEncoding<B>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<B: Backend> Display for RotaryEncoding<B>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<B: Backend> Module<B> for RotaryEncoding<B>

type Record = RotaryEncodingRecord<B>

Type to save and load the module.

fn load_record(self, record: Self::Record) -> Self

Load the module state from a record.

fn into_record(self) -> Self::Record

Convert the module into a record containing the state.

fn num_params(&self) -> usize

Get the number of parameters the module has, including all of its sub-modules.

fn visit<Visitor: ModuleVisitor<B>>(&self, visitor: &mut Visitor)

Visit each tensor parameter in the module with a visitor.

fn map<Mapper: ModuleMapper<B>>(self, mapper: &mut Mapper) -> Self

Map each tensor parameter in the module with a mapper.

fn collect_devices(&self, devices: Devices<B>) -> Devices<B>

Return all the devices found in the underneath module tree added to the given vector without duplicates.

fn to_device(self, device: &B::Device) -> Self

Move the module and all of its sub-modules to the given device.

fn fork(self, device: &B::Device) -> Self

Fork the module and all of its sub-modules to the given device.

fn devices(&self) -> Devices<B>

Return all the devices found in the underneath module tree without duplicates.

fn no_grad(self) -> Self

Each tensor in the module tree will not require grad.

fn save_file<FR, PB>( self, file_path: PB, recorder: &FR, ) -> Result<(), RecorderError>

where FR: FileRecorder<B>, PB: Into<PathBuf>,

Save the module to a file using the provided file recorder.

fn load_file<FR, PB>( self, file_path: PB, recorder: &FR, device: &B::Device, ) -> Result<Self, RecorderError>

where FR: FileRecorder<B>, PB: Into<PathBuf>,

Load the module from a file using the provided file recorder.

fn quantize_weights<C: Calibration>(self, quantizer: &mut Quantizer<C>) -> Self

Quantize the weights of the module.

impl<B: Backend> ModuleDisplay for RotaryEncoding<B>

fn custom_settings(&self) -> Option<DisplaySettings>

Custom display settings for the module.

fn custom_content(&self, content: Content) -> Option<Content>

Custom attributes for the module.

fn format(&self, passed_settings: DisplaySettings) -> String

Formats the module with provided display settings.

impl<B: Backend> ModuleDisplayDefault for RotaryEncoding<B>

fn content(&self, content: Content) -> Option<Content>

Attributes of the module used for display purposes.

fn num_params(&self) -> usize

Gets the number of the parameters of the module.