How dr206/quantum-circuit-simulator works
This Python package simulates circuit-based quantum programs: a caller supplies an initial state and gate program, circuit execution constructs and applies each gate operator, then experiment functions sample measurement outcomes and aggregate shot counts. Gate definitions and the shared logarithm helper support those stages. The README also documents variational-algorithm examples, represented by the notebook. Edges reflect the sampled calls or README statements; the notebook’s internal implementation was not sampled.
Main entry points: circuit.py Program runner · experiment.py Single measurement · utils.py Log helper · Variational_Quantum_Algorithm.ipynb Variational example
Components 11
Circuit execution
- Ground state
quantumcircuitsimulator/circuit.py - Program runner
quantumcircuitsimulator/circuit.py - Operator builder
quantumcircuitsimulator/circuit.py - State evolution
quantumcircuitsimulator/circuit.py - Log helper
quantumcircuitsimulator/utils.py
Gate system
- Gate catalog
quantumcircuitsimulator/gates.py - Parametric gates
quantumcircuitsimulator/gates.py
Measurement
- Single measurement
quantumcircuitsimulator/experiment.py - Shot counts
quantumcircuitsimulator/experiment.py
Other components
- Simulator user
- Variational example
jupyter/Variational_Quantum_Algorithm.ipynb
Connections 12
- Simulator user → Ground state: requests initialization
- Simulator user → Program runner: provides program
- Simulator user → Single measurement: requests measurement
- Simulator user → Shot counts: requests shots
- Program runner → Operator builder: builds operators
quantumcircuitsimulator/circuit.py - Program runner → Log helper: calculates qubits
quantumcircuitsimulator/circuit.py - Program runner → State evolution: updates state
quantumcircuitsimulator/circuit.py - Operator builder → Gate catalog: looks up gates
quantumcircuitsimulator/circuit.py - Operator builder → Parametric gates: evaluates parameters
quantumcircuitsimulator/circuit.py - Single measurement → Log helper: formats outcome
quantumcircuitsimulator/experiment.py - Shot counts → Single measurement: samples repeatedly
quantumcircuitsimulator/experiment.py - Variational example → Program runner: uses package