快速入门

独立模拟工作台

pysparq info
pysparq run --case ghz --qubits 32 --out results/ghz.json
pysparq run --case qft --qubits 6 --basis 3
pysparq run --case stateprep --qubits 8 --seed 20261109
pysparq gui

安装包自带独立本地界面,不依赖 demo-suite 或外部网页资源。示例实际调用 CPU 原生模拟器,导出复振幅,并核对独立参考值和逆操作。报告包含逻辑比特数、稀疏 支撑规模、归一化、复相位误差、原生二进制摘要及构造/执行分项耗时。GHZ 支持 至多32比特,傅里叶变换和稠密酉态制备支持2..10比特。这些是经典模拟耗时, 不是量子运行时间或应用加速验收证明。界面每次使用独立子进程,限时60秒; 不提交任何真机任务。

寄存器级编程

PySparQ 采用"寄存器级编程"范式。与从单个门组合电路不同,您直接对命名的量子寄存器进行操作。操作层面从量子比特上升到了量子寄存器,几乎所有操作都以寄存器为单位。

基本工作流程

  1. 调用 System.clear() 清理静态状态

  2. :doc:`声明寄存器 </guide/core_concepts/register_management>`(名称、类型、比特数)

  3. 创建 SparseState()——默认构造函数自动创建 |0...0⟩ 初态

  4. 应用量子操作(见 算子参考)

  5. 通过 部分迹算子 读取测量结果

示例:量子加法

import pysparq as ps

# 第一步:清理静态状态
ps.System.clear()

# 第二步:声明寄存器
ps.System.add_register("a", ps.UnsignedInteger, 4)
ps.System.add_register("b", ps.UnsignedInteger, 4)
ps.System.add_register("result", ps.UnsignedInteger, 4)

# 第三步:创建稀疏量子态(自动创建 |a=0, b=0⟩ 初态)
state = ps.SparseState()

# 第四步:将寄存器置于叠加态
ps.Hadamard_Int("a", 4)(state)
ps.Hadamard_Int("b", 4)(state)

# 量子加法:result = a + b
ps.Add_UInt_UInt("a", "b", "result")(state)

# 状态现在包含所有可能求和结果的叠加态
ps.pprint(state)

示例使用了 Hadamard_Int 将两个寄存器置于叠加态,并用 Add_UInt_UInt 完成求和。 详见 Hadamard 操作、算术算子 与 调试工具 (pprint)。

条件操作

操作可以根据其他寄存器的值进行条件控制(完整参考见 条件执行):

# 添加控制寄存器
ps.AddRegister("control", ps.Boolean, 1)(state)

# 仅当 control 为 |1> 时应用操作
ps.Add_UInt_UInt("a", "b").conditioned_by_nonzeros("control")(state)

控制类型

下一步

在 PySparQ 快速入门 notebook 中以交互方式尝试同样的工作流,然后继续阅读 核心概念 与 示例。