Skip to content

API Reference - Circuits

Detailed API reference for quantum circuit exploration.

quantumpytho.modules.circuit_explorer

Functions

bell_pair

from quantumpytho.modules.circuit_explorer import bell_pair

result = bell_pair(shots: int = 1024) -> dict

Creates and runs a Bell pair circuit to demonstrate quantum entanglement.

Parameters:

  • shots (int, optional) - Number of measurement shots. Default: 1024

Returns:

Dictionary containing: - counts (dict) - Measurement counts for each basis state - circuit (str) - ASCII circuit diagram

Example:

from quantumpytho.modules.circuit_explorer import bell_pair

# Create Bell pair
result = bell_pair(shots=1024)

print(f"Counts: {result['counts']}")
print(f"Circuit:\n{result['circuit']}")

Output:

Counts: {'00': 512, '11': 512}
Circuit:
     ┌───┐     
q_0: ┤ H ├──■──
     └───┘┌─┴─┐
q_1: ─────┤ X ├
          └───┘

Theory

The Bell pair creates the maximally entangled state:

$$|\Phi^+\rangle = \frac{1}{\sqrt{2}}(|00\rangle + |11\rangle)$$

This state exhibits perfect correlations: measuring one qubit immediately determines the state of the other, regardless of distance.

hadamard_sweep

from quantumpytho.modules.circuit_explorer import hadamard_sweep

result = hadamard_sweep(depth: int = 3, shots: int = 1024) -> dict

Applies repeated Hadamard gates to explore quantum superposition.

Parameters:

  • depth (int, optional) - Number of Hadamard layers. Default: 3
  • shots (int, optional) - Number of measurement shots. Default: 1024

Returns:

Dictionary containing: - counts (dict) - Measurement counts for each basis state - circuit (str) - ASCII circuit diagram - depth (int) - Circuit depth

Example:

from quantumpytho.modules.circuit_explorer import hadamard_sweep

# Apply 5 Hadamard layers
result = hadamard_sweep(depth=5, shots=1024)

print(f"Counts: {result['counts']}")
print(f"Depth: {result['depth']}")

Theory

The Hadamard gate creates superposition:

$$H|0\rangle = \frac{1}{\sqrt{2}}(|0\rangle + |1\rangle)$$

Applying H repeatedly explores the space of quantum states: - Depth 1: Equal superposition - Depth 2: Returns to |0⟩ - Depth 3: Equal superposition again - Pattern repeats every 2 applications

quantumpytho.modules.teleport_bridge

Functions

run_teleport_bridge

from quantumpytho.modules.teleport_bridge import run_teleport_bridge

result = run_teleport_bridge(engine: QuantumEngine) -> dict

Demonstrates the quantum teleportation protocol.

Parameters:

  • engine (QuantumEngine) - Quantum engine instance

Returns:

Dictionary containing: - circuit (str) - ASCII circuit diagram

Example:

from quantumpytho.modules.teleport_bridge import run_teleport_bridge
from quantumpytho.engine import QuantumEngine

engine = QuantumEngine()
result = run_teleport_bridge(engine)

print(f"Circuit:\n{result['circuit']}")

Theory

Quantum teleportation allows transfer of an unknown quantum state using: 1. Entanglement (Bell pair) 2. Classical communication (2 bits) 3. Conditional operations on receiver's qubit

The protocol does not violate the no-cloning theorem because the original state is destroyed during measurement.

quantumpytho.modules.tmt_sierpinski

Functions

run_tmt_sierpinski

from quantumpytho.modules.tmt_sierpinski import run_tmt_sierpinski

result = run_tmt_sierpinski(engine: QuantumEngine) -> dict

Creates a 21-qubit circuit implementing the TMT Sierpinski fractal pattern.

Parameters:

  • engine (QuantumEngine) - Quantum engine instance

Returns:

Dictionary containing: - circuit (str) - ASCII circuit diagram - counts (dict) - Measurement counts

Example:

from quantumpytho.modules.tmt_sierpinski import run_tmt_sierpinski
from quantumpytho.engine import QuantumEngine

engine = QuantumEngine()
result = run_tmt_sierpinski(engine)

print(f"Circuit:\n{result['circuit']}")
print(f"Counts: {result['counts']}")

Theory

The TMT Sierpinski circuit creates a fractal pattern in the measurement distribution, demonstrating: - Self-similarity across scales - Sacred geometry connections - Quantum interference patterns

See Also