Skip to main content
Ctrl+K

ATLAS-Q

  • Installation
  • Quick Start
  • Tutorials
  • How-To Guides
  • Explanations
    • API Reference
    • Developer Documentation
    • Examples
    • Frequently Asked Questions
    • Changelog
    • Citing ATLAS-Q
  • GitHub
  • PyPI
  • Installation
  • Quick Start
  • Tutorials
  • How-To Guides
  • Explanations
  • API Reference
  • Developer Documentation
  • Examples
  • Frequently Asked Questions
  • Changelog
  • Citing ATLAS-Q
  • GitHub
  • PyPI

Section Navigation

  • IR Module (Informational Relativity)
  • atlas_q.adaptive_mps
    • atlas_q.adaptive_mps.AdaptiveMPS
    • atlas_q.adaptive_mps.DTypePolicy
  • MPS PyTorch Backend
  • atlas_q.mpo_ops
    • atlas_q.mpo_ops.MPO
    • atlas_q.mpo_ops.MPOBuilder
    • atlas_q.mpo_ops.expectation_value
    • atlas_q.mpo_ops.apply_mpo_to_mps
    • atlas_q.mpo_ops.correlation_function
  • atlas_q.tdvp
    • atlas_q.tdvp.TDVP1Site
    • atlas_q.tdvp.TDVP2Site
    • atlas_q.tdvp.TDVPConfig
    • atlas_q.tdvp.run_tdvp
  • atlas_q.vqe_qaoa
    • atlas_q.vqe_qaoa.VQE
    • atlas_q.vqe_qaoa.QAOA
    • atlas_q.vqe_qaoa.VQEConfig
    • atlas_q.vqe_qaoa.HardwareEfficientAnsatz
    • atlas_q.vqe_qaoa.QAOAAnsatz
    • atlas_q.vqe_qaoa.build_molecular_hamiltonian
  • atlas_q.grover
    • atlas_q.grover.GroverSearch
    • atlas_q.grover.GroverConfig
    • atlas_q.grover.OracleBase
    • atlas_q.grover.FunctionOracle
    • atlas_q.grover.BitmapOracle
    • atlas_q.grover.DiffusionOperator
    • atlas_q.grover.grover_search
    • atlas_q.grover.calculate_grover_iterations
  • atlas_q.stabilizer_backend
    • atlas_q.stabilizer_backend.StabilizerSimulator
    • atlas_q.stabilizer_backend.StabilizerState
    • atlas_q.stabilizer_backend.HybridSimulator
    • atlas_q.stabilizer_backend.is_clifford_gate
  • Noise Models
  • PEPS (2D Tensor Networks)
  • Circuit Cutting
  • 2D/Planar Circuits
  • Distributed MPS
  • atlas_q.cuquantum_backend
    • atlas_q.cuquantum_backend.CuQuantumConfig
    • atlas_q.cuquantum_backend.CuQuantumBackend
  • atlas_q.quantum_hybrid_system
    • atlas_q.quantum_hybrid_system.CompressedQuantumState
    • atlas_q.quantum_hybrid_system.PeriodicState
    • atlas_q.quantum_hybrid_system.ProductState
    • atlas_q.quantum_hybrid_system.MatrixProductState
    • atlas_q.quantum_hybrid_system.PeriodResult
    • atlas_q.quantum_hybrid_system.PeriodFinder
    • atlas_q.quantum_hybrid_system.QuantumClassicalHybrid
    • atlas_q.quantum_hybrid_system.QuantumCircuit
    • atlas_q.quantum_hybrid_system.GPUAccelerator
  • Triton GPU Kernels
  • atlas_q.diagnostics
    • atlas_q.diagnostics.bond_entropy_from_S
    • atlas_q.diagnostics.effective_rank
    • atlas_q.diagnostics.spectral_gap
    • atlas_q.diagnostics.MPSStatistics
  • atlas_q.linalg_robust
    • atlas_q.linalg_robust.robust_svd
    • atlas_q.linalg_robust.robust_qr
    • atlas_q.linalg_robust.condition_number
  • atlas_q.truncation
    • atlas_q.truncation.choose_rank_from_sigma
    • atlas_q.truncation.compute_global_error_bound
    • atlas_q.truncation.check_entropy_sanity
  • API Reference
  • atlas_q.grover
  • atlas_q.grover.grover_search

atlas_q.grover.grover_search#

atlas_q.grover.grover_search(n_qubits, marked_states, iterations=None, device='cuda', verbose=False)[source]#

Convenience function to run Grover’s search

Args:

n_qubits: Number of qubits marked_states: Either set/list of marked states or marking function iterations: Number of iterations (None = auto) device: ‘cuda’ or ‘cpu’ verbose: Print progress

Returns:

Results dictionary

Example:
>>> result = grover_search(4, marked_states={7}, verbose=True)
>>> print(f"Found: {result['measured_state']}")
Found: 7

previous

atlas_q.grover.DiffusionOperator

next

atlas_q.grover.calculate_grover_iterations

On this page
  • grover_search()

© Copyright 2025, ATLAS-Q Development Team.

Created using Sphinx 8.2.3.

Built with the PyData Sphinx Theme 0.16.1.