Skip to content

Simulation

← Curated API reference · Simulate · Execution

GeminiLogicalSimulator compiles logical kernels for Gemini and runs them with its TSIM-backed task in the Bloqade 0.34.0 SDK profile.

  • from bloqade.gemini import GeminiLogicalSimulator

    This is the primary entry point for compiling and simulating logical quantum circuits on the Gemini architecture. Use :meth:`task` to compile a kernel into a reusable :class:`GeminiLogicalSimulatorTask`.

  • from bloqade.gemini import GeminiLogicalSimulatorTask

    A compiled simulation task for the Gemini logical simulator.

How the simulator works in this SDK version

Section titled “How the simulator works in this SDK version”
GeminiLogicalSimulator

compiles a logical kernel for Gemini and creates a GeminiLogicalSimulatorTask. Its constructor accepts a noise_model, which defaults to generate_logical_noise_model(). There is no injectable sampling-backend parameter in Bloqade Lanes 0.10.6.

from bloqade.gemini import GeminiLogicalSimulator
simulator = GeminiLogicalSimulator()
task = simulator.task(my_logical_kernel)
result = task.run(shots=100)

task() eagerly compiles the logical kernel through the Gemini pipeline. The physical SQUIN kernel, TSIM circuits, samplers, and detector error model are computed lazily by the task when requested. The task exposes run() and run_async(), and can return detector results with run_detectors=True.

The source-pinned QuEra PPVM snapshot has its own Python and Rust API reference. It is not an injectable backend for this version of GeminiLogicalSimulator; that interface belongs to newer Lanes versions and is outside the Bloqade 0.34.0 documentation profile.

StackMemorySimulator and DynamicMemorySimulator from bloqade.pyqrack execute supported circuit kernels directly. They do not run the Gemini compilation path and therefore do not validate a program for Gemini hardware.