快速开始

从零开始搭建 Quatm 实验控制环境,只需几分钟即可运行第一个实验。

欢迎!下面几步就能让 Quatm 在你的机器上跑起来。

完成本指南后,你将能够:

  • ✅ 在本地安装并验证 Quatm 环境
  • ✅ 理解 device_db.py 的设备配置方式
  • ✅ 编写一个带有参数面板的完整实验脚本
  • ✅ 在模拟模式下运行和调试实验

环境要求

  • Python:3.9 及以上版本
  • 操作系统:Windows 7 以上、Linux(内核版本 5.10.261 及以上)、macOS 10.12 及以上
  • 硬件:模拟模式无需硬件;实际实验需要支持 TTL/DAC 的 FPGA 实时控制器

安装

git clone https://github.com/quatm/quatm.git
cd quatm
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

验证

from quatm.experiment import Experiment

class HelloQuatm(Experiment):
    def build(self):
        print("Quatm 就绪!")
    def run(self):
        print("Hello, Quatm!")

HelloQuatm().run()

下一步


编写第一个实验

从零开始编写你的第一个 Quatm 实验脚本,学习实验类的基本结构和运行方式。

常见问题

Quatm 安装和使用中的常见问题及解决方案。

配置仪器设备

通过 device_db.py 将实验仪器接入 Quatm 框架。