How ashiteshsingh/tpu-accelerated-quantum-jax works
This repository is a JAX quantum-circuit simulator and research suite, with GPU and TPU-oriented execution paths. The main workflow is to define a circuit, simulate its state, then evaluate observables or measurements; research workloads apply that runtime to algorithms such as VQE, QAOA, and noisy-circuit studies. It also includes a separate statevector/density-matrix implementation and standalone TPU-scale, Shor, Grover, and supremacy programs. Edges are limited to relationships visible in excerpts or the README; unsampled TPU wiring is not inferred.
Main entry points: circuit.py Circuit API · observables.py Observables · core.py State Engine · ops.py Gate Operators
Components 25
GPU Simulator
- Circuit API
gpu/jax_qsim/circuit.py - State Engine
gpu/jax_qsim/core.py - Gate Operators
gpu/jax_qsim/ops.py - Noise Channels
gpu/jax_qsim/noise.py - Observables
gpu/jax_qsim/observables.py
Research Workloads
- Algorithm Studies
gpu/quantum_research - Gradient Study
gpu/quantum_research/barren_plateau_gradient_vanishing.py - GPU Scaling Study
gpu/quantum_research/gpu_vram_and_qubit_scaling_benchmark.py - Noisy NISQ Study
gpu/quantum_research/noisy_nisq_circuit_simulation.py - QAOA MaxCut
gpu/quantum_research/quantum_approximate_optimization_algorithm_maxcut.py - VQE H2
gpu/quantum_research/variational_quantum_eigensolver_h2.py - Noise Trajectories
gpu/quantum_research/quantum_noise_simulation_monte_carlo.py - XOR Classifier
gpu/quantum_research/variational_quantum_classifier_xor.py - GHZ Preparation
gpu/quantum_research/ghz_state_preparation.py
State Simulators
- Functional Circuit
experiment/jax_qsim/circuit.py - Gate Definitions
experiment/jax_qsim/gates.py - Statevector Runtime
experiment/jax_qsim/statevector.py - Density Matrix
experiment/jax_qsim/density_matrix.py - Observable Types
experiment/jax_qsim/observables.py
Large-Scale Runs
- TPU Scale Suite
tpu/tpu_quantum_scale.py - Shor Algorithm
shors/shors_algorithm_33q.py - Grover Runs
grover_simulation - 42-Qubit Run
supremacy_42_tpu.py - 75-Qubit Run
supremacy_75_tpu.py
Other components
- Researcher
Connections 39
- Circuit API → State Engine: applies gates
gpu/jax_qsim/circuit.py - Circuit API → Gate Operators: records operators
gpu/jax_qsim/circuit.py - Noise Channels → State Engine: applies channels
gpu/jax_qsim/noise.py - Noise Channels → Gate Operators: uses Kraus gates
gpu/jax_qsim/noise.py - Observables → State Engine: applies observables
gpu/jax_qsim/observables.py - Observables → Gate Operators: uses Pauli gates
gpu/jax_qsim/observables.py - Gradient Study → Circuit API: uses circuits
gpu/quantum_research/barren_plateau_gradient_vanishing.py - Gradient Study → Observables: evaluates observables
gpu/quantum_research/barren_plateau_gradient_vanishing.py - GPU Scaling Study → State Engine: uses state engine
gpu/quantum_research/gpu_vram_and_qubit_scaling_benchmark.py - GPU Scaling Study → Gate Operators: uses operators
gpu/quantum_research/gpu_vram_and_qubit_scaling_benchmark.py - GPU Scaling Study → Circuit API: builds circuits
gpu/quantum_research/gpu_vram_and_qubit_scaling_benchmark.py - Noisy NISQ Study → State Engine: uses state engine
gpu/quantum_research/noisy_nisq_circuit_simulation.py - Noisy NISQ Study → Gate Operators: uses operators
gpu/quantum_research/noisy_nisq_circuit_simulation.py - Noisy NISQ Study → Noise Channels: uses channels
gpu/quantum_research/noisy_nisq_circuit_simulation.py - QAOA MaxCut → Circuit API: builds circuits
gpu/quantum_research/quantum_approximate_optimization_algorithm_maxcut.py - QAOA MaxCut → Observables: evaluates observables
gpu/quantum_research/quantum_approximate_optimization_algorithm_maxcut.py - QAOA MaxCut → State Engine: uses state engine
gpu/quantum_research/quantum_approximate_optimization_algorithm_maxcut.py - VQE H2 → Circuit API: builds circuits
gpu/quantum_research/variational_quantum_eigensolver_h2.py - VQE H2 → Observables: evaluates observables
gpu/quantum_research/variational_quantum_eigensolver_h2.py - Noise Trajectories → Gate Operators: uses operators
gpu/quantum_research/quantum_noise_simulation_monte_carlo.py - Noise Trajectories → Noise Channels: uses channels
gpu/quantum_research/quantum_noise_simulation_monte_carlo.py - Noise Trajectories → Observables: evaluates observables
gpu/quantum_research/quantum_noise_simulation_monte_carlo.py - XOR Classifier → Observables: evaluates observables
gpu/quantum_research/variational_quantum_classifier_xor.py - GHZ Preparation → Circuit API: uses simulator API
gpu/quantum_research/ghz_state_preparation.py - Functional Circuit → Gate Definitions: constructs gates
experiment/jax_qsim/circuit.py - Functional Circuit → Statevector Runtime: runs statevector
experiment/jax_qsim/circuit.py - Functional Circuit → Density Matrix: runs density matrix
experiment/jax_qsim/circuit.py - Density Matrix → Statevector Runtime: reuses gate application
experiment/jax_qsim/density_matrix.py - Density Matrix → Gate Definitions: builds channels
experiment/jax_qsim/density_matrix.py - Density Matrix → Observable Types: uses observable types
experiment/jax_qsim/density_matrix.py - Statevector Runtime → Gate Definitions: applies Pauli gates
experiment/jax_qsim/statevector.py - Statevector Runtime → Observable Types: evaluates observables
experiment/jax_qsim/statevector.py - Researcher → Circuit API: defines circuit
- Researcher → TPU Scale Suite: runs scaling suite
README.md - TPU Scale Suite → State Engine: executes distributed simulation
- Researcher → Shor Algorithm: runs algorithm
- Researcher → Grover Runs: runs search
- Researcher → 42-Qubit Run: runs workload
- Researcher → 75-Qubit Run: runs workload