# lamina-dev/lmcas architecture

> Architecture diagram of the GitHub repository lamina-dev/lmcas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lamina-dev/lmcas
- Repository: https://github.com/lamina-dev/lmcas

## Overview

LMCAS is a C++ computer algebra system. A typical workflow starts with a consumer creating or parsing a symbolic expression, then applies transformations or mathematical operations and receives symbolic or checked results. The product also exposes numerical, algebraic, calculus, analysis, matrix, geometry, and reasoning capabilities. The graph combines README-documented API behavior with source-index evidence; many implementation relationships are not shown in the sampled excerpts, so those links are omitted rather than inferred.

Main entry points: [`include/symbolic.hpp`](https://github.com/lamina-dev/lmcas/blob/main/include/symbolic.hpp) (Symbolic API), [`include/inference_engine.hpp`](https://github.com/lamina-dev/lmcas/blob/main/include/inference_engine.hpp) (Property Inference), [`include/assumption_context.hpp`](https://github.com/lamina-dev/lmcas/blob/main/include/assumption_context.hpp) (Assumptions), [`include/expr.hpp`](https://github.com/lamina-dev/lmcas/blob/main/include/expr.hpp) (Expression API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_expression["Expressions"]
  node_expr_api["Expression API<br/>[expr.hpp]"]
  node_symbolic_api["Symbolic API<br/>[symbolic.hpp]"]
  node_ast["Expression AST<br/>[special_forms.hpp]"]
  node_result["Checked Results<br/>[result.hpp]"]
end

subgraph group_reasoning["Reasoning"]
  node_assumptions["Assumptions"]
  node_inference["Property Inference"]
  node_property_store[("Property Store<br/>[property_store.hpp]")]
  node_relation_store[("Relation Store<br/>[relation_store.hpp]")]
end

subgraph group_algebra["Algebra"]
  node_numeric["Numeric Types<br/>[bigint.hpp]"]
  node_polynomials["Polynomial Algebra<br/>[polynomial.hpp]"]
  node_factorization["Factorization"]
  node_matrices["Matrix Operations"]
  node_solver["Equation Solving<br/>[solver.hpp]"]
end

subgraph group_calculus["Calculus"]
  node_differentiation["Differentiation"]
  node_integration["Integration<br/>[integrator.cpp]"]
  node_ode["ODE Solving"]
  node_vector_calculus["Vector Calculus"]
end

subgraph group_analysis["Analysis"]
  node_series["Series Engine<br/>[series_engine.cpp]"]
  node_transforms["Transforms"]
  node_geometry["Symbolic Geometry"]
end

node_consumer(("C++ Consumer"))

node_consumer -->|"creates or parses"| node_expr_api
node_consumer -->|"uses expressions"| node_symbolic_api
node_expr_api -.->|"represents expressions"| node_ast
node_symbolic_api -.->|"builds expressions"| node_ast
node_symbolic_api -->|"differentiates"| node_differentiation
node_symbolic_api -->|"integrates"| node_integration
node_symbolic_api -->|"factors"| node_factorization
node_symbolic_api -->|"solves equations"| node_solver
node_symbolic_api -->|"uses numeric values"| node_numeric
node_symbolic_api -->|"exposes matrix operations"| node_matrices
node_assumptions -->|"stores properties"| node_property_store
node_assumptions -->|"stores relations"| node_relation_store
node_inference -->|"queries assumptions"| node_assumptions
node_inference -->|"uses properties"| node_property_store
node_inference -->|"uses relations"| node_relation_store
node_symbolic_api -->|"solves ODEs"| node_ode
node_symbolic_api -->|"offers vector calculus"| node_vector_calculus
node_symbolic_api -->|"offers series analysis"| node_series
node_symbolic_api -->|"offers transforms"| node_transforms
node_symbolic_api -.->|"offers geometry"| node_geometry
node_symbolic_api -->|"returns checked results"| node_result
node_series -->|"returns results"| node_result

click node_expr_api "https://github.com/lamina-dev/lmcas/blob/main/include/expr.hpp"
click node_symbolic_api "https://github.com/lamina-dev/lmcas/blob/main/include/symbolic.hpp"
click node_ast "https://github.com/lamina-dev/lmcas/blob/main/src/internal/symbolic_ast/special_forms.hpp"
click node_numeric "https://github.com/lamina-dev/lmcas/blob/main/include/bigint.hpp"
click node_assumptions "https://github.com/lamina-dev/lmcas/blob/main/include/assumption_context.hpp"
click node_inference "https://github.com/lamina-dev/lmcas/blob/main/include/inference_engine.hpp"
click node_property_store "https://github.com/lamina-dev/lmcas/blob/main/include/property_store.hpp"
click node_relation_store "https://github.com/lamina-dev/lmcas/blob/main/include/relation_store.hpp"
click node_polynomials "https://github.com/lamina-dev/lmcas/blob/main/include/polynomial.hpp"
click node_factorization "https://github.com/lamina-dev/lmcas/blob/main/include/multivariate_factor.hpp"
click node_matrices "https://github.com/lamina-dev/lmcas/blob/main/include/symbolic_matrix.hpp"
click node_solver "https://github.com/lamina-dev/lmcas/blob/main/include/solver.hpp"
click node_differentiation "https://github.com/lamina-dev/lmcas/blob/main/src/differentiation_structural.cpp"
click node_integration "https://github.com/lamina-dev/lmcas/blob/main/src/integrator.cpp"
click node_ode "https://github.com/lamina-dev/lmcas/blob/main/include/symbolic_ode_engine.hpp"
click node_vector_calculus "https://github.com/lamina-dev/lmcas/blob/main/include/vector_calculus.hpp"
click node_series "https://github.com/lamina-dev/lmcas/blob/main/src/series_engine.cpp"
click node_transforms "https://github.com/lamina-dev/lmcas/blob/main/include/transform_engine.hpp"
click node_geometry "https://github.com/lamina-dev/lmcas/blob/main/include/symbolic_geometry.hpp"
click node_result "https://github.com/lamina-dev/lmcas/blob/main/include/result.hpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_expr_api,node_symbolic_api,node_ast,node_result toneBlue
class node_assumptions,node_inference,node_property_store,node_relation_store toneAmber
class node_numeric,node_polynomials,node_factorization,node_matrices,node_solver toneMint
class node_differentiation,node_integration,node_ode,node_vector_calculus toneRose
class node_series,node_transforms,node_geometry,node_consumer toneIndigo
```

## Components

### Expressions

- [Expression API](https://github.com/lamina-dev/lmcas/blob/main/include/expr.hpp): `include/expr.hpp`
- [Symbolic API](https://github.com/lamina-dev/lmcas/blob/main/include/symbolic.hpp): `include/symbolic.hpp`
- [Expression AST](https://github.com/lamina-dev/lmcas/blob/main/src/internal/symbolic_ast/special_forms.hpp): `src/internal/symbolic_ast/special_forms.hpp`
- [Checked Results](https://github.com/lamina-dev/lmcas/blob/main/include/result.hpp): `include/result.hpp`

### Reasoning

- [Assumptions](https://github.com/lamina-dev/lmcas/blob/main/include/assumption_context.hpp): `include/assumption_context.hpp`
- [Property Inference](https://github.com/lamina-dev/lmcas/blob/main/include/inference_engine.hpp): `include/inference_engine.hpp`
- [Property Store](https://github.com/lamina-dev/lmcas/blob/main/include/property_store.hpp): `include/property_store.hpp`
- [Relation Store](https://github.com/lamina-dev/lmcas/blob/main/include/relation_store.hpp): `include/relation_store.hpp`

### Algebra

- [Numeric Types](https://github.com/lamina-dev/lmcas/blob/main/include/bigint.hpp): `include/bigint.hpp`
- [Polynomial Algebra](https://github.com/lamina-dev/lmcas/blob/main/include/polynomial.hpp): `include/polynomial.hpp`
- [Factorization](https://github.com/lamina-dev/lmcas/blob/main/include/multivariate_factor.hpp): `include/multivariate_factor.hpp`
- [Matrix Operations](https://github.com/lamina-dev/lmcas/blob/main/include/symbolic_matrix.hpp): `include/symbolic_matrix.hpp`
- [Equation Solving](https://github.com/lamina-dev/lmcas/blob/main/include/solver.hpp): `include/solver.hpp`

### Calculus

- [Differentiation](https://github.com/lamina-dev/lmcas/blob/main/src/differentiation_structural.cpp): `src/differentiation_structural.cpp`
- [Integration](https://github.com/lamina-dev/lmcas/blob/main/src/integrator.cpp): `src/integrator.cpp`
- [ODE Solving](https://github.com/lamina-dev/lmcas/blob/main/include/symbolic_ode_engine.hpp): `include/symbolic_ode_engine.hpp`
- [Vector Calculus](https://github.com/lamina-dev/lmcas/blob/main/include/vector_calculus.hpp): `include/vector_calculus.hpp`

### Analysis

- [Series Engine](https://github.com/lamina-dev/lmcas/blob/main/src/series_engine.cpp): `src/series_engine.cpp`
- [Transforms](https://github.com/lamina-dev/lmcas/blob/main/include/transform_engine.hpp): `include/transform_engine.hpp`
- [Symbolic Geometry](https://github.com/lamina-dev/lmcas/blob/main/include/symbolic_geometry.hpp): `include/symbolic_geometry.hpp`

### Other components

- **C++ Consumer**

## Connections

- C++ Consumer → Expression API: creates or parses (evidence: `README.md`)
- C++ Consumer → Symbolic API: uses expressions (evidence: `README.md`)
- Expression API → Expression AST: represents expressions
- Symbolic API → Expression AST: builds expressions
- Symbolic API → Differentiation: differentiates (evidence: `README.md`)
- Symbolic API → Integration: integrates (evidence: `README.md`)
- Symbolic API → Factorization: factors (evidence: `README.md`)
- Symbolic API → Equation Solving: solves equations (evidence: `README.md`)
- Symbolic API → Numeric Types: uses numeric values (evidence: `README.md`)
- Symbolic API → Matrix Operations: exposes matrix operations (evidence: `README.md`)
- Assumptions → Property Store: stores properties (evidence: `include/assumption_context.hpp`)
- Assumptions → Relation Store: stores relations (evidence: `include/assumption_context.hpp`)
- Property Inference → Assumptions: queries assumptions (evidence: `include/inference_engine.hpp`)
- Property Inference → Property Store: uses properties (evidence: `src/internal/inference_engine_impl.hpp`)
- Property Inference → Relation Store: uses relations (evidence: `src/internal/inference_engine_impl.hpp`)
- Symbolic API → ODE Solving: solves ODEs (evidence: `README.md`)
- Symbolic API → Vector Calculus: offers vector calculus (evidence: `README.md`)
- Symbolic API → Series Engine: offers series analysis (evidence: `src/series_engine.cpp`)
- Symbolic API → Transforms: offers transforms (evidence: `include/transform_engine.hpp`)
- Symbolic API → Symbolic Geometry: offers geometry
- Symbolic API → Checked Results: returns checked results (evidence: `include/symbolic.hpp`)
- Series Engine → Checked Results: returns results
