脚本 Convert 或验证不通过

CONVERT 有三个页签:Stunt-to-Python、Python-to-Stunt、Validate Stunt。先确定在哪个页签、弹的哪句话。

脚本有语法错误

Python-to-Stunt 页点 Validate Script 弹出 Validation Failed,列出出错位置

  1. 按列出的行改掉语法错误
  2. 或把报错原文贴给 Stuntman AI,让它修脚本,例如「this script fails with … can you fix it?」
  3. 改完先 Validate Script,通过后再 Run Script

出处:官方手册 Stuntman AI & CONVERT User Guide p.12;官方手册 Stuntman AI & CONVERT User Guide p.23;官方手册 Stuntman AI & CONVERT User Guide p.32

脚本能解析,但试运行出错

弹出 Validation Error 或 Error running script: …。常见原因(名称缺失或重复、map 数据不匹配、输出文件被占用)会翻译成一句话说明

  1. 按弹窗里的说明改脚本,或把原文交给 Stuntman AI 修
  2. 提示输出文件被占用时,先关掉正打开这个 .stunt 文件的程序
  3. 仍是看不懂的 HDF5 原始报错,说明是别的原因,把报错原文和脚本发给 support@unchainedlabs.com

出处:官方手册 Stuntman AI & CONVERT User Guide p.27;官方手册 Stuntman AI & CONVERT User Guide p.33

Run Script 前有输入项没填

提示 Please select a valid Python script file.、Please select a valid destination folder. 或 Please enter a file name.

  1. 选一个存在的 .py 文件
  2. 选一个已存在的目标文件夹
  3. 填 .stunt 文件名后再点 Run Script

出处:官方手册 Stuntman AI & CONVERT User Guide p.23;官方手册 Stuntman AI & CONVERT User Guide p.32

.stunt 文件读不出,或生成的脚本有警告

Error loading designs from file: … 表示文件损坏、被占用或不是有效 .stunt;Validation Warning 表示 .py 已写出但语法检查发现问题

  1. 读不出时,先关掉正打开这个文件的程序再试
  2. 有 Validation Warning 时,按列出的问题检查生成的 .py
  3. 提示 Error generating script 时,确认目标路径可写

出处:官方手册 Stuntman AI & CONVERT User Guide p.22;官方手册 Stuntman AI & CONVERT User Guide p.32

对照了别台仪器的系统配置

Validate Stunt 按选定的 SystemConfiguration.xml 检查,选错了也会判不通过

  1. Select SystemConfiguration.xml 一栏改选这台设计对应的配置
  2. 或清空这一栏,让 CONVERT 按设计里保存的 System Name 自动查找 C:\Stuntman\Run\Configuration 和 C:\Stuntman\Plan\Configurations 下的配置
  3. 再点 Validate Design

出处:官方手册 Stuntman AI & CONVERT User Guide p.24;官方手册 Stuntman AI & CONVERT User Guide p.27

化学品或样品库定义不合规

粉色结果框 === Chemicals and Libraries === 下有报错,例如 Library … has invalid row count (0). Rows must be between 1 and 16.

  1. 化学品名、条码、库名、库条码各自不能重复(不分大小写)
  2. 库的行列数要和系统配置里同名标准库一致,并放得进台面上的载具
  3. 浓度、分子量、密度填了就必须大于 0
  4. 在 PLAN 第 2 步改,或让 Stuntman AI 改脚本后重新 Convert

出处:官方手册 Stuntman AI & CONVERT User Guide p.25;官方手册 Stuntman PLAN User Guide p.25;Save 和 Next 检查的内容不同

台面位置没指定完整或有冲突

=== Chemical and Library Source Mappings === 下有报错,例如 Library Substrate Type must be selected. This field is mandatory for all libraries.

  1. 每块库都要有 Substrate Type、Substrate Position 和 Initial State
  2. 每个台面化学品还要有 Row/Column;填了 Amount 必须填 Unit
  3. 粉末化学品必须放在 Hopper 类载具
  4. Initial State 选 Capped 或 Uncapped 时必须指定盖架位置,且不能和自身位置相同
  5. 同一台面位置只能放一块库或一种化学品
  6. 在 PLAN 第 4 步 Configure Deck 里改

出处:官方手册 Stuntman AI & CONVERT User Guide p.25;官方手册 Stuntman PLAN User Guide p.39;官方手册 Stuntman PLAN User Guide p.40;位置不能重复

流程步骤参数缺失或和硬件对不上

=== Recipe === 下按步骤号报错,例如 Step 19: Parameter 'Pause': Value is required for all selected wells.

  1. 按步骤号找到对应步骤,给选中的孔都填上参数值
  2. 步骤显示 unresolved(多在换系统之后),删掉重建
  3. 分液步骤的工具、吸头、类别或 Tag 与系统配置对不上,逐个改
  4. 同一化学品在几步里的单位类别或 Backsolvent/Inventory Tag 要一致

出处:官方手册 Stuntman AI & CONVERT User Guide p.25;官方手册 Stuntman PLAN User Guide p.49;官方手册 Stuntman PLAN User Guide p.50;常见提示和处理办法