https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/Recent content in 实验框架 on QuatmHugozh-cnhttps://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E6%95%B0%E6%8D%AE%E7%B1%BB%E6%8E%A7%E4%BB%B6/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E6%95%B0%E6%8D%AE%E7%B1%BB%E6%8E%A7%E4%BB%B6/类和方法 FloatBox 类 FloatBox 继承自 FloatManager，用于处理实验中的浮点数参数。 方法： __init__(self, props, value, parent=None, **kwargs)：初始化浮点数控件。 props：属性对象，用于存储和管理配置数据。 value：初始值。 parent：父窗口。 **kwargs：其他关键字参数，包括参数名称等。 调用父类的初始化方法，并传递参数名称。 updateValue(self, value)：更新实验中的对应参数。 value：新的浮点数值。 更新控件的值，并在属性对象中设置对应的参数值和最后设置的参数信息。 BoolBox 类 BoolBox 继承自 BoolManager，用于处理实验中的布尔值参数。 方法： updateValue(self, value)：更新实验中的对应参数。 value：新的布尔值。 更新控件的值，并在属性对象中设置对应的参数值和最后设置的参数信息。 updateCheckbox(self)：更新复选框状态。 如果属性中的值与当前复选框的状态不一致，则更新复选框的状态。 ComboBox 类 ComboBox 继承自 ComboManager，用于处理实验中的组合框参数。 方法： updateValue(self, value)：更新实验中的对应参数。 value：新的组合框值。 将值转换为字符串列表中的对应值。 更新控件的值，并在属性对象中设置对应的参数值和最后设置的参数信息。 类的详细说明 FloatBox 类 FloatBox类用于处理实验中的浮点数参数。它继承自FloatManager，并扩展了其功能，以便在属性对象中设置参数值。 class FloatBox(FloatManager): ''' Box for handling the attribute argument Args: argument:(NumberValue) points to the argument in the experiment unit:(str) unit string display_multiplier:(float) multiplication factor for the unit ''' def __init__(self, props, value, parent=None, **kwargs): super().https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E7%AA%97%E5%8F%A3%E6%8E%A7%E4%BB%B6%E7%B1%BB/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E7%AA%97%E5%8F%A3%E6%8E%A7%E4%BB%B6%E7%B1%BB/类和方法 BWidget 类 BWidget 继承自 QWidget，实现了一个基础窗口小部件类，包含移动和调整大小事件的日志记录功能。 方法： __init__(self, name='Noname', parent=None)：初始化窗口小部件。 name：窗口小部件名称，默认为’Noname’。 parent：父窗口。 初始化属性对象并恢复窗口几何设置。 closeEvent(self, event)：处理窗口关闭事件。 event：关闭事件。 保存窗口几何设置并调用父类的关闭事件处理方法。 BFrame 类 BFrame 继承自 QFrame，实现了一个基础框架类，包含移动和调整大小事件的日志记录功能。 方法： __init__(self, name='Noname', parent=None)：初始化框架。 name：框架名称，默认为’Noname’。 parent：父窗口。 初始化属性对象并恢复框架几何设置。 closeEvent(self, event)：处理框架关闭事件。 event：关闭事件。 保存框架几何设置并调用父类的关闭事件处理方法。 BMainWindow 类 BMainWindow 继承自 QMainWindow，实现了一个基础主窗口类，包含移动和调整大小事件的日志记录功能。 方法： __init__(self, name='Noname', parent=None)：初始化主窗口。 name：主窗口名称，默认为’Noname’。 parent：父窗口。 初始化属性对象并恢复主窗口几何设置。 closeEvent(self, event)：处理主窗口关闭事件。 event：关闭事件。 保存主窗口几何设置并调用父类的关闭事件处理方法。 CustomCompleter 类 CustomCompleter 继承自 QCompleter，实现了一个自定义的自动完成器。 方法： __init__(self, items, parent=None, match_flag='contains')：初始化自动完成器。 items：自动完成项。 parent：父窗口。 match_flag：匹配标志，默认为’contains’。 设置完成模式为弹出完成。 pathFromIndex(self, index)：根据索引返回路径。 index：索引。 根据匹配标志返回路径。 SearchComboBox 类 SearchComboBox 继承自 QComboBox，实现了一个带有自动完成功能的组合框。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E5%BA%8F%E5%88%97%E7%BC%96%E8%BE%91%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E5%BA%8F%E5%88%97%E7%BC%96%E8%BE%91%E5%99%A8/类和方法 CodeEditor 类 CodeEditor 继承自 QsciScintilla，实现了一个简单的代码编辑器，具有语法高亮和自动补全功能。 方法： __init__(self, parent=None, filename=None)：初始化编辑器，设置字体、缩进、自动补全和行号。 parent：父窗口 filename：要加载的文件名 设置最小尺寸为800x600 设置编辑器字体为Courier New，字号12，固定间距 设置缩进宽度为4，不使用制表符缩进，启用自动缩进 启用自动补全，触发阈值为3个字符 设置边距宽度以显示行号 如果提供了文件名，则加载文件内容到编辑器中 saveFile(self)：保存当前文本到文件。 如果提供了文件名，则将编辑器中的文本写入文件 如果保存成功，打印"file saved successfully" 如果保存失败，打印错误信息 如果文件名无效，打印"filename is invalid, failed to save file" ExperimentSequencer 类 ExperimentSequencer 继承自 QtWidgets.QWidget，用于可视化实验序列。 方法： __init__(self, parent=None, filename=None)：初始化窗口，订阅属性并创建绘图窗口。 parent：父窗口 filename：文件名（未使用） 订阅Properties的Sequencer属性 创建GraphicsLayoutWidget并设置背景为白色 将绘图窗口添加到网格布局中 plotSequence(self, sequence)：绘制实验序列，输入格式由 ExperimentParser 定义。 sequence：包含实验序列的字典，键为通道名，值为包含时间和状态的子字典 重置绘图窗口 矢量化布尔值到整数的转换 找到全局最小和最大时间 处理开始和结束时未定义的值 准备颜色 为每个通道创建线图，根据通道名选择颜色 将所有图的X轴链接到第一个图 ExperimentParser 类 ExperimentParser 用于解析实验代码，模拟实验运行并输出包含通道、时间和通道状态的表。 方法： __init__(self, filename=None)：初始化解析器，构建实验。 filename：文件名 调用buildExperiment方法构建实验 buildExperiment(self)：构建实验，使其在 self.filename 中可访问。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E8%BF%90%E8%A1%8C%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E8%BF%90%E8%A1%8C%E7%AE%A1%E7%90%86%E5%99%A8/以下是该代码的详细中文文档说明： 代码概述 该代码实现了一个实验管理器 (ExperimentManager) 类，用于管理和运行实验队列中的任务。该管理器在一个工作线程中不断检查队列中的实验任务，并根据任务的优先级和状态来决定执行哪些实验。实验任务由测量、序列（或扫描）和运行组成，在执行实验时会调用相关的开始和结束函数来控制实验的流程。 依赖库 numpy：用于数值计算和数组操作。 time：用于时间操作和延时。 Qt.QtCore：用于信号槽机制和日期时间操作。 quatm.GUI.browser_workers：包含 Worker 类，用于多线程处理。 quatm.servers：包含发送信息和错误的函数。 类 ExperimentManager 该类包含了管理实验任务队列的功能，包括运行实验、暂停实验、终止实验等。 初始化方法 __init__(self, browser=None) 初始化实验管理器，设置浏览器、属性、队列、线程池等，并启动实验队列。 参数： browser：浏览器对象，用于获取属性和队列。 运行实验方法 run(self, taskNr, progress_callback=None) 处理实验任务的运行逻辑。 参数： taskNr：任务编号。 progress_callback：进度回调函数。 内部方法 _sequence_run(self) 初始化运行循环并开始实验。 内部方法 _runloop(self) 运行实验（或实验扫描），在每次运行前检查实验是否暂停或终止。 暂停方法 pause(self) 暂停或继续实验。 启动队列方法 start_queue(self) 在实验线程中启动实验队列工作器。 队列函数 queue_fn(self, progress_callback=None) 实验队列持续检查实验字典中的新任务，如果字典为空或有实验在运行，则不做任何操作。 检查到期方法 due_check(taskDict) 检查任务是否到期。 参数： taskDict：任务字典。 返回： True 或 False，表示任务是否到期。 更新表格方法 update_table(self) 通知 GUI 更新表格显示。 终止实验方法 terminate_experiment(self) 优雅地终止实验，允许当前运行完成。 开始测量方法 start_measurement(self) 设置参数并调用实验的 start_measurement 函数。 开始序列方法 start_sequence(self) 调用实验的 start_sequence 函数。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E6%8E%A7%E5%88%B6%E6%B5%8F%E8%A7%88%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E6%8E%A7%E5%88%B6%E6%B5%8F%E8%A7%88%E5%99%A8/代码概述 该代码实现了一个实验浏览器（Browser）应用程序，提供了图形用户界面来管理和运行各种实验。通过使用Qt库构建界面，代码实现了实验文件选择、实验队列管理、参数设置和实验执行等功能。 依赖库 os、importlib.util、inspect、traceback、numpy、json、datetime：标准库，用于文件操作、模块加载、错误处理、数值计算和日期时间处理。 Qt.QtCore 和 Qt.QtWidgets：用于构建GUI应用程序。 quatm.servers 和 quatm.GUI：自定义库，用于属性管理和GUI组件。 类和方法 Browser 类 Browser 继承自 QMainWindow，实现了实验浏览器的主界面。 信号： experimentOpened：实验打开信号。 方法： __init__(self)：初始化浏览器，设置属性、任务队列和其他组件，并恢复窗口几何设置。 closeEvent(self, event)：处理窗口关闭事件，调用父类的关闭事件处理方法。 init_ui(self)：初始化用户界面，设置状态栏和中央窗口区域，并创建停靠窗口。 create_dock_widgets(self)：创建停靠窗口，包含文件选择器、实验队列、准备站和循环器。 open_experiment(self, filepath, startup=False)：打开一个新的实验窗口，如果实验已经打开，则不执行任何操作。 update_exp_window_task(self)：更新所有实验窗口中的任务号。 ExperimentSubWindow 类 ExperimentSubWindow 继承自 QMdiSubWindow，实现了实验窗口的容器。 方法： __init__(self, name, props, parent=None)：初始化子窗口，设置窗口标题和属性。 store_geometry(self)：存储窗口几何设置。 ExperimentWindow 类 ExperimentWindow 继承自 QWidget，实现了单个实验的控制，包括参数设置和任务提交。 方法： __init__(self, filepath, props, parent=None, browser=None)：初始化实验窗口，加载实验文件并构建用户界面。 init_ui(self)：初始化用户界面，创建控件和布局。 save_params(self, backup=False)：保存实验参数到JSON文件。 load_params(self)：从JSON文件加载实验参数。 get_files(self)：打开文件选择对话框，获取文件路径。 update_task_qsb(self)：更新任务号选择框。 submit_to_queue(self)：提交实验到实验队列。 submit_next(self)：提交实验到实验队列，并设置最高优先级。 submit_to_prepper(self)：提交实验到准备站。 setup_scan(self)：设置扫描序列。 setup_task_dict(self)：创建任务字典，存储实验参数。 build_argument_dict(self)：创建实验参数字典。 edit_sequence(self)：打开序列编辑器窗口。 closeEvent(self, event)：处理窗口关闭事件，移除打开的窗口。 gui_columns(self)：返回GUI列数。 arguments(self)：返回实验参数。 argument_names(self)：返回实验参数名称列表。 argument_dicts(self)：返回实验参数字典列表。 store_geometry(self)：存储窗口几何设置。 SequenceEditor 类 SequenceEditor 继承自 QDialog，实现了序列编辑器窗口。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E9%98%9F%E5%88%97%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E9%98%9F%E5%88%97%E7%AE%A1%E7%90%86%E5%99%A8/类和方法 ExperimentQ 类 ExperimentQ 继承自 QGroupBox，实现了一个实验队列管理器，显示和控制实验任务队列。 方法： __init__(self, browser, parent=None, title="Experiment Queue")：初始化实验队列管理器。 browser：浏览器对象，用于访问属性和实验管理器 parent：父窗口 title：组框标题，默认为"Experiment Queue" 创建按钮和表格，并设置布局 初始化属性 设置锁定标志为False create_buttons(self)：创建并配置控制按钮。 创建暂停按钮、终止按钮、终止所有按钮和重启按钮 设置按钮图标、提示信息和点击事件处理函数 init_table_actions(self)：初始化表格操作。 创建删除、终止、终止所有、休眠和暂停操作 设置操作的快捷键和上下文 将操作添加到表格 init_table(self)：初始化表格。 创建 QTableView 并设置选择行为、选择模式和上下文菜单策略 隐藏垂直表头并设置其调整模式为内容适应 初始化 expDict 为一个空字典 创建 ScheduleModel 并将其设置为表格模型 设置水平表头的调整模式 set_model(self, model)：设置表格的新模型。 model：新的模型对象 将模型设置为表格模型 delete_clicked(self)：从队列中删除任务，或者如果任务正在运行则优雅地终止。 获取选中的行，并获取对应的任务编号 如果任务状态为“Running”或“Scanning”，则标记任务为终止 否则，从模型中删除任务 设置当前索引为选中的行 terminate_clicked(self)：优雅地终止选中的任务（允许完成运行）。 获取选中的行，并获取对应的任务编号 标记任务为终止，状态设置为“Termination Pending” 如果没有选中任务，且模型中有任务，则终止第一个任务 terminate_all(self)：终止所有任务。 遍历所有任务，标记为终止，状态设置为“Termination Pending” set_sleeping(self)：将选中的任务设置为“Sleeping”状态，或者取消“Sleeping”状态。 获取选中的行，并获取对应的任务编号 如果任务状态为“Sleeping”，则设置为“Queued”，否则设置为“Sleeping” pause(self)：暂停当前运行的实验。 调用浏览器的实验管理器的暂停方法 根据实验管理器的暂停状态，切换暂停按钮的图标 update_item(self, k, v)：更新表格中的项目。 k：键（任务编号） v：值（任务信息） 将任务信息更新到模型中，并解锁 delete_item(self, k)：删除表格中的项目。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%A4%9A%E7%BA%BF%E7%A8%8B%E4%BB%BB%E5%8A%A1%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%A4%9A%E7%BA%BF%E7%A8%8B%E4%BB%BB%E5%8A%A1%E7%AE%A1%E7%90%86%E5%99%A8/代码概述 该代码实现了一个多线程工作者类（Worker）和信号类（WorkerSignals），用于在应用程序中处理多线程任务。Worker类继承自QRunnable，WorkerSignals类继承自QObject，定义了一组可用的信号，以便在工作线程中传递信息。 依赖库 sys：用于获取异常信息。 traceback：用于格式化异常跟踪信息。 Qt.QtCore：提供Qt核心功能，包括信号和槽机制、可运行对象等。 类和方法 WorkerSignals 类 WorkerSignals 继承自 QObject，定义了一组可用的信号，以便在工作线程中传递信息。 信号： finished：没有数据，表示任务完成。 error：传递一个包含异常类型、异常值和格式化异常跟踪信息的元组。 result：传递处理函数返回的结果数据。 progress：传递一个整数，表示进度百分比。 update_ui：用于更新用户界面。 tableUpdate：用于更新表格。 addItem：传递一个整数和一个QVariant，用于添加项目。 deleteItem：传递一个整数，用于删除项目。 taskStart：表示任务开始。 taskDone：表示任务完成。 class WorkerSignals(QObject): ''' Defines the signals available from a running worker thread. Supported signals are: finished No data error `tuple` (exctype, value, traceback.format_exc() ) result `object` data returned from processing, anything progress `int` indicating % progress ''' finished = pyqtSignal() error = pyqtSignal(tuple) result = pyqtSignal(object) progress = pyqtSignal(int) update_ui = pyqtSignal() tableUpdate = pyqtSignal() addItem = pyqtSignal(int, QtCore.https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E8%87%AA%E5%8A%A8%E4%BF%9D%E5%AD%98%E7%BC%96%E8%BE%91%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E8%87%AA%E5%8A%A8%E4%BF%9D%E5%AD%98%E7%BC%96%E8%BE%91%E5%99%A8/类和方法 AutoSaveEditor 类 AutoSaveEditor 继承自 BWidget，实现了一个自动保存时间的编辑器。 信号： subscriptionsChanged：订阅改变信号。 propertiesChanged：属性改变信号。 方法： __init__(self, props, max_items, name='regular_auto_save_times', parent=None)：初始化自动保存编辑器。 props：属性对象，用于存储和管理配置数据。 max_items：最大项目数量。 name：属性名称，默认为’regular_auto_save_times’。 parent：父窗口。 设置布局，并加载和初始化日期时间控件。 load_AutoSaveEditor_props(props, prop_name, max_items)：加载自动保存编辑器属性。 props：属性对象。 prop_name：属性名称。 max_items：最大项目数量。 返回日期时间和勾选状态。 update_props(props, prop_name, datetimes, ticked)：更新属性。 props：属性对象。 prop_name：属性名称。 datetimes：日期时间数组。 ticked：勾选状态数组。 update_datetime(self, idx, datetime_save)：更新日期时间。 idx：索引。 datetime_save：新的日期时间。 update_ticked(self, idx, ticked)：更新勾选状态。 idx：索引。 ticked：新的勾选状态。 accept(self)：接受并保存更改。 更新属性并通知父组件，然后关闭窗口。 DateTimeWidget 类 DateTimeWidget 继承自 QFrame，实现了一个日期时间选择控件。 方法： __init__(self, idx, parent, datetime_save=datetime.datetime.now(), ticked=False)：初始化日期时间控件。 idx：索引。 parent：父组件。 datetime_save：初始日期时间，默认为当前时间。 ticked：初始勾选状态，默认为False。 设置布局，创建并初始化日期时间编辑控件和复选框。 datetime_changed(self)：日期时间改变事件处理。 更新日期时间，并通知父组件。 ticked_changed(self)：勾选状态改变事件处理。 更新勾选状态，并通知父组件。 主函数 代码通过创建 QApplication 实例和 AutoSaveEditor 窗口来执行，并启动应用程序的主循环。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E6%97%B6%E9%97%B4%E7%BA%BF%E6%9F%A5%E7%9C%8B%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E6%97%B6%E9%97%B4%E7%BA%BF%E6%9F%A5%E7%9C%8B%E5%99%A8/类和方法 Timeline 类 Timeline 继承自 QMainWindow，实现了一个实验时间线查看器。 方法： __init__(self, *args, **kwargs)：初始化时间线查看器。 设置窗口标题为"Timeline Viewer"。 加载JSON文件中的实验序列。 创建主窗口组件，包括文件加载区、绘图区和选择区。 设置中央窗口部件。 plot_experimental_sequence(self, time_dict, init_vals=None)：绘制实验时间序列。 重置绘图区域。 深拷贝时间序列字典。 找到最大时间tmax。 为每个时间序列添加一个点，确保每个序列都在tmax结束。 准备颜色。 为每个选中的输出绘制折线图，并根据条件选择不同的颜色和填充方式。 load_file(self, filename)：加载实验序列文件。 读取JSON文件并解析实验序列。 获取输出名称集合。 构建时间序列字典。 逆向设备数据库转换时间序列字典。 更新选择器组件中的名称。 decode_ttl_bitmask(self, bitmask, command)：解码TTL位掩码。 将位掩码转换为二进制字符串。 找到二进制字符串中的所有1的位置。 根据命令生成TTL字典。 get_set_of_used_outputs(self, sequence)：获取使用的输出集合。 遍历实验序列，提取所有使用的输出名称。 construct_time_sequences(self, sequence, set_of_output_names)：构建时间序列字典。 创建时间序列字典结构。 填充时间序列字典。 reverse_device_db_transformation(self, time_sequence_dict, device_db_path=workpath+'/configuration/')：逆向设备数据库转换时间序列字典。 加载设备数据库。 构建逆向映射字典。 根据逆向映射字典转换时间序列字典中的名称和值。 TimelinePlotter 类 TimelinePlotter 继承自 GraphicsLayoutWidget，用于可视化实验序列。 方法： __init__(self, sequence)：初始化绘图组件。 订阅属性。 设置背景为白色。 初始化绘图字典。 SelectorWidget 类 SelectorWidget 继承自 QFrame，用于选择要显示的实验序列。 方法： __init__(self, parent=None, clear_name_dict=None)：初始化选择器组件。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%A4%9A%E7%BA%BF%E7%A8%8B%E5%A4%84%E7%90%86%E6%A1%86%E6%9E%B6/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%A4%9A%E7%BA%BF%E7%A8%8B%E5%A4%84%E7%90%86%E6%A1%86%E6%9E%B6/ 功能介绍 该代码实现了一个基于 Qt 的多线程处理框架。主要包含两个类：WorkerSignals 和 Worker。WorkerSignals 类定义了线程工作时使用的各种信号，而 Worker 类继承自 QRunnable，用于处理多线程任务的设置、执行和信号传递。 代码结构 导入必要的模块和库 定义类 WorkerSignals 定义类 Worker 类：WorkerSignals 简短功能介绍 WorkerSignals 类定义了可从正在运行的工作线程发出的信号。这些信号用于指示线程的各种状态和进度，包括完成、错误、结果和进度更新。 属性 finished：无数据的信号，指示线程已完成。 error：包含异常类型、值和追溯信息的元组信号。 result：处理结果数据的信号。 progress：指示进度的整数信号。 terminate：终止信号。 start：启动信号。 publish：发布信号。 runDone：运行完成信号。 logging：日志信号，包含日志信息字符串。 clear：清除信号。 类：Worker 简短功能介绍 Worker 类继承自 QRunnable，用于处理工作线程的设置、信号和结束。它允许在独立线程中运行指定的函数，并通过信号机制与主线程通信。 方法：__init__ 功能：初始化 Worker 对象，存储传递的函数及其参数，并设置信号。 参数： fn：要在工作线程中运行的函数。 args：传递给函数的参数。 kwargs：传递给函数的关键字参数。 主要步骤： 调用父类 QRunnable 的构造函数。 存储传递的函数及其参数。 初始化 WorkerSignals 对象。 将进度回调添加到关键字参数中。 方法：run 功能：初始化传递的函数并执行它，处理可能的异常，并通过信号机制传递结果。 主要步骤： 尝试运行传递的函数，并捕获其结果。 如果发生异常，捕获异常信息并发出 error 信号。 如果函数运行成功，发出 result 信号传递结果。 最后，无论是否发生异常，发出 finished 信号指示完成。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E5%BE%AA%E7%8E%AF%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E5%BE%AA%E7%8E%AF%E7%AE%A1%E7%90%86%E5%99%A8/代码结构 导入必要的模块和库 定义主要的 Looper 类 定义 LoopItem 类及其子类（TaskItem, ListItem, ConditionalItem 等） 定义辅助类（DataManager, LoopManager, LoopGroup 等） 实现 GUI 部件和功能 类：Looper 简短功能介绍 Looper 类是整个循环控制的核心。它负责管理任务组、定时器、按钮和循环的启动与终止。 方法 __init__：初始化 Looper 对象，设置属性和布局，创建按钮和标签页。 add_tab：添加新的任务组标签页。 delete_tab：删除指定的任务组标签页。 create_buttons：创建控制按钮。 save_loop：保存当前循环配置。 load_loop：加载之前保存的循环配置。 terminate_by_time：根据时间自动终止循环。 类：LoopItem 简短功能介绍 LoopItem 类是所有循环项的基类，提供了基本的属性和方法。它被 TaskItem, ListItem, ConditionalItem 等类继承，并扩展其功能。 子类：TaskItem 功能：表示单个任务项，执行特定的任务并跟踪运行次数。 方法： __init__：初始化任务项，设置任务信息和UI组件。 run：执行任务，并将任务添加到任务队列。 end_run：更新任务状态和运行次数。 task_start：任务开始时的操作。 task_end：任务结束时的操作。 update_task：更新任务信息。 max_check：检查是否达到最大运行次数。 子类：ListItem 功能：表示一个任务列表，按顺序执行列表中的任务。 方法： __init__：初始化任务列表项，设置任务列表信息和UI组件。 run：执行当前任务，并更新任务索引。 end_run：更新任务列表状态和运行次数。 edit_list：编辑任务列表。 update_task_labels：更新任务标签。 子类：ConditionalItem 功能：表示条件项，根据条件的结果执行不同的任务。 方法： __init__：初始化条件项，设置条件信息和UI组件。 run：评估条件并选择下一步操作。 update_boxes：更新条件的UI组件。 类：DataManager 简短功能介绍 DataManager 类管理数据订阅和更新，处理数据的接收和存储。 方法 __init__：初始化数据管理器，设置属性和数据客户端。 set_new_data：处理新的数据，更新数据字典。 edit_subscriptions：编辑数据订阅。 类：LoopManager 简短功能介绍 LoopManager 类负责管理循环的执行，处理循环任务的启动、终止和控制。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E9%A2%84%E5%A4%87%E9%98%9F%E5%88%97%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E9%A2%84%E5%A4%87%E9%98%9F%E5%88%97%E7%AE%A1%E7%90%86%E5%99%A8/概要 该代码定义了用于管理和展示队列（Queue）和准备站（PrepStation）表格的模型。模型指定了表格数据的形式（如字典或列表），以及如何展示和操作这些数据，包括如何获取、设置和删除数据，以及如何排序数据。模型可以直接从数据集中读取数据，并在数据集发生更改时自动更新表格。 主要类和功能 _SyncSubstruct 此类定义了用于操作表格数据字典的方法。方法包括添加、插入、弹出、设置、删除和获取字典项。这个类主要是为了便于在模型中更新数据字典，并在数据更新时调用回调函数来通知模型。 DictSyncModel 这是一个基类，用于将字典（backing_store）转换为表格。模型可以读取和编辑字典中的数据，并根据需要更新表格显示。其主要功能包括： 初始化模型，设置表头、数据名称和初始数据。 获取行数和列数。 获取和设置单元格数据。 获取表头数据。 插入和删除字典项。 排序和转换数据。 关键方法 rowCount: 返回字典中的条目数。 columnCount: 返回列的数量，即表头的数量。 data: 根据索引和角色获取数据。 setData: 设置单元格数据，并根据需要进行类型转换。 headerData: 获取表头数据。 __setitem__: 插入或更新字典项，并更新表格显示。 __delitem__: 删除字典项，并更新表格显示。 __getitem__: 获取字典项。 sort_key: 定义排序键（由子类实现）。 convert: 将字典键转换为列数据（由子类实现）。 flags: 定义单元格的属性（由子类实现）。 ScheduleModel 这是用于管理实验队列的表格模型。数据结构是一个字典，每个字典代表一个实验任务。任务按优先级和任务编号排序。 关键方法 sort_key: 返回用于排序的键，首先按优先级排序，然后按任务编号排序。 convert: 将字典键转换为列数据，特别是将日期时间字符串转换为 QDateTime 对象。 flags: 定义可编辑和不可编辑的列。 ListSyncModel 类似于 DictSyncModel，但处理的是列表而不是字典。主要用于管理需要按顺序排列的数据集合。 关键方法 rowCount: 返回列表的长度。 columnCount: 返回列的数量。 data: 根据索引和角色获取数据。 setData: 设置单元格数据，并根据需要进行类型转换。 headerData: 获取表头数据。 __delitem__: 删除列表项，并更新表格显示。 __getitem__: 获取列表项。 sort_key: 定义排序键（由子类实现）。 convert: 将列表项转换为列数据（由子类实现）。 flags: 定义单元格的属性（由子类实现）。 PrepModel 这是用于准备站的表格模型，使用列表来管理任务，因为准备站中的任务不需要唯一的 ID，可以自由更改顺序。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E8%BF%90%E8%A1%8C%E8%B0%83%E5%BA%A6%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E8%BF%90%E8%A1%8C%E8%B0%83%E5%BA%A6%E7%AE%A1%E7%90%86%E5%99%A8/概述 Prepper 类（位于 quatm.gui.prepper 模块）是实验调度和运行系统的核心，提供以下核心能力： 任务队列管理：维护待执行的实验任务列表 线程调度：基于线程池的单线程调度策略，避免并发冲突 状态跟踪：通过 expDict 追踪每个实验的配置和运行状态 定时轮询：周期性检查任务状态并更新 UI 核心架构 graph TD A[实验任务入队] --> B[queue 任务队列] B --> C[threadpool 线程池] C --> D[执行实验] D --> E[expDict 状态更新] E --> F[timer 定时刷新 UI] F --> G[browser 界面展示] API 参考 构造函数 from quatm.gui.prepper import Prepper prepper = Prepper(browser=None) 参数 类型 必填 说明 browser object 否 浏览器/UI 对象，用于界面交互和状态展示 成员变量 变量 类型 说明 browser object 关联的 UI 浏览器对象 queue Queue 实验任务队列（FIFO） expDict dict 实验配置与状态字典 threadpool ThreadPoolExecutor 线程池（max_workers=1） timer QTimer UI 定时刷新器 使用示例 基础用法 from quatm.https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E9%A2%84%E5%A4%84%E7%90%86/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E9%A2%84%E5%A4%84%E7%90%86/详细代码分析：PrepStation 类及其相关组件 该代码展示了一个名为 PrepStation 的类，用于实验的预处理和队列管理。以下是对代码的详细分析，涵盖导入的模块、类的定义及其成员、注释和错误处理等方面。 PrepStation 类 PrepStation 类是该代码的核心部分，用于管理实验任务的预处理和队列操作。以下是对该类的详细分析： 初始化方法 __init__ 方法： 初始化类实例，并设置初始状态或配置。 接受 browser、parent 和 title 作为参数。 初始化各类成员变量，如 parent、browser、queue、expDict、qWidget、layout、buttonLayout、props、_task、paramDir、table 和 prepList。 调用 init_ui 和 init_table_actions 方法来设置界面和表格操作。 初始化界面 init_ui 方法： 配置表格的垂直头，使其根据内容调整大小并隐藏。 创建各种按钮并设置其图标、工具提示和点击事件。 将按钮添加到布局中，并设置布局对齐方式。 初始化表格操作 init_table_actions 方法： 创建各种操作（如删除、休眠、推送、循环、编辑、查看和保存）并设置其快捷键和触发事件。 将这些操作添加到表格中。 设置模型 set_model 方法： 创建 PrepModel 实例并设置为表格模型。 调整表格列的宽度。 加载之前的任务 load_previous 方法： 从 prepfile.json 文件中加载之前的任务列表，并打开相关的实验窗口。 更新 prepList。 任务操作方法 push 方法： 将选中的任务推送到队列中，如果没有选中任务，则推送第一个任务。 push_row 方法： 推送指定行的任务到队列中，并更新任务状态。 push_first 方法： 推送第一个任务到队列中。 delete_clicked 方法： 删除选中的任务，并更新任务文件。 set_sleeping 方法： 设置选中的任务为休眠状态。 push_to_looper 方法：https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E9%9B%86%E5%90%88%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E9%9B%86%E5%90%88%E7%AE%A1%E7%90%86%E5%99%A8/环境变量设置 代码通过检查操作系统平台设置了 QT_SCALE_FACTOR 环境变量，以调整 MacOS 上的缩放比例。 SingleProcess 类 SingleProcess 类用于表示单个可管理的进程。以下是该类的详细分析： 初始化方法 __init__ 方法： 初始化类实例，并设置初始状态或配置。 接受 script、name、active、category 和 parent 作为参数。 根据操作系统平台设置 Python 解释器路径。 创建和配置按钮、布局和样式表。 配置定时器以定期更新进程状态。 进程管理方法 startProcess 方法： 停止现有进程（如果有）。 使用 subprocess.Popen 启动新的进程。 更新按钮状态。 stopProcess 方法： 停止现有进程，根据需要选择终止或强制杀死进程。 更新按钮状态。 updateStatus 方法： 定期检查进程状态并更新按钮颜色以指示进程是否运行。 析构方法 __del__ 方法： 确保在对象销毁时停止进程。 ProcessManager 类 ProcessManager 类用于管理多个 SingleProcess 实例。以下是该类的详细分析： 初始化方法 __init__ 方法： 初始化类实例，并设置初始状态或配置。 读取配置文件，创建 SingleProcess 实例，并将其添加到布局中。 设置窗口样式和布局。 事件处理方法 closeEvent 方法： 在关闭窗口时，停止所有正在运行的进程。 析构方法 __del__ 方法： 在对象销毁时输出调试信息。 主函数 main 方法： 设置高 DPI 缩放策略。 创建应用程序实例，设置窗口图标，创建和显示主窗口。 进入应用程序事件循环。 结论 该代码实现了一个进程管理和监控的 GUI 应用程序。通过 SingleProcess 类，用户可以启动、停止和监控单个进程；通过 ProcessManager 类，用户可以批量管理多个进程。代码结构清晰，使用了 Qt 的多种控件和信号槽机制来实现用户交互和数据更新。https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E5%8F%82%E6%95%B0%E7%AE%A1%E7%90%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E5%8F%82%E6%95%B0%E7%AE%A1%E7%90%86%E5%99%A8/DefaultExp 类概述 DefaultExp 是一个实验类，包含所有设备的属性，并组织这些属性以便于管理和访问。 方法详解 build(self) 功能： 设置实验的初始参数，如计数器。 遍历设备数据库，加载设备并根据设备类型进行分组。 处理属性的加载错误，并将设备分为显示和隐藏两类。 run(self) 功能： 运行实验的主要逻辑（此处为空实现，作为模板）。 BasicManager 类概述 BasicManager 是一个基础管理类，用于创建和管理各种类型的参数小部件。 构造方法 参数说明： props：属性对象，用于与属性数据库交互。 parent：父级小部件。 kwargs：其他参数，用于初始化属性。 功能： 初始化基础属性，如单位、最大最小值、步长等。 设置样式并调用 _initGUI 方法。 方法详解 _initGUI(self) 功能： 初始化图形界面，创建布局和标签。 如果存在工具提示，则设置工具提示。 创建定时器，用于定期更新参数值。 updateSpin(self) 功能： 占位方法，用于在子类中实现具体的更新逻辑。 IntManager 类概述 IntManager 继承自 BasicManager，用于管理整数类型的参数。 方法详解 initSpin(self) 功能： 创建一个整数选择框 (QSpinBox)。 从属性对象中获取初始值并设置到选择框中。 连接选择框的值变化信号到 updateValue 方法。 updateValue(self, v) 参数： v：新值。 功能： 更新实验和属性对象中的参数值。 updateSpin(self) 功能： 检查属性对象中的值是否有变化，如果有变化，则更新选择框中的值。 BoolManager 类概述 BoolManager 继承自 QCheckBox，用于管理布尔类型的参数。 方法详解 updateValue(self, val) 参数： val：新值。 功能：https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E8%BF%90%E8%A1%8C%E7%9B%91%E8%A7%86%E5%99%A8/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E8%BF%90%E8%A1%8C%E7%9B%91%E8%A7%86%E5%99%A8/概述 这个代码定义了一个 StreamMonitor 类和一个 TableModel 类，用于监控和显示各种数据流（包括数据流、图像流、命令流和消息流）的内容。它还提供了一个主函数 main，用于初始化和运行一个包含多个标签页的 PyQt 应用程序，每个标签页显示不同类型的数据流。 StreamMonitor 类 StreamMonitor 类继承自 QWidget，用于监控和显示不同类型的数据流。 主要方法和属性 初始化方法 __init__： 接受参数：name（数据流名称）、streamtype（数据流类型，如 ‘Data’、‘Image’ 等）、parent（父组件）。 根据 streamtype 初始化不同类型的客户端对象（如 DataClient、ImageClient 等）。 初始化用户界面，包括标签、复选框、组合框、按钮、文本编辑器和表格视图等。 设置一个定时器，用于定期更新数据流的内容。 _update_message 方法： 定期从消息流中获取新消息，并将其添加到消息列表中。 如果启用了保存选项，则将新消息写入文件。 update_text 方法： 根据用户选择的过滤条件更新显示的消息内容。 使用 QTableView 显示过滤后的消息列表。 _update_selected_message 方法： 从文件中读取历史消息，并更新显示内容。 _update_list 方法： 定期从数据流中获取新数据，并将其添加到消息列表中。 load_selected_message 方法： 打开文件对话框，允许用户选择一个消息文件，并加载文件内容。 update_table_selected 方法： 根据用户选择的过滤条件更新显示的历史消息内容。 on_checkbox_changed 方法： 处理复选框状态变化事件。 TableModel 类 TableModel 类继承自 QAbstractTableModel，用于管理和显示表格数据。 主要方法和属性 初始化方法 __init__： 接受参数：data（表格数据），并初始化模型。 data 方法： 根据指定的索引和角色返回相应的数据内容和样式。 rowCount 方法： 返回表格的行数。 columnCount 方法：https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E6%8A%98%E5%8F%A0%E7%AE%A1%E7%90%86/Mon, 01 Jan 0001 00:00:00 +0000https://www.quatm.com/%E5%BC%80%E5%8F%91%E6%96%87%E6%A1%A3/%E5%AE%9E%E9%AA%8C%E6%A1%86%E6%9E%B6/%E5%AE%9E%E9%AA%8C%E4%BB%BB%E5%8A%A1%E6%8A%98%E5%8F%A0%E7%AE%A1%E7%90%86/概述 这段代码定义了一个可折叠的对话框组件，允许用户在应用程序中添加和管理可折叠的部分。主要组件包括 SectionExpandButton 类和 CollapsibleDialog 类，它们协同工作以实现可折叠部分的创建和管理。 主要组件 SectionExpandButton 类 SectionExpandButton 类继承自 QPushButton，用于创建一个可以展开或折叠其关联部分的按钮。 主要方法和属性 初始化方法 __init__： 接受参数：item（关联的部分项）、text（按钮文本）、parent（父组件）。 设置按钮的初始文本，并连接点击事件到 on_clicked 方法。 on_clicked 方法： 处理按钮的点击事件，切换关联部分的展开或折叠状态。 如果部分是展开的，则将其折叠；如果是折叠的，则将其展开。 CollapsibleDialog 类 CollapsibleDialog 类继承自 QDialog，用于创建一个包含可折叠部分的对话框。 主要方法和属性 初始化方法 __init__： 创建并配置一个 QTreeWidget 以隐藏标题，并将其添加到对话框的布局中。 设置树的缩进为 0。 add_section 方法： 接受参数：title（部分的标题）、widget（部分的内容部件）。 调用 add_button 方法创建一个按钮，并调用 add_widget 方法将内容部件添加为按钮的子项。 define_sections 方法： 定义并添加对话框中的所有部分。 示例实现中，创建了一个包含两个标签的 QFrame 部件，并将其添加到部分中。 add_button 方法： 接受参数：title（部分的标题）。 创建一个 QTreeWidgetItem 项，并将其添加为树的顶级项。 创建一个 SectionExpandButton 按钮，将其设置为项的部件，并返回该项。 add_widget 方法： 接受参数：button（按钮项）、widget（部分的内容部件）。 创建一个 QTreeWidgetItem 项，将其设置为按钮项的子项，并将内容部件设置为子项的部件。 使用场景 这个组件可以用于需要包含多个可折叠部分的对话框的应用程序，例如设置对话框、信息面板等。通过扩展 CollapsibleDialog 类并重写 define_sections 方法，可以轻松定义和管理对话框中的各个部分。