How rqm-technologies-dev/rqm-compiler works
rqm-compiler is a backend-neutral quantum circuit planner and optimizer. Users provide a circuit and observable; representation-aware planning selects a validated query/readout route, or the compiler normalizes and optimizes the circuit, verifies equivalence, and prepares backend-neutral materialization. Its major branches include relational representation analysis, observable evaluation, and backend capability planning. Backend bridges execute compiled work; this package does not execute or simulate it. Relationships are based on the README and SOURCE INDEX references; unsampled implementation details are not assumed.
Main entry points: compile.py Circuit optimizer · planner.py Representation planner · __init__.py Compiler API · circuit.py Circuit model
Components 23
Circuit model
- Circuit model
src/rqm_compiler/circuit.py - Operation model
src/rqm_compiler/ops.py
Compiler pipeline
- Circuit validation
src/rqm_compiler/validate.py - IR normalization
src/rqm_compiler/normalize.py - Circuit optimizer
src/rqm_compiler/compile.py - Optimization passes
src/rqm_compiler/passes - Circuit depth
src/rqm_compiler/depth.py - Adaptive Cartan
src/rqm_compiler/adaptive.py - Regional optimization
src/rqm_compiler/regional.py - Semantic verification
src/rqm_compiler/verification.py - SU4 block analysis
src/rqm_compiler/su4_blocks.py - Compiler report
src/rqm_compiler/report.py
Query planning
- Representation planner
src/rqm_compiler/planner.py - Observable evaluation
src/rqm_compiler/observables.py - Direct readout
src/rqm_compiler/direct_readout.py - Topology readout
src/rqm_compiler/topology_readout.py - Readout frontier
src/rqm_compiler/frontier.py
Interoperability
- Compiler API
src/rqm_compiler/__init__.py - Backend descriptors
src/rqm_compiler/descriptors.py - Backend capabilities
src/rqm_compiler/backends.py - Descriptor conversion
src/rqm_compiler/io/from_dict.py
Other components
- Circuit user
- Backend bridge
Connections 26
- Circuit user → Compiler API: calls
README.md - Compiler API → Representation planner: exposes planning
src/rqm_compiler/__init__.py - Compiler API → Circuit optimizer: exposes optimization
src/rqm_compiler/__init__.py - Circuit model → Operation model: stores
src/rqm_compiler/circuit.py - Circuit optimizer → Circuit validation: validates
src/rqm_compiler/compile.py - Circuit optimizer → IR normalization: normalizes
src/rqm_compiler/compile.py - Circuit optimizer → Optimization passes: runs passes
src/rqm_compiler/compile.py - Circuit optimizer → Adaptive Cartan: routes adaptively
src/rqm_compiler/compile.py - Circuit optimizer → Circuit depth: measures depth
src/rqm_compiler/compile.py - Circuit optimizer → Semantic verification: verifies candidate
src/rqm_compiler/compile.py - Circuit optimizer → Compiler report: records outcome
src/rqm_compiler/compile.py - Adaptive Cartan → SU4 block analysis: uses blocks
src/rqm_compiler/adaptive.py - Regional optimization → Circuit optimizer: invokes compiler
src/rqm_compiler/regional.py - SU4 block analysis → Semantic verification: proves extraction
src/rqm_compiler/su4_blocks.py - Semantic verification → Optimization passes: canonicalizes for comparison
src/rqm_compiler/verification.py - Representation planner → Adaptive Cartan: uses routing
src/rqm_compiler/planner.py - Representation planner → Observable evaluation: evaluates queries
src/rqm_compiler/planner.py - Representation planner → Direct readout: selects readout
- Representation planner → Topology readout: selects topology route
- Representation planner → Readout frontier: uses frontier
- Representation planner → Circuit optimizer: compiles circuit
src/rqm_compiler/planner.py - Circuit model → Backend capabilities: plans materialization
README.md - Backend capabilities → Backend descriptors: plans descriptors
- Backend descriptors → Backend bridge: provides lowering input
README.md - Backend bridge → Circuit user: returns result
- Descriptor conversion → Circuit model: constructs circuit
src/rqm_compiler/io/from_dict.py