How munich-quantum-toolkit/predictor works
MQT Predictor turns a quantum circuit into a device-specific compiled circuit: it predicts a suitable target, then uses a learned reinforcement-learning policy to select and apply compiler passes. Separate training workflows build the device-selection model and the RL compiler policy. The README also documents customizable figures of merit and mixed passes from Qiskit, TKET, and BQSKit. Several implementation details are unsampled, so the graph omits unverified links rather than implying a complete runtime sequence.
Main entry points: predictorenv.py Compiler environment · registry.py Pass registry · qcompile.py Compile API · predictor.py Device predictor
Components 15
Entry and orchestration
- Compile API
src/mqt/predictor/qcompile.py
Device selection
- Device predictor
src/mqt/predictor/ml/predictor.py - Training and features
src/mqt/predictor/ml/helper.py
RL compilation
- RL compile workflow
src/mqt/predictor/rl/predictor.py - Compiler environment
src/mqt/predictor/rl/predictorenv.py - Pass action types
src/mqt/predictor/rl/actions/base.py - Pass registry
src/mqt/predictor/rl/actions/registry.py - Qiskit passes
src/mqt/predictor/rl/actions/qiskit_actions.py - TKET passes
src/mqt/predictor/rl/actions/tket_actions.py - BQSKit passes
src/mqt/predictor/rl/actions/bqskit_actions.py - Compilation tracing
src/mqt/predictor/rl/tracer.py
Scoring and features
- Figures of merit
src/mqt/predictor/reward.py - Hellinger metrics
src/mqt/predictor/hellinger/utils.py - Circuit features
src/mqt/predictor/utils.py
Other components
- Circuit user
Connections 18
- Circuit user → Compile API: submits circuit
README.md - Compile API → Device predictor: predicts device
src/mqt/predictor/qcompile.py - Compile API → RL compile workflow: compiles circuit
src/mqt/predictor/qcompile.py - Device predictor → RL compile workflow: trains per device
src/mqt/predictor/ml/predictor.py - Training and features → Circuit features: extracts features
src/mqt/predictor/ml/helper.py - RL compile workflow → Compiler environment: uses environment
src/mqt/predictor/rl/predictor.py - Compiler environment → Pass registry: loads actions
src/mqt/predictor/rl/predictorenv.py - Pass registry → Qiskit passes: registers passes
src/mqt/predictor/rl/actions/registry.py - Pass registry → TKET passes: registers passes
src/mqt/predictor/rl/actions/registry.py - Pass registry → BQSKit passes: registers passes
src/mqt/predictor/rl/actions/registry.py - Qiskit passes → Pass action types: defines actions
src/mqt/predictor/rl/actions/qiskit_actions.py - TKET passes → Pass action types: defines actions
src/mqt/predictor/rl/actions/tket_actions.py - BQSKit passes → Pass action types: defines actions
src/mqt/predictor/rl/actions/bqskit_actions.py - Compiler environment → Figures of merit: calculates score
src/mqt/predictor/rl/predictorenv.py - Compiler environment → Hellinger metrics: calculates metric
src/mqt/predictor/rl/predictorenv.py - Figures of merit → Hellinger metrics: uses metric
src/mqt/predictor/reward.py - Compiler environment → Compilation tracing: records steps
src/mqt/predictor/rl/predictorenv.py - Device predictor → Figures of merit: scores circuits
src/mqt/predictor/ml/predictor.py