mutli_grovers 0.1.1

High-performance classical simulator of Grover's algorithm with support for multiple marked states.
Documentation
  • Coverage
  • 0%
    0 out of 23 items documented0 out of 13 items with examples
  • Size
  • Source code size: 43.41 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 1.9 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Links
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • AngryBeaverss

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