用 RUN 运行实验、用 SHOW 看结果

用 RUN 运行实验,用 SHOW 看结果 从载入设计到导出 Excel

设计在 PLAN 或 AI 里建好、检查通过后,交给 RUN 在台面上执行。结果写回同一个 .stunt 文件,再用 SHOW 打开查看和导出。RUN 不能建设计,也不能改设计。

六个程序各管什么,见 Stuntman 软件概览;设计怎么建,见 PLAN 操作指南。内容依据原厂 RUN 和 SHOW 用户指南(Rev A)。

开始前先初始化系统,再对一遍台面

每次开始工作时,在左上角 ☰ 菜单里点一次 Initialize System。它在后台运行初始化脚本,把所有硬件带到已知的就绪状态。重启之后、硬件出现异常之后,也要再跑一次。

上机前逐项确认:

  • 吸头和废料:装好设计要用的 PDT、ADT 吸头架,需要时倒空废吸头桶和废液桶。
  • 原料:粉末、储液槽、板和样品瓶架放好。加了盖或封膜的,确认设计里有开盖、刺穿或去膜步骤。
  • 目标耗材:目标板、瓶架、过滤组件放在设计规定的位置。
  • 溶剂:背液、清洗液等够整个运行用。
  • 预热:天平称量单元和目检灯要先达到工作状态。目检灯用前预热 20 分钟。
  • 实物:台面上没有散落物品,耗材、工具、盖子和压板与设计一致。

RUN 会校验设计、发现配置上的不一致,但看不到台面上的每个实物。开始前要拿 Deck Layout 的图和台面实物对一遍。

Run Experiment 分五步:载入、选项、选孔、提问、台面

在 Main 页点 Run experiment 打开向导。五步依次是 Load Design、Run Options、Design Options、System Options、Deck Layout。不适用的步骤会自动跳过。向导打开期间,Run Queue 不能用。

1. Load Design:选文件和设计

  • 从最近文件里选,或浏览找文件。最近文件最多列 50 个。
  • 选中设计后,Design Details 显示描述、System Name、创建人、创建时间和全部 map。点 Next 前看一眼,确认没选错。
  • 每个设计都记着它所针对的 System Name。RUN 只列出和本机名称一致的设计。预期的设计没出现,先查名称是否一致。
  • 点 Next 时,RUN 会按当前系统配置重新校验一次。系统配置改过,原来通过的设计也可能报 Invalid Design。
  • RUN 以写模式打开文件。同一个文件在 PLAN 或 SHOW 里开着时,RUN 可能打不开,先在那边关掉。

2. Run Options:四个开关

Run Options:Experiment type 选 Experiment;默认只勾选从设计载入台面配置。图取自原厂 RUN 用户指南。

  • Experiment type:跑设计选 Experiment。做校准时选对应的 Calibration 项,先看生成的脚本和台面要求。
  • Bypass all prompts?:设计带提问时才出现。勾选后直接用上次保存的答案。试剂、位置或数量可能变了,就不要勾。
  • Load Deck Configuration from design?:默认勾选,按设计里保存的位置摆化学品和样品库。只有本机 Configure Deck 已按别的方式摆好、不想被覆盖时才取消。
  • Force hardware initialization?:默认不勾。没初始化的硬件运行时总会被初始化。手动动过台面、怀疑位置不对或排查问题时,才勾选强制全部重新初始化。
  • Select specific maps or wells?:默认不勾,跑全部 map 和全部孔。只想重跑失败的 map 或可疑的孔时勾选,进入第 3 步。

3. Design Options:只跑一部分孔或 map

左边每个样品库一张板图,设计没用到的孔是灰的。点单孔切换,拖动框选一块,点行号或列号切换整行整列。右边是所有 map 的勾选表,至少留一个。

  • 选的是目标孔。某个孔同时是别的库的来源时,取消它不能阻止取液;要阻止,得取消用它做来源的那个目标孔。
  • 孔的列表和 map 的选择不联动。取消了部分 map 后,再核对一遍孔的选择。

Design Options:左边按瓶架选目标孔,右边勾选要执行的 map(加水、加盖、开盖)。图取自原厂 RUN 用户指南。

4. System Options:回答设计脚本的提问

设计脚本可以在运行前提问,形式有是 / 否、数字、文字、下拉选项和板孔位置选择。没有提问的设计会跳过这一步。

5. Deck Layout:核对三个页签

这一步确认样品库(Libraries)、化学品(Chemicals)和吸头架(Tip Racks)的位置。三个页签都要看,点 Next 时保存。

点 Save Prompts to File,提问答案和 Run Options 的选择会存成文件。下次勾 Bypass all prompts 时调用这些答案。设计的提问改过(数量或顺序不同),存下的答案就不能用,需要重新回答。

Deck Layout:台面图上高亮样品库和盖架的位置,下方表格列出每个库的规格、位置和初始状态。图取自原厂 RUN 用户指南。

点 Next 后弹出最后一次确认,点 OK 开始运行。仪器没开机或断开时,会提示 CAN 总线初始化失败。初始化时出现 Python 报错,会单独弹窗显示完整的 traceback,联系技术支持时整段复制。

新设计先手动跑一次,才能放进队列

Run Queue 把多个设计和 Python 脚本排成一串,无人值守地依次运行,适合过夜或连续几小时的实验。队列运行中没人回答提问,所以设计必须先在 Run Experiment 里手动跑过一次,并在 Deck Layout 页存好提问答案。否则加入时提示没有保存的提问答案。

  • Add design:加入 .stunt 设计,加入时按系统配置校验,不通过就拒绝。
  • Add script:加入 .py 脚本,加入时不校验。可以在两个实验之间插一个清洗脚本。
  • 调整顺序:用上下箭头移动,点 × 删除,Clear 清空整个队列。
  • Import / Export:队列存成 .rql 文件。常跑的固定序列导出一次,以后直接导入。队列长时,开跑前先导出,中途停下后好重建。

Run Queue:一个加盖设计前后各排一个脚本,每项都能上移、下移或删除。图取自原厂 RUN 用户指南。

  • 点 Run 时先校验队列里所有设计,有一项不通过,整个队列都不启动。按提示逐条修改后再点 Run。
  • 想让队列平稳收尾,用 Discontinue Queue:当前这一项跑完后停止。紧急停止要在 Experiment Status 里 Abort。
  • 队列里任何一项失败,整个队列停止,不会跳到下一项。没开始的项标为 Cancelled。

在 Experiment Status 里看进度、暂停或中止

运行开始后,Main 页的 Experiment status 按钮才能点。它有两个页签:Run Status 显示进度和控制按钮,Data 显示每个孔的实时数据。

Run Status 顶部的 Script Info 有四行。Design 是正在跑的文件和设计,Script Name 是脚本名。Script Status 是当前硬件动作,Current Step 显示执行到第几个 map。下方板图标出已完成的孔。

Run Status:正在执行 5 个 map 中的第 2 个(加盖)。绿色孔已完成,蓝框是当前孔。图取自原厂 RUN 用户指南。

Data 页签和 SHOW 用的是同一种数据表,只是数据随运行实时填入。能看到哪些字段,取决于设计测了什么,例如实际分液量、实际参数、pH、颜色、浊度、颗粒计数、图像和曲线。双击单元格可以弹出这个孔的原尺寸图像或曲线。

Data 页签:每行一个孔,两组 Actual Parameter 分别记录加盖和开盖的时间。图取自原厂 RUN 用户指南。

  • Pause / Resume:不弹确认。短暂停下检查台面时用。
  • Skip:只在延时步骤可用,确认静置、孵育或平衡已经够了时跳过剩余等待。
  • Abort:先暂停再弹确认,选 Resume 可以退回。确认中止后会问是否复位硬件:选 Yes 机械臂回到安全位置;选 No 硬件停在原处,方便检查当前步骤。
  • Script log / App log:打开日志文件夹。前者记录设计脚本做了什么,后者记录 RUN 程序本身。联系技术支持时从这里取日志。

设计脚本也可以在运行中暂停并提问,例如显示一条消息、让你选一项,或在无法自行恢复时让你选 Resume 或 Abort。选 Abort 的效果和手动中止相同。

吸头用完时,运行自动暂停。点提示框的 OK 打开 Tip Management,补好或重新指定吸头架后继续。

运行结束后,Script Status 变为 Complete,机械臂回到原位。确认机械臂停止后再伸手进台面。等 RUN 把数据写完,再关闭程序、移动 .stunt 文件或用其他程序打开它。

运行中途死机或断电,数据可能没来得及并入 .stunt 文件。下次打开 RUN 时,☰ 菜单里会出现 Recover Orphaned Data,点 OK 把数据合并回原文件。SHOW 只会提示有这类数据,恢复必须在 RUN 里做。

单个动作用 Run Action,Python 文件用 Run Script

这两个工具在 Utilities 页,用于维护、测试和一次性操作,不需要建完整的实验。

  • Run Action:执行单个硬件动作,例如移动一次机械臂,或做一次处理、检测操作。动作按 Arm、Balance、Gripper、Syringe、Tip 等硬件分类列出,只显示本机有的硬件。双击动作打开对话框,填好输入后点 Execute;输出显示 Execution Completed 才算结束。Loop 可以按设定间隔重复执行。
  • Run Script:对实际仪器运行一个 .py 文件,可以暂停、继续或中止。脚本里有 input() 时,窗口变成交互控制台,输入答案后按回车。

实验或队列运行时,这两个工具和 Substrate Management 的机械臂点动都还能用。RUN 不检查它们会不会和正在跑的实验冲突。不要对运行中实验正在用的机械臂发命令。运行中机械臂意外移动或卡住,先查是否有人开着这些窗口。

Utilities 页的 Data Monitor 实时画出仪器读数曲线,例如温度、压力、搅拌和 pH。从 Data Tree 里选数据项加入图表,设好采样间隔、单位和坐标轴。常看的一组数据项可以存成 .dms 配置文件;需要原始数字时,用 Stream to File 写成以制表符、逗号或竖线分隔的文本文件。

台面、吸头和位置在运行前设好

向导第 5 步会核对台面,也可以在 Main 页提前设好。

  • Configure Deck:给化学品和样品库指定台面位置,分 Chemicals 和 Libraries 两个页签。用 Load from design 从 .stunt 文件导入,比手动输入少出错;导入是追加,名称、行数、列数都相同的库会跳过。大改之前先 Export Current State 留一份。
  • Tip Management:设定每个吸头架装哪种吸头,一个架只能装一种规格。Tips Remaining 记录剩余吸头数,运行之间保留。换了新的满架,点 Reset as Full;架子用过一部分,用 Select 勾出还有吸头的位置。
  • Substrate Management:列出仪器知道的每个台面位置和容器,查看训练好的坐标、Z 高度等属性。新系统交付时机械臂和位置已训练好,大批位置用 Stuntman TRAIN 训练;这里用于查看和微调单个位置。属性 Stuntman TRAIN 为 True 的位置由 TRAIN 管理,以后 TRAIN 刷新时可能被重新计算。

吸头规格、分液类别和液体参数的设置,见 Stuntman 分液设置指南。

☰ 菜单的 Import / Export 把系统配置、训练好的台面位置、脚本、模块界面和校准打包成一个 .ulsa 文件。训练位置、调好校准或改完脚本后导出一份,出问题时能恢复到已知可用的状态。导入前,RUN 会自动把当前整套系统备份到 C:\Stuntman\Backup;导入后建议重启 RUN。

原厂建议每周按规定的关机、开机流程重启一次 Stuntman,重启前确认没有实验、队列、动作、脚本或手动移动在运行。

SHOW 只读:选文件、选库、选运行,再点 Load

SHOW 不改设计,也不改结果,随便点都不会动到文件。窗口分上下两部分:上面选数据,下面是数据表。

  • 打开文件:点文件夹图标选 .stunt 文件。RUN 还在写这个文件时,SHOW 会等到能读取为止,等它完成比反复取消重试快。一次只能开一个文件,打开新文件会清空之前的内容。
  • 选样品库:Libraries 列出文件里所有设计用过的库,可以按名称搜索。右边 Library Info 显示板型、描述、条码。
  • 选运行:Designs - Runs 只列出在这个库里写过数据的运行,每项显示为「设计名 — 运行时间」。同一设计跑几次就有几项。按住 Ctrl 或 Shift 可以多选。
  • 点 Load:只选不点 Load,数据表不会变。换了库或运行后,数据表仍显示上次 Load 的结果,这是最容易看错的地方。

选中 Reactions 库后,Designs - Runs 里列出两次运行;选好后点 Load。图取自原厂 SHOW 用户指南。

要对比多次运行,在 Designs - Runs 里一次选好再点 Load。同一设计的重复运行可以对比,用了同名库的不同设计也可以对比。不同库的数据不能放在一张表里,要分别选库、分别载入。

Export Logs 把选中运行的原始执行日志导出为 .7z 压缩包。同一运行再次导出会覆盖旧文件,要保留先改名。

数据表每行一个孔,每次运行一组列

点 Load 后,下方数据表每行是库里的一个孔,分液量、工艺参数和检测读数按实验步骤排成列。左侧 Well ID 列固定不动。载入了几次运行,就有几组列,每组标着「设计名 - 运行时间」,同一孔的结果在一行里横向对比。有图像或曲线的结果在单元格里显示缩略图。

数据表:两组 Actual Dispense 分别是溶剂和化学品,每组列出时间、来源、目标体积和实际体积。图取自原厂 SHOW 用户指南。

  • 按孔筛选:左侧小板图每个孔都能勾选。点孔切换,点行号或列号切换整行整列,拖动框选。点击后立即生效。
  • 选字段:板图下面的 Field Chooser 按「实验 → 步骤 → 字段」分层勾选。勾完要点下方的刷新图标才生效;Check All、Uncheck All 和表格下方的 Reset to Default 也一样。
  • 保存视图:Save Format 把当前勾选存成 .json 文件,默认放在 C:\Stuntman\Show\Formats。以后用 Load Format 调回,换文件、换运行都能用。只存勾选,不存列宽和列顺序。

单元格里显示不全的文字,鼠标悬停可以看到全文。

点有图像或曲线的单元格,上方显示细节

载入的数据里有图像或曲线时,窗口上半部分分成左右两块:左边是选择区,右边是 Record Data。点数据表里的单元格,Record Data 显示这个孔这一项结果的完整内容。纯数字或文字的单元格在表里已经完整,点了不会多显示什么。

Record Data 显示 A1 孔的一张图像。上下箭头换孔,左右箭头换同一孔的其他结果,右侧三个小按钮用于导出 Excel、Snap 和复制。图取自原厂 SHOW 用户指南。

  • 换孔、换结果:面板顶部和底部的大箭头换到别的孔,保持同类结果;图两侧的小箭头在同一孔的其他图像和曲线之间切换。数据表里用方向键移动,效果一样。
  • 曲线:在任一坐标轴上拖动可以放大这一段,双击恢复全图。
  • 图像:工具栏有原尺寸、适应高度或宽度、框选放大、放大镜、平移窗口、十字线和测量,测量单位可选像素或微米。滚轮缩放。

临时取图用 Snap,留存记录用 Export Results

Record Data 旁的三个按钮只作用于当前这一项结果:

  • Copy to clipboard:复制当前图像或曲线,直接粘贴到文档。复制失败时不报错,粘贴不出来就改用 Snap。
  • Snap:把当前画面存成 Snap [n].png,不弹窗,直接存到 Data 目录。
  • Export to Excel:只对曲线(XY)结果可用,存成 Sheet [n].xlsx 并自动打开。

Snap 和 Sheet 每次都取下一个没用过的编号,不会覆盖旧文件。删掉旧文件,编号也不会回收。

数据表下方的 Export 按钮导出当前所有可见的数据,即孔筛选和 Field Chooser 之后剩下的内容。拿不准以后要不要某个字段,先放宽筛选再一次导出。

Export Results:这次运行没有曲线,XY Data 不可选。图取自原厂 SHOW 用户指南。

  • Numerical and text data:写成 Data.xlsx。第一页是实验信息,包括文件名、库、设计、系统和运行时间;第二页以库命名,就是屏幕上的数据表,保留分组表头。图像和曲线在这里只写成文字占位。
  • XY Data:写成 XY_data.xlsx,每个孔的曲线占一组列,表头带坐标轴名称和单位。数据超过 Excel 行数上限会被截断。
  • Images:每张图存成一个 .png,放在 images 子文件夹。文件名含设计名、时间、孔号和字段,能和 Data.xlsx 里的占位文字对上。

导出的文件名是固定的。每个实验单独建一个文件夹再导出;目标文件夹里已有文件时,同名文件会被覆盖,SHOW 会先提醒。

SHOW 的 ☰ 菜单里,Default save locations 设两个默认目录。Data 目录放 Snap 和单项 Excel,默认 C:\Stuntman\Show\Data。Export 目录是 Export Results 预填的目录,默认 C:\Stuntman\Show\Export。RUN 里各个 Export 按钮默认存到 C:\Stuntman\Run\Import-Export,可在 RUN 的 Preferences 里改。

  • show-open · SHOW 选数据