文档版本 dev

LocalDigitalSimulator

from cascaqit import LocalDigitalSimulator

LocalDigitalSimulator

LocalDigitalSimulator(
    seed: int | None = None,
    max_qubits: int = 4,
    target_id: str = "local.digital_simulator",
    created_at: str | None = None,
)

小规模数字线路的参考状态向量模拟器。默认 max_qubits=4，可显式配置；内存随比特数指数增长。它不提供统一后端的噪声、扫描与资源规划入口。seed 用于采样，target_id 与 created_at 写入结果来源信息。

from cascaqit import Circuit, LocalDigitalSimulator

program = Circuit(1).x(0).measure_all().to_program()
result = LocalDigitalSimulator(seed=7).run(program, shots=32)
assert result.counts == {"1": 32}

需要统一任务接口时使用 LocalBackend。

run

run(
    program: DigitalProgramIR,
    *,
    shots: int = 1000,
    config: SimulatorConfigIR | None = None,
) -> ResultIR

同步执行 DigitalProgramIR 并返回 ResultIR；Circuit 需先调用 to_program()。从全零态开始，演化后进行终端采样。shots=0 不采样。若提供 SimulatorConfigIR，它完整取代 shots 与构造 seed 的默认配置。部分程序校验失败会返回带错误 diagnostics 的结果，因此应检查诊断；错误类型与算法选择等问题也可能直接抛异常。