SparQ Documentation¶
SparQ is a sparse-state quantum circuit simulator framework with native QRAM support, a register-level programming paradigm, a quantum algorithm library (Grover, Shor, block encoding, Hamiltonian simulation, discrete adiabatic, etc.), and complete Python bindings (pysparq).
Quick Links¶
GitHub repository - source code and issue tracking
QRAM-Simulator repository - the QRAM foundation (referenced by this repository as a submodule)
PyPI -
pip install pysparq
User Guide
- Installation
- Quick Start
- SparQSim Architecture
- Examples
- Dynamic Operator Extension
- RIR Interpretive Execution
- Core Concepts
- Quantum Algorithm Development Guide
Operator Reference
C++ API Reference
- C++ API Reference
- Core Components and Quantum Gates
- Measurement and Readout
- QRAM Operations
- Quantum Arithmetic and State Organization
- Register/System Operations and Debugging
- Algorithm Library (Top Level)
- Block Encoding (BlockEncoding/)
- Discrete Adiabatic (DiscreteAdiabatic/)
- CUDA Backend
- Python Binding Layer (C++ Side)
Interactive Tutorials
Getting Started¶
Install PySparQ via pip:
pip install pysparq
A quick example:
from pysparq import System, SparseState, AddRegister, Hadamard_Int
system = System()
state = SparseState(system)
AddRegister("q", pysparq.UnsignedInteger, 4)(state)
Hadamard_Int("q")(state)
print(state)