# ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray- architecture

> Architecture diagram of the GitHub repository ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-
- Repository: https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-

## Overview

Extension 1 is lightweight scaffolding for reproducible medical-image super-resolution experiments: it validates a fixed evaluation protocol, plans training and sensitivity runs, describes baseline commands, and supports per-image evaluation and seed aggregation. The principal workflow is CLI invocation through manifest validation and run planning; separate commands handle baselines, sensitivity, and result aggregation. Source excerpts show the CLI, runner, configuration, manifest, and aggregation relationships. Evaluation, plotting, and statistical comparison modules are present, but their integration with other modules is not shown.

Main entry points: [`Major project/extension1/cli.py`](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/cli.py) (Command CLI), [`Major project/extension1/runner.py`](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/runner.py) (Run planner), [`Major project/extension1/manifest.py`](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/manifest.py) (Manifest validation), [`Major project/extension1/sensitivity.py`](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/sensitivity.py) (Sensitivity planner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Experiment workflow"]
  node_cli["Command CLI<br/>[cli.py]"]
  node_runner["Run planner<br/>[runner.py]"]
  node_run_plan["Run plan"]
end

subgraph group_protocol["Protocol and planning"]
  node_manifest["Manifest validation<br/>[manifest.py]"]
  node_protocol_files["Protocol inputs"]
  node_config["Experiment definitions<br/>[config.py]"]
  node_sensitivity["Sensitivity planner<br/>[sensitivity.py]"]
  node_sensitivity_plan["Sensitivity plan"]
end

subgraph group_evaluation["Evaluation and analysis"]
  node_evaluation["Per-image evaluation<br/>[evaluation.py]"]
  node_result_csv["Result CSV"]
  node_aggregation["Seed aggregation<br/>[aggregate.py]"]
  node_summary_csv["Summary CSV"]
  node_statistics["Paired statistics<br/>[stats.py]"]
  node_plots["Sensitivity plots<br/>[plots.py]"]
end

subgraph group_integrations["Baseline integrations"]
  node_adapters["Baseline adapters<br/>[adapters.py]"]
  node_baseline["Baseline commands"]
end

node_user(("Experimenter"))

node_user -->|"invokes"| node_cli
node_cli -->|"validates"| node_manifest
node_manifest -->|"checks paths"| node_protocol_files
node_cli -->|"plans runs"| node_runner
node_runner -->|"loads"| node_manifest
node_runner -->|"uses grid"| node_config
node_runner -->|"writes"| node_run_plan
node_cli -->|"plans sweep"| node_sensitivity
node_sensitivity -->|"uses ranges"| node_config
node_cli -->|"writes"| node_sensitivity_plan
node_cli -->|"selects adapter"| node_adapters
node_adapters -->|"describes command"| node_baseline
node_evaluation -->|"writes"| node_result_csv
node_cli -->|"aggregates results"| node_aggregation
node_aggregation -->|"reads"| node_result_csv
node_cli -->|"writes"| node_summary_csv
node_plots -->|"reads"| node_result_csv

click node_cli "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/cli.py"
click node_manifest "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/manifest.py"
click node_config "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/config.py"
click node_runner "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/runner.py"
click node_sensitivity "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/sensitivity.py"
click node_adapters "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/adapters.py"
click node_evaluation "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/evaluation.py"
click node_aggregation "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/aggregate.py"
click node_statistics "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/stats.py"
click node_plots "https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/plots.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_cli,node_runner,node_run_plan toneBlue
class node_manifest,node_protocol_files,node_config,node_sensitivity,node_sensitivity_plan toneAmber
class node_evaluation,node_result_csv,node_aggregation,node_summary_csv,node_statistics,node_plots toneMint
class node_adapters,node_baseline toneRose
class node_user toneIndigo
```

## Components

### Experiment workflow

- [Command CLI](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/cli.py): `Major project/extension1/cli.py`
- [Run planner](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/runner.py): `Major project/extension1/runner.py`
- **Run plan**

### Protocol and planning

- [Manifest validation](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/manifest.py): `Major project/extension1/manifest.py`
- **Protocol inputs**
- [Experiment definitions](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/config.py): `Major project/extension1/config.py`
- [Sensitivity planner](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/sensitivity.py): `Major project/extension1/sensitivity.py`
- **Sensitivity plan**

### Evaluation and analysis

- [Per-image evaluation](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/evaluation.py): `Major project/extension1/evaluation.py`
- **Result CSV**
- [Seed aggregation](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/aggregate.py): `Major project/extension1/aggregate.py`
- **Summary CSV**
- [Paired statistics](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/stats.py): `Major project/extension1/stats.py`
- [Sensitivity plots](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/plots.py): `Major project/extension1/plots.py`

### Baseline integrations

- [Baseline adapters](https://github.com/ashwanthbingi/beyond-perceptual-quality-task-driven-super-resolution-for-diagnostically-reliable-chest-x-ray-/blob/master/Major%20project/extension1/adapters.py): `Major project/extension1/adapters.py`
- **Baseline commands**

### Other components

- **Experimenter**

## Connections

- Experimenter → Command CLI: invokes (evidence: `Major project/extension1/cli.py`)
- Command CLI → Manifest validation: validates (evidence: `Major project/extension1/cli.py`)
- Manifest validation → Protocol inputs: checks paths (evidence: `Major project/extension1/manifest.py`)
- Command CLI → Run planner: plans runs (evidence: `Major project/extension1/cli.py`)
- Run planner → Manifest validation: loads (evidence: `Major project/extension1/runner.py`)
- Run planner → Experiment definitions: uses grid (evidence: `Major project/extension1/runner.py`)
- Run planner → Run plan: writes (evidence: `Major project/extension1/runner.py`)
- Command CLI → Sensitivity planner: plans sweep (evidence: `Major project/extension1/cli.py`)
- Sensitivity planner → Experiment definitions: uses ranges (evidence: `Major project/extension1/sensitivity.py`)
- Command CLI → Sensitivity plan: writes (evidence: `Major project/extension1/cli.py`)
- Command CLI → Baseline adapters: selects adapter (evidence: `Major project/extension1/cli.py`)
- Baseline adapters → Baseline commands: describes command (evidence: `Major project/extension1/adapters.py`)
- Per-image evaluation → Result CSV: writes (evidence: `Major project/extension1/evaluation.py`)
- Command CLI → Seed aggregation: aggregates results (evidence: `Major project/extension1/cli.py`)
- Seed aggregation → Result CSV: reads (evidence: `Major project/extension1/aggregate.py`)
- Command CLI → Summary CSV: writes (evidence: `Major project/extension1/cli.py`)
- Sensitivity plots → Result CSV: reads (evidence: `Major project/extension1/plots.py`)
