# hiimsharon/icu-ventilator-adjustment architecture

> Architecture diagram of the GitHub repository hiimsharon/icu-ventilator-adjustment, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hiimsharon/icu-ventilator-adjustment
- Repository: https://github.com/hiimsharon/icu-ventilator-adjustment

## Overview

This repository documents a research framework for predicting ICU ventilator adjustments, rather than containing an executable implementation: the tree has no source code, and the phase repositories are represented only by a placeholder directory. The documented workflow transforms ICU telemetry into phase-specific sequences, then models adjustment need, direction, and target settings before evaluation. LSTM/GRU modeling, TPE optimization, and checkpoint selection are described as model-development capabilities. Relationships below reflect the README’s stated framework; implementation-level calls cannot be verified.

Main entry points: [`README.md`](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md) (Adjustment direction), [`PREPROCESSING.md`](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/PREPROCESSING.md) (Data processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_preprocessing["Data processing<br/>[PREPROCESSING.md]"]
  node_samples["Sample formulation<br/>[README.md]"]
  node_sequences["Sequence generation<br/>[README.md]"]
end

subgraph group_decisions["Clinical decisions"]
  node_phase1["Adjustment need<br/>[README.md]"]
  node_phase21["Adjustment direction<br/>[README.md]"]
  node_phase22["Setting recommendation<br/>[README.md]"]
end

subgraph group_modeling["Model development"]
  node_sequence_models["LSTM / GRU models<br/>[README.md]"]
  node_optimization["TPE optimization<br/>[README.md]"]
  node_model_selection["Checkpoint selection<br/>[README.md]"]
end

subgraph group_evaluation["Evaluation"]
  node_phase_evaluation["Phase evaluation<br/>[README.md]"]
end

node_icu_streams(("ICU telemetry"))

node_icu_streams -->|"provides records"| node_preprocessing
node_preprocessing -->|"processed data"| node_samples
node_samples -->|"forms windows"| node_sequences
node_sequences -->|"feeds task"| node_phase1
node_sequences -->|"feeds task"| node_phase21
node_sequences -->|"feeds task"| node_phase22
node_phase1 -->|"confirms trigger"| node_phase21
node_phase21 -->|"guides targets"| node_phase22
node_phase1 -->|"modeled by"| node_sequence_models
node_phase21 -->|"modeled by"| node_sequence_models
node_phase22 -->|"modeled by"| node_sequence_models
node_optimization -->|"tunes parameters"| node_sequence_models
node_sequence_models -->|"produces candidates"| node_model_selection
node_model_selection -->|"selected checkpoints"| node_phase_evaluation
node_phase1 -->|"evaluated by"| node_phase_evaluation
node_phase21 -->|"evaluated by"| node_phase_evaluation
node_phase22 -->|"evaluated by"| node_phase_evaluation

click node_preprocessing "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/PREPROCESSING.md"
click node_samples "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_sequences "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_phase1 "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_phase21 "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_phase22 "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_sequence_models "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_optimization "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_model_selection "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"
click node_phase_evaluation "https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md"

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_preprocessing,node_samples,node_sequences toneBlue
class node_phase1,node_phase21,node_phase22 toneAmber
class node_sequence_models,node_optimization,node_model_selection toneMint
class node_phase_evaluation toneRose
class node_icu_streams toneIndigo
```

## Components

### Data preparation

- [Data processing](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/PREPROCESSING.md): `PREPROCESSING.md`
- [Sample formulation](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`
- [Sequence generation](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`

### Clinical decisions

- [Adjustment need](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`
- [Adjustment direction](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`
- [Setting recommendation](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`

### Model development

- [LSTM / GRU models](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`
- [TPE optimization](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`
- [Checkpoint selection](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`

### Evaluation

- [Phase evaluation](https://github.com/hiimsharon/icu-ventilator-adjustment/blob/main/README.md): `README.md`

### Other components

- **ICU telemetry**

## Connections

- ICU telemetry → Data processing: provides records
- Data processing → Sample formulation: processed data
- Sample formulation → Sequence generation: forms windows
- Sequence generation → Adjustment need: feeds task
- Sequence generation → Adjustment direction: feeds task
- Sequence generation → Setting recommendation: feeds task
- Adjustment need → Adjustment direction: confirms trigger
- Adjustment direction → Setting recommendation: guides targets
- Adjustment need → LSTM / GRU models: modeled by
- Adjustment direction → LSTM / GRU models: modeled by
- Setting recommendation → LSTM / GRU models: modeled by
- TPE optimization → LSTM / GRU models: tunes parameters
- LSTM / GRU models → Checkpoint selection: produces candidates
- Checkpoint selection → Phase evaluation: selected checkpoints
- Adjustment need → Phase evaluation: evaluated by
- Adjustment direction → Phase evaluation: evaluated by
- Setting recommendation → Phase evaluation: evaluated by