快速入门¶
独立模拟工作台¶
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 采用"寄存器级编程"范式。与从单个门组合电路不同,您直接对命名的量子寄存器进行操作。操作层面从量子比特上升到了量子寄存器,几乎所有操作都以寄存器为单位。
基本工作流程¶
调用
System.clear()清理静态状态:doc:`声明寄存器 </guide/core_concepts/register_management>`(名称、类型、比特数)
创建
SparseState()——默认构造函数自动创建|0...0⟩初态应用量子操作(见 算子参考)
通过 部分迹算子 读取测量结果
示例:量子加法¶
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)
控制类型¶
conditioned_by_nonzeros(reg) - 当寄存器非零时执行
conditioned_by_all_ones(reg) - 当寄存器全为1时执行
conditioned_by_bit(reg, pos) - 当特定位为1时执行
conditioned_by_value(reg, val) - 当寄存器值等于特定值时执行
下一步¶
在 PySparQ 快速入门 notebook 中以交互方式尝试同样的工作流,然后继续阅读 核心概念 与 示例。