Skip to content

Latest commit

 

History

History
60 lines (39 loc) · 2.18 KB

File metadata and controls

60 lines (39 loc) · 2.18 KB

无硬件快速开始

本页用于在未连接任何仪器时确认 WaveBench 已安装,并验证一个现有 plan 可以通过离线检查。完成后可以看到模板列表、示例 TOML 和 run check 的明确成功结果。

前置条件

  • Python 3.11 或更高版本。
  • 一个新的 WaveBench 工作副本。
  • 不需要 wavebench.toml,也不需要连接仪器。

1. 创建虚拟环境并安装

在仓库根目录运行:

python3 -m venv .venv
.venv/bin/python -m pip install -e .

PowerShell:

py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

安装完成后,后续命令使用同一虚拟环境中的 Python;不依赖 shell 是否已激活虚拟环境。

2. 检查命令入口

.venv/bin/python -m wavebench --help

输出会列出 runscopesourcepowerdmmdoctorplugincapability 等命令域。PowerShell 中将前缀替换为 .\.venv\Scripts\python.exe

3. 查看并打印一个模板

.venv/bin/python -m wavebench run template --list
.venv/bin/python -m wavebench run template source-scope-sine --print

第一条命令应包含 source-scope-sine。第二条命令会把 TOML 打印到标准输出,其中包含实验段和 [[steps]];它不会写文件、加载配置或连接仪器。

4. 离线检查现有示例

.venv/bin/python -m wavebench run check --plan plans/closure_sine_1k.toml

成功时,输出末尾为 safety_limits=ok / 安全上限=通过run check 会解析 plan、检查 schema、离线安全上限和声明的 capability;它不会打开 transport 或访问仪器。

下一步

run verify 会对配置中的仪器执行只读身份查询,run plan 会执行真实实验;两者不属于本页的无硬件流程。