Function random_sparse_vec 

pub fn random_sparse_vec(
    rng: &mut impl Rng,
    dims: usize,
    sparsity: usize,
) -> SparseVec

Generate a random sparse vector with specified dimensions and sparsity

Arguments

• rng - Random number generator
• dims - Total dimensions of the vector
• sparsity - Number of non-zero elements (split roughly evenly between pos/neg)

Example

use rand::thread_rng;
let mut rng = thread_rng();
let vec = random_sparse_vec(&mut rng, 10000, 200);
assert_eq!(vec.pos.len() + vec.neg.len(), 200);

Examples found in repository

examples/performance_metrics.rs (line 22)

fn main() {
    println!("=== Embeddenator TestKit - Performance Metrics ===\n");

    // Create test metrics
    let mut metrics = TestMetrics::new("example_operations");

    // Time a simple operation
    println!("1. Timing vector generation...");
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    for _ in 0..10 {
        metrics.time_operation(|| {
            let _vec = random_sparse_vec(&mut rng, 10000, 200);
        });
    }

    println!("   Completed 10 operations");
    let stats = metrics.timing_stats();
    println!("   Mean: {:.2}µs", stats.mean_ns / 1000.0);
    println!("   Median: {:.2}µs", stats.p50_ns as f64 / 1000.0);
    println!("   P95: {:.2}µs", stats.p95_ns as f64 / 1000.0);

    // Record custom metrics
    println!("\n2. Recording custom metrics...");
    metrics.record_metric("accuracy", 0.95);
    metrics.record_metric("precision", 0.92);
    metrics.record_metric("recall", 0.89);
    metrics.inc_op("validation_checks");

    // Record memory usage
    println!("\n3. Recording memory snapshots...");
    for i in 1..=5 {
        metrics.record_memory(i * 1024 * 1024); // Simulate growing memory usage
    }

    // Display full summary
    println!("\n4. Full metrics summary:");
    println!("{}", metrics.summary());

    // Test timing with actual work
    println!("\n5. Timing with simulated work...");
    let mut work_metrics = TestMetrics::new("simulated_work");

    for sleep_ms in [1, 2, 5, 10, 20] {
        work_metrics.time_operation(|| {
            thread::sleep(Duration::from_millis(sleep_ms));
        });
    }

    let work_stats = work_metrics.timing_stats();
    println!("   Operations: {}", work_stats.count);
    println!(
        "   Total time: {:.2}ms",
        work_stats.total_ns as f64 / 1_000_000.0
    );
    println!("   Throughput: {:.2} ops/sec", work_stats.ops_per_sec());

    println!("\n✅ Performance metrics example complete!");
}

examples/basic_generators.rs (line 16)

fn main() {
    println!("=== Embeddenator TestKit - Basic Generators ===\n");

    // Create a deterministic RNG for reproducibility
    let mut rng = rand::rngs::StdRng::seed_from_u64(42);

    // Generate random sparse vector
    println!("1. Generating random sparse vector...");
    let vec = random_sparse_vec(&mut rng, 10000, 200);
    println!(
        "   Created vector: dim={}, nnz={} (pos={}, neg={})",
        10000,
        vec.pos.len() + vec.neg.len(),
        vec.pos.len(),
        vec.neg.len()
    );

    // Generate deterministic sparse vector
    println!("\n2. Generating deterministic sparse vector...");
    let vec1 = deterministic_sparse_vec(10000, 200, 42);
    let vec2 = deterministic_sparse_vec(10000, 200, 42);
    println!(
        "   Vector 1: pos.len={}, neg.len={}",
        vec1.pos.len(),
        vec1.neg.len()
    );
    println!(
        "   Vector 2: pos.len={}, neg.len={}",
        vec2.pos.len(),
        vec2.neg.len()
    );
    println!(
        "   Determinism check: {}",
        vec1.pos == vec2.pos && vec1.neg == vec2.neg
    );

    // Test sparse dot product
    println!("\n3. Computing sparse dot product...");
    let a = deterministic_sparse_vec(10000, 100, 123);
    let b = deterministic_sparse_vec(10000, 100, 456);
    let dot_ab = sparse_dot(&a, &b);
    let dot_ba = sparse_dot(&b, &a);
    println!("   dot(a, b) = {}", dot_ab);
    println!("   dot(b, a) = {}", dot_ba);
    println!("   Symmetric: {}", dot_ab == dot_ba);

    // Generate noise pattern
    println!("\n4. Generating noise patterns...");
    let noise1 = generators::generate_noise_pattern(1024, 42);
    let noise2 = generators::generate_noise_pattern(1024, 42);
    println!("   Noise 1 length: {}", noise1.len());
    println!("   Noise 2 length: {}", noise2.len());
    println!("   Deterministic: {}", noise1 == noise2);

    // Generate gradient pattern
    println!("\n5. Generating gradient pattern...");
    let gradient = generators::generate_gradient_pattern(256, 256);
    println!("   Gradient size: {} bytes", gradient.len());
    println!("   First pixel: {}", gradient[0]);
    println!("   Center pixel: {}", gradient[gradient.len() / 2]);
    println!("   Last pixel: {}", gradient[gradient.len() - 1]);

    println!("\n✅ All generators working correctly!");
}