How rajarshitiwari/quex works
Quex is a quantum-circuit construction and state-vector simulation library. Users can build circuits directly or ingest OpenQASM, then execute them with the NumPy backend and inspect the resulting state; optional JAX and CuPy backends reuse NumPy simulator logic. Circuit utilities also cover parameter binding, probabilities, sampling, cutting, random circuit generation, and visualization. The README describes hardware-aware dispatch and QIR ingestion as roadmap items; no implemented dispatcher is shown. Arrows reflect the excerpts, SOURCE INDEX references, or documented behavior; visualization’s connection to Circuit is documented but not shown in source excerpts.
Main entry points: circuit.py Circuit model · numpy_sim.py NumPy simulator · parser.py QASM parser · qrandom.py Random circuits
Components 15
Ingestion and construction
- QASM parser
src/quex/parser.py - Circuit model
src/quex/circuit.py
Circuit tools
- Random circuits
src/quex/qrandom.py - Operation list
src/quex/utils.py - Circuit cutting
src/quex/circuit.py
Execution engines
- Gate matrices
src/quex/gates.py - Simulator interface
src/quex/backends/base.py - NumPy simulator
src/quex/backends/numpy_sim.py - JAX simulator
src/quex/backends/jax_sim.py - CuPy simulator
src/quex/backends/cupy_sim.py
Results and visualization
- Probabilities and sampling
src/quex/circuit.py - Circuit visualization
src/quex/vis.py - Final state tensor
Other components
- Circuit user
- OpenQASM input
Connections 19
- Circuit user → OpenQASM input: provides
README.md - OpenQASM input → QASM parser: parses
README.md - QASM parser → Circuit model: builds operations
src/quex/circuit.py - Circuit user → Circuit model: constructs
README.md - Circuit user → Random circuits: requests generation
src/quex/qrandom.py - Random circuits → Circuit model: adds operations
src/quex/qrandom.py - Circuit model → Operation list: stores operations
src/quex/circuit.py - Circuit user → Circuit model: requests execution
README.md - Circuit model → NumPy simulator: invokes run
src/quex/circuit.py - NumPy simulator → Simulator interface: implements
src/quex/backends/numpy_sim.py - NumPy simulator → Gate matrices: uses gate definitions
src/quex/backends/numpy_sim.py - NumPy simulator → Circuit model: reads operations
src/quex/backends/numpy_sim.py - NumPy simulator → Final state tensor: returns state
src/quex/backends/numpy_sim.py - JAX simulator → NumPy simulator: inherits execution
src/quex/backends/jax_sim.py - CuPy simulator → NumPy simulator: inherits execution
src/quex/backends/cupy_sim.py - Circuit model → Probabilities and sampling: computes results
src/quex/circuit.py - Circuit model → Circuit cutting: supports cutting
src/quex/circuit.py - Circuit model → Circuit visualization: visualizes topology
- Circuit user → Circuit visualization: requests drawing
src/quex/vis.py