Struct ModelDef 

pub struct ModelDef {
    pub name: String,
    pub description: Option<String>,
    pub vocab_size: usize,
    pub max_seq_len: usize,
    pub hidden_size: usize,
    pub num_layers: usize,
    pub block: BlockDef,
    pub pattern: Option<Vec<BlockDef>>,
    pub embeddings: EmbeddingsConfig,
    pub output: OutputConfig,
}

Parsed model definition from MAL

Fields

name: String

description: Option<String>

vocab_size: usize

Number of token IDs exposed by the tokenizer and model API. Parameter storage is padded internally for efficient accelerator kernels.

max_seq_len: usize

hidden_size: usize

num_layers: usize

block: BlockDef

pattern: Option<Vec<BlockDef>>

Optional heterogeneous layer pattern, repeated cyclically across num_layers (e.g. [mamba, mamba, attn]). Overrides block when set.

embeddings: EmbeddingsConfig

output: OutputConfig

Implementations

impl ModelDef

pub fn block_for_layer(&self, i: usize) -> &BlockDef

Block definition for layer i: cycles through pattern when set, otherwise the homogeneous block.

pub fn dt_rank(&self, ssm: &SsmDef) -> usize

Effective Δ rank for an SSM mixer (paper default: ceil(hidden/16))

pub fn num_heads(&self) -> usize

Query-head count of the homogeneous/default block.

Pattern-aware callers should use Self::block_for_layer and BlockDef::num_heads instead.

pub fn num_kv_heads(&self) -> usize

Key/value-head count of the homogeneous/default block.

Pattern-aware callers should use Self::block_for_layer and BlockDef::num_kv_heads instead.

pub fn head_dim(&self) -> usize

Attention-head width of the homogeneous/default block.

Pattern-aware callers should use Self::block_for_layer and BlockDef::head_dim instead.

pub fn intermediate_size(&self) -> usize

FFN width of the homogeneous/default block.

Pattern-aware callers should use Self::block_for_layer and BlockDef::intermediate_size instead.

pub fn norm_eps(&self) -> f64

Normalization epsilon of the homogeneous/default block.

Pattern-aware callers should use Self::block_for_layer and BlockDef::norm_eps instead.

pub fn rope_theta(&self) -> f64

RoPE theta of the homogeneous/default block.

Pattern-aware callers should use Self::block_for_layer and BlockDef::rope_theta instead.

pub fn padded_vocab_size(&self) -> usize

Vocabulary rows stored by embeddings and the output projection.

Keeping this derived preserves a single logical vocabulary in MAL and checkpoint configs while giving GPU kernels an aligned output dimension.

pub fn estimated_params(&self) -> usize

Count trainable parameters implied by the model definition.

pub fn from_json<P: AsRef<Path>>(path: P) -> Result<Self>

Load from JSON file

pub fn save_json(&self, path: &str) -> Result<()>

Save to JSON file

Trait Implementations

impl Clone for ModelDef

fn clone(&self) -> ModelDef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelDef

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

Formats the value using the given formatter.

impl Default for ModelDef

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ModelDef

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ModelDef

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

Formats the value using the given formatter.

impl Serialize for ModelDef

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.