Cympha

将 CBCT 分割为 STL 模型

CBCT 分割在您自己的电脑上把影像拆分为牙齿、颌骨和神经管模型,并在Cympha Studio 的 CBCT 查看器中叠加在影像上显示.

适用对象: 在 Cympha 病例上或在自己的 Windows 电脑上有 CBCT 影像、希望把它拆分为独立 3D 模型的临床医生、技工所经理和设计师:每颗牙一个模型,上下颌骨,以及下牙槽神经管.

阅读后您将得到: 模型显示在 Cympha Studio 中、叠加在影像上,可逐层对照切片检查;需要时,还可以得到打包为一个 zip 或保存到病例的 STL 文件.

操作位置: 共三处. 分割在您 Windows 电脑上的 Cympha Agent Manager 中运行:影像留在这台电脑上,从不上传. 您可以从 Cympha Studio(studio.cympha.com)、从 app.cympha.com 上的病例页面,或从 Agent Manager 的托盘菜单启动. 每次运行最后都在同一台电脑上 Cympha Studio 的 CBCT 分割 (CBCT Segmentation) 工作区结束:Studio 在那里重建模型,从您的余额中扣费并显示模型.

这些模型由 AI 生成. 牙齿、骨骼和神经管是 AI 根据影像做出的推断,是需要审阅的草稿,绝不是临床结论或建议. 在病例页面上,每个浏览器会话第一次运行前,Cympha 会显示提示 实验性 AI — 非临床工具 (Experimental AI — not a clinical tool). 使用前请对照影像切片逐一检查每个模型,尤其是神经管,以及与缺失牙或形态异常牙相邻的牙齿.


开始之前

  • 一个 Cympha 账户,以及足够一次运行的余额. 任何账户都可以,包括免费账户;无需订阅. Cympha Studio 把余额称为 Studio 余额 (Studio balance);app.cympha.com 称为 Cympha 余额 (Cympha balance). 两者是同一个余额. 开始运行时不收取任何费用:Studio 在重建模型之后、显示模型之前扣费,运行失败不收费. 一次运行的价格在开始前显示在 CBCT 分割 工作区中,也列在 Studio 价格页(studio.cympha.com/pricing)上. 充值方法:
    • 在 Cympha Studio 中:打开菜单(左上角的三条横线);Studio 余额 位于顶部的账户区域;
    • 在 app.cympha.com 上:点击左侧边栏中的 Cympha 余额(临床医生账户),或点击左侧边栏底部您的姓名,然后点击 Cympha 余额.
  • 一台 Windows 电脑. 分割可以在任何支持 DirectX 12 的显卡上运行,没有显卡时则在处理器上运行. 配有 8 GB 显存的 NVIDIA RTX 显卡时速度更快;在其他电脑上,一次运行最长可能需要 20 分钟.
  • 该电脑上已安装 Cympha Agent Manager 1.2.1 或更高版本,并配对到您在 Studio 和 app.cympha.com 上使用的同一个 Cympha 账户. 参见 设备配对:安装并配对 Cympha Agent Manager. 版本号显示在 Agent Manager 状态窗口的顶部(右键点击 Windows 任务栏中的 Cympha 图标,然后选择 Show window).
  • 查看结果时,在同一台电脑上打开 Cympha Studio. Studio 从它所在电脑上的 Agent Manager 获取结果,因此要在运行分割的那台电脑上打开模型.
  • 仅从病例页面运行时需要:已设置 Cloud Monitoring,这样病例的文件才会在这台电脑上. 右键点击任务栏中的 Cympha 图标,选择 Cloud Monitoring > Configure workspace…,点击 Choose folder… 并选择病例要存放的文件夹. 选好文件夹后监控即开始,每个病例会下载到该文件夹下各自的子文件夹中. 从 Studio 和从托盘菜单启动的运行不需要 Cloud Monitoring.

影像必须是 DICOM 序列:散装切片文件(.dcm,或 00000DCM 这类光盘式文件名)、含有 DICOMDIR 文件的文件夹,或一个 DICOM 文件夹的 .zip. 在病例上,请把 CBCT 作为一个 DICOM 文件夹的 .zip 附上. 上传大型压缩包的方法见 通过 Agent 上传——从病例详情上传并可选网格修复.

选择从哪里启动. 三种方式运行的是同一个分割,结束在同一个地方:

  • 方式 A — 从 Cympha Studio 启动: 适用于您电脑上的影像. Agent Manager 会请您选择文件夹.
  • 方式 B — 从病例页面启动: 适用于附在 Cympha 病例上的 CBCT. Agent Manager 从已同步的病例文件夹中读取影像;您可以把模型保存回病例.
  • 方式 C — 从 Agent Manager 托盘菜单启动: 适用于您电脑上的影像,无需先打开浏览器.

方式 A — 从 Cympha Studio 启动

  1. 在 studio.cympha.com/app 打开 Cympha Studio,或通过 studio.cympha.com/app/?workspace=cbct-segmentation 直接进入该工作区. 用您的 Cympha 账户登录:如果您未登录,面板会显示 "请登录 Cympha 账户后再分割 CBCT." 和 登录 (Sign in).
  2. 点击左上角菜单按钮旁边的工作区切换器,选择 CBCT 分割(标有 高级 (Premium)). CBCT 分割 面板在 3D 视图右侧打开(窄屏时在底部). 面板右上角的 退出 (Exit) 返回 3D 处理 (3D Processing).
  3. 面板会检查您的 Agent Manager 和您上一次的运行("正在检查您的 Agent 和上一次分割…"). 当配对到您账户的 Agent Manager 正在运行时,面板显示 在这台电脑上分割 CBCT (Segment a CBCT on this computer),附 "Agent 在线:" 和电脑名称,以及价格说明. 如果显示的是 这台电脑上没有运行 Cympha Agent Manager (Cympha Agent Manager is not running on this computer),请参见 "如果出现问题".
  4. 点击 在这台电脑上分割 CBCT. 面板变为 等待 Agent (Waiting for the Agent):"请在 电脑名称 上的 Agent 对话框中选择 CBCT DICOM 文件夹."
  5. 在电脑上,Agent Manager 打开 Select CBCT DICOM folder 对话框. 在没有 8 GB NVIDIA RTX 显卡的电脑上,对话框标题会附加 "(on this computer segmentation can take up to 20 minutes)"(在这台电脑上分割最长可能需要 20 分钟). 选择存放 CBCT 切片的文件夹(或存放 DICOM 压缩包的文件夹)并确认.
  6. 面板标题变为 正在 电脑名称 上分割… (Segmenting on computer name…),并显示 "已运行 … 分钟". 您可以继续工作,也可以关闭 Studio. 运行在 Agent Manager 中继续,您回来时 Studio 会读取结果(见 "完成后").

如果您的账户配对了多台电脑且都在运行,最先签到的那台会接手任务并打开对话框. 运行分割时,请只让存放影像的那台电脑运行 Agent Manager.

方式 B — 从病例页面启动

第 1 步 — 打开病例并确认 CBCT 已在其中

  1. 在 app.cympha.com 上,点击左侧边栏中的 工作台 (Dashboard).
  2. 在病例表中点击该病例所在行. 病例页面打开.
  3. 滚动到 文件 (Files) 区域,确认 CBCT 的 .zip 已列出. 如果没有,请先上传.

文件 标题行的右端有一组按钮:X 光分析 (X-Ray Analysis),然后是 分割 CBCT (Segment CBCT)(紫色立方体图标),然后是 Studio 工作区 (Studio Workspace). 在技工所账户上,最前面还有 检查模型 (Check models).

第 2 步 — 开始分割

  1. 点击 分割 CBCT.
  2. 每个浏览器会话第一次使用时,会打开提示 实验性 AI — 非临床工具. 阅读后点击 我已了解 — 继续 (I understand — continue).
  3. 消息 "已发送到您的电脑 — 分割将在约 20 秒内开始." 确认请求已发出. 此时不收取任何费用.

第 3 步 — 在病例页面上跟踪运行

分割 CBCT 按钮现在显示任务进展:

  • 已排队 — 正在等待您的电脑… (Queued — waiting for your computer…):Cympha 正在等待您的 Agent Manager 接手任务. 如果病例还没有到达这台电脑,Agent Manager 会等待下一次病例同步,届时再接手.
  • 正在 电脑名称 上运行… (Running on computer name…):电脑已接手任务.
  • 在 Studio 中打开 (Open in Studio) 和 再次运行 (Run again):运行已完成. 请继续阅读 "完成后".
  • 分割 CBCT 并附 "分割失败:" 和原因,或 "分割超时":运行未完成. 请参见 "如果出现问题".

在电脑上,如果病例文件夹中有 DICOM 子文件夹,Agent Manager 就从中读取影像,否则从病例文件夹本身读取;如果没有散装切片,就解压 .zip.

方式 C — 从 Agent Manager 托盘菜单启动

  1. 右键点击 Windows 任务栏中的 Cympha 图标,选择 CBCT Segmentation….
  2. 在 Select CBCT DICOM folder 中,选择存放 CBCT 切片的文件夹(或存放 DICOM 压缩包的文件夹)并确认. 如果不做选择就关闭对话框,则不会启动任何运行.
  3. 运行开始. 把鼠标悬停在托盘图标上可查看阶段和进度,例如 "CBCT Segmentation: Packing DICOM"(CBCT 分割:正在打包 DICOM).
  4. 结束时,托盘提示显示 "CBCT segmentation finished. Open Cympha Studio to view it."(CBCT 分割已完成. 请打开 Cympha Studio 查看.) 在这台电脑上打开 Cympha Studio,然后继续阅读 "完成后".

在您电脑上运行期间

  • 在一台电脑上第一次运行时,会直接下载分割引擎,约 311 MB,不会询问. 托盘图标的提示文字先显示 Downloading CBCT engine 和百分比,然后显示 Installing CBCT engine. 之后的运行会立即开始. 发布新版本引擎时,下一次运行会下载一次.

  • 开始提示:在没有 8 GB NVIDIA RTX 显卡的电脑上,托盘会显示 "CBCT segmentation started. On this computer it can take up to 20 minutes; you can keep working."(CBCT 分割已开始. 在这台电脑上最长可能需要 20 分钟;您可以继续工作.) 在有这种显卡的电脑上,从病例页面启动的运行会显示 "Picked up a segmentation job from Cympha. Open Cympha Studio to view it when the worker finishes (≈8 min)."(已从 Cympha 接手一个分割任务. 处理完成后(约 8 分钟)请打开 Cympha Studio 查看.)

  • 进度显示在托盘图标的提示文字中;托盘菜单中的 Show window 显示完整日志.

  • 结果存放位置: 在 cympha_segmentation 文件夹内,一个以任务命名的文件夹中:

    • 病例:在病例文件夹中(<case folder>\cympha_segmentation\<job>\);
    • 您选择的文件夹:在该文件夹旁边(<parent folder>\cympha_segmentation\<job>\).

    其中有 dicom.zip(为 Studio 打包的影像)、stage2.nii.gz(分割结果)和 labels.json(本次运行的详情). 这里没有 STL 文件:Studio 根据这些文件构建模型. 请不要移动该文件夹. 运行后 7 天内,Agent Manager 会把它提供给同一台电脑上的 Cympha Studio. Cloud Monitoring 不会把这些文件上传到病例.

  • 停止运行: 右键点击托盘图标,选择 Cancel CBCT Segmentation(仅在有运行进行时可用,否则为灰色). 点击 Yes 确认. 已产生的部分输出会被丢弃,不收取任何费用.

Agent Manager 1.2.1 启动后不久,会自动删除早期版本留在电脑上的分割软件文件夹(约 5 GB).

完成后:在 Studio 中打开、付款并查看

得知已完成

每次运行,无论以哪种方式启动,都会在以下几处通知:

  • 电脑上 Agent Manager 的托盘提示:"CBCT segmentation finished. Open Cympha Studio to view it."(CBCT 分割已完成. 请打开 Cympha Studio 查看.)
  • app.cympha.com 页头栏中的通知铃铛:"CBCT segmentation finished. Open Cympha Studio to view it."(CBCT 分割已完成. 请打开 Cympha Studio 查看.) 点击它即可在 Cympha Studio 中打开这次运行.
  • 发给启动运行的账户的一封邮件,附 Open Cympha Studio(打开 Cympha Studio)按钮.
  • 在 Cympha Studio 的任何其他工作区中: 右下角会出现提示 CBCT 分割已完成 (CBCT segmentation finished),"结果已在 电脑名称 上就绪." 点击 打开 (Open) 切换到 CBCT 分割,或点击 稍后 (Later) 关闭提示.
  • 在病例页面上(方式 B):按钮显示 在 Studio 中打开. 在技工所账户上,病例的 操作记录 (Activity Log) 也会显示 CBCT segmentation finished.(CBCT 分割已完成.),并附在 Cympha Studio 中打开的链接.

中途停止的运行也以同样方式通知,显示为 "CBCT segmentation failed"(CBCT 分割失败)或 "No computer picked up the segmentation"(没有电脑接手该分割),在 Studio 中显示为 CBCT 分割未完成 (CBCT segmentation did not finish).

打开结果

在运行分割的那台电脑上打开,并保持其 Agent Manager 运行:

  • 从 Studio 的提示:打开;
  • 从病例页面:在 Studio 中打开(Studio 在新标签页中打开);
  • 从通知铃铛或邮件:点击即可;
  • 或者打开 Studio,自己切换到 CBCT 分割. 如果 Studio 已经打开在这个工作区,面板会自动继续.

随后面板会自动经过以下阶段:

  1. 正在从 Agent 获取结果 (Fetching the result from the Agent):显示每个文件的进度,然后是 "正在加载 CBCT…". Studio 先清空场景,因此之前载入的模型会被移除,然后像用 打开 DICOM… (Open DICOM…) 打开一样载入 CBCT.
  2. 正在重建模型 (Rebuilding the models):一次一个结构,例如 "下牙 3 (12 / 30)",并显示当前步骤. 在此期间导出暂停("CBCT 分割正在重建和付款, 导出暂停.").
  3. 模型已就绪 (Models ready):"已重建 … 个模型. 从 Studio 余额支付 … 后显示." Studio 立即从您的余额中扣费;扣费期间按钮显示 正在付款… (Paying…). 付款完成后,模型即会显示.

如果余额不足以支付这次运行,Studio 余额 窗口会打开,面板显示 "请充值余额, 然后回到此标签页: 系统会再次尝试付款." 在那里用银行卡充值. 回到 Studio 标签页时,系统会自动再次尝试付款;您也可以点击 付款并显示模型 (Pay and show the models).

您的账户已经付过款的病例,再次运行时不会重复收费:按钮显示 显示模型 (Show the models).

查看模型

面板显示 场景中的模型 (Models in the scene),并列出每个模型及其颜色:上颌骨 (Maxilla)、下颌骨 (Mandible)、上颌 (闭合) (Upper jaw (closed))、下颌 (闭合) (Lower jaw (closed))、下牙槽神经 (Lower nerve),以及带编号的 上牙 (Upper tooth) / 下牙 (Lower tooth). 对于本结果,测量、在 2D 中显示 (Show in 2D) 和导出均免费.

  • 对照影像检查: 右键点击一个模型,选择 在 2D 中显示,即可在切片上看到它的轮廓,然后逐层浏览切片进行比较. 如何在 Cympha Studio 中使用 CBCT 查看器 介绍了各个切片窗格.
  • 闭合的上下颌一开始是隐藏的: "闭合的上颌和下颌模型默认隐藏; 可在模型列表中显示." 打开模型浏览器(Studio 第二行右侧操作按钮中的书本图标),在它们所在行点击 显示模型 (Show model).
  • 下载全部 STL 文件 (Download all STL files),位于 下载模型 (Download the models) 下:保存一个 zip,内含所有模型的 STL 和一个 manifest.json;病例的 zip 命名为 cbct-segmentation-case-<case number>.zip,否则以任务命名.
  • 将模型保存到病例 (Save models to the case)(仅限从病例页面启动的运行):把所有模型以 STL 格式连同一个 manifest.json 上传到病例文件. 点击之前不会上传任何内容. "已将 … 个文件保存到病例." 表示已完成.
  • 完成 (Done) 关闭面板并切换到 3D 处理;模型保留在场景中. 分割另一个 CBCT (Segment another CBCT) 重新开始.

以后再次打开

再次打开 CBCT 分割 时,面板显示 您上一次的分割已付款 (Your last segmentation is paid)、"… 在 电脑名称 上完成. 再次打开免费." 以及 再次打开 (Open again). 点击它即可免费再次载入影像和模型. 此功能适用于您最近一次的运行,须在运行它的那台电脑上,7 天内有效.

得到哪些模型

| Studio 中的名称 | 文件名(zip 和病例) | 说明 | |---|---|---| | 上颌骨 | maxilla.stl | 上颌骨,带牙槽窝. | | 下颌骨 | mandible.stl | 下颌骨,带牙槽窝. | | 上颌 (闭合) | upper_jaw.stl | 上颌骨与上牙合并为一个整体模型. 一开始隐藏. | | 下颌 (闭合) | lower_jaw.stl | 下颌骨与下牙合并为一个整体模型. 一开始隐藏. | | 下牙槽神经 | lower_nerve.stl | 下牙槽神经管. | | 上牙 1, 2… / 下牙 1, 2… | tooth_us_01.stl 到 tooth_us_32.stl | 识别到的每颗牙一个模型. |

牙齿编号不是牙位编号. Studio 在面板中说明了这一点:"牙齿按牙弓顺序编号 (1 = 找到的第一颗牙), 不是牙位编号." 文件名中的编号也按同样的牙弓顺序,上牙为 01–16,下牙为 17–32,与面板中名称的计数方式不同. 请在影像上辨认每颗牙,不要依据编号.

manifest.json 列出每个文件及其结构和显示名称.

一次只能运行一个

每个 Cympha 账户在其所有已配对的电脑上,同一时间只能有一个排队或运行中的分割. 有任务进行时:

  • 在同一个病例上,分割 CBCT 显示其进度;
  • 在其他任何病例上,按钮显示 正在 电脑名称 上运行 (Busy on computer name)(或 正在分割 (Segmentation in progress)),且无法点击;
  • 从病例页面再次发起请求会显示 "已在 电脑名称 上运行 — 请等待完成." 或 "已在分割或排队中 — 请等待完成.";
  • 在 Studio 中,在这台电脑上分割 CBCT 会转而跟踪正在进行的运行:"电脑名称 上已有一个分割在运行; Studio 将显示其结果.";
  • 从托盘菜单启动时,提示显示 "A CBCT segmentation is already running on computer name."(电脑名称 上已有一个 CBCT 分割在运行.)

如果出现问题

  • Studio 显示 "这台电脑上没有运行 Cympha Agent Manager": 过去几分钟内,没有配对到您账户的 Agent Manager 签到. 按面板中的步骤操作:下载安装程序 (Download the installer),配对(托盘菜单:Pair to Cympha…),保持其运行,然后点击 重新检查 (Re-check). 安装指南 (Set-up guide) 会打开 设备配对:安装并配对 Cympha Agent Manager.
  • "无法连接这台电脑上的 Agent. 该任务是在 … 上运行的": 打开 Studio 的那台电脑上没有运行 Agent Manager. 从开始菜单(Cympha Agent Manager)启动它并点击 重试 (Retry),或在运行该任务的电脑上打开 Studio.
  • "这台电脑上的 Agent 没有保存此结果: 该任务是在 … 上运行的, 或者已超过 7 天.": 在运行该任务的电脑上打开 Studio. 超过 7 天的结果无法打开;请重新运行分割.
  • "任务已完成, 但 Agent 未报告结果位置.": 这台电脑运行的 Agent Manager 版本低于 1.2.1. 请更新(参见 设备配对:安装并配对 Cympha Agent Manager 中的 "Updates"),然后重新运行分割.
  • "请充值余额, 然后回到此标签页: 系统会再次尝试付款.": 余额低于价格. 在 Studio 余额 窗口中充值,或在 app.cympha.com 的 Cympha 余额 下充值,然后回到 Studio 标签页. "付款失败: …":再次点击 付款并显示模型.
  • 分割失败:"Agent 报告: No DICOM files found in …"(在 … 中未找到 DICOM 文件): 该文件夹中既没有 DICOM 切片,也没有 .zip. 请选择存放切片文件的文件夹,或把 CBCT 作为一个 DICOM 文件夹的 .zip 附到病例上. 点击 重试 (Try again). 运行失败不收取任何费用("未产生任何费用.").
  • "在 Agent 中取消了文件夹选择.": Select CBCT DICOM folder 对话框被关闭,或运行已从托盘菜单取消. 点击 重试 并开始新的运行.
  • "Agent 停止报告, 任务已超时."(Studio)或 "分割超时"(病例页面): 运行期间电脑停止、休眠或断开了连接,或者没有电脑接手任务. 通知铃铛和邮件会说明是哪种情况:"No computer picked up the segmentation"(没有电脑接手该分割)表示 10 分钟内没有 Agent Manager 接手 Studio 任务,或 30 分钟内没有接手病例任务. 请确认 Agent Manager 正在运行且已配对,然后重新开始.
  • 病例页面一直停在 已排队 — 正在等待您的电脑…: 请依次检查:Agent Manager 正在这台电脑上运行;它配对的是您登录所用的账户;Cloud Monitoring 已设置工作区文件夹;病例已到达该文件夹. 日志(托盘菜单 > Show window)会说明病例文件夹是否还不在这台电脑上.
  • 病例中有多个 .zip 文件,运行失败: 病例文件夹中没有散装切片时,Agent Manager 会解压它找到的第一个 .zip,而那可能不是 CBCT. 在电脑上,把 DICOM 切片放到病例文件夹的 DICOM 子文件夹中,然后再次点击 分割 CBCT.
  • "无法显示结果" (The result could not be shown),并附 "无法加载 CBCT."、"重建失败: …" 或 "标签体数据中没有可重建的结构.":点击 重试. 在模型显示之前不收取任何费用.
  • 进度下方出现警告,例如 "标签与扫描的吻合度较差 (骨密度核验); 请将模型与扫描对照检查.": Studio 无法完全确定模型与影像已对齐. 使用前请用 在 2D 中显示 检查.
  • "保存到病例在 … 处中止" 或 "下载在 … 处停止": 点击 再次保存 (Save again) 或再次点击 下载全部 STL 文件.
  • 托盘提示显示 "Not paired to Cympha"(未配对到 Cympha): 重新配对 Agent Manager(设备配对:安装并配对 Cympha Agent Manager).

相关内容

  • 设备配对:安装并配对 Cympha Agent Manager
  • 如何在 Cympha Studio 中使用 CBCT 查看器
  • Cympha Studio 要点——第一次找到方向
  • 通过 Agent 上传——从病例详情上传并可选网格修复
  • 从您的云盘文件夹创建病例
Cympha病例CymphaStudio