# sri-nadella-c/cuffless-bp-monitoring architecture

> Architecture diagram of the GitHub repository sri-nadella-c/cuffless-bp-monitoring, 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/sri-nadella-c/cuffless-bp-monitoring
- Repository: https://github.com/sri-nadella-c/cuffless-bp-monitoring

## Overview

This repository is a cuffless blood-pressure research pipeline: an engineer supplies MATLAB patient records and runs `main.py` to produce pooled beat-level features, model evaluations, personalization and robustness results, example predictions, and figures. The graph separates record ingestion, feature construction, analysis stages, and presentation. Calls and file reads/writes are shown where the excerpts support them; analysis stages share `src/modeling.py`, and the README documents the broader reported capabilities.

Main entry points: [`main.py`](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/main.py) (Pipeline runner), [`src/figures.py`](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/figures.py) (Plot generation), [`src/pipeline.py`](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py) (Pooled dataset), [`results`](https://github.com/sri-nadella-c/cuffless-bp-monitoring/tree/main/results) (Analysis tables)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingestion["Signal ingestion"]
  node_mat_files["MAT records"]
  node_record_scan["Record discovery<br/>[pipeline.py]"]
  node_record_read["Record reader<br/>[pipeline.py]"]
  node_beat_features["Beat features<br/>[pipeline.py]"]
  node_pooled_data["Pooled dataset<br/>[pipeline.py]"]
end

subgraph group_analysis["BP analysis"]
  node_baseline["Baseline models<br/>[modeling.py]"]
  node_personalization["Personalization<br/>[modeling.py]"]
  node_robustness["Robustness checks<br/>[modeling.py]"]
  node_examples["Patient examples<br/>[modeling.py]"]
end

subgraph group_presentation["Results and figures"]
  node_result_files["Analysis tables"]
  node_plot_generation["Plot generation<br/>[figures.py]"]
  node_figure_files["Figures"]
end

node_user(("Researcher"))
node_runner["Pipeline runner<br/>[main.py]"]

node_user -->|"runs"| node_runner
node_mat_files -->|"scans"| node_record_scan
node_record_scan -->|"opens files"| node_record_read
node_record_scan -->|"builds dataset"| node_runner
node_record_read -->|"yields records"| node_beat_features
node_beat_features -->|"extracts beats"| node_pooled_data
node_runner -->|"evaluates"| node_baseline
node_runner -->|"calibrates"| node_personalization
node_runner -->|"checks stability"| node_robustness
node_runner -->|"generates examples"| node_examples
node_pooled_data -->|"provides data"| node_baseline
node_pooled_data -->|"provides data"| node_personalization
node_pooled_data -->|"provides data"| node_robustness
node_pooled_data -->|"provides data"| node_examples
node_runner -->|"writes tables"| node_result_files
node_baseline -->|"returns metrics"| node_result_files
node_personalization -->|"returns metrics"| node_result_files
node_robustness -->|"returns checks"| node_result_files
node_examples -->|"returns predictions"| node_result_files
node_runner -->|"dispatches plots"| node_plot_generation
node_pooled_data -->|"provides plot data"| node_plot_generation
node_baseline -->|"provides metrics"| node_plot_generation
node_personalization -->|"provides metrics"| node_plot_generation
node_examples -->|"provides predictions"| node_plot_generation
node_plot_generation -->|"reads sample record"| node_mat_files
node_plot_generation -->|"saves plots"| node_figure_files

click node_mat_files "https://github.com/sri-nadella-c/cuffless-bp-monitoring/tree/main/data"
click node_runner "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/main.py"
click node_record_scan "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py"
click node_record_read "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py"
click node_beat_features "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py"
click node_pooled_data "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py"
click node_baseline "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py"
click node_personalization "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py"
click node_robustness "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py"
click node_examples "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py"
click node_result_files "https://github.com/sri-nadella-c/cuffless-bp-monitoring/tree/main/results"
click node_plot_generation "https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/figures.py"
click node_figure_files "https://github.com/sri-nadella-c/cuffless-bp-monitoring/tree/main/figures"

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_mat_files,node_record_scan,node_record_read,node_beat_features,node_pooled_data toneBlue
class node_baseline,node_personalization,node_robustness,node_examples toneAmber
class node_result_files,node_plot_generation,node_figure_files toneMint
class node_user toneIndigo
class node_runner toneTeal
```

## Components

### Signal ingestion

- [MAT records](https://github.com/sri-nadella-c/cuffless-bp-monitoring/tree/main/data): `data`
- [Record discovery](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py): `src/pipeline.py`
- [Record reader](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py): `src/pipeline.py`
- [Beat features](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py): `src/pipeline.py`
- [Pooled dataset](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/pipeline.py): `src/pipeline.py`

### BP analysis

- [Baseline models](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py): `src/modeling.py`
- [Personalization](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py): `src/modeling.py`
- [Robustness checks](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py): `src/modeling.py`
- [Patient examples](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/modeling.py): `src/modeling.py`

### Results and figures

- [Analysis tables](https://github.com/sri-nadella-c/cuffless-bp-monitoring/tree/main/results): `results`
- [Plot generation](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/src/figures.py): `src/figures.py`
- [Figures](https://github.com/sri-nadella-c/cuffless-bp-monitoring/tree/main/figures): `figures`

### Other components

- **Researcher**
- [Pipeline runner](https://github.com/sri-nadella-c/cuffless-bp-monitoring/blob/main/main.py): `main.py`

## Connections

- Researcher → Pipeline runner: runs (evidence: `README.md`)
- MAT records → Record discovery: scans (evidence: `src/pipeline.py`)
- Record discovery → Record reader: opens files (evidence: `src/pipeline.py`)
- Record discovery → Pipeline runner: builds dataset (evidence: `main.py`)
- Record reader → Beat features: yields records (evidence: `src/pipeline.py`)
- Beat features → Pooled dataset: extracts beats (evidence: `src/pipeline.py`)
- Pipeline runner → Baseline models: evaluates (evidence: `main.py`)
- Pipeline runner → Personalization: calibrates (evidence: `main.py`)
- Pipeline runner → Robustness checks: checks stability (evidence: `main.py`)
- Pipeline runner → Patient examples: generates examples (evidence: `main.py`)
- Pooled dataset → Baseline models: provides data (evidence: `main.py`)
- Pooled dataset → Personalization: provides data (evidence: `main.py`)
- Pooled dataset → Robustness checks: provides data (evidence: `main.py`)
- Pooled dataset → Patient examples: provides data (evidence: `main.py`)
- Pipeline runner → Analysis tables: writes tables (evidence: `main.py`)
- Baseline models → Analysis tables: returns metrics
- Personalization → Analysis tables: returns metrics
- Robustness checks → Analysis tables: returns checks
- Patient examples → Analysis tables: returns predictions
- Pipeline runner → Plot generation: dispatches plots (evidence: `main.py`)
- Pooled dataset → Plot generation: provides plot data (evidence: `main.py`)
- Baseline models → Plot generation: provides metrics (evidence: `main.py`)
- Personalization → Plot generation: provides metrics (evidence: `main.py`)
- Patient examples → Plot generation: provides predictions (evidence: `main.py`)
- Plot generation → MAT records: reads sample record (evidence: `src/figures.py`)
- Plot generation → Figures: saves plots (evidence: `src/figures.py`)
