atlas_q.quantum_hybrid_system.QuantumClassicalHybrid#

class atlas_q.quantum_hybrid_system.QuantumClassicalHybrid(verbose=True, use_gpu=True)[source]#

Bases: object

Main system combining: - Compressed quantum state representations - Classical O(√r) period-finding algorithms - Hybrid approach for optimal performance - Quantum circuit emulation (tensor contractions) - GPU acceleration support (optional)

Methods

create_circuit(num_qubits)

Create a new quantum circuit

create_mps_state(num_qubits[, bond_dim])

Create a tensor network (MPS) quantum state

create_periodic_state(num_qubits, period)

Create a compressed periodic quantum state

create_product_state(num_qubits)

Create a compressed product (separable) quantum state

execute_circuit(circuit[, backend])

Execute a quantum circuit using tensor contractions

factor_number(N[, max_attempts])

Factor N using period-finding (Shor's algorithm approach)

find_period(a, N[, method])

Find period of a^x mod N

find_period_gpu(a, N)

GPU-accelerated period finding Falls back to CPU if GPU unavailable
__init__(verbose=True, use_gpu=True)[source]#

Methods

__init__([verbose, use_gpu])

create_circuit(num_qubits)

Create a new quantum circuit

create_mps_state(num_qubits[, bond_dim])

Create a tensor network (MPS) quantum state

create_periodic_state(num_qubits, period)

Create a compressed periodic quantum state

create_product_state(num_qubits)

Create a compressed product (separable) quantum state

execute_circuit(circuit[, backend])

Execute a quantum circuit using tensor contractions

factor_number(N[, max_attempts])

Factor N using period-finding (Shor's algorithm approach)

find_period(a, N[, method])

Find period of a^x mod N

find_period_gpu(a, N)

GPU-accelerated period finding Falls back to CPU if GPU unavailable
find_period(a, N, method='auto')[source]#

Find period of a^x mod N

Args:

a: Base N: Modulus method: “auto” (tries all), or specific method name

Returns:

PeriodResult with period, method used, and timing

factor_number(N, max_attempts=20)[source]#

Factor N using period-finding (Shor’s algorithm approach)

Returns:

Tuple of (factor1, factor2) if successful, None otherwise

create_periodic_state(num_qubits, period)[source]#

Create a compressed periodic quantum state

create_product_state(num_qubits)[source]#

Create a compressed product (separable) quantum state

create_mps_state(num_qubits, bond_dim=8)[source]#

Create a tensor network (MPS) quantum state

create_circuit(num_qubits)[source]#

Create a new quantum circuit

execute_circuit(circuit, backend='auto')[source]#

Execute a quantum circuit using tensor contractions

Args:

circuit: The quantum circuit to execute backend: “product” (separable only), “mps” (tensor network),

or “auto” (choose automatically based on gates)

Returns:

The final quantum state

find_period_gpu(a, N)[source]#

GPU-accelerated period finding Falls back to CPU if GPU unavailable