bloqade.pyqrack.device.DynamicMemorySimulator

← Module overview

classDynamicMemorySimulator¶source

bloqade.pyqrack.device.DynamicMemorySimulator

Bases: PyQrackSimulatorBase

PyQrack simulator device with dynamic qubit allocation.

Signature

class DynamicMemorySimulator(options: PyQrackOptions = _default_pyqrack_args(), *, loss_m_result: MeasurementResultValue = MeasurementResultValue.One, rng_state: np.random.Generator = np.random.default_rng())

Public import paths

• from bloqade.pyqrack import DynamicMemorySimulator

This can be used to simulate kernels where the number of qubits is not known ahead of time.

Usage examples

# Define a kernel
@qasm2.main
def main():
    q = qasm2.qreg(2)
    c = qasm2.creg(2)

    qasm2.h(q[0])
    qasm2.cx(q[0], q[1])

    qasm2.measure(q, c)
    return q

# Create the simulator object
sim = DynamicMemorySimulator()

# Execute the kernel
qubits = sim.run(main)

You can also obtain other information from it, such as the state vector:

ket = sim.state_vector(main)

from pyqrack.pauli import Pauli
expectation_vals = sim.pauli_expectation([Pauli.PauliX, Pauli.PauliI], qubits)

Parameters

Name	Type	Default	Description
options	PyQrackOptions	_default_pyqrack_args()
loss_m_result	MeasurementResultValue	MeasurementResultValue.One
rng_state	np.random.Generator	np.random.default_rng()

methodtask¶source

bloqade.pyqrack.device.DynamicMemorySimulator.task

Signature

def task(kernel: ir.Method[Params, RetType], args: tuple[Any, ...] = (), kwargs: dict[str, Any] | None = None)

Parameters

Name	Type	Default	Description
kernel	ir.Method[Params, RetType]	required	The kernel method to run.
args	tuple[Any, ...]	()	Positional arguments to pass to the kernel method.
kwargs	dict[str, Any] | None	None	Keyword arguments to pass to the kernel method.

Returns

PyQrackSimulatorTask: The task object used to track execution.

source