mutli_grovers

Crates.iomutli_grovers
lib.rsmutli_grovers
version0.1.1
created_at2025-10-07 13:35:59.508066+00
updated_at2025-10-07 13:39:27.67478+00
descriptionHigh-performance classical simulator of Grover's algorithm with support for multiple marked states.
homepage
repository
max_upload_size
id1871669
size43,880
(AngryBeaverss)

documentation

README

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

Related

If you like this project, check out:


⚖License

MIT

Commit count: 0

cargo fmt