# iranchamika/paper2-segperturb-fm-radiomics architecture

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

- Interactive diagram: https://gitdiagram.com/iranchamika/paper2-segperturb-fm-radiomics
- Repository: https://github.com/iranchamika/paper2-segperturb-fm-radiomics

## Overview

This repository implements a reproducible lung-nodule imaging study, not a general-purpose application. Its principal workflow downloads LIDC-IDRI scans, selects and labels nodules, creates mask perturbations, extracts radiomics and foundation-model features, measures feature stability, and evaluates malignancy classification and size-stratified performance. The README documents the pipeline order and major outputs; sampled scripts confirm several extraction and analysis roles. Unsampled modules are represented by their documented responsibilities, without asserting internal calls beyond the documented workflow.

Main entry points: [`code/05_extract_fm_embeddings.py`](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/05_extract_fm_embeddings.py) (FM embeddings), [`code/04_extract_radiomics.py`](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/04_extract_radiomics.py) (Radiomics 2D/3D), [`code/07_downstream_classifier.py`](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/07_downstream_classifier.py) (Malignancy classifier), [`code/utils.py`](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/utils.py) (Image and seed helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cohort["Cohort preparation"]
  node_weight_setup["Cache BiomedCLIP"]
  node_download["Download CT scans"]
  node_select["Select nodules"]
  node_balance["Balance cohort"]
  node_perturb["Perturb masks"]
end

subgraph group_features["Feature extraction"]
  node_radiomics["Radiomics 2D/3D"]
  node_embeddings["FM embeddings"]
  node_utils["Image and seed helpers<br/>[utils.py]"]
end

subgraph group_analysis["Stability and evaluation"]
  node_icc["Compute ICC<br/>[06_compute_icc.py]"]
  node_classifier["Malignancy classifier"]
  node_subgroup["Diameter subgroups"]
  node_icc_results["ICC results<br/>[icc_table.csv]"]
  node_metrics["Classifier metrics"]
  node_stratum_metrics["Stratum metrics"]
end

subgraph group_reporting["Study outputs"]
  node_figures["Study figures<br/>[08_make_figures.py]"]
  node_manuscript["Manuscript<br/>[main.tex]"]
end

node_researcher(("Researcher"))
node_tcia[("TCIA LIDC-IDRI")]
node_weight_cache[("FM weights")]

node_researcher -->|"caches weights"| node_weight_setup
node_weight_setup -->|"downloads BiomedCLIP"| node_weight_cache
node_researcher -->|"starts pipeline"| node_download
node_tcia -->|"provides scans"| node_download
node_download -->|"supplies DICOMs"| node_select
node_select -->|"writes cohort labels"| node_balance
node_select -->|"provides nodule masks"| node_perturb
node_perturb -->|"supplies perturbed masks"| node_radiomics
node_perturb -->|"supplies perturbed masks"| node_embeddings
node_weight_cache -->|"loads cached weights"| node_embeddings
node_utils -->|"supports image I/O"| node_select
node_utils -->|"supports image processing"| node_perturb
node_utils -->|"supports image processing"| node_radiomics
node_utils -->|"provides slice helpers"| node_embeddings
node_radiomics -->|"writes feature parquets"| node_icc
node_embeddings -->|"writes feature parquets"| node_icc
node_icc -->|"writes ICC table"| node_icc_results
node_radiomics -->|"provides features"| node_classifier
node_embeddings -->|"provides features"| node_classifier
node_balance -->|"provides labels"| node_classifier
node_icc_results -->|"filters features"| node_classifier
node_classifier -->|"writes metrics"| node_metrics
node_radiomics -->|"provides features"| node_subgroup
node_embeddings -->|"provides features"| node_subgroup
node_balance -->|"provides labels"| node_subgroup
node_subgroup -->|"writes metrics"| node_stratum_metrics
node_icc_results -->|"supplies analysis data"| node_figures
node_metrics -->|"supplies analysis data"| node_figures
node_stratum_metrics -->|"supplies analysis data"| node_figures
node_figures -->|"provides figures"| node_manuscript

click node_weight_setup "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/00_download_weights.py"
click node_download "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/01_download_lidc.py"
click node_select "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/02_select_nodule_subset.py"
click node_balance "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/02b_balance_cohort.py"
click node_perturb "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/03_generate_perturbations.py"
click node_radiomics "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/04_extract_radiomics.py"
click node_embeddings "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/05_extract_fm_embeddings.py"
click node_utils "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/utils.py"
click node_icc "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/06_compute_icc.py"
click node_classifier "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/07_downstream_classifier.py"
click node_subgroup "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/07b_subgroup_analysis.py"
click node_icc_results "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/results/icc_table.csv"
click node_metrics "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/results/downstream_metrics.csv"
click node_stratum_metrics "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/results/downstream_metrics_by_stratum.csv"
click node_figures "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/08_make_figures.py"
click node_manuscript "https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/overleaf_project/main.tex"

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_weight_setup,node_download,node_select,node_balance,node_perturb toneBlue
class node_radiomics,node_embeddings,node_utils,node_tcia,node_weight_cache toneAmber
class node_icc,node_classifier,node_subgroup,node_icc_results,node_metrics,node_stratum_metrics toneMint
class node_figures,node_manuscript toneRose
class node_researcher toneIndigo
```

## Components

### Cohort preparation

- [Cache BiomedCLIP](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/00_download_weights.py): `code/00_download_weights.py`
- [Download CT scans](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/01_download_lidc.py): `code/01_download_lidc.py`
- [Select nodules](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/02_select_nodule_subset.py): `code/02_select_nodule_subset.py`
- [Balance cohort](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/02b_balance_cohort.py): `code/02b_balance_cohort.py`
- [Perturb masks](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/03_generate_perturbations.py): `code/03_generate_perturbations.py`

### Feature extraction

- [Radiomics 2D/3D](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/04_extract_radiomics.py): `code/04_extract_radiomics.py`
- [FM embeddings](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/05_extract_fm_embeddings.py): `code/05_extract_fm_embeddings.py`
- [Image and seed helpers](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/utils.py): `code/utils.py`

### Stability and evaluation

- [Compute ICC](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/06_compute_icc.py): `code/06_compute_icc.py`
- [Malignancy classifier](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/07_downstream_classifier.py): `code/07_downstream_classifier.py`
- [Diameter subgroups](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/07b_subgroup_analysis.py): `code/07b_subgroup_analysis.py`
- [ICC results](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/results/icc_table.csv): `results/icc_table.csv`
- [Classifier metrics](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/results/downstream_metrics.csv): `results/downstream_metrics.csv`
- [Stratum metrics](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/results/downstream_metrics_by_stratum.csv): `results/downstream_metrics_by_stratum.csv`

### Study outputs

- [Study figures](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/code/08_make_figures.py): `code/08_make_figures.py`
- [Manuscript](https://github.com/iranchamika/paper2-segperturb-fm-radiomics/blob/main/overleaf_project/main.tex): `overleaf_project/main.tex`

### Other components

- **Researcher**
- **TCIA LIDC-IDRI**
- **FM weights**

## Connections

- Researcher → Cache BiomedCLIP: caches weights (evidence: `README.md`)
- Cache BiomedCLIP → FM weights: downloads BiomedCLIP (evidence: `README.md`)
- Researcher → Download CT scans: starts pipeline (evidence: `README.md`)
- TCIA LIDC-IDRI → Download CT scans: provides scans (evidence: `README.md`)
- Download CT scans → Select nodules: supplies DICOMs (evidence: `README.md`)
- Select nodules → Balance cohort: writes cohort labels (evidence: `README.md`)
- Select nodules → Perturb masks: provides nodule masks (evidence: `README.md`)
- Perturb masks → Radiomics 2D/3D: supplies perturbed masks (evidence: `README.md`)
- Perturb masks → FM embeddings: supplies perturbed masks (evidence: `README.md`)
- FM weights → FM embeddings: loads cached weights (evidence: `README.md`)
- Image and seed helpers → Select nodules: supports image I/O (evidence: `code/02_select_nodule_subset.py`)
- Image and seed helpers → Perturb masks: supports image processing (evidence: `code/03_generate_perturbations.py`)
- Image and seed helpers → Radiomics 2D/3D: supports image processing (evidence: `code/04_extract_radiomics.py`)
- Image and seed helpers → FM embeddings: provides slice helpers (evidence: `code/05_extract_fm_embeddings.py`)
- Radiomics 2D/3D → Compute ICC: writes feature parquets (evidence: `README.md`)
- FM embeddings → Compute ICC: writes feature parquets (evidence: `README.md`)
- Compute ICC → ICC results: writes ICC table (evidence: `README.md`)
- Radiomics 2D/3D → Malignancy classifier: provides features (evidence: `README.md`)
- FM embeddings → Malignancy classifier: provides features (evidence: `README.md`)
- Balance cohort → Malignancy classifier: provides labels (evidence: `README.md`)
- ICC results → Malignancy classifier: filters features (evidence: `README.md`)
- Malignancy classifier → Classifier metrics: writes metrics (evidence: `README.md`)
- Radiomics 2D/3D → Diameter subgroups: provides features (evidence: `README.md`)
- FM embeddings → Diameter subgroups: provides features (evidence: `README.md`)
- Balance cohort → Diameter subgroups: provides labels (evidence: `README.md`)
- Diameter subgroups → Stratum metrics: writes metrics (evidence: `README.md`)
- ICC results → Study figures: supplies analysis data (evidence: `README.md`)
- Classifier metrics → Study figures: supplies analysis data (evidence: `README.md`)
- Stratum metrics → Study figures: supplies analysis data (evidence: `README.md`)
- Study figures → Manuscript: provides figures (evidence: `README.md`)
