# slepik/apalinea architecture

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

- Interactive diagram: https://gitdiagram.com/slepik/apalinea
- Repository: https://github.com/slepik/apalinea

## Overview

Apalinea is a C++ stream-processing library. A user configures logging and an executor, builds a Plan from source, pipe, and sink operators, connects links, then processes the stream in unordered or ordered iterations. The tree also shows image/video operators and typed tuple/expression support. The Plan and several operator headers are not excerpted, so workflow links rely on the README; sampled source references support only the explicitly shown image, tuple, and expression dependencies.

Main entry points: [`include/Core/Plan/Plan.hpp`](https://github.com/slepik/apalinea/blob/master/include/Core/Plan/Plan.hpp) (Plan), [`include/Core/Type/Datatype`](https://github.com/slepik/apalinea/tree/master/include/Core/Type/Datatype) (Typed Values), [`include/Core/Tuple/Tuple.hpp`](https://github.com/slepik/apalinea/blob/master/include/Core/Tuple/Tuple.hpp) (Tuple), [`include/Expression`](https://github.com/slepik/apalinea/tree/master/include/Expression) (Expressions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Plan Orchestration"]
  node_plan["Plan<br/>[Plan.hpp]"]
  node_executor["Executors"]
  node_logging["Logging"]
end

subgraph group_stream["Stream Runtime"]
  node_source_link["Source Link<br/>[SourceLink.hpp]"]
  node_pipe_link["Pipe Link<br/>[PipeLink.hpp]"]
  node_sink_link["Sink Link<br/>[SinkLink.hpp]"]
  node_source_ops["Source Operators"]
  node_pipe_ops["Pipe Operators"]
  node_sink_ops["Sink Operators"]
end

subgraph group_data["Data And Expressions"]
  node_tuple["Tuple<br/>[Tuple.hpp]"]
  node_datatypes["Typed Values"]
  node_image["Image Types<br/>[Image.hpp]"]
  node_expressions["Expressions"]
  node_calculation["Calculation Expressions"]
  node_comparison["Comparison Expressions"]
end

subgraph group_vision["Vision Operators"]
  node_camera["Camera Source"]
  node_crop["Crop Operator"]
  node_detector["Detector Operator"]
  node_energy["Energy Calculator"]
end

node_user(("Library User"))

node_user -->|"configures"| node_logging
node_user -->|"builds"| node_plan
node_plan -->|"uses"| node_executor
node_plan -->|"uses"| node_logging
node_plan -->|"creates"| node_source_link
node_plan -->|"creates"| node_pipe_link
node_plan -->|"creates"| node_sink_link
node_plan -->|"accepts operators"| node_source_ops
node_plan -->|"accepts operators"| node_pipe_ops
node_plan -->|"accepts operators"| node_sink_ops
node_plan -->|"connects links"| node_source_link
node_plan -->|"connects links"| node_pipe_link
node_plan -->|"connects links"| node_sink_link
node_plan -->|"processes iteration"| node_source_link
node_camera -->|"populates"| node_tuple
node_camera -->|"uses"| node_image
node_camera -->|"uses"| node_datatypes
node_crop -->|"reads and updates"| node_tuple
node_crop -->|"uses"| node_image
node_crop -->|"uses"| node_datatypes
node_detector -->|"reads and updates"| node_tuple
node_detector -->|"uses"| node_image
node_detector -->|"uses"| node_datatypes
node_energy -->|"reads and updates"| node_tuple
node_energy -->|"uses"| node_datatypes
node_calculation -->|"extends"| node_expressions
node_calculation -->|"uses"| node_datatypes
node_comparison -->|"extends"| node_expressions
node_comparison -->|"uses"| node_datatypes
node_expressions -->|"reads values"| node_tuple
node_expressions -->|"uses"| node_datatypes

click node_plan "https://github.com/slepik/apalinea/blob/master/include/Core/Plan/Plan.hpp"
click node_executor "https://github.com/slepik/apalinea/tree/master/include/Core/Executor"
click node_logging "https://github.com/slepik/apalinea/tree/master/include/Core/Log"
click node_source_link "https://github.com/slepik/apalinea/blob/master/include/Core/Link/SourceLink/SourceLink.hpp"
click node_pipe_link "https://github.com/slepik/apalinea/blob/master/include/Core/Link/PipeLink/PipeLink.hpp"
click node_sink_link "https://github.com/slepik/apalinea/blob/master/include/Core/Link/SinkLink/SinkLink.hpp"
click node_source_ops "https://github.com/slepik/apalinea/tree/master/include/Operator/SourceOperator"
click node_pipe_ops "https://github.com/slepik/apalinea/tree/master/include/Operator/PipeOperator"
click node_sink_ops "https://github.com/slepik/apalinea/tree/master/include/Operator/SinkOperator"
click node_tuple "https://github.com/slepik/apalinea/blob/master/include/Core/Tuple/Tuple.hpp"
click node_datatypes "https://github.com/slepik/apalinea/tree/master/include/Core/Type/Datatype"
click node_image "https://github.com/slepik/apalinea/blob/master/include/Core/Type/Image/Image.hpp"
click node_expressions "https://github.com/slepik/apalinea/tree/master/include/Expression"
click node_calculation "https://github.com/slepik/apalinea/blob/master/include/Expression/Calculation/CalculationExpression.hpp"
click node_comparison "https://github.com/slepik/apalinea/blob/master/include/Expression/Compare/CompareExpression.hpp"
click node_camera "https://github.com/slepik/apalinea/blob/master/include/Operator/SourceOperator/CameraSourceOperator/CameraSourceOperator.hpp"
click node_crop "https://github.com/slepik/apalinea/blob/master/include/Operator/PipeOperator/CropPipeOperator/CropPipeOperator.hpp"
click node_detector "https://github.com/slepik/apalinea/blob/master/include/Operator/PipeOperator/DetectorPipeOperator/DetectorPipeOperator.hpp"
click node_energy "https://github.com/slepik/apalinea/blob/master/include/Operator/PipeOperator/EnergyCalculatorPipeOperator/EnergyCalculatorPipeOperator.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_plan,node_executor,node_logging,node_user toneBlue
class node_source_link,node_pipe_link,node_sink_link,node_source_ops,node_pipe_ops,node_sink_ops toneAmber
class node_tuple,node_datatypes,node_image,node_expressions,node_calculation,node_comparison toneMint
class node_camera,node_crop,node_detector,node_energy toneRose
```

## Components

### Plan Orchestration

- [Plan](https://github.com/slepik/apalinea/blob/master/include/Core/Plan/Plan.hpp): `include/Core/Plan/Plan.hpp`
- [Executors](https://github.com/slepik/apalinea/tree/master/include/Core/Executor): `include/Core/Executor`
- [Logging](https://github.com/slepik/apalinea/tree/master/include/Core/Log): `include/Core/Log`

### Stream Runtime

- [Source Link](https://github.com/slepik/apalinea/blob/master/include/Core/Link/SourceLink/SourceLink.hpp): `include/Core/Link/SourceLink/SourceLink.hpp`
- [Pipe Link](https://github.com/slepik/apalinea/blob/master/include/Core/Link/PipeLink/PipeLink.hpp): `include/Core/Link/PipeLink/PipeLink.hpp`
- [Sink Link](https://github.com/slepik/apalinea/blob/master/include/Core/Link/SinkLink/SinkLink.hpp): `include/Core/Link/SinkLink/SinkLink.hpp`
- [Source Operators](https://github.com/slepik/apalinea/tree/master/include/Operator/SourceOperator): `include/Operator/SourceOperator`
- [Pipe Operators](https://github.com/slepik/apalinea/tree/master/include/Operator/PipeOperator): `include/Operator/PipeOperator`
- [Sink Operators](https://github.com/slepik/apalinea/tree/master/include/Operator/SinkOperator): `include/Operator/SinkOperator`

### Data And Expressions

- [Tuple](https://github.com/slepik/apalinea/blob/master/include/Core/Tuple/Tuple.hpp): `include/Core/Tuple/Tuple.hpp`
- [Typed Values](https://github.com/slepik/apalinea/tree/master/include/Core/Type/Datatype): `include/Core/Type/Datatype`
- [Image Types](https://github.com/slepik/apalinea/blob/master/include/Core/Type/Image/Image.hpp): `include/Core/Type/Image/Image.hpp`
- [Expressions](https://github.com/slepik/apalinea/tree/master/include/Expression): `include/Expression`
- [Calculation Expressions](https://github.com/slepik/apalinea/blob/master/include/Expression/Calculation/CalculationExpression.hpp): `include/Expression/Calculation/CalculationExpression.hpp`
- [Comparison Expressions](https://github.com/slepik/apalinea/blob/master/include/Expression/Compare/CompareExpression.hpp): `include/Expression/Compare/CompareExpression.hpp`

### Vision Operators

- [Camera Source](https://github.com/slepik/apalinea/blob/master/include/Operator/SourceOperator/CameraSourceOperator/CameraSourceOperator.hpp): `include/Operator/SourceOperator/CameraSourceOperator/CameraSourceOperator.hpp`
- [Crop Operator](https://github.com/slepik/apalinea/blob/master/include/Operator/PipeOperator/CropPipeOperator/CropPipeOperator.hpp): `include/Operator/PipeOperator/CropPipeOperator/CropPipeOperator.hpp`
- [Detector Operator](https://github.com/slepik/apalinea/blob/master/include/Operator/PipeOperator/DetectorPipeOperator/DetectorPipeOperator.hpp): `include/Operator/PipeOperator/DetectorPipeOperator/DetectorPipeOperator.hpp`
- [Energy Calculator](https://github.com/slepik/apalinea/blob/master/include/Operator/PipeOperator/EnergyCalculatorPipeOperator/EnergyCalculatorPipeOperator.hpp): `include/Operator/PipeOperator/EnergyCalculatorPipeOperator/EnergyCalculatorPipeOperator.hpp`

### Other components

- **Library User**

## Connections

- Library User → Logging: configures
- Library User → Plan: builds
- Plan → Executors: uses (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Logging: uses (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Source Link: creates (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Pipe Link: creates (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Sink Link: creates (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Source Operators: accepts operators
- Plan → Pipe Operators: accepts operators
- Plan → Sink Operators: accepts operators
- Plan → Source Link: connects links (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Pipe Link: connects links (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Sink Link: connects links (evidence: `include/Core/Plan/Plan.hpp`)
- Plan → Source Link: processes iteration (evidence: `include/Core/Plan/Plan.hpp`)
- Camera Source → Tuple: populates (evidence: `include/Operator/SourceOperator/CameraSourceOperator/CameraSourceOperator.hpp`)
- Camera Source → Image Types: uses (evidence: `include/Operator/SourceOperator/CameraSourceOperator/CameraSourceOperator.hpp`)
- Camera Source → Typed Values: uses (evidence: `include/Operator/SourceOperator/CameraSourceOperator/CameraSourceOperator.hpp`)
- Crop Operator → Tuple: reads and updates (evidence: `include/Operator/PipeOperator/CropPipeOperator/CropPipeOperator.hpp`)
- Crop Operator → Image Types: uses (evidence: `include/Operator/PipeOperator/CropPipeOperator/CropPipeOperator.hpp`)
- Crop Operator → Typed Values: uses (evidence: `include/Operator/PipeOperator/CropPipeOperator/CropPipeOperator.hpp`)
- Detector Operator → Tuple: reads and updates (evidence: `include/Operator/PipeOperator/DetectorPipeOperator/DetectorPipeOperator.hpp`)
- Detector Operator → Image Types: uses (evidence: `include/Operator/PipeOperator/DetectorPipeOperator/DetectorPipeOperator.hpp`)
- Detector Operator → Typed Values: uses (evidence: `include/Operator/PipeOperator/DetectorPipeOperator/DetectorPipeOperator.hpp`)
- Energy Calculator → Tuple: reads and updates (evidence: `include/Operator/PipeOperator/EnergyCalculatorPipeOperator/EnergyCalculatorPipeOperator.hpp`)
- Energy Calculator → Typed Values: uses (evidence: `include/Operator/PipeOperator/EnergyCalculatorPipeOperator/EnergyCalculatorPipeOperator.hpp`)
- Calculation Expressions → Expressions: extends (evidence: `include/Expression/Calculation/CalculationExpression.hpp`)
- Calculation Expressions → Typed Values: uses (evidence: `include/Expression/Calculation/CalculationExpression.hpp`)
- Comparison Expressions → Expressions: extends (evidence: `include/Expression/Compare/CompareExpression.hpp`)
- Comparison Expressions → Typed Values: uses (evidence: `include/Expression/Compare/CompareExpression.hpp`)
- Expressions → Tuple: reads values (evidence: `include/Expression/IExpression.hpp`)
- Expressions → Typed Values: uses (evidence: `include/Expression/IExpression.hpp`)
