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) -> Self

Create a minimal schema with just dimension and density

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

Set scaling mode

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

Set auto-thin threshold

pub fn from_json(json: &str) -> Result<Self, 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

Formats the value using the given formatter.

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

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::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::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.