How pavanchougaladev/clarity-ai works
CLARITY* is a lunar-image co-registration and analysis platform with a Streamlit client, FastAPI job/API layer, and image-processing engine. Users select or upload imagery, configure a registration, and inspect alignment, quality, and terrain-analysis results. The engine covers ingestion, illumination normalization, matching, geometric refinement, validation, and exports; separate capabilities include crater analysis and DEM generation. Edges are limited to relationships shown in the README or cited source index/excerpts; some documented subsystems have unsampled implementations, so their internal wiring is not inferred.
Main entry points: pipeline.py Registration pipeline · worker.py Registration worker · services.py Client services · app.py Streamlit app
Components 27
Interactive client
- Streamlit app
client/app.py - Registration studio
client/views/view_registration.py - Analysis views
client/views - Client services
client/services.py - API client
client/api_client.py
REST and jobs
- FastAPI gateway
server/api/main.py - Job state
server/api/state.py - API routers
server/api/routers - Registration worker
server/api/worker.py
Registration engine
- Registration pipeline
server/src/pipeline.py - PDS4 ingestion
server/src/ingest/pds4_parser.py - Preprocess routing
server/src/preprocess/pipeline_router.py - Photometric correction
server/src/preprocess/photometric_correction.py - Shadow normalization
server/src/preprocess/shadow_normalization.py - Feature fusion
server/src/features/lunar_fusion_matcher.py - Outlier filtering
server/src/matching/outlier_rejection.py - Subpixel refinement
server/src/registration/subpixel_refine.py - Quality evaluation
server/src/evaluate/quality_gate.py
Terrain and analysis
- Crater detection
server/src/features/crater_detector.py - DEM generation
server/src/features/dem_builder.py - Stereo pair fusion
server/src/dual_pair_pipeline.py - Result visualization
client/components/visualizations.py
Access and outputs
- Artifact export
server/src/registration/artifact_exporter.py - JWT and RBAC
server/src/auth/jwt_handler.py - PDF reporting
server/src/reporting/pdf_report.py
Other components
- Analyst
- Lunar imagery
Connections 26
- Analyst → Streamlit app: uses
client/app.py - Streamlit app → Registration studio: routes to
client/app.py - Streamlit app → Analysis views: routes to
client/app.py - Registration studio → Client services: requests processing
client/views/view_registration.py - Client services → Registration pipeline: runs registration
client/services.py - Client services → Crater detection: calls detection
client/services.py - Client services → DEM generation: calls DEM builder
client/services.py - API client → FastAPI gateway: sends requests
- FastAPI gateway → API routers: mounts routes
server/api/main.py - FastAPI gateway → Registration worker: uses worker
server/api/main.py - Registration worker → Job state: updates jobs
server/api/worker.py - Registration worker → Registration pipeline: runs registration
server/api/worker.py - Registration worker → Artifact export: exports artifacts
server/api/worker.py - Registration worker → PDF reporting: generates report
server/api/worker.py - Lunar imagery → PDS4 ingestion: provides products
- Registration pipeline → Preprocess routing: routes preprocessing
server/src/pipeline.py - Registration pipeline → Photometric correction: applies correction
server/src/pipeline.py - Registration pipeline → Shadow normalization: normalizes shadows
server/src/pipeline.py - Registration pipeline → Feature fusion: matches features
server/src/pipeline.py - Registration pipeline → Outlier filtering: filters matches
server/src/pipeline.py - Registration pipeline → Subpixel refinement: refines alignment
server/src/pipeline.py - Registration pipeline → Quality evaluation: checks quality
server/src/pipeline.py - Stereo pair fusion → Registration pipeline: registers pairs
server/src/dual_pair_pipeline.py - Stereo pair fusion → DEM generation: builds pair DEMs
server/src/dual_pair_pipeline.py - Analysis views → Result visualization: renders results
- JWT and RBAC → API routers: supports login
server/api/routers/auth.py