deep_causality_multivector 0.5.2

Multivector and MultiField implementation for DeepCausality
Documentation
/*
 * SPDX-License-Identifier: MIT
 * Copyright (c) 2023 - 2026. The DeepCausality Authors and Contributors. All Rights Reserved.
 */

use criterion::{Criterion, criterion_group, criterion_main};
use deep_causality_metric::Metric;
use deep_causality_multivector::{CausalMultiField, CausalMultiVector};
use std::hint::black_box;

fn bench_geometric_product_size(c: &mut Criterion, size: usize) {
    let metric = Metric::from_signature(3, 0, 0);
    // Create two fields
    let shape = [size, size, size];
    let dx = [1.0, 1.0, 1.0];
    let num_cells = size * size * size;

    // StandardMultiVector uses the default float type
    let mv = CausalMultiVector::unchecked(vec![0.5; 8], metric);

    let field_a = CausalMultiField::from_coefficients(&vec![mv.clone(); num_cells], shape, dx);
    let field_b = field_a.clone();

    let bench_name = format!("geometric_product_3d_{}^3", size);

    c.bench_function(&bench_name, |b| {
        b.iter(|| {
            let result = &field_a * &field_b;
            black_box(result)
        })
    });
}

fn bench_geometric_product(c: &mut Criterion) {
    // 64 cells (Current)
    bench_geometric_product_size(c, 4);
    // 512 cells
    bench_geometric_product_size(c, 8);
    // 4096 cells
    bench_geometric_product_size(c, 16);
}

fn bench_gradient(c: &mut Criterion) {
    let metric = Metric::from_signature(3, 0, 0);
    let shape = [4, 4, 4];
    let dx = [1.0, 1.0, 1.0];

    let num_cells = 64;
    let mv = CausalMultiVector::unchecked(vec![0.5; 8], metric);

    let field = CausalMultiField::from_coefficients(&vec![mv; num_cells], shape, dx);

    let bench_name = "multifield_gradient_3d";

    c.bench_function(bench_name, |b| b.iter(|| field.gradient()));
}

fn bench_conversion(c: &mut Criterion) {
    let metric = Metric::from_signature(3, 0, 0);
    let shape = [4, 4, 4];
    let dx = [1.0, 1.0, 1.0];

    let num_cells = 64;
    let mv = CausalMultiVector::unchecked(vec![0.5; 8], metric);

    let data_vec = vec![mv; num_cells];

    let bench_name_from = "multifield_from_coefficients";

    c.bench_function(bench_name_from, |b| {
        b.iter(|| CausalMultiField::from_coefficients(black_box(&data_vec), shape, dx))
    });

    let field = CausalMultiField::from_coefficients(&data_vec, shape, dx);

    let bench_name_to = "multifield_to_coefficients";

    c.bench_function(bench_name_to, |b| b.iter(|| field.to_coefficients()));
}

criterion_group!(
    benches,
    bench_geometric_product,
    bench_gradient,
    bench_conversion
);
criterion_main!(benches);