amari/
lib.rs

1//! Amari: Advanced Mathematical Algebra for Robust Intelligence
2//!
3//! A comprehensive mathematical computing library combining:
4//! - Geometric algebra (Clifford algebras)
5//! - Tropical algebra (max-plus semiring)
6//! - Dual number automatic differentiation
7//! - Geometric network analysis
8//! - Information geometry
9//! - Fusion systems for neural network optimization
10//! - Measure theory and Lebesgue integration (opt-in via `measure` feature)
11//! - Differential calculus on geometric algebra (opt-in via `calculus` feature)
12//! - Holographic memory / Vector Symbolic Architectures (opt-in via `holographic` feature)
13//! - Probability theory on geometric algebra (opt-in via `probabilistic` feature)
14//! - Probabilistic contracts and verification (opt-in via `flynn` feature)
15//! - Deterministic physics for networked applications (opt-in via `deterministic` feature)
16//! - Functional analysis on multivector spaces (opt-in via `functional` feature)
17//! - Algebraic topology: homology, persistent homology, Morse theory (opt-in via `topology` feature)
18//!
19//! Use `features = ["full"]` to enable all optional crates.
20
21pub use amari_automata as automata;
22pub use amari_core as core;
23pub use amari_dual as dual;
24pub use amari_enumerative as enumerative;
25pub use amari_fusion as fusion;
26pub use amari_info_geom as info_geom;
27pub use amari_network as network;
28pub use amari_relativistic as relativistic;
29pub use amari_tropical as tropical;
30
31#[cfg(feature = "measure")]
32pub use amari_measure as measure;
33
34#[cfg(feature = "calculus")]
35pub use amari_calculus as calculus;
36
37#[cfg(feature = "holographic")]
38pub use amari_holographic as holographic;
39
40#[cfg(feature = "probabilistic")]
41pub use amari_probabilistic as probabilistic;
42
43#[cfg(feature = "functional")]
44pub use amari_functional as functional;
45
46#[cfg(feature = "topology")]
47pub use amari_topology as topology;
48
49#[cfg(feature = "flynn")]
50pub use amari_flynn as flynn;
51
52#[cfg(feature = "gpu")]
53pub use amari_gpu as gpu;
54
55#[cfg(feature = "optimization")]
56pub use amari_optimization as optimization;
57
58// Deterministic computation module (opt-in via feature flag)
59#[cfg(feature = "deterministic")]
60pub mod deterministic;
61
62use thiserror::Error;
63
64/// Unified error type for the Amari library
65#[derive(Error, Debug)]
66pub enum AmariError {
67    /// Core geometric algebra error
68    #[error(transparent)]
69    Core(#[from] amari_core::CoreError),
70
71    /// Automata error
72    #[error("{0}")]
73    Automata(amari_automata::AutomataError),
74
75    /// Enumerative geometry error
76    #[error(transparent)]
77    Enumerative(#[from] amari_enumerative::EnumerativeError),
78
79    /// GPU computation error
80    #[cfg(feature = "gpu")]
81    #[error(transparent)]
82    Gpu(#[from] amari_gpu::GpuError),
83
84    /// Information geometry error
85    #[error(transparent)]
86    InfoGeom(#[from] amari_info_geom::InfoGeomError),
87
88    /// Network analysis error
89    #[error(transparent)]
90    Network(#[from] amari_network::NetworkError),
91
92    /// Fusion system error
93    #[error(transparent)]
94    Fusion(#[from] amari_fusion::EvaluationError),
95
96    /// Tropical algebra error
97    #[error(transparent)]
98    Tropical(#[from] amari_tropical::TropicalError),
99
100    /// Dual number error
101    #[error(transparent)]
102    Dual(#[from] amari_dual::DualError),
103
104    /// Calculus error
105    #[cfg(feature = "calculus")]
106    #[error(transparent)]
107    Calculus(#[from] amari_calculus::CalculusError),
108
109    /// Holographic memory error
110    #[cfg(feature = "holographic")]
111    #[error(transparent)]
112    Holographic(#[from] amari_holographic::HolographicError),
113
114    /// Probabilistic error
115    #[cfg(feature = "probabilistic")]
116    #[error(transparent)]
117    Probabilistic(#[from] amari_probabilistic::ProbabilisticError),
118
119    /// Functional analysis error
120    #[cfg(feature = "functional")]
121    #[error(transparent)]
122    Functional(#[from] amari_functional::FunctionalError),
123
124    /// Topology error
125    #[cfg(feature = "topology")]
126    #[error(transparent)]
127    Topology(#[from] amari_topology::TopologyError),
128}
129
130/// Result type for Amari operations
131pub type AmariResult<T> = Result<T, AmariError>;
132
133// Manual implementation for AutomataError since it doesn't use thiserror
134impl From<amari_automata::AutomataError> for AmariError {
135    fn from(err: amari_automata::AutomataError) -> Self {
136        AmariError::Automata(err)
137    }
138}
139
140// Re-export common types
141pub use amari_core::{Bivector, Multivector, Scalar, Vector};
142pub use amari_dual::{DualMultivector, DualNumber};
143pub use amari_fusion::TropicalDualClifford;
144pub use amari_info_geom::{DuallyFlatManifold, FisherInformationMatrix, SimpleAlphaConnection};
145pub use amari_network::{
146    Community, GeometricEdge, GeometricNetwork, NodeMetadata, PropagationAnalysis,
147};
148pub use amari_tropical::{TropicalMatrix, TropicalMultivector, TropicalNumber};
amari/lib.rs

amari/
lib.rs
