Struct TruenoNativeModel 

pub struct TruenoNativeModel {
    pub model_type: ModelType,
    pub n_params: u32,
    pub n_features: u32,
    pub n_outputs: u32,
    pub params: Option<AlignedVec<f32>>,
    pub bias: Option<AlignedVec<f32>>,
    pub extra: Option<ModelExtra>,
}

Model format optimized for Trueno SIMD operations (spec §5.2)

Memory layout guarantees:

• 64-byte alignment (AVX-512 compatible)
• Contiguous storage (no pointer chasing)
• Row-major ordering (matches Trueno convention)
• Padding to SIMD width boundaries

Example

use aprender::native::{TruenoNativeModel, AlignedVec, ModelExtra};
use aprender::format::ModelType;

let params = AlignedVec::from_slice(&[0.5, -0.3, 0.8, 0.2]);
let bias = AlignedVec::from_slice(&[1.0]);

let model = TruenoNativeModel::new(
    ModelType::LinearRegression,
    4,   // n_params
    4,   // n_features
    1,   // n_outputs
)
.with_params(params)
.with_bias(bias);

assert_eq!(model.n_params, 4);
assert!(model.is_aligned());

Fields

model_type: ModelType

Model type identifier

n_params: u32

Number of parameters

n_features: u32

Number of features expected in input

n_outputs: u32

Number of outputs (classes for classification, 1 for regression)

params: Option<AlignedVec<f32>>

Model parameters (64-byte aligned)

bias: Option<AlignedVec<f32>>

Bias terms (64-byte aligned)

extra: Option<ModelExtra>

Additional model-specific data

Implementations

impl TruenoNativeModel

pub const fn new( model_type: ModelType, n_params: u32, n_features: u32, n_outputs: u32, ) -> TruenoNativeModel

Create a new native model skeleton

pub fn with_params(self, params: AlignedVec<f32>) -> TruenoNativeModel

Set model parameters

pub fn with_bias(self, bias: AlignedVec<f32>) -> TruenoNativeModel

Set bias terms

pub fn with_extra(self, extra: ModelExtra) -> TruenoNativeModel

Set extra model data

pub fn is_aligned(&self) -> bool

Check if all buffers are properly aligned

pub fn size_bytes(&self) -> usize

Total size in bytes (including alignment padding)

pub fn validate(&self) -> Result<(), NativeModelError>

Validate model structure

pub fn params_ptr(&self) -> Option<*const f32>

Get raw pointer to parameters for SIMD operations

Safety

Caller must ensure the returned pointer is not used after the model is dropped.

pub fn bias_ptr(&self) -> Option<*const f32>

Get raw pointer to bias for SIMD operations

Safety

Caller must ensure the returned pointer is not used after the model is dropped.

pub fn predict_linear(&self, features: &[f32]) -> Result<f32, NativeModelError>

Predict for a single sample (linear models only)

Uses naive implementation for validation; production code should use Trueno SIMD operations.

Trait Implementations

impl Clone for TruenoNativeModel

fn clone(&self) -> TruenoNativeModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TruenoNativeModel

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

Formats the value using the given formatter.

impl Default for TruenoNativeModel

fn default() -> TruenoNativeModel

Returns the “default value” for a type.