How nadjibsalmi/quanta-nexus works
QuantaNexus is a research prototype for renewable-microgrid dispatch: it models energy scenarios, forms a constrained dispatch problem, compares classical and QUBO-based methods, and presents results through Python API and dashboard scaffolds. The README documents forecasting, uncertainty, resilience, explanations, and benchmarks as capabilities. Edges follow explicit excerpts, SOURCE INDEX references, or README statements; unsampled implementation details are not assumed, and the TypeScript server is documented only as a scaffold.
Main entry points: model.py Dispatch formulation · service.py Application services · engine.py Adaptive engine · app.py Python HTTP API
Components 19
Energy inputs
- Digital twin
src/quantanexus/simulation/digital_twin.py - Energy model
src/quantanexus/energy/model.py - Load forecasting
src/quantanexus/forecasting/load.py
Dispatch optimization
- Dispatch formulation
src/quantanexus/optimization/model.py - Adaptive engine
src/quantanexus/core/engine.py - Classical solvers
src/quantanexus/optimization/baselines.py - Exact solver
src/quantanexus/optimization/solver.py - QUBO encoder
src/quantanexus/quantum/qubo.py
Evaluation and analytics
- Uncertainty analysis
src/quantanexus/optimization/uncertainty.py - Resilience analysis
src/quantanexus/optimization/resilience.py - Decision explanations
src/quantanexus/analytics/explanations.py - Benchmark suite
src/quantanexus/benchmarks.py
API and dashboard
- Application services
src/quantanexus/api/service.py - Python HTTP API
src/quantanexus/api/app.py - Request schemas
src/quantanexus/api/schemas.py - Dashboard
artifacts/dashboard/src/App.tsx - TypeScript API scaffold
artifacts/api-server/src/app.ts
Other components
- Microgrid planner
- Microgrid planner
Connections 23
- Microgrid planner → Digital twin: defines scenario
README.md - Digital twin → Energy model: provides energy data
src/quantanexus/simulation/digital_twin.py - Microgrid planner → Load forecasting: supplies load data
README.md - Load forecasting → Dispatch formulation: informs dispatch
README.md - Energy model → Dispatch formulation: defines constraints
src/quantanexus/optimization/model.py - Dispatch formulation → Adaptive engine: is planned by
src/quantanexus/core/engine.py - Adaptive engine → Exact solver: runs exact solve
src/quantanexus/core/engine.py - Adaptive engine → QUBO encoder: encodes small cases
src/quantanexus/core/engine.py - Dispatch formulation → Classical solvers: supports baselines
src/quantanexus/optimization/baselines.py - Dispatch formulation → Uncertainty analysis: evaluates forecast errors
src/quantanexus/optimization/uncertainty.py - Dispatch formulation → Resilience analysis: supports resilience studies
README.md - Dispatch formulation → Decision explanations: explains decisions
src/quantanexus/analytics/explanations.py - Dispatch formulation → Benchmark suite: benchmarks methods
src/quantanexus/benchmarks.py - Python HTTP API → Application services: routes requests
src/quantanexus/api/app.py - Python HTTP API → Request schemas: validates requests
src/quantanexus/api/app.py - Application services → Adaptive engine: runs dispatch
src/quantanexus/api/service.py - Application services → Digital twin: generates scenarios
src/quantanexus/api/service.py - Application services → Decision explanations: builds explanation
src/quantanexus/api/service.py - Application services → Benchmark suite: reads benchmark export
src/quantanexus/api/service.py - Microgrid planner → Python HTTP API: sends requests
src/quantanexus/api/app.py - Microgrid planner → Dashboard: views results
README.md - Dashboard → Python HTTP API: fetches summary
artifacts/dashboard/src/App.tsx - TypeScript API scaffold → Microgrid planner: serves scaffold API
README.md