How paultitus0702/saksham- works
SAKSHAM analyzes and solves LP/MPS optimization models, then independently checks solutions and emits certificates. The principal workflow is upload or benchmark input → parse and validate → structural/numerical analysis and strategy recommendation → HiGHS solve → verification and certificate. The dashboard presents system status, solve results, pipeline views, and Netlib benchmarks. The README documents synthetic refinery benchmarks and Netlib validation, though their runner implementation is not present in the supplied tree. Some edges reflect explicit README or SOURCE INDEX references; unsampled relationships are omitted or marked unverified.
Main entry points: runner.py Pipeline Runner · App.tsx Dashboard App · api_router.py API Routes · mps_parser.py MPS Parser
Components 23
Dashboard
- Dashboard App
frontend/src/App.tsx - API Client
frontend/src/api/client.ts - Pipeline Views
frontend/src/components/PipelineModuleView.tsx - Benchmark View
frontend/src/components/BenchmarkSuite.tsx
API Service
- FastAPI Service
backend/app/main.py - API Routes
backend/app/api/api_router.py
Model Analysis
- LP Parser
engine/saksham/parser/lp_parser.py - MPS Parser
engine/saksham/parser/mps_parser.py - Canonical Model
engine/saksham/canonical/model.py - Model Validator
engine/saksham/canonical/validator.py - Structural Fingerprint
engine/saksham/fingerprint/analyzer.py - Structure Graph
engine/saksham/isg/graph_builder.py - Numerical Health
engine/saksham/health/conditioner.py - Strategy Recommender
engine/saksham/strategy/recommender.py
Solve and Assurance
- Pipeline Runner
engine/saksham/pipeline/runner.py - Solver Contract
engine/saksham/solvers/base.py - Solver Registry
engine/saksham/solvers/registry.py - HiGHS Backend
engine/saksham/solvers/highs_backend.py - SAKSHI Verifier
engine/saksham/sakshi/verifier.py - Certificate Builder
engine/saksham/certificate/cert_builder.py
Benchmark Inputs
- Netlib Runner
engine/saksham - Refinery Scenarios
engine/saksham/scenarios/refinery.py
Other components
- Engineer
Connections 25
- Engineer → Dashboard App: uses
frontend/src/App.tsx - Dashboard App → API Client: requests status
frontend/src/App.tsx - Dashboard App → Pipeline Views: renders results
frontend/src/App.tsx - Dashboard App → Benchmark View: renders benchmarks
frontend/src/App.tsx - API Client → API Routes: calls HTTP API
frontend/src/api/client.ts - FastAPI Service → API Routes: registers routes
backend/app/main.py - API Routes → Pipeline Runner: runs solve
backend/app/api/api_router.py - API Routes → Netlib Runner: runs benchmark
backend/app/api/api_router.py - Pipeline Runner → LP Parser: dispatches LP
engine/saksham/pipeline/runner.py - Pipeline Runner → MPS Parser: dispatches MPS
engine/saksham/pipeline/runner.py - LP Parser → Canonical Model: builds model
engine/saksham/parser/lp_parser.py - MPS Parser → Canonical Model: builds model
engine/saksham/parser/mps_parser.py - Pipeline Runner → Model Validator: validates model
engine/saksham/pipeline/runner.py - MPS Parser → Model Validator: validates model
engine/saksham/parser/mps_parser.py - Pipeline Runner → Structural Fingerprint: analyzes structure
engine/saksham/pipeline/runner.py - Pipeline Runner → Structure Graph: builds graph
engine/saksham/pipeline/runner.py - Pipeline Runner → Numerical Health: checks numerics
engine/saksham/pipeline/runner.py - Pipeline Runner → Strategy Recommender: recommends strategy
engine/saksham/pipeline/runner.py - Pipeline Runner → Solver Registry: selects solver
engine/saksham/pipeline/runner.py - Solver Registry → HiGHS Backend: registers backend
engine/saksham/solvers/registry.py - HiGHS Backend → Solver Contract: implements contract
engine/saksham/solvers/highs_backend.py - Pipeline Runner → SAKSHI Verifier: checks solution
engine/saksham/pipeline/runner.py - Pipeline Runner → Certificate Builder: builds certificate
engine/saksham/pipeline/runner.py - Netlib Runner → Pipeline Runner: uses shared pipeline
engine/saksham/pipeline/__init__.py - Refinery Scenarios → Pipeline Runner: benchmark input