# sravanidasari4488/mri_brats architecture

> Architecture diagram of the GitHub repository sravanidasari4488/mri_brats, 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/sravanidasari4488/mri_brats
- Repository: https://github.com/sravanidasari4488/mri_brats

## Overview

This repository supports brain-tumor MRI analysis and 3D reconstruction, including a web viewer and a workflow for real hospital studies. A typical user views a study, obtains tumor segmentation and anatomical meshes, and inspects the exported scene. Real-study processing also covers DICOM inventory, preprocessing, and quality checks; evaluation and slice viewing are distinct capabilities. The graph reflects documented calls and module references in the supplied excerpts and SOURCE INDEX; unsampled implementation details and some data-flow links are left unspecified.

Main entry points: [`recon/scene.py`](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/scene.py) (Scene builder), [`web/app.py`](https://github.com/sravanidasari4488/mri_brats/blob/main/web/app.py) (Web app), [`recon/review_real.py`](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/review_real.py) (Real-study review), [`scripts/reconstruct.py`](https://github.com/sravanidasari4488/mri_brats/blob/main/scripts/reconstruct.py) (Reconstruct command)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web review"]
  node_webapp["Web app<br/>[app.py]"]
  node_viewer["Scene viewer<br/>[viewer.js]"]
  node_slices["MRI slices<br/>[slices.py]"]
end

subgraph group_pipeline["Reconstruction pipeline"]
  node_reconstruct["Reconstruct command<br/>[reconstruct.py]"]
  node_scene["Scene builder<br/>[scene.py]"]
  node_inference["Tumor inference<br/>[infer.py]"]
  node_postprocess["Segmentation cleanup<br/>[postprocess.py]"]
  node_caseio["Case loading<br/>[io.py]"]
  node_mesh["Tumor meshing<br/>[mesh.py]"]
  node_outputs[("Reconstruction outputs")]
end

subgraph group_clinical["Clinical MRI"]
  node_inventory["Study inventory<br/>[inventory_real.py]"]
  node_ingest["DICOM preprocessing<br/>[ingest_real.py]"]
  node_qc["Study quality checks<br/>[qc_real.py]"]
  node_review["Real-study review<br/>[review_real.py]"]
end

subgraph group_analysis["Evaluation and anatomy"]
  node_anatomy["Anatomy meshes<br/>[anatomy.py]"]
  node_tracts["Tract estimation<br/>[tracts.py]"]
  node_labels["Structure catalog<br/>[labels.py]"]
  node_evaluation["Segmentation evaluation<br/>[evaluate.py]"]
end

node_reviewer(("Reviewer"))

node_reviewer -->|"uses"| node_webapp
node_webapp -->|"serves viewer"| node_viewer
node_webapp -->|"loads slices"| node_slices
node_webapp -->|"invokes"| node_reconstruct
node_reconstruct -->|"builds scene"| node_scene
node_reconstruct -->|"runs inference"| node_inference
node_scene -->|"loads scans"| node_caseio
node_scene -->|"detects tumor"| node_inference
node_scene -->|"processes labels"| node_postprocess
node_scene -->|"meshes regions"| node_mesh
node_scene -->|"adds anatomy"| node_anatomy
node_scene -->|"estimates tracts"| node_tracts
node_scene -->|"uses catalog"| node_labels
node_scene -->|"uses region masks"| node_evaluation
node_scene -->|"exports scene"| node_outputs
node_inventory -->|"supplies study inventory"| node_ingest
node_review -->|"uses preprocessing"| node_ingest
node_review -->|"checks study quality"| node_qc
node_review -->|"views slices"| node_slices

click node_webapp "https://github.com/sravanidasari4488/mri_brats/blob/main/web/app.py"
click node_viewer "https://github.com/sravanidasari4488/mri_brats/blob/main/web/static/viewer.js"
click node_slices "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/slices.py"
click node_reconstruct "https://github.com/sravanidasari4488/mri_brats/blob/main/scripts/reconstruct.py"
click node_scene "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/scene.py"
click node_inference "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/infer.py"
click node_postprocess "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/postprocess.py"
click node_caseio "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/io.py"
click node_mesh "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/mesh.py"
click node_anatomy "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/anatomy.py"
click node_tracts "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/tracts.py"
click node_labels "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/labels.py"
click node_evaluation "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/evaluate.py"
click node_inventory "https://github.com/sravanidasari4488/mri_brats/blob/main/scripts/inventory_real.py"
click node_ingest "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/ingest_real.py"
click node_qc "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/qc_real.py"
click node_review "https://github.com/sravanidasari4488/mri_brats/blob/main/recon/review_real.py"
click node_outputs "https://github.com/sravanidasari4488/mri_brats/tree/main/outputs"

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_webapp,node_viewer,node_slices,node_reviewer toneBlue
class node_reconstruct,node_scene,node_inference,node_postprocess,node_caseio,node_mesh,node_outputs toneAmber
class node_inventory,node_ingest,node_qc,node_review toneMint
class node_anatomy,node_tracts,node_labels,node_evaluation toneRose
```

## Components

### Web review

- [Web app](https://github.com/sravanidasari4488/mri_brats/blob/main/web/app.py): `web/app.py`
- [Scene viewer](https://github.com/sravanidasari4488/mri_brats/blob/main/web/static/viewer.js): `web/static/viewer.js`
- [MRI slices](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/slices.py): `recon/slices.py`

### Reconstruction pipeline

- [Reconstruct command](https://github.com/sravanidasari4488/mri_brats/blob/main/scripts/reconstruct.py): `scripts/reconstruct.py`
- [Scene builder](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/scene.py): `recon/scene.py`
- [Tumor inference](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/infer.py): `recon/infer.py`
- [Segmentation cleanup](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/postprocess.py): `recon/postprocess.py`
- [Case loading](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/io.py): `recon/io.py`
- [Tumor meshing](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/mesh.py): `recon/mesh.py`
- [Reconstruction outputs](https://github.com/sravanidasari4488/mri_brats/tree/main/outputs): `outputs`

### Clinical MRI

- [Study inventory](https://github.com/sravanidasari4488/mri_brats/blob/main/scripts/inventory_real.py): `scripts/inventory_real.py`
- [DICOM preprocessing](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/ingest_real.py): `recon/ingest_real.py`
- [Study quality checks](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/qc_real.py): `recon/qc_real.py`
- [Real-study review](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/review_real.py): `recon/review_real.py`

### Evaluation and anatomy

- [Anatomy meshes](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/anatomy.py): `recon/anatomy.py`
- [Tract estimation](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/tracts.py): `recon/tracts.py`
- [Structure catalog](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/labels.py): `recon/labels.py`
- [Segmentation evaluation](https://github.com/sravanidasari4488/mri_brats/blob/main/recon/evaluate.py): `recon/evaluate.py`

### Other components

- **Reviewer**

## Connections

- Reviewer → Web app: uses
- Web app → Scene viewer: serves viewer (evidence: `web/app.py`)
- Web app → MRI slices: loads slices (evidence: `web/app.py`)
- Web app → Reconstruct command: invokes (evidence: `web/app.py`)
- Reconstruct command → Scene builder: builds scene (evidence: `scripts/reconstruct.py`)
- Reconstruct command → Tumor inference: runs inference (evidence: `scripts/reconstruct.py`)
- Scene builder → Case loading: loads scans (evidence: `recon/scene.py`)
- Scene builder → Tumor inference: detects tumor (evidence: `recon/scene.py`)
- Scene builder → Segmentation cleanup: processes labels (evidence: `recon/scene.py`)
- Scene builder → Tumor meshing: meshes regions (evidence: `recon/scene.py`)
- Scene builder → Anatomy meshes: adds anatomy (evidence: `recon/scene.py`)
- Scene builder → Tract estimation: estimates tracts (evidence: `recon/scene.py`)
- Scene builder → Structure catalog: uses catalog (evidence: `recon/scene.py`)
- Scene builder → Segmentation evaluation: uses region masks (evidence: `recon/scene.py`)
- Scene builder → Reconstruction outputs: exports scene (evidence: `recon/scene.py`)
- Study inventory → DICOM preprocessing: supplies study inventory (evidence: `recon/ingest_real.py`)
- Real-study review → DICOM preprocessing: uses preprocessing (evidence: `recon/review_real.py`)
- Real-study review → Study quality checks: checks study quality (evidence: `recon/review_real.py`)
- Real-study review → MRI slices: views slices (evidence: `recon/review_real.py`)
