qililab-control git:20260928.4386e3dA

Immutable. This exact content never changes and is served at /api/v1/blob/501487b3737dc21a.

---
name: qililab-control
description: 用 Qililab 将结构化 I/Q 方波和等待离线编译为 Qblox Q1ASM 及波形表，核对仪器指令，不连接实验设备。
---

# Qililab 离线测控编译

调用 `qililab_local` 的 `compile_qililab_pulses`。固定 `qililab==0.33.3`，Apache-2.0。
先显式执行 `node scripts/setup-paper-tools.mjs qililab-control`。

1. 使用场景是把一个逻辑 I/Q 总线上的方波序列编译成控制指令。此入口不消费真实 runcard，不自动连接设备。
2. `iAmplitude` 与 `qAmplitude` 为 `[-1,1]` 归一化 DAC 幅度。`durationNs` 至少 4 ns，
   `waitAfterNs` 可为零，两者须为 4 ns 的整数倍；波形采样率固定 1 GSa/s。
3. 工具通过真实 `QProgram`、`IQPair` 与 `QbloxCompiler` 生成 `program`（Q1ASM）、
   `sequenceJson` 与 `waveforms`。检查 play 指令的波形索引、持续时间、等待和 I/Q 符号。
4. 解释波形时同时读取 Q1ASM：编译器可能把常量脉冲转为增益指令与共享波形。
   `requestedDurationNs` 只累加用户请求，未计入编译器的同步、标记和停止开销。

未知参数、幅度越界或不符合指令时间栅格会失败。环境缺失/锁变化时运行显式 setup，
SDK 编译错误按原错误解释，不降级为手写假 Q1ASM。`execution` 单独控制 worker 资源。

适配不实例化 `Platform`、仪器、实验执行器或云客户端；没有鉴权步骤。实际硬件连接与校准由用户另行配置。
编译成功不证明芯片表征、真实电压、量子态或实验测量正确；此 L1 工具返回 `scientificValidation=not_evaluated`。

来源：[官方仓库](https://github.com/qilimanjaro-tech/qililab)、
[QProgram](https://github.com/qilimanjaro-tech/qililab/blob/main/src/qililab/qprogram/qprogram.py)、
[Qblox 编译器](https://github.com/qilimanjaro-tech/qililab/blob/main/src/qililab/qprogram/qblox_compiler.py)。