How mahimmuradimath7-debug/clarity works
CLARITY is a lunar-image co-registration and mapping suite. Users submit image pairs through the Streamlit interface or REST API; the registration orchestrator preprocesses imagery, finds and refines matches, evaluates quality, and produces registered imagery and exports. Separate capabilities support batch work, history, mosaics, crater analysis, and stereo DEM generation. The README documents the product branches; source excerpts and the index establish several internal calls, while unsampled subsystem connections are left out.
Main entry points: app.py Streamlit UI · pipeline.py Registration Orchestrator · worker.py Job Worker · main.py REST API
Components 18
User Interfaces
- Streamlit UI
ui/app.py - REST API
api/main.py - API Client
ui/services/api_client.py
Registration Core
- Registration Orchestrator
src/pipeline.py - Image Preprocessing
src/preprocess/photometric_correction.py - Feature Matching
src/features/deep_matcher.py - Match Refinement
src/registration/subpixel_refine.py - Quality Evaluation
src/evaluate/metrics.py
Mapping & Analysis
- Batch Processing
src/batch.py - Registration History
src/history.py - Mosaic Builder
src/mosaic.py - Stereo DEM
src/features/dem_builder.py - Crater Detection
src/features/crater_detector.py
API & Outputs
- JWT & RBAC
src/auth/jwt_handler.py - Job Worker
api/worker.py - Registration Exports
src/registration/artifact_exporter.py - PDF Reports
src/reporting/pdf_report.py
Other components
- Mission User
Connections 19
- Mission User → Streamlit UI: uses
README.md - Mission User → REST API: submits imagery
README.md - Streamlit UI → API Client: requests jobs
ui/app.py - API Client → REST API: calls REST
ui/services/api_client.py - REST API → Job Worker: dispatches jobs
api/main.py - REST API → JWT & RBAC: authenticates users
- Job Worker → Registration Orchestrator: runs registration
api/worker.py - Registration Orchestrator → Image Preprocessing: preprocesses imagery
src/pipeline.py - Registration Orchestrator → Feature Matching: finds matches
src/pipeline.py - Registration Orchestrator → Match Refinement: refines matches
src/pipeline.py - Registration Orchestrator → Quality Evaluation: measures quality
src/pipeline.py - Registration Orchestrator → Registration Exports: exports artifacts
src/pipeline.py - Job Worker → Registration Exports: writes artifacts
api/worker.py - Job Worker → PDF Reports: generates reports
api/worker.py - Streamlit UI → Batch Processing: offers batch runs
README.md - Streamlit UI → Registration History: shows history
ui/app.py - Streamlit UI → Mosaic Builder: offers mosaics
ui/app.py - Streamlit UI → Stereo DEM: offers 3D mapping
ui/app.py - Streamlit UI → Crater Detection: offers crater analysis
ui/app.py