#csv #trial #qubit #summary #amp #benchmark #grover

bin+lib mutli_grovers

High-performance classical simulator of Grover's algorithm with support for multiple marked states

2 releases

Uses new Rust 2024

0.1.1 Oct 7, 2025
0.1.0 Oct 7, 2025

#169 in Simulation

Download history 284/week @ 2025-10-07 22/week @ 2025-10-14 2/week @ 2025-10-21

308 downloads per month

MIT license

10KB
171 lines

Multi-Grovers Simulator

A fast and faithful simulation of Grover's quantum search algorithm, supporting multiple target indices and large qubit registers — implemented in pure Rust.


Crates.io Docs.rs License


Features

  • Simulation of Grover's Algorithm
  • Multi-target oracle support
  • Tracks amplitude growth per iteration
  • Measurement histogram after repeated trials
  • Benchmarks runtime and memory usage
  • Exports results to .csv

Usage

Build & Run

cargo run --release

Configuration (via CLI)

cargo run --release -- \
  --qubits 10000 \
  --targets 777 888 999 \
  --iterations 50 \
  --trials 100

Output

  • grover_summary.csv: amplitude data, performance stats, and measurement frequencies.

Example Output

Grover finished in 0.006s with final amp 0.4016
Saved: grover_summary.csv

Project Structure

src/
├── main.rs       # CLI + entry point
├── runner.rs     # Core simulation logic
└── utils.rs      # CSV export and helper utilities

Requirements

  • Rust 1.70+
  • rand crate for measurement simulation
  • clap crate for CLI parsing (to be added)

TODO

  • Core Grover simulation
  • Multi-target support
  • Add CLI via clap
  • Visual output (plotting)
  • Optional: Export binary state

If you like this project, check out:


⚖License

MIT

Dependencies

~1.3–2MB
~35K SLoC