Skip to main content

Mamba2SsdPath

Enum Mamba2SsdPath 

Source
pub enum Mamba2SsdPath {
    Minimal(Option<usize>),
    Serial(Option<usize>),
    SerialRecalculated(Option<usize>),
}
Expand description

Algorithm selection for the Mamba-2 chunkwise SSD.

Each variant carries an optional chunk length. Larger values increase the intra-chunk GEMM work and reduce the inter-chunk scan length; the optimal value is approximately √(state_rank · per_head_dim) (see Self::optimal_chunk_len). None falls back to that optimal value.

Variants§

§

Minimal(Option<usize>)

Minimal SSD: mostly batched matmuls; backward via autodiff.

See Mamba2SsdInput::ssd_minimal. For training, prefer Self::SerialRecalculated.

Based on /mamba_ssm/modules/ssd_minimal.py from the state-spaces/mamba github reference.

§

Serial(Option<usize>)

(Hybrid) serial SSD: a serial loop over the chunks plus batched matmuls; backward via autodiff.

See Mamba2SsdInput::ssd_serial. For a memory-saving custom backward, see Self::SerialRecalculated.

Based on 5 kernels under /mamba_ssm/ops/triton/ from the state-spaces/mamba github reference:

  • ssd_chunk_state.py (K1, K3).
  • ssd_bmm.py (K2).
  • ssd_state_passing.py (K4).
  • ssd_chunk_scan.py (K5).
§

SerialRecalculated(Option<usize>)

(Hybrid) serial SSD with a custom, memory-efficient backward that recomputes the forward intermediates instead of storing them.

See Mamba2SsdInput::ssd_serial_recalculated. For a plain autodiff backward, see Self::Serial.

Based on the combined kernel /mamba_ssm/ops/triton/ssd_combined.py from the state-spaces/mamba github reference.

Implementations§

Source§

impl Mamba2SsdPath

Source

pub fn optimal_chunk_len(state_rank: usize, per_head_dim: usize) -> usize

Optimal chunk length, approximately √(state_rank · per_head_dim), rounded up to a multiple of 32 and capped at 512.

Source

pub fn chunk_len(&self) -> Option<usize>

The chunk length carried by this variant, if any.

Source

pub fn chunk_len_or_optimal( &self, state_rank: usize, per_head_dim: usize, ) -> usize

The chunk length carried by this variant, or Self::optimal_chunk_len when unset.

Source

pub fn default_optimal_from_block<B: Backend>(block: &Mamba2) -> Self

The recommended default path for a given block: Self::SerialRecalculated with Self::optimal_chunk_len for the block’s dimensions.

Trait Implementations§

Source§

impl Clone for Mamba2SsdPath

Source§

fn clone(&self) -> Mamba2SsdPath

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Mamba2SsdPath

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Mamba2SsdPath

Source§

fn default() -> Mamba2SsdPath

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.