mathhook-core 0.2.0

Core mathematical engine for MathHook - expressions, algebra, and solving
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

//! Unified matrix system with zero-cost abstractions
//!
//! This module provides a single `Matrix` type that can represent all special
//! matrix types while maintaining optimal memory usage and performance.

use crate::matrices::types::*;
use serde::{Deserialize, Serialize};

mod construction;
mod decomposition;
mod operations;
mod solvers;

pub use operations::CoreMatrixOps;

/// Unified matrix type that can represent any matrix efficiently
///
/// This enum uses zero-cost abstractions to provide a single interface
/// for all matrix types while maintaining optimal memory usage.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub enum Matrix {
    /// Regular dense matrix: O(n²) memory
    Dense(MatrixData),

    /// Identity matrix: O(1) memory
    Identity(IdentityMatrixData),

    /// Zero matrix: O(1) memory
    Zero(ZeroMatrixData),

    /// Diagonal matrix: O(n) memory
    Diagonal(DiagonalMatrixData),

    /// Scalar matrix: O(1) memory
    Scalar(ScalarMatrixData),

    /// Upper triangular: O(n²/2) memory
    UpperTriangular(UpperTriangularMatrixData),

    /// Lower triangular: O(n²/2) memory
    LowerTriangular(LowerTriangularMatrixData),

    /// Symmetric matrix: O(n²/2) memory
    Symmetric(SymmetricMatrixData),

    /// Permutation matrix: O(n) memory
    Permutation(PermutationMatrixData),
}