# rifat-binreza/mowaveqformer architecture

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

- Interactive diagram: https://gitdiagram.com/rifat-binreza/mowaveqformer
- Repository: https://github.com/rifat-binreza/mowaveqformer

## Overview

MoWaveQFormer is a research experiment snapshot, not an installable inference package. Its principal workflow is to load BUT PPG data, train and evaluate the notebook’s motion-conditioned, quality-gated heart-rate model, and retain recorded results. The README documents the experiment stages and outputs; notebook internals were not sampled, so the graph does not assert unverified calls or a fully automatic motion-conditioning pipeline.

Main entry points: [`notebooks/brnodatajournal.ipynb`](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb) (Experiment notebook), [`results/logs/kaggle-run.txt`](https://github.com/rifat-binreza/mowaveqformer/blob/main/results/logs/kaggle-run.txt) (Recorded run), [`results/metrics.csv`](https://github.com/rifat-binreza/mowaveqformer/blob/main/results/metrics.csv) (Comparison metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experiment["Notebook experiment"]
  node_experiment_notebook["Experiment notebook"]
  node_data_prep["Data preparation"]
  node_conditioning["Motion and quality"]
  node_model_training["Model training"]
  node_evaluation["Evaluation and baselines"]
  node_analysis["Statistical analysis"]
end

subgraph group_results["Recorded results"]
  node_training_outputs["Training outputs"]
  node_run_log["Recorded run<br/>[kaggle-run.txt]"]
  node_metrics["Comparison metrics<br/>[metrics.csv]"]
end

node_researcher(("Researcher"))
node_butppg[("BUT PPG data")]

node_researcher -->|"runs"| node_experiment_notebook
node_butppg -->|"supplies data"| node_experiment_notebook
node_experiment_notebook -->|"executes cells"| node_data_prep
node_experiment_notebook -->|"executes stages"| node_conditioning
node_experiment_notebook -->|"trains model"| node_model_training
node_experiment_notebook -->|"runs evaluation"| node_evaluation
node_experiment_notebook -->|"runs analysis"| node_analysis
node_model_training -->|"generates"| node_training_outputs
node_evaluation -->|"records run"| node_run_log
node_run_log -->|"transcribed into"| node_metrics

click node_experiment_notebook "https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb"
click node_data_prep "https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb"
click node_conditioning "https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb"
click node_model_training "https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb"
click node_evaluation "https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb"
click node_analysis "https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb"
click node_training_outputs "https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb"
click node_run_log "https://github.com/rifat-binreza/mowaveqformer/blob/main/results/logs/kaggle-run.txt"
click node_metrics "https://github.com/rifat-binreza/mowaveqformer/blob/main/results/metrics.csv"

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_experiment_notebook,node_data_prep,node_conditioning,node_model_training,node_evaluation,node_analysis toneBlue
class node_training_outputs,node_run_log,node_metrics,node_butppg toneAmber
class node_researcher toneIndigo
```

## Components

### Notebook experiment

- [Experiment notebook](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb): `notebooks/brnodatajournal.ipynb`
- [Data preparation](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb): `notebooks/brnodatajournal.ipynb`
- [Motion and quality](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb): `notebooks/brnodatajournal.ipynb`
- [Model training](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb): `notebooks/brnodatajournal.ipynb`
- [Evaluation and baselines](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb): `notebooks/brnodatajournal.ipynb`
- [Statistical analysis](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb): `notebooks/brnodatajournal.ipynb`

### Recorded results

- [Training outputs](https://github.com/rifat-binreza/mowaveqformer/blob/main/notebooks/brnodatajournal.ipynb): `notebooks/brnodatajournal.ipynb`
- [Recorded run](https://github.com/rifat-binreza/mowaveqformer/blob/main/results/logs/kaggle-run.txt): `results/logs/kaggle-run.txt`
- [Comparison metrics](https://github.com/rifat-binreza/mowaveqformer/blob/main/results/metrics.csv): `results/metrics.csv`

### Other components

- **Researcher**
- **BUT PPG data**

## Connections

- Researcher → Experiment notebook: runs (evidence: `README.md`)
- BUT PPG data → Experiment notebook: supplies data (evidence: `README.md`)
- Experiment notebook → Data preparation: executes cells (evidence: `README.md`)
- Experiment notebook → Motion and quality: executes stages (evidence: `README.md`)
- Experiment notebook → Model training: trains model (evidence: `README.md`)
- Experiment notebook → Evaluation and baselines: runs evaluation (evidence: `README.md`)
- Experiment notebook → Statistical analysis: runs analysis (evidence: `README.md`)
- Model training → Training outputs: generates (evidence: `README.md`)
- Evaluation and baselines → Recorded run: records run (evidence: `README.md`)
- Recorded run → Comparison metrics: transcribed into (evidence: `README.md`)
