https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B/Recent content in 快速开始 on QuatmHugozh-cnhttps://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B/first-experiment/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B/first-experiment/实验的基本结构 每个 Quatm 实验都是一个继承自 Experiment 的 Python 类。只需定义 build() 和 run() 两个核心方法： from quatm.experiment import Experiment, NumberValue from quatm.experiment.experiment import delay class MyFirstExperiment(Experiment): def build(self): # 声明设备 self.setattr_device("fpga") # 声明参数 self.setattr_argument( "target_voltage", NumberValue("target_voltage", ndecimals=2, step=0.01, value=4.00) ) def run(self): # 设置 DAC 通道输出并等待后切换 self.my_dac = 1.0 delay(0.5) self.my_dac = self.target_voltage build() — 声明阶段 build() 在实验加载时执行一次，用于声明实验中使用的设备和参数。 设备声明模式 # DAQ/控制器设备（type: local） self.setattr_device("fpga") # 属性设备（type: attr），直接作为实验属性使用 self.setattr_device("cooling_ttl") # 通用属性设备（type: generic_attr） self.setattr_device("Li_frequency") 参数类型 类型 类 使用场景 数值 NumberValue 电压、频率、时间等连续量 布尔 BoolValue 开关、使能等二值选项 选项 StringCombo 模式选择、扫描类型等固定选项 self.https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B/known_issues/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B/known_issues/Windows 系统 pyzmq 安装失败 安装 Microsoft C++ Build Tools 后重试。 FPGA 控制器驱动 需安装厂商提供的 SDK，FPGA 需要按照实际需求定义和烧录timetable。模拟模式下无需实际硬件。 Linux 系统 Qt 图形库依赖 sudo apt install libxcb-cursor0 libxcb-xinerama0 libegl1-mesa 相机权限 Andor / BlackFly 需配置 udev 规则。 Windows Subsystem for Linux (WSL) WSL 用户请确保在 Linux 文件系统挂载上运行，避免在 Windows 文件系统上操作导致意外错误。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B/basic-configuration/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B/basic-configuration/Quatm 通过 configuration/device_db.py 管理所有实验仪器。该文件定义一个名为 device_db 的字典，每个键对应一个可在实验中使用的设备名称。 设备类型 device_db 支持三种设备类型： type 说明 使用场景 local 驱动类实例 FPGA 控制器、相机等需要完整驱动对象的设备 attr 属性映射 将驱动的某个通道映射为实验属性（如 DAC、TTL） generic_attr 通用属性 调用驱动的任意函数，实现灵活的功能映射 配置示例 device_db = { # 驱动设备：加载完整的驱动实例 "fpga": { "type": "local", "module": "quatm.drivers.fpga.client", "class": "fpgaClient", "arguments": {}, }, # 属性设备：TTL 通道映射 "cooling_aom": { "type": "attr", "module": "quatm.experiment.attributes", "class": "TTLOut", "arguments": {"channel": 5, "logic": "a"}, }, # 属性设备：DAC 通道映射 "trap_coil_x": { "type": "attr", "module": "quatm.experiment.attributes", "class": "DAC", "arguments": {"channel": 2}, }, } 属性设备参数 TTLOut — 数字输出 参数 说明 channel FPGA 控制器 TTL 通道编号 logic "l" 为正逻辑，"a" 为反逻辑 DAC — 模拟输出 参数 说明 channel FPGA 控制器 DAC 通道编号 gaugefile 校准文件路径（可选） 通用属性配置 对于需要灵活映射的驱动功能，使用 genericAttr：