How suriya1230/3d-brain-tumor-detection-and-visualization works
NeuroEvidence is a local glioma MRI segmentation and evidence-grounded explanation application. Its main workflow uploads four MRI volumes, segments the tumour, serves 3D assets, then lets users request a clinical explanation or ask follow-up questions against retrieved evidence. The evidence subsystem also ingests and indexes reference material and supports restricted live search. The graph reflects documented routes and SOURCE INDEX references; unsampled implementation details are omitted where call ownership is uncertain.
Main entry points: knowledge_routes.py Case knowledge routes · main.py FastAPI application · cli.py Corpus builder · EvidencePanel.jsx Evidence panel
Components 26
Browser experience
- MRI upload
frontend/components/UploadPanel.jsx - Case page
frontend/app/page.js - 3D viewer
frontend/components/BrainViewer.jsx - Brain visuals
frontend/components/brainVisuals.jsx - Evidence panel
frontend/components/EvidencePanel.jsx - Streaming text
frontend/components/StreamingText.jsx
MRI segmentation
- FastAPI application
backend/app/main.py - MRI segmenter
backend/app/inference.py - Mesh generation
backend/app/meshing.py
Evidence answering
- Case knowledge routes
backend/app/knowledge_routes.py - Question planner
backend/app/knowledge/agents/planner.py - Clinical agent
backend/app/knowledge/agents/clinical_agent.py - Imaging agent
backend/app/knowledge/agents/imaging_agent.py - Hybrid retrieval
backend/app/knowledge/index/fuse.py - BM25 search
backend/app/knowledge/index/bm25.py - Dense search
backend/app/knowledge/index/dense.py - Restricted web search
backend/app/knowledge/web_search.py - Citation-gated answer
backend/app/knowledge/answering.py - Evidence validator
backend/app/knowledge/validator.py - Evidence contracts
backend/app/knowledge/schema.py
Evidence corpus
- Corpus builder
backend/app/knowledge/cli.py - NCI PDQ ingest
backend/app/knowledge/ingest/nci_pdq.py - PubMed ingest
backend/app/knowledge/ingest/pubmed.py - Chunk preparation
backend/app/knowledge/chunking.py
Other components
- User
- LLM providers
Connections 28
- User → MRI upload: selects scans
- MRI upload → FastAPI application: uploads volumes
- FastAPI application → MRI segmenter: runs inference
backend/app/main.py - FastAPI application → Mesh generation: creates meshes
backend/app/main.py - FastAPI application → Case page: returns assets
- Case page → 3D viewer: shows case
- 3D viewer → Brain visuals: uses primitives
frontend/components/BrainViewer.jsx - User → Evidence panel: asks question
- Evidence panel → Case knowledge routes: requests explanation
- Evidence panel → Streaming text: renders text
frontend/components/EvidencePanel.jsx - FastAPI application → Case knowledge routes: mounts routes
backend/app/main.py - Case knowledge routes → Question planner: routes question
backend/app/knowledge_routes.py - Case knowledge routes → Clinical agent: builds explanation
backend/app/knowledge_routes.py - Case knowledge routes → Imaging agent: dispatches imaging
backend/app/knowledge_routes.py - Case knowledge routes → Hybrid retrieval: retrieves evidence
backend/app/knowledge_routes.py - Case knowledge routes → Restricted web search: searches optionally
backend/app/knowledge_routes.py - Case knowledge routes → Citation-gated answer: generates answer
backend/app/knowledge_routes.py - Case knowledge routes → Evidence validator: checks claims
backend/app/knowledge_routes.py - Clinical agent → LLM providers: requests explanation
backend/app/knowledge/agents/clinical_agent.py - Citation-gated answer → LLM providers: generates claims
- Citation-gated answer → Evidence contracts: uses contracts
backend/app/knowledge/answering.py - Evidence validator → Evidence contracts: validates claims
backend/app/knowledge/validator.py - Hybrid retrieval → BM25 search: runs lexical search
backend/app/knowledge/index/fuse.py - Hybrid retrieval → Dense search: runs vector search
backend/app/knowledge/index/fuse.py - Corpus builder → NCI PDQ ingest: ingests documents
backend/app/knowledge/cli.py - Corpus builder → PubMed ingest: ingests articles
backend/app/knowledge/cli.py - Corpus builder → Chunk preparation: chunks sources
backend/app/knowledge/cli.py - Chunk preparation → Evidence contracts: produces chunks
backend/app/knowledge/chunking.py