Crate ruqu_algorithms 

ruqu-algorithms – Quantum Algorithm Implementations

High-level quantum algorithms built on the ruqu-core simulation engine:

• VQE (Variational Quantum Eigensolver): Find ground-state energies of molecular Hamiltonians using a classical-quantum hybrid loop with hardware-efficient ansatz and parameter-shift gradient descent.

• Grover’s Search: Quadratic speedup for unstructured search over N items, using amplitude amplification with direct state-vector oracle access.

• QAOA (Quantum Approximate Optimization Algorithm): Approximate solutions to combinatorial optimization problems (MaxCut) via parameterized phase-separation and mixing layers.

• Surface Code: Distance-3 surface code error correction simulation with stabilizer measurement cycles, noise injection, and syndrome decoding.

Quick Start

use ruqu_algorithms::{VqeConfig, run_vqe, vqe::h2_hamiltonian};

let config = VqeConfig {
    hamiltonian: h2_hamiltonian(),
    num_qubits: 2,
    ansatz_depth: 2,
    max_iterations: 100,
    convergence_threshold: 1e-6,
    learning_rate: 0.1,
    seed: Some(42),
};
let result = run_vqe(&config).expect("VQE failed");
println!("Ground state energy: {:.6}", result.optimal_energy);

Re-exports

pub use grover::GroverConfig;

pub use grover::GroverResult;

pub use grover::run_grover;

pub use qaoa::Graph;

pub use qaoa::QaoaConfig;

pub use qaoa::QaoaResult;

pub use qaoa::run_qaoa;

pub use surface_code::SurfaceCodeConfig;

pub use surface_code::SurfaceCodeResult;

pub use surface_code::run_surface_code;

pub use vqe::VqeConfig;

pub use vqe::VqeResult;

pub use vqe::run_vqe;

Modules

grover

Grover’s Search Algorithm

qaoa

Quantum Approximate Optimization Algorithm (QAOA) for MaxCut

surface_code

Surface Code Error Correction Simulation

vqe

Variational Quantum Eigensolver (VQE)