Skip to main content

GroverSearch

numrs2::new_modules::quantum::algorithms

Struct GroverSearch

pub struct GroverSearch;

Expand description

Grover’s Search Algorithm

Provides quadratic speedup for unstructured search problems. Searches for a marked item in O(√N) queries compared to O(N) classically.

§Mathematical Background

Grover’s algorithm uses amplitude amplification to increase the probability of measuring the marked state. Each iteration applies:

Oracle that marks the solution
Diffusion operator that amplifies the marked amplitude

Implementations§

impl GroverSearch

pub fn search<T, F>( num_qubits: usize, oracle: F, num_iterations: usize, ) -> Result<StateVector<T>>
where T: Float + Clone + Debug + Into<f64> + From<f64>, F: Fn(&mut QuantumCircuit<T>) -> Result<()>,

Run Grover’s search algorithm

§Arguments

num_qubits - Number of qubits (search space size = 2^n)
oracle - Oracle function marking the solution
num_iterations - Number of Grover iterations (optimal: π/4 * √N)

§Returns

State after Grover iterations

pub fn optimal_iterations(num_qubits: usize, num_solutions: usize) -> usize

Calculate optimal number of Grover iterations

§Arguments

num_qubits - Number of qubits
num_solutions - Number of marked items

§Returns

Optimal number of iterations

Auto Trait Implementations§

impl Freeze for GroverSearch

impl RefUnwindSafe for GroverSearch

impl Send for GroverSearch

impl Sync for GroverSearch

impl Unpin for GroverSearch

impl UnsafeUnpin for GroverSearch

impl UnwindSafe for GroverSearch

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

impl<T> Pointable for T

const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

impl<T> Same for T

type Output = T

Should always be Self

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V