laboneq-control git:20260928.15104b0A

Immutable. This exact content never changes and is served at /api/v1/blob/03037b50da42d56d.

---
name: laboneq-control
description: 使用 Zurich Instruments LabOne Q 离线编译 HDAWG 脉冲和模拟仪器输出波形；区分输出信号仿真、量子动力学与实际硬件执行。
---

# LabOne Q 离线脉冲编译

调用 `laboneq_local` 的 `compile_laboneq_pulses`，把结构化顺序脉冲转为 HDAWG sequencer 程序并提取输出波形。
显式执行 `node scripts/setup-paper-tools.mjs laboneq-control`。固定 `laboneq==26.7.0`，Apache-2.0。

- 输入 `pulses` 的 `shape` 为 `constant` 或 `gaussian`。`amplitude` 是归一化幅度 `[-1,1]`，`lengthSeconds` 与 `delayAfterSeconds` 单位为秒。
- Gaussian 使用 SDK 默认的标准高斯包络，截取 `[-3σ,+3σ)`，不强制把边界置零。此处脉冲参数不是 Rabi 频率或已经校准的旋转角。
- 固定虚拟独立 HDAWG 的 RF 输出 0，采样率 2.4 GSa/s，内部时钟；`repetitions` 给出实验重复次数。编译器负责样本对齐和仪器表示约束，可能调整输入时长。
- `snippetStartSeconds` 与 `snippetLengthSeconds` 选择返回的波形片段；实际输出长度可以小于请求窗口。`execution` 独立控制 worker 资源。
- 返回真实编译器的 sequencer 源码、估计执行时长、采样时刻及波形实虚部。可用常数脉冲的幅度、持续样本数和间隔核对生成结果。
- 当前 SDK 的 `Session.compile` 可直接调用离线编译器；适配不调用 `Session.connect` 或 `Session.run`，不连接 data server，不写仪器。
- 输出模拟描述仪器信号，不能当作量子态动力学、实际测量信号或校准后的设备行为。后续真实仪器连接与权限由用户自行设置。
- 当前 L1，`scientificValidation=not_evaluated`；编译成功与波形对照不等于最终科学 Acceptance。

参考：[官方仓库](https://github.com/zhinst/laboneq)、[实验与输出模拟](https://docs.zhinst.com/labone_q_user_manual/core/functionality_and_concepts/05_experiment/concepts/index.html)、
[单 HDAWG 设置](https://docs.zhinst.com/labone_q_user_manual/core/functionality_and_concepts/00_device_setup/concepts/index.html)。