# fitteia/onefit-engine architecture

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

- Interactive diagram: https://gitdiagram.com/fitteia/onefit-engine
- Repository: https://github.com/fitteia/onefit-engine

## Overview

OneFit Engine is a Raku fitting core exposed through a CLI and an optional Cro HTTP service. Its principal workflow is to receive a fit definition and experimental data, run nonlinear fitting, and produce plots or portable fit descriptions. The README documents major capabilities but no source excerpts were supplied, so internal call relationships are limited to documented workflow links; module assignments reflect the repository tree, not inspected implementations.

Main entry points: [`lib/OneFit.rakumod`](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit.rakumod) (Fit engine), [`bin/onefite`](https://github.com/fitteia/onefit-engine/blob/main/bin/onefite) (CLI), [`lib/OneFit/Engine/Import.rakumod`](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Import.rakumod) (Data import), [`lib/OneFit/Engine/Grammars.rakumod`](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Grammars.rakumod) (Model expressions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry points"]
  node_cli["CLI"]
  node_http["HTTP service"]
end

subgraph group_model["Fit inputs"]
  node_data["Data import<br/>[Import.rakumod]"]
  node_expressions["Model expressions<br/>[Grammars.rakumod]"]
  node_functions["Model functions<br/>[Functions.rakumod]"]
  node_aliases["Function aliases<br/>[Agrs.rakumod]"]
  node_parameters["Fit parameters<br/>[Parameters.rakumod]"]
end

subgraph group_runtime["Fit runtime"]
  node_engine["Fit engine<br/>[OneFit.rakumod]"]
  node_conditions["Fit conditions<br/>[Condition.rakumod]"]
  node_batch["Batch fitting<br/>[Batch.rakumod]"]
  node_minuit["CERNLIB MINUIT"]
end

subgraph group_results["Fit results"]
  node_plots["Plots<br/>[Graphs.rakumod]"]
  node_axes["Plot axes<br/>[Axes.rakumod]"]
  node_fitfiles["JSON/SAV descriptions<br/>[SAV.rakumod]"]
  node_archives["Output archives<br/>[Archive.rakumod]"]
end

node_user(("Fit user"))

node_user -->|"runs fit"| node_cli
node_user -.->|"uploads fit"| node_http
node_cli -->|"loads data"| node_data
node_cli -->|"defines models"| node_expressions
node_cli -->|"runs fit"| node_engine
node_http -.->|"runs fit"| node_engine
node_engine -->|"fits with"| node_minuit
node_engine -->|"produces plots"| node_plots
node_engine -->|"saves descriptions"| node_fitfiles

click node_cli "https://github.com/fitteia/onefit-engine/blob/main/bin/onefite"
click node_http "https://github.com/fitteia/onefit-engine/blob/main/bin/onefite"
click node_data "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Import.rakumod"
click node_expressions "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Grammars.rakumod"
click node_functions "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Functions.rakumod"
click node_aliases "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Agrs.rakumod"
click node_parameters "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Parameters.rakumod"
click node_engine "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit.rakumod"
click node_conditions "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Condition.rakumod"
click node_batch "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Batch.rakumod"
click node_plots "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Graphs.rakumod"
click node_axes "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Axes.rakumod"
click node_fitfiles "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/SAV.rakumod"
click node_archives "https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Archive.rakumod"

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_cli,node_http,node_user toneBlue
class node_data,node_expressions,node_functions,node_aliases,node_parameters toneAmber
class node_engine,node_conditions,node_batch,node_minuit toneMint
class node_plots,node_axes,node_fitfiles,node_archives toneRose
```

## Components

### User entry points

- [CLI](https://github.com/fitteia/onefit-engine/blob/main/bin/onefite): `bin/onefite`
- [HTTP service](https://github.com/fitteia/onefit-engine/blob/main/bin/onefite): `bin/onefite`

### Fit inputs

- [Data import](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Import.rakumod): `lib/OneFit/Engine/Import.rakumod`
- [Model expressions](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Grammars.rakumod): `lib/OneFit/Engine/Grammars.rakumod`
- [Model functions](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Functions.rakumod): `lib/OneFit/Engine/Functions.rakumod`
- [Function aliases](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Agrs.rakumod): `lib/OneFit/Engine/Agrs.rakumod`
- [Fit parameters](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Parameters.rakumod): `lib/OneFit/Engine/Parameters.rakumod`

### Fit runtime

- [Fit engine](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit.rakumod): `lib/OneFit.rakumod`
- [Fit conditions](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Condition.rakumod): `lib/OneFit/Condition.rakumod`
- [Batch fitting](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Batch.rakumod): `lib/OneFit/Batch.rakumod`
- **CERNLIB MINUIT**

### Fit results

- [Plots](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Graphs.rakumod): `lib/OneFit/Engine/Graphs.rakumod`
- [Plot axes](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Axes.rakumod): `lib/OneFit/Engine/Axes.rakumod`
- [JSON/SAV descriptions](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/SAV.rakumod): `lib/OneFit/SAV.rakumod`
- [Output archives](https://github.com/fitteia/onefit-engine/blob/main/lib/OneFit/Engine/Archive.rakumod): `lib/OneFit/Engine/Archive.rakumod`

### Other components

- **Fit user**

## Connections

- Fit user → CLI: runs fit (evidence: `README.md`)
- Fit user → HTTP service: uploads fit (evidence: `README.md`)
- CLI → Data import: loads data (evidence: `README.md`)
- CLI → Model expressions: defines models (evidence: `README.md`)
- CLI → Fit engine: runs fit (evidence: `README.md`)
- HTTP service → Fit engine: runs fit (evidence: `README.md`)
- Fit engine → CERNLIB MINUIT: fits with (evidence: `README.md`)
- Fit engine → Plots: produces plots (evidence: `README.md`)
- Fit engine → JSON/SAV descriptions: saves descriptions (evidence: `README.md`)
