# lamina-dev/lmmc architecture

> Architecture diagram of the GitHub repository lamina-dev/lmmc, 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/lmmc
- Repository: https://github.com/lamina-dev/lmmc

## Overview

LMMC is a C11 numerical-computing library for Lamina/LMMP. A caller supplies numerical data through its public C API, selects a numerical capability, and receives computed results or status codes. The README documents dense and sparse linear algebra, scientific algorithms, statistics and probability, tensors and transforms, and standard-library adapters. Storage helpers and shared internal utilities form a useful lower layer. The sampled sources show dense/sparse storage and tensor internals, but not most algorithm implementations; dashed links mark unverified routing.

Main entry points: [`include/lmmc/lmmc.h`](https://github.com/lamina-dev/lmmc/blob/main/include/lmmc/lmmc.h) (LMMC API), [`src/tensor_nd_storage.c`](https://github.com/lamina-dev/lmmc/blob/main/src/tensor_nd_storage.c) (N-D Tensors), [`src/dense_storage.c`](https://github.com/lamina-dev/lmmc/blob/main/src/dense_storage.c) (Dense Matrices), [`src/sparse_storage.c`](https://github.com/lamina-dev/lmmc/blob/main/src/sparse_storage.c) (Sparse Matrices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API"]
  node_public["LMMC API<br/>[lmmc.h]"]
  node_status["Status Codes<br/>[status.h]"]
end

subgraph group_linear["Linear Algebra"]
  node_dense["Dense Matrices<br/>[dense_storage.c]"]
  node_sparse["Sparse Matrices<br/>[sparse_storage.c]"]
  node_linear_solve["Linear Solvers<br/>[linear_algebra.c]"]
  node_eigen["Eigen and SVD<br/>[eigen_symmetric.c]"]
  node_precondition["Preconditioners<br/>[precond.c]"]
  node_iterative["Iterative Solvers<br/>[itersolve.c]"]
end

subgraph group_methods["Scientific Methods"]
  node_nonlinear["Nonlinear Equations<br/>[nonlinear.c]"]
  node_optimization["Optimization<br/>[optimize.c]"]
  node_quadrature["Quadrature"]
  node_interpolation["Interpolation<br/>[interp.c]"]
  node_ode["ODE Integration<br/>[ode_common.c]"]
end

subgraph group_data["Data and Probability"]
  node_statistics["Statistics"]
  node_probability["Probability"]
  node_random["Random Streams<br/>[random.c]"]
  node_tensor3["Rank-3 Tensors<br/>[tensor3_storage.c]"]
  node_tensor_nd["N-D Tensors"]
  node_fft["FFT<br/>[fft.c]"]
  node_complex["Complex Arithmetic<br/>[complex.c]"]
  node_special["Special Functions"]
  node_stdlib["Standard Adapters"]
end

subgraph group_foundation["Shared Internals"]
  node_internal["Shared Utilities<br/>[internal.h]"]
  node_memory["Memory Bridge<br/>[memory_bridge.h]"]
end

node_caller(("C Caller"))

node_caller -->|"calls"| node_public
node_public -.->|"reports status"| node_status
node_public -.->|"selects capability"| node_dense
node_public -.->|"selects capability"| node_sparse
node_public -.->|"selects capability"| node_linear_solve
node_public -.->|"selects capability"| node_eigen
node_public -.->|"selects capability"| node_precondition
node_public -.->|"selects capability"| node_iterative
node_public -.->|"selects capability"| node_nonlinear
node_public -.->|"selects capability"| node_optimization
node_public -.->|"selects capability"| node_quadrature
node_public -.->|"selects capability"| node_interpolation
node_public -.->|"selects capability"| node_ode
node_public -.->|"selects capability"| node_statistics
node_public -.->|"selects capability"| node_probability
node_public -.->|"selects capability"| node_random
node_public -.->|"selects capability"| node_tensor3
node_public -.->|"selects capability"| node_tensor_nd
node_public -.->|"selects capability"| node_fft
node_public -.->|"selects capability"| node_complex
node_public -.->|"selects capability"| node_special
node_public -.->|"selects capability"| node_stdlib
node_dense -->|"uses helpers"| node_internal
node_dense -->|"allocates storage"| node_memory
node_sparse -->|"uses helpers"| node_internal
node_sparse -->|"allocates storage"| node_memory
node_tensor_nd -->|"uses helpers"| node_internal
node_tensor_nd -->|"allocates results"| node_memory
node_tensor3 -->|"uses declarations"| node_tensor_nd

click node_public "https://github.com/lamina-dev/lmmc/blob/main/include/lmmc/lmmc.h"
click node_status "https://github.com/lamina-dev/lmmc/blob/main/include/lmmc/status.h"
click node_dense "https://github.com/lamina-dev/lmmc/blob/main/src/dense_storage.c"
click node_sparse "https://github.com/lamina-dev/lmmc/blob/main/src/sparse_storage.c"
click node_linear_solve "https://github.com/lamina-dev/lmmc/blob/main/src/linear_algebra.c"
click node_eigen "https://github.com/lamina-dev/lmmc/blob/main/src/eigen_symmetric.c"
click node_precondition "https://github.com/lamina-dev/lmmc/blob/main/src/precond.c"
click node_iterative "https://github.com/lamina-dev/lmmc/blob/main/src/itersolve.c"
click node_nonlinear "https://github.com/lamina-dev/lmmc/blob/main/src/nonlinear.c"
click node_optimization "https://github.com/lamina-dev/lmmc/blob/main/src/optimize.c"
click node_quadrature "https://github.com/lamina-dev/lmmc/blob/main/src/quadrature_common.c"
click node_interpolation "https://github.com/lamina-dev/lmmc/blob/main/src/interp.c"
click node_ode "https://github.com/lamina-dev/lmmc/blob/main/src/ode_common.c"
click node_statistics "https://github.com/lamina-dev/lmmc/blob/main/src/statistics_descriptive.c"
click node_probability "https://github.com/lamina-dev/lmmc/blob/main/src/probability_continuous.c"
click node_random "https://github.com/lamina-dev/lmmc/blob/main/src/random.c"
click node_tensor3 "https://github.com/lamina-dev/lmmc/blob/main/src/tensor3_storage.c"
click node_tensor_nd "https://github.com/lamina-dev/lmmc/blob/main/src/tensor_nd_storage.c"
click node_fft "https://github.com/lamina-dev/lmmc/blob/main/src/fft.c"
click node_complex "https://github.com/lamina-dev/lmmc/blob/main/src/complex.c"
click node_special "https://github.com/lamina-dev/lmmc/blob/main/src/special_functions.c"
click node_stdlib "https://github.com/lamina-dev/lmmc/blob/main/src/stdlib_linalg_elementwise.c"
click node_internal "https://github.com/lamina-dev/lmmc/blob/main/src/internal.h"
click node_memory "https://github.com/lamina-dev/lmmc/blob/main/src/memory_bridge.h"

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_public,node_status toneBlue
class node_dense,node_sparse,node_linear_solve,node_eigen,node_precondition,node_iterative toneAmber
class node_nonlinear,node_optimization,node_quadrature,node_interpolation,node_ode toneMint
class node_statistics,node_probability,node_random,node_tensor3,node_tensor_nd,node_fft,node_complex,node_special,node_stdlib toneRose
class node_internal,node_memory,node_caller toneIndigo
```

## Components

### Public API

- [LMMC API](https://github.com/lamina-dev/lmmc/blob/main/include/lmmc/lmmc.h): `include/lmmc/lmmc.h`
- [Status Codes](https://github.com/lamina-dev/lmmc/blob/main/include/lmmc/status.h): `include/lmmc/status.h`

### Linear Algebra

- [Dense Matrices](https://github.com/lamina-dev/lmmc/blob/main/src/dense_storage.c): `src/dense_storage.c`
- [Sparse Matrices](https://github.com/lamina-dev/lmmc/blob/main/src/sparse_storage.c): `src/sparse_storage.c`
- [Linear Solvers](https://github.com/lamina-dev/lmmc/blob/main/src/linear_algebra.c): `src/linear_algebra.c`
- [Eigen and SVD](https://github.com/lamina-dev/lmmc/blob/main/src/eigen_symmetric.c): `src/eigen_symmetric.c`
- [Preconditioners](https://github.com/lamina-dev/lmmc/blob/main/src/precond.c): `src/precond.c`
- [Iterative Solvers](https://github.com/lamina-dev/lmmc/blob/main/src/itersolve.c): `src/itersolve.c`

### Scientific Methods

- [Nonlinear Equations](https://github.com/lamina-dev/lmmc/blob/main/src/nonlinear.c): `src/nonlinear.c`
- [Optimization](https://github.com/lamina-dev/lmmc/blob/main/src/optimize.c): `src/optimize.c`
- [Quadrature](https://github.com/lamina-dev/lmmc/blob/main/src/quadrature_common.c): `src/quadrature_common.c`
- [Interpolation](https://github.com/lamina-dev/lmmc/blob/main/src/interp.c): `src/interp.c`
- [ODE Integration](https://github.com/lamina-dev/lmmc/blob/main/src/ode_common.c): `src/ode_common.c`

### Data and Probability

- [Statistics](https://github.com/lamina-dev/lmmc/blob/main/src/statistics_descriptive.c): `src/statistics_descriptive.c`
- [Probability](https://github.com/lamina-dev/lmmc/blob/main/src/probability_continuous.c): `src/probability_continuous.c`
- [Random Streams](https://github.com/lamina-dev/lmmc/blob/main/src/random.c): `src/random.c`
- [Rank-3 Tensors](https://github.com/lamina-dev/lmmc/blob/main/src/tensor3_storage.c): `src/tensor3_storage.c`
- [N-D Tensors](https://github.com/lamina-dev/lmmc/blob/main/src/tensor_nd_storage.c): `src/tensor_nd_storage.c`
- [FFT](https://github.com/lamina-dev/lmmc/blob/main/src/fft.c): `src/fft.c`
- [Complex Arithmetic](https://github.com/lamina-dev/lmmc/blob/main/src/complex.c): `src/complex.c`
- [Special Functions](https://github.com/lamina-dev/lmmc/blob/main/src/special_functions.c): `src/special_functions.c`
- [Standard Adapters](https://github.com/lamina-dev/lmmc/blob/main/src/stdlib_linalg_elementwise.c): `src/stdlib_linalg_elementwise.c`

### Shared Internals

- [Shared Utilities](https://github.com/lamina-dev/lmmc/blob/main/src/internal.h): `src/internal.h`
- [Memory Bridge](https://github.com/lamina-dev/lmmc/blob/main/src/memory_bridge.h): `src/memory_bridge.h`

### Other components

- **C Caller**

## Connections

- C Caller → LMMC API: calls (evidence: `README.md`)
- LMMC API → Status Codes: reports status
- LMMC API → Dense Matrices: selects capability
- LMMC API → Sparse Matrices: selects capability
- LMMC API → Linear Solvers: selects capability
- LMMC API → Eigen and SVD: selects capability
- LMMC API → Preconditioners: selects capability
- LMMC API → Iterative Solvers: selects capability
- LMMC API → Nonlinear Equations: selects capability
- LMMC API → Optimization: selects capability
- LMMC API → Quadrature: selects capability
- LMMC API → Interpolation: selects capability
- LMMC API → ODE Integration: selects capability
- LMMC API → Statistics: selects capability
- LMMC API → Probability: selects capability
- LMMC API → Random Streams: selects capability
- LMMC API → Rank-3 Tensors: selects capability
- LMMC API → N-D Tensors: selects capability
- LMMC API → FFT: selects capability
- LMMC API → Complex Arithmetic: selects capability
- LMMC API → Special Functions: selects capability
- LMMC API → Standard Adapters: selects capability
- Dense Matrices → Shared Utilities: uses helpers (evidence: `src/dense_storage.c`)
- Dense Matrices → Memory Bridge: allocates storage (evidence: `src/dense_storage.c`)
- Sparse Matrices → Shared Utilities: uses helpers (evidence: `src/sparse_storage.c`)
- Sparse Matrices → Memory Bridge: allocates storage (evidence: `src/sparse_storage.c`)
- N-D Tensors → Shared Utilities: uses helpers
- N-D Tensors → Memory Bridge: allocates results
- Rank-3 Tensors → N-D Tensors: uses declarations (evidence: `src/tensor3_storage.c`)
