# osupcvlab/mobileunetr architecture

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

- Interactive diagram: https://gitdiagram.com/osupcvlab/mobileunetr
- Repository: https://github.com/osupcvlab/mobileunetr

## Overview

MobileUNETR is a medical-image segmentation model and experiment framework. The principal workflow is to launch a dataset-specific experiment, load image/mask pairs from CSV-backed ISIC datasets, augment and batch them, build a MobileUNETR variant, then train and validate it with configured losses, optimization, and segmentation metrics. The README also documents offline/online experiment tracking and reports results across several medical datasets. The graph follows the sampled 2016 runner and indexed counterparts; model internals and some trainer behavior are only partially excerpted.

Main entry points: [`experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py) (ISIC 2016 runner), [`experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py) (ISIC 2017 runner), [`experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py) (ISIC 2018 runner), [`experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py) (PH2 runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experiment["Experiment setup"]
  node_isic2016["ISIC 2016 runner<br/>[run_experiment.py]"]
  node_isic2017["ISIC 2017 runner<br/>[run_experiment.py]"]
  node_isic2018["ISIC 2018 runner<br/>[run_experiment.py]"]
  node_ph2["PH2 runner<br/>[run_experiment.py]"]
end

subgraph group_data["Data preparation"]
  node_csvdata["CSV image/mask data"]
  node_dataset_builder["Dataset builder<br/>[build_dataset.py]"]
  node_isic_dataset["ISIC datasets<br/>[isic_dataset.py]"]
  node_augmentations["Augmentation transforms"]
  node_tv_augmentations["Torchvision transforms"]
end

subgraph group_model["Segmentation model"]
  node_architecture_builder["Architecture selector"]
  node_mobileunetr["MobileUNETR variants<br/>[mobileunetr.py]"]
end

subgraph group_training["Training and evaluation"]
  node_losses["Segmentation losses<br/>[losses.py]"]
  node_optimizers["Optimizer builder<br/>[optimizers.py]"]
  node_schedulers["Learning-rate schedulers<br/>[schedulers.py]"]
  node_trainer["Segmentation trainer"]
  node_ema["EMA updates<br/>[ema.py]"]
end

node_user(("Experiment user"))
node_wandb(("Weights &amp; Biases"))

node_user -->|"launches"| node_isic2016
node_user -->|"launches"| node_isic2017
node_user -->|"launches"| node_isic2018
node_user -->|"launches"| node_ph2
node_isic2016 -->|"builds loaders"| node_dataset_builder
node_isic2017 -->|"builds loaders"| node_dataset_builder
node_isic2018 -->|"builds loaders"| node_dataset_builder
node_ph2 -->|"builds loaders"| node_dataset_builder
node_dataset_builder -->|"selects dataset"| node_isic_dataset
node_dataset_builder -->|"uses transforms"| node_augmentations
node_dataset_builder -->|"uses transforms"| node_tv_augmentations
node_csvdata -->|"provides image paths"| node_isic_dataset
node_isic2016 -->|"builds model"| node_architecture_builder
node_isic2017 -->|"builds model"| node_architecture_builder
node_isic2018 -->|"builds model"| node_architecture_builder
node_ph2 -->|"builds model"| node_architecture_builder
node_architecture_builder -->|"selects variant"| node_mobileunetr
node_isic2016 -->|"builds criterion"| node_losses
node_isic2017 -->|"builds criterion"| node_losses
node_isic2018 -->|"builds criterion"| node_losses
node_ph2 -->|"builds criterion"| node_losses
node_isic2016 -->|"builds optimizer"| node_optimizers
node_isic2017 -->|"builds optimizer"| node_optimizers
node_isic2018 -->|"builds optimizer"| node_optimizers
node_ph2 -->|"builds optimizer"| node_optimizers
node_isic2016 -->|"builds schedulers"| node_schedulers
node_isic2017 -->|"builds schedulers"| node_schedulers
node_isic2018 -->|"builds schedulers"| node_schedulers
node_ph2 -->|"builds schedulers"| node_schedulers
node_isic2016 -->|"configures trainer"| node_trainer
node_isic2017 -->|"configures trainer"| node_trainer
node_isic2018 -->|"configures trainer"| node_trainer
node_ph2 -->|"configures trainer"| node_trainer
node_trainer -->|"updates EMA"| node_ema
node_isic2016 -.->|"initializes tracking"| node_wandb
node_isic2017 -.->|"initializes tracking"| node_wandb
node_isic2018 -.->|"initializes tracking"| node_wandb
node_ph2 -.->|"initializes tracking"| node_wandb

click node_isic2016 "https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py"
click node_isic2017 "https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py"
click node_isic2018 "https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py"
click node_ph2 "https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py"
click node_dataset_builder "https://github.com/osupcvlab/mobileunetr/blob/main/dataloaders/build_dataset.py"
click node_isic_dataset "https://github.com/osupcvlab/mobileunetr/blob/main/dataloaders/isic_dataset.py"
click node_augmentations "https://github.com/osupcvlab/mobileunetr/blob/main/augmentations/segmentation_augmentations.py"
click node_tv_augmentations "https://github.com/osupcvlab/mobileunetr/blob/main/augmentations/segmentation_augmentations_tv.py"
click node_architecture_builder "https://github.com/osupcvlab/mobileunetr/blob/main/architectures/build_architecture.py"
click node_mobileunetr "https://github.com/osupcvlab/mobileunetr/blob/main/architectures/mobileunetr.py"
click node_losses "https://github.com/osupcvlab/mobileunetr/blob/main/losses/losses.py"
click node_optimizers "https://github.com/osupcvlab/mobileunetr/blob/main/optimizers/optimizers.py"
click node_schedulers "https://github.com/osupcvlab/mobileunetr/blob/main/optimizers/schedulers.py"
click node_trainer "https://github.com/osupcvlab/mobileunetr/blob/main/train_scripts/segmentation_trainer.py"
click node_ema "https://github.com/osupcvlab/mobileunetr/blob/main/train_scripts/ema.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_isic2016,node_isic2017,node_isic2018,node_ph2,node_user toneBlue
class node_csvdata,node_dataset_builder,node_isic_dataset,node_augmentations,node_tv_augmentations toneAmber
class node_architecture_builder,node_mobileunetr toneMint
class node_losses,node_optimizers,node_schedulers,node_trainer,node_ema toneRose
class node_wandb toneIndigo
```

## Components

### Experiment setup

- [ISIC 2016 runner](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py): `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`
- [ISIC 2017 runner](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py): `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`
- [ISIC 2018 runner](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py): `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`
- [PH2 runner](https://github.com/osupcvlab/mobileunetr/blob/main/experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py): `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`

### Data preparation

- **CSV image/mask data**
- [Dataset builder](https://github.com/osupcvlab/mobileunetr/blob/main/dataloaders/build_dataset.py): `dataloaders/build_dataset.py`
- [ISIC datasets](https://github.com/osupcvlab/mobileunetr/blob/main/dataloaders/isic_dataset.py): `dataloaders/isic_dataset.py`
- [Augmentation transforms](https://github.com/osupcvlab/mobileunetr/blob/main/augmentations/segmentation_augmentations.py): `augmentations/segmentation_augmentations.py`
- [Torchvision transforms](https://github.com/osupcvlab/mobileunetr/blob/main/augmentations/segmentation_augmentations_tv.py): `augmentations/segmentation_augmentations_tv.py`

### Segmentation model

- [Architecture selector](https://github.com/osupcvlab/mobileunetr/blob/main/architectures/build_architecture.py): `architectures/build_architecture.py`
- [MobileUNETR variants](https://github.com/osupcvlab/mobileunetr/blob/main/architectures/mobileunetr.py): `architectures/mobileunetr.py`

### Training and evaluation

- [Segmentation losses](https://github.com/osupcvlab/mobileunetr/blob/main/losses/losses.py): `losses/losses.py`
- [Optimizer builder](https://github.com/osupcvlab/mobileunetr/blob/main/optimizers/optimizers.py): `optimizers/optimizers.py`
- [Learning-rate schedulers](https://github.com/osupcvlab/mobileunetr/blob/main/optimizers/schedulers.py): `optimizers/schedulers.py`
- [Segmentation trainer](https://github.com/osupcvlab/mobileunetr/blob/main/train_scripts/segmentation_trainer.py): `train_scripts/segmentation_trainer.py`
- [EMA updates](https://github.com/osupcvlab/mobileunetr/blob/main/train_scripts/ema.py): `train_scripts/ema.py`

### Other components

- **Experiment user**
- **Weights & Biases**

## Connections

- Experiment user → ISIC 2016 runner: launches (evidence: `README.md`)
- Experiment user → ISIC 2017 runner: launches (evidence: `README.md`)
- Experiment user → ISIC 2018 runner: launches (evidence: `README.md`)
- Experiment user → PH2 runner: launches (evidence: `README.md`)
- ISIC 2016 runner → Dataset builder: builds loaders (evidence: `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2017 runner → Dataset builder: builds loaders (evidence: `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2018 runner → Dataset builder: builds loaders (evidence: `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`)
- PH2 runner → Dataset builder: builds loaders (evidence: `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`)
- Dataset builder → ISIC datasets: selects dataset (evidence: `dataloaders/build_dataset.py`)
- Dataset builder → Augmentation transforms: uses transforms (evidence: `dataloaders/build_dataset.py`)
- Dataset builder → Torchvision transforms: uses transforms (evidence: `dataloaders/build_dataset.py`)
- CSV image/mask data → ISIC datasets: provides image paths (evidence: `README.md`)
- ISIC 2016 runner → Architecture selector: builds model (evidence: `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2017 runner → Architecture selector: builds model (evidence: `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2018 runner → Architecture selector: builds model (evidence: `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`)
- PH2 runner → Architecture selector: builds model (evidence: `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`)
- Architecture selector → MobileUNETR variants: selects variant (evidence: `architectures/build_architecture.py`)
- ISIC 2016 runner → Segmentation losses: builds criterion (evidence: `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2017 runner → Segmentation losses: builds criterion (evidence: `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2018 runner → Segmentation losses: builds criterion (evidence: `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`)
- PH2 runner → Segmentation losses: builds criterion (evidence: `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2016 runner → Optimizer builder: builds optimizer (evidence: `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2017 runner → Optimizer builder: builds optimizer (evidence: `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2018 runner → Optimizer builder: builds optimizer (evidence: `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`)
- PH2 runner → Optimizer builder: builds optimizer (evidence: `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2016 runner → Learning-rate schedulers: builds schedulers (evidence: `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2017 runner → Learning-rate schedulers: builds schedulers (evidence: `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2018 runner → Learning-rate schedulers: builds schedulers (evidence: `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`)
- PH2 runner → Learning-rate schedulers: builds schedulers (evidence: `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2016 runner → Segmentation trainer: configures trainer (evidence: `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2017 runner → Segmentation trainer: configures trainer (evidence: `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2018 runner → Segmentation trainer: configures trainer (evidence: `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`)
- PH2 runner → Segmentation trainer: configures trainer (evidence: `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`)
- Segmentation trainer → EMA updates: updates EMA (evidence: `train_scripts/segmentation_trainer.py`)
- ISIC 2016 runner → Weights & Biases: initializes tracking (evidence: `experiments_medical/isic_2016/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2017 runner → Weights & Biases: initializes tracking (evidence: `experiments_medical/isic_2017/exp_2_dice_b8_a2/run_experiment.py`)
- ISIC 2018 runner → Weights & Biases: initializes tracking (evidence: `experiments_medical/isic_2018/exp_2_dice_b8_a2/run_experiment.py`)
- PH2 runner → Weights & Biases: initializes tracking (evidence: `experiments_medical/ph2/exp_2_dice_b8_a2/run_experiment.py`)
