Struct ContainerModel 

pub struct ContainerModel { /* private fields */ }

A bundle of pre-trained submodels selected by a quality threshold.

Each submodel covers values up to (but not including) its max_value. The last submodel is the fallback for values at or above the last threshold.

Architecture

This implements the official NAM SlimmableContainer architecture (registered since file version 0.7.0). It is the format used by the mainstream A2 distribution (nano + standard bundle).

Implementations

impl ContainerModel

pub fn new( submodels: Vec<(f32, Box<StaticModel>)>, sample_rate: u32, ) -> Result<Self>

Creates a new ContainerModel.

Requirements (enforced)

• submodels must be non-empty.
• Sorted by max_value ascending.
• Last max_value must be >= 1.0.

pub fn submodels(&self) -> &[(f32, Box<StaticModel>)]

Returns the list of (max_value, StaticModel ref) for diagnostics.

pub fn submodels_mut(&mut self) -> &mut [(f32, Box<StaticModel>)]

Mutable access to submodels (for testing purposes only).

pub fn active_index(&self) -> usize

Returns the index of the currently active submodel.

pub fn set_active_index(&mut self, idx: usize)

Sets the active submodel index directly, bypassing crossfade (testing only).

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

Returns the index of the pending submodel during crossfade, if any.

pub fn is_crossfading(&self) -> bool

Returns true if a crossfade is in progress.

pub fn sample_rate(&self) -> u32

Returns the sample rate used to validate submodels.

Trait Implementations

impl NamModel for ContainerModel

fn process(&mut self, input: &[f32], output: &mut [f32])

Invoked by the DSP RT-Thread to process acoustic sample blocks (Float32).

fn prewarm(&mut self, num_samples: usize)

“Heats up” the virtual tubes of the neural engine (prewarm).

fn reset(&mut self, sample_rate: u32, max_buffer_size: usize) -> Result<()>

Resets the model’s internal state with a new sample rate and max buffer size.

fn set_max_buffer_size(&mut self, max_buf: usize) -> Result<()>

Reallocates internal buffers to support the given maximum block size.

fn prewarm_samples(&self) -> usize

Returns the number of samples needed to fully stabilize the model’s internal state (receptive field / recurrent memory depth).

fn prewarm_on_reset(&self) -> bool

Returns whether prewarm should be executed on reset().

fn set_prewarm_on_reset(&mut self, val: bool)

Sets whether prewarm should be executed on reset().

fn slimmable_breakpoints(&self) -> Vec<f64>

Returns the breakpoints at which slimmable quality transitions occur.

impl SlimmableModel for ContainerModel

fn slimmable_breakpoints(&self) -> Vec<f64>

Returns the breakpoints at which slimmable quality transitions occur.

fn set_slimmable_size(&mut self, val: f32, rt_status: Option<&RtStatusFlags>)

Sets the slimmable quality/size level.