Struct Mamba3DoubleSsdCache 

pub struct Mamba3DoubleSsdCache {
    pub ssm_bhpr: Tensor<4>,
    pub k_state_bmhr: Tensor<4>,
    pub v_state_bhp: Tensor<3>,
    pub rotation: RotationState,
}

The mutable state carried between decoding steps for a single Mamba-3 layer.

All tensors are updated at every call to crate::mamba3::mamba3::Mamba3::step.

Fields

ssm_bhpr: Tensor<4>

SSM hidden state hₜ.

Updated via the (double-ssd) trapezoidal recurrence: hₜ = αₜ hₜ₋₁ + βₜ (sumₘ Kₜ₋₁[m] ⊗ (Vₜ₋₁ * mimo_x[m])) + γₜ (sumₘ Bₜ[m] ⊗ (xₜ * mimo_x[m]))

Shape: [batch, nheads, per_head_dim, state_rank]

k_state_bmhr: Tensor<4>

Previous token’s B per mimo rank = Bₜ₋₁[m].

Used to reconstruct the β term: β * sum_r Bₜ₋₁[m] ⊗ (xₜ₋₁ * mimo_x[m]). For SISO (mimo_rank=1) this is shape [batch, 1, nheads, state_rank].

Shape: [batch, mimo_rank, nheads, state_rank]

v_state_bhp: Tensor<3>

Previous token’s x = xₜ₋₁.

Combined with k_state_bmhr and mimo_x to produce the β term.

Shape: [batch, nheads, per_head_dim]

rotation: RotationState

Cumulative data-dependent rotation up to the current position (RotationState): the abelian RoPE angle for Complex2D (each step cum_angleₜ = cum_angleₜ₋₁ + Δₜ · tanh(θₜ) · π), or the cumulative unit quaternion for Quaternion4D.

Starts at the identity for fresh sequences; continued across calls for streaming.

Implementations

impl Mamba3DoubleSsdCache

pub fn sanity(&self)

Run the NaN/Inf guards on every cached tensor.

Trait Implementations

impl AutodiffModule for Mamba3DoubleSsdCache

fn valid(&self) -> Self

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

fn from_inner(module: Self) -> Self

Wraps an inner module back into an auto-diff module.

impl Clone for Mamba3DoubleSsdCache

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mamba3DoubleSsdCache

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

Formats the value using the given formatter.

impl Display for Mamba3DoubleSsdCache

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

Formats the value using the given formatter.

impl From<Mamba3DoubleSsdCache> for Mamba3Cache

fn from(cache: Mamba3DoubleSsdCache) -> Self

Converts to this type from the input type.

impl From<Mamba3DoubleSsdCache> for Mamba3SingleSsdCache

fn from(cache: Mamba3DoubleSsdCache) -> Self

Converts to this type from the input type.

impl From<Mamba3SingleSsdCache> for Mamba3DoubleSsdCache

fn from(cache: Mamba3SingleSsdCache) -> Self

Converts to this type from the input type.

impl Module for Mamba3DoubleSsdCache

fn num_params(&self) -> usize

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

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

Visit each tensor parameter in the module with a visitor.

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

Map each tensor parameter in the module with a mapper.

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

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

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

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

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

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

fn devices(&self) -> Vec<Device>

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 freeze_group(self, group: ParamGroup) -> Self

Set require_grad to false for every parameter in the given group, leaving the rest of the module untouched.

fn unfreeze_group(self, group: ParamGroup) -> Self

Set require_grad to true for every parameter in the given group, leaving the rest of the module untouched.

fn train(self) -> Self

where Self: AutodiffModule,

Move the module and all of its sub-modules to the autodiff backend.

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

Quantize the weights of the module.

fn quantize_weights_group( self, quantizer: &mut Quantizer, group: ParamGroup, ) -> Self

Quantize the weights of the given parameter group.

fn apply_reparameterization<R>(self, reparameterizer: R) -> Self

where Self: Sized, R: Reparameterizer,

Attach reparameterizations using the given [Reparameterizer].

fn apply_lora(self, lora: Lora) -> Self

where Self: Sized,

Attach LoRA adapters to the module’s 2-D weights, freezing the base weights.

fn apply_qlora(self, qlora: QLora) -> Self

where Self: Sized,

Apply QLoRA to the module: quantize the (frozen) base weights and attach trainable LoRA adapters to 2-D weights.

fn into_record(self) -> ModuleRecord

where Self: Sized,

Collect this module’s parameters into a ModuleRecord.

fn into_record_group(self, group: ParamGroup) -> ModuleRecord

where Self: Sized,

Collect the parameters group names into a ModuleRecord.

fn try_load_record(self, record: ModuleRecord) -> Result<Self, RecordError>

where Self: Sized,

Apply a ModuleRecord to this module, returning the loaded module.

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

where Self: Sized,

Apply a ModuleRecord to this module, consuming and returning it.

fn save_file<P>(self, path: P) -> Result<(), RecordError>

where P: AsRef<Path>, Self: Sized,

Save this module’s parameters to a burnpack file on disk.

fn load_file<P>(self, path: P) -> Self

where P: AsRef<Path>, Self: Sized,

Load this module’s parameters from a burnpack file on disk, returning the loaded module.

fn try_load_file<P>(self, path: P) -> Result<Self, RecordError>

where P: AsRef<Path>, Self: Sized,

Fallible variant of load_file.

impl ModuleDisplay for Mamba3DoubleSsdCache

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

Formats the module with provided display settings.

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.

impl ModuleDisplayDefault for Mamba3DoubleSsdCache

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.