Skip to main content

polygeo_core/
lib.rs

1//! Proof-bearing native mathematical core for `PolyGeo`.
2
3#[path = "chain.rs"]
4mod chain_impl;
5mod coefficient;
6mod complex;
7mod correspondence;
8mod csr;
9mod evidence;
10#[path = "field.rs"]
11mod field_impl;
12#[path = "form.rs"]
13mod form_impl;
14#[path = "geometry.rs"]
15mod geometry_impl;
16mod halfedge;
17mod homology;
18mod incidence;
19mod mask;
20mod numeric;
21mod operator;
22#[path = "solve.rs"]
23mod solve_impl;
24mod subset;
25mod surface;
26pub mod topology;
27
28/// Exact coefficients, chains, maps, homology, and bounded CSR materialization.
29pub mod chain {
30    pub use crate::chain_impl::{
31        BasisIdentification, Chain, ChainComplex, ChainError, ChainIsomorphism, ChainLawLimit,
32        ChainMap, Cochain, CompositionError, DualChainIsomorphism, DualComplex, Element,
33        IntegralChain, IntegralChainComplex, IntegralCochain, IntegralLinearMap, IsomorphismError,
34        LinearMap, PresentationEquality, PresentationError, Space, Variance, compose,
35    };
36    pub use crate::coefficient::{
37        BigIntEncoding, CoefficientSystem, CommutativeRing, EuclideanDomain, ExactRational, Field,
38        FractionField, FractionFieldOf, IntegerRing, IntegralDomain, RationalField,
39        ReducedFractionEncoding, Ring, RingMorphism, ValueEncoding,
40    };
41    pub use crate::csr::{Csr, CsrBuildLimit, CsrError, CsrEstimate};
42    pub use crate::homology::{HomologyError, HomologyGroup, HomologyLimit, IntegralHomology};
43}
44
45/// Binary64 chains, cochains, and matrix-free operators.
46pub mod form {
47    pub use crate::form_impl::{
48        Binary64Chain as Chain, Binary64ChainSpace as ChainSpace, Binary64Cochain as Cochain,
49        Binary64CochainSpace as CochainSpace, Binary64Element as Element,
50        Binary64ElementError as ElementError, Binary64Space as Space,
51    };
52    pub use crate::operator::{LinearOperator as Operator, OperatorError, compose};
53}
54
55/// Admitted Euclidean geometry, metric evidence, and surface algorithms.
56pub mod geometry {
57    pub use crate::geometry_impl::{
58        CircumcentricPairing, Geometry, GeometryError, Limit, Metric, MetricError,
59        NondegenerateCapability, NondegeneratePairing, PairingCapability,
60    };
61    pub use crate::surface::{
62        EntityVectors as VectorField, FaceVectors as FaceField, FlowEvidence, FlowStep,
63        LeastSquaresConformalMapEvidence as ConformalMapEvidence,
64        LeastSquaresConformalMapSolution as ConformalMap, SurfaceError, TriangleSurface,
65        VertexVectors as VertexField,
66    };
67}
68
69/// Numerical problem admission, preparation, workspace, policy, and results.
70pub mod solve {
71    pub use crate::solve_impl::{
72        CancellationToken, DirichletEvidence, DirichletProblem, DirichletResult, Executor,
73        HarmonicExtension, HeatProblem, HeatResult, PoissonProblem, PoissonResult, Policy,
74        Prepared, Problem, ProblemError, ResidualEvidence, SolveError, SolveExt, StorageLimit,
75        SurfaceComputationError, WorkLimit, Workspace,
76    };
77}
78
79/// Discrete connections, Hodge decomposition, harmonic bases, and direction fields.
80pub mod field {
81    pub use crate::chain_impl::IntegralDualCycleBasis as DualCycles;
82    pub use crate::field_impl::{
83        DirectionFieldSingularities as Singularities, FaceDirectionField as Direction,
84        HarmonicOneFormBasis as HarmonicBasis, HolonomyEvidence as Holonomy, IntegrableConnection,
85        SurfaceConnection as Connection,
86    };
87    pub use crate::solve_impl::{HodgeDecomposition, HodgeEvidence, HodgeProblem};
88}
89
90pub(crate) use chain_impl::{
91    Chain, ChainComplex, ChainError, ChainIsomorphism, ChainLawLimit, Cochain, Element,
92    IntegralChain, IntegralChainComplex, IntegralCochain, IntegralDualCycleBasis, IsomorphismError,
93    LinearMap, Space, Variance,
94};
95pub(crate) use coefficient::{BigIntEncoding, CoefficientSystem, ExactRational, IntegerRing};
96pub(crate) use complex::{CandidateInput, ComplexCore};
97pub(crate) use form_impl::{
98    Binary64Chain, Binary64ChainSpace, Binary64Cochain, Binary64CochainSpace, Binary64Element,
99    Binary64ElementError, Binary64Space,
100};
101pub(crate) use geometry_impl::{
102    CircumcentricPairing, Geometry, GeometryError, Limit, Metric, NondegenerateCapability,
103    NondegeneratePairing, PairingCapability,
104};
105pub(crate) use halfedge::{HalfedgeInput, HalfedgeSurfaceCore, MaterialFace};
106pub(crate) use homology::HomologyGroup;
107pub(crate) use incidence::{Basis, BoundaryRef, CanonicalBoundary, ChainView, CoefficientSlice};
108pub(crate) use operator::{LinearOperator, OperatorError};
109pub(crate) use solve_impl::{
110    CancellationToken, Executor, Policy, SolveError, StorageLimit, SurfaceComputationError,
111    WorkLimit,
112};
113pub(crate) use subset::CanonicalSelection;
114pub(crate) use surface::{FaceVectors, SurfaceError};
115pub(crate) use topology::TopologyError;