How qqq-wisc/wisq works
wisq is a Python quantum-circuit compiler with optimization-only, mapping/routing-only, and combined fault-tolerant modes. The main user workflow accepts OpenQASM, optionally optimizes it, maps logical qubits to a surface-code architecture, routes gates, and emits QASM or a schedule JSON. The graph preserves the documented GUOQ, BQSKit/Synthetiq, Qualtran, DASCOT, SAT-SCMR, and custom-layout capabilities. Some subsystem links rely on README statements or SOURCE INDEX references; unsampled implementation details are not inferred.
Main entry points: __init__.py Mode selection · dascot.py DASCOT orchestration · guoq.py Optimization pass · resynth.py Resynthesis
Components 16
Compiler entry
- Mode selection
src/wisq/__init__.py
Circuit optimization
- Optimization pass
src/wisq/guoq.py - GUOQ optimizer
src/wisq/lib/GUOQ-1.0-jar-with-dependencies.jar - Resynthesis
src/wisq/resynth.py - Rotation synthesis
src/wisq/qualtran_rotation_synthesis.py - Synthetiq backend
src/wisq/lib/synthetiq
Mapping and routing
- DASCOT orchestration
src/wisq/dascot.py - Phased mapping
src/wisq/phased_graph.py - Annealing router
src/wisq/sarouting.py - SAT scheduler
src/wisq/sat_scmr.py
Architecture and output
- Architecture helpers
src/wisq/architecture.py - Arbitrary layouts
src/wisq/optimal_arb_layout.py - Schedule writer
src/wisq/dascot.py
Other components
- Circuit user
- OpenQASM input
- Compiled result
Connections 17
- Circuit user → OpenQASM input: supplies
README.md - OpenQASM input → Mode selection: loads
README.md - Mode selection → Optimization pass: runs optimization
src/wisq/__init__.py - Optimization pass → GUOQ optimizer: invokes
src/wisq/guoq.py - Optimization pass → Resynthesis: uses
src/wisq/guoq.py - Optimization pass → Rotation synthesis: uses
src/wisq/guoq.py - Resynthesis → Synthetiq backend: runs backend
- Mode selection → DASCOT orchestration: dispatches mapping
src/wisq/__init__.py - DASCOT orchestration → Phased mapping: builds mapping
src/wisq/dascot.py - DASCOT orchestration → Annealing router: routes gates
src/wisq/dascot.py - DASCOT orchestration → SAT scheduler: solves schedule
src/wisq/dascot.py - Annealing router → Architecture helpers: reads neighbors
src/wisq/sarouting.py - Mode selection → Architecture helpers: selects layout
src/wisq/__init__.py - Mode selection → Arbitrary layouts: may optimize layout
- DASCOT orchestration → Schedule writer: returns schedule
src/wisq/dascot.py - Mode selection → Compiled result: writes output
src/wisq/__init__.py - Schedule writer → Compiled result: serializes JSON
src/wisq/dascot.py