Struct VsaConfigSchema 

pub struct VsaConfigSchema {
    pub dimension: usize,
    pub density: f64,
    pub scaling: Option<SparsityScaling>,
    pub auto_thin: Option<usize>,
    pub min_nnz: Option<usize>,
    pub max_nnz: Option<usize>,
    pub target_accuracy: Option<f64>,
}

User-provided schema for custom VSA configuration

This allows users to specify their own parameters for specialized use cases without needing to understand the internal scaling formulas.

Example

use embeddenator_vsa::{VsaConfig, VsaConfigSchema, SparsityScaling};

// Custom schema for a specific application
let schema = VsaConfigSchema {
    dimension: 8192,
    density: 0.015,
    scaling: Some(SparsityScaling::SquareRoot),
    auto_thin: Some(1000),
    min_nnz: Some(16),
    max_nnz: Some(512),
    target_accuracy: Some(0.97),
};

let config = VsaConfig::from_schema(schema);
assert_eq!(config.dimension, 8192);

Fields

dimension: usize

Required: Number of dimensions

density: f64

Required: Target density (0.0-1.0)

scaling: Option<SparsityScaling>

Optional: Sparsity scaling mode

auto_thin: Option<usize>

Optional: Auto-thinning threshold (0 to disable)

min_nnz: Option<usize>

Optional: Minimum non-zero elements

max_nnz: Option<usize>

Optional: Maximum non-zero elements

target_accuracy: Option<f64>

Optional: Target reconstruction accuracy

Implementations

impl VsaConfigSchema

pub fn new(dimension: usize, density: f64) -> VsaConfigSchema

Create a minimal schema with just dimension and density

pub fn with_scaling(self, mode: SparsityScaling) -> VsaConfigSchema

Set scaling mode

pub fn with_auto_thin(self, threshold: usize) -> VsaConfigSchema

Set auto-thin threshold

pub fn from_json(json: &str) -> Result<VsaConfigSchema, Error>

Parse from JSON string

pub fn to_json(&self) -> Result<String, Error>

Serialize to JSON string

Trait Implementations

impl Clone for VsaConfigSchema

fn clone(&self) -> VsaConfigSchema

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VsaConfigSchema

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VsaConfigSchema

fn deserialize<__D>( __deserializer: __D, ) -> Result<VsaConfigSchema, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for VsaConfigSchema

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

where __S: Serializer,

Serialize this value into the given Serde serializer.