# ylaxor/flowar architecture

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

- Interactive diagram: https://gitdiagram.com/ylaxor/flowar
- Repository: https://github.com/ylaxor/flowar

## Overview

FlowAR is a Streamlit research framework for developing and evaluating binary-sensor human activity recognition. Users load a smart-home dataset, explore it, configure segmentation and representation, and run classification or hyperparameter search; cross-validation evaluates the resulting pipeline. The graph preserves the documented GUI stages and backend evaluation capabilities. Some page implementations and algorithm variants were not sampled, so their internal calls are omitted rather than inferred.

Main entry points: [`backend/classification/quality/cv.py`](https://github.com/ylaxor/flowar/blob/main/backend/classification/quality/cv.py) (Classification cross-validation), [`gui/main.py`](https://github.com/ylaxor/flowar/blob/main/gui/main.py) (Streamlit app), [`gui/pages/3_classification.py`](https://github.com/ylaxor/flowar/blob/main/gui/pages/3_classification.py) (Classification page), [`gui/components/data_loader.py`](https://github.com/ylaxor/flowar/blob/main/gui/components/data_loader.py) (Dataset loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gui["Research interface"]
  node_app["Streamlit app<br/>[main.py]"]
  node_explore["Dataset exploration<br/>[0_exploration.py]"]
  node_segment_ui["Segmentation page<br/>[1_segmentation.py]"]
  node_representation_ui["Representation page"]
  node_classification_ui["Classification page"]
  node_controls["Method controls<br/>[shared.py]"]
  node_loader["Dataset loader<br/>[data_loader.py]"]
end

subgraph group_data["Dataset and domain"]
  node_dataset["Smart-home dataset<br/>[base.py]"]
  node_domain["Events and segments<br/>[models.py]"]
end

subgraph group_pipeline["Recognition pipeline"]
  node_segmentation["Segmentation methods"]
  node_representation["Feature extractors"]
  node_annotation["Activity annotators"]
  node_classifiers["Classifiers"]
end

subgraph group_evaluation["Evaluation and tuning"]
  node_seg_quality["Segmentation metrics<br/>[metrics.py]"]
  node_seg_cv["Segmentation validation<br/>[cv.py]"]
  node_rep_quality["Representation analysis"]
  node_clf_cv["Classification cross-validation<br/>[cv.py]"]
  node_clf_metrics["Classification metrics<br/>[metrics.py]"]
  node_optimizer["Hyperparameter search<br/>[optimizer.py]"]
end

node_user(("Researcher"))

node_user -->|"opens"| node_app
node_app -.->|"presents"| node_explore
node_app -.->|"presents"| node_segment_ui
node_app -.->|"presents"| node_representation_ui
node_app -.->|"presents"| node_classification_ui
node_explore -->|"uses"| node_loader
node_segment_ui -.->|"uses"| node_loader
node_representation_ui -->|"uses"| node_loader
node_classification_ui -->|"uses"| node_loader
node_representation_ui -->|"uses"| node_controls
node_classification_ui -->|"uses"| node_controls
node_loader -->|"loads"| node_dataset
node_dataset -->|"builds events"| node_domain
node_controls -->|"runs annotator"| node_annotation
node_classification_ui -->|"runs segmenter"| node_segmentation
node_classification_ui -->|"configures search"| node_optimizer
node_clf_cv -->|"splits dataset"| node_dataset
node_clf_cv -->|"fits and transforms"| node_segmentation
node_clf_cv -->|"extracts features"| node_representation
node_clf_cv -->|"labels segments"| node_annotation
node_clf_cv -->|"fits and predicts"| node_classifiers
node_clf_cv -->|"scores boundaries"| node_seg_quality
node_clf_cv -->|"scores labels"| node_clf_metrics
node_optimizer -->|"evaluates candidates"| node_clf_cv
node_seg_cv -->|"validates methods"| node_segmentation
node_representation_ui -->|"analyzes results"| node_rep_quality

click node_app "https://github.com/ylaxor/flowar/blob/main/gui/main.py"
click node_explore "https://github.com/ylaxor/flowar/blob/main/gui/pages/0_exploration.py"
click node_segment_ui "https://github.com/ylaxor/flowar/blob/main/gui/pages/1_segmentation.py"
click node_representation_ui "https://github.com/ylaxor/flowar/blob/main/gui/pages/2_representation.py"
click node_classification_ui "https://github.com/ylaxor/flowar/blob/main/gui/pages/3_classification.py"
click node_controls "https://github.com/ylaxor/flowar/blob/main/gui/components/shared.py"
click node_loader "https://github.com/ylaxor/flowar/blob/main/gui/components/data_loader.py"
click node_dataset "https://github.com/ylaxor/flowar/blob/main/backend/dataset/methods/base.py"
click node_domain "https://github.com/ylaxor/flowar/blob/main/backend/models.py"
click node_segmentation "https://github.com/ylaxor/flowar/tree/main/backend/segmentation/methods"
click node_representation "https://github.com/ylaxor/flowar/tree/main/backend/representation/methods"
click node_annotation "https://github.com/ylaxor/flowar/tree/main/backend/annotation/methods"
click node_classifiers "https://github.com/ylaxor/flowar/tree/main/backend/classification/methods"
click node_seg_quality "https://github.com/ylaxor/flowar/blob/main/backend/segmentation/quality/metrics.py"
click node_seg_cv "https://github.com/ylaxor/flowar/blob/main/backend/segmentation/quality/cv.py"
click node_rep_quality "https://github.com/ylaxor/flowar/tree/main/backend/representation/quality"
click node_clf_cv "https://github.com/ylaxor/flowar/blob/main/backend/classification/quality/cv.py"
click node_clf_metrics "https://github.com/ylaxor/flowar/blob/main/backend/classification/quality/metrics.py"
click node_optimizer "https://github.com/ylaxor/flowar/blob/main/backend/classification/optimization/optimizer.py"

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_app,node_explore,node_segment_ui,node_representation_ui,node_classification_ui,node_controls,node_loader toneBlue
class node_dataset,node_domain toneAmber
class node_segmentation,node_representation,node_annotation,node_classifiers toneMint
class node_seg_quality,node_seg_cv,node_rep_quality,node_clf_cv,node_clf_metrics,node_optimizer toneRose
class node_user toneIndigo
```

## Components

### Research interface

- [Streamlit app](https://github.com/ylaxor/flowar/blob/main/gui/main.py): `gui/main.py`
- [Dataset exploration](https://github.com/ylaxor/flowar/blob/main/gui/pages/0_exploration.py): `gui/pages/0_exploration.py`
- [Segmentation page](https://github.com/ylaxor/flowar/blob/main/gui/pages/1_segmentation.py): `gui/pages/1_segmentation.py`
- [Representation page](https://github.com/ylaxor/flowar/blob/main/gui/pages/2_representation.py): `gui/pages/2_representation.py`
- [Classification page](https://github.com/ylaxor/flowar/blob/main/gui/pages/3_classification.py): `gui/pages/3_classification.py`
- [Method controls](https://github.com/ylaxor/flowar/blob/main/gui/components/shared.py): `gui/components/shared.py`
- [Dataset loader](https://github.com/ylaxor/flowar/blob/main/gui/components/data_loader.py): `gui/components/data_loader.py`

### Dataset and domain

- [Smart-home dataset](https://github.com/ylaxor/flowar/blob/main/backend/dataset/methods/base.py): `backend/dataset/methods/base.py`
- [Events and segments](https://github.com/ylaxor/flowar/blob/main/backend/models.py): `backend/models.py`

### Recognition pipeline

- [Segmentation methods](https://github.com/ylaxor/flowar/tree/main/backend/segmentation/methods): `backend/segmentation/methods`
- [Feature extractors](https://github.com/ylaxor/flowar/tree/main/backend/representation/methods): `backend/representation/methods`
- [Activity annotators](https://github.com/ylaxor/flowar/tree/main/backend/annotation/methods): `backend/annotation/methods`
- [Classifiers](https://github.com/ylaxor/flowar/tree/main/backend/classification/methods): `backend/classification/methods`

### Evaluation and tuning

- [Segmentation metrics](https://github.com/ylaxor/flowar/blob/main/backend/segmentation/quality/metrics.py): `backend/segmentation/quality/metrics.py`
- [Segmentation validation](https://github.com/ylaxor/flowar/blob/main/backend/segmentation/quality/cv.py): `backend/segmentation/quality/cv.py`
- [Representation analysis](https://github.com/ylaxor/flowar/tree/main/backend/representation/quality): `backend/representation/quality`
- [Classification cross-validation](https://github.com/ylaxor/flowar/blob/main/backend/classification/quality/cv.py): `backend/classification/quality/cv.py`
- [Classification metrics](https://github.com/ylaxor/flowar/blob/main/backend/classification/quality/metrics.py): `backend/classification/quality/metrics.py`
- [Hyperparameter search](https://github.com/ylaxor/flowar/blob/main/backend/classification/optimization/optimizer.py): `backend/classification/optimization/optimizer.py`

### Other components

- **Researcher**

## Connections

- Researcher → Streamlit app: opens
- Streamlit app → Dataset exploration: presents
- Streamlit app → Segmentation page: presents
- Streamlit app → Representation page: presents
- Streamlit app → Classification page: presents
- Dataset exploration → Dataset loader: uses (evidence: `gui/pages/0_exploration.py`)
- Segmentation page → Dataset loader: uses
- Representation page → Dataset loader: uses (evidence: `gui/pages/2_representation.py`)
- Classification page → Dataset loader: uses (evidence: `gui/pages/3_classification.py`)
- Representation page → Method controls: uses (evidence: `gui/pages/2_representation.py`)
- Classification page → Method controls: uses (evidence: `gui/pages/3_classification.py`)
- Dataset loader → Smart-home dataset: loads (evidence: `gui/components/data_loader.py`)
- Smart-home dataset → Events and segments: builds events (evidence: `backend/dataset/methods/base.py`)
- Method controls → Activity annotators: runs annotator (evidence: `gui/components/shared.py`)
- Classification page → Segmentation methods: runs segmenter (evidence: `gui/pages/3_classification.py`)
- Classification page → Hyperparameter search: configures search (evidence: `gui/pages/3_classification.py`)
- Classification cross-validation → Smart-home dataset: splits dataset (evidence: `backend/classification/quality/cv.py`)
- Classification cross-validation → Segmentation methods: fits and transforms (evidence: `backend/classification/quality/cv.py`)
- Classification cross-validation → Feature extractors: extracts features (evidence: `backend/classification/quality/cv.py`)
- Classification cross-validation → Activity annotators: labels segments (evidence: `backend/classification/quality/cv.py`)
- Classification cross-validation → Classifiers: fits and predicts (evidence: `backend/classification/quality/cv.py`)
- Classification cross-validation → Segmentation metrics: scores boundaries (evidence: `backend/classification/quality/cv.py`)
- Classification cross-validation → Classification metrics: scores labels (evidence: `backend/classification/quality/cv.py`)
- Hyperparameter search → Classification cross-validation: evaluates candidates (evidence: `backend/classification/optimization/optimizer.py`)
- Segmentation validation → Segmentation methods: validates methods (evidence: `backend/segmentation/quality/cv.py`)
- Representation page → Representation analysis: analyzes results (evidence: `gui/pages/2_representation.py`)
