如何在 Cympha Studio 与 GuideMia Implant Software 之间往返同步种植病例

通过 .pie 与 .imp 往返，Cympha Studio 可以打开、编辑并交回 GuideMia 口腔种植软件的项目，让浏览器审阅与桌面规划使用同一组种植体.

适用对象: 跨 Cympha Studio(浏览器)和桌面 GuideMia Implant Software 协作的临床医生和种植设计师. 任何一方都可能创建病例;任何一方都可以审阅、调整、评论并把它交回.

阅读后您将了解: 如何在 Studio 中打开同事的 .pie 项目,审阅并编辑种植,读取和追加设计日志,选择性地换入从别处导出的 .imp 方案,并保存回同一份 .pie,使桌面应用程序干净地接收您的更改.

所需时间: 首例约十五分钟——其中大部分用于核实您是否有正确的 DICOM. 之后每例五到十分钟.

开始之前

您需要:

同事的 .pie 项目文件.
匹配的 DICOM 文件夹 — .pie 据以规划的原始 CBCT 序列. Cympha Studio 通过 Series Instance UID 把 .pie 与 CT 匹配,这是 GuideMia Implant Software 使用的相同标识符. 来自不同患者的 CT,或新分配 UID 的重新导出序列,将不匹配.
在 studio.cympha.com 打开 Cympha Studio.

如果您只有 .pie 而没有 DICOM,请在继续之前请求发送方共享 CBCT 文件夹——.pie 中的种植位于 CT 体素空间中,因此 Studio 在没有匹配体积的情况下无法在 3D 中渲染它们.

步骤 1 — 切换到 Implant 工作区

在顶部栏中,打开 Workspace nav 并挑选 Implant. 汉堡菜单收窄为种植工作的文件操作:DICOM、种植项目(.pie)、光学扫描、图片、打开 URL、reset camera、clear scene、用户指南.

从同事的邮件或 URL 共享中打开 .pie 深链时会自动切换到 Implant,因此通常不需要手动设置.

步骤 2 — 先打开 DICOM

在 .pie 加载之前,DICOM 必须先在场景中,因为 Studio 需要体积来在 3D 中渲染种植并验证患者匹配.

☰ → Open DICOM….
选择包含一个 CBCT 序列的文件夹. Studio 在浏览器中解码序列;不会上传任何内容.
等待 MPR 切片行出现——这是体积就绪的信号.
可选:从左侧浮动栏打开 View tools 面板,调整 HU threshold(滑条范围大致 −1024 … 2048)和 Opacity,使骨骼易于查看. 在步骤 4 及之后您将需要这种对比度.

如果您的部署有云端种植 API 且您通过此菜单打开了 DICOM,Studio 可能会询问导入此序列的云端治疗方案. 如果您即将为同一病例打开 .pie,跳过此提示——.pie 将提供种植.

步骤 3 — 打开 `.pie` 项目

☰ → Open implant project…. 文件选择器限制为 .pie.
挑选同事的文件.

接下来发生什么取决于 DICOM 是否匹配:

匹配时: 种植立即加载. Models 浏览器自动打开,左侧栏的 Implant tools 工具箱展开,使参数面板和设计日志可见.
不匹配时(尚未加载 DICOM,或加载的 CT 属于另一名患者):Studio 显示 DICOM required for this implant project 对话框. 该对话框在该信息可用时命名 .pie 上存储的患者. 点击对话框内的 Open DICOM 并挑选正确的文件夹;一旦 Studio 确认 Series Instance UID 匹配,种植自动加载.

DICOM 不匹配时,您无法把种植保存回 .pie——Studio 故意阻止写入,以防方案被悄悄重新锚定到错误的扫描.

步骤 4 — 审阅现有种植

在 Models 浏览器中,每颗种植显示为自己的一行. 在 .pie 携带数据时,Studio 用以下信息丰富该行:

品牌和系列(例如制造商名称加产品线).
总钻孔长度.
套筒尺寸,以 ID × OD × H 表示,单位毫米.

点击一行种植,把该种植设为 Implant tools 工具箱中的当前种植——面板的 diameter、length、apical、brand 和 catalog ID 字段填入 .pie 中的值. 在开始编辑任何东西之前,把这作为合理性检查.

要在 3D 和切片中检查种植:

在主 3D 视图中双击种植体以打开定位(手柄). 拖动轴手柄以平移,拖动旋转环以倾斜.
定位激活时,View tools 面板提供 Gizmo MPR 模式,把切片面板对齐到种植体轴——用于验证与邻牙根的平行度或与下牙槽神经的套筒间隙.

步骤 5 — 阅读设计日志

设计日志是规划者的运行注释,存储在 .pie 内部本身. 项目打开时,Implant tools 工具箱按 GuideMia Implant Software 写入的顺序按作者分组显示现有日志条目. 在您更改任何东西之前阅读这些——之前的设计师可能解释了为何放置在那些位置.

步骤 6 — 添加或更新种植

对于新种植:

在 Implant tools 工具箱中,可选择点击 Open catalog… 以加载内嵌的 XML 目录并挑选品牌/尺寸. 选择目录行会填入 diameter、length、apical、brand 和 catalog ID 字段.
输入通用牙位编号(1–32). 如果该牙已携带种植,Studio 显示警告并拒绝——挑选其它牙,或先移除现有种植.
点击 Add. 视口底部的状态行提示:"click in 3D or a slice view to place."
在 3D 视图或任意 MPR 面板上点击所需位点. 种植体连同其套筒出现在点击点.
用 3D 中的手柄或切片面板上的手柄精调位置.

对于已有种植:

在 Models 浏览器中点击种植行,使其成为当前种植.
在面板中编辑 diameter/length/apical/catalog 字段.
点击 Update 以重新生成几何体. 在放置仍未完成时 Update 被禁用——先完成 Add 的点击.

步骤 7 — 把您的审阅评论添加到设计日志

在现有日志条目下方,Implant tools 工具箱显示一个文本区域和一个 Add comment 按钮.

输入您的评论——例如 "Reduced 16 length to 10 mm for sinus clearance; verify on coronal at z=…". 请具体;这是下一位审阅者将读到的内容.
点击 Add comment,或在文本区域内按 Ctrl+Enter(Mac 上为 Cmd+Enter).

您的评论会以您的名义追加到设计日志中. 在下次 Save project 时,更改将持久化到磁盘.

步骤 8 — 保存回 `.pie`

☰ → Save project. Studio 把种植更改(新放置、变换、设计日志追加)写回到同一份 .pie 文件名.

Studio 保存时保留的内容:

每颗种植、套筒、变换以及 Studio 修改过的元数据字段.
桌面应用写入的每一个非种植 Segment 和属性——Studio 保留完整的 XML 文档,只重写它建模过的部分. 在 GuideMia Implant Software 中重新打开文件的规划者不会看到意外.

状态行确认保存的文件名. 把更新的 .pie 送回给同事;他们可以在 GuideMia Implant Software 或 Cympha Studio 中重新打开它,并精确地从您离开的地方继续.

何时改用 `.imp`

.imp 是 Studio 原生的种植方案文件(仅 XML 元数据——不是网格块). 在以下情况下有用:

您还没有 .pie,但想与使用不同桌面应用的人共享种植方案.
您想从导出 .imp 的另一个工具导入种植位置.

在 Implant tools 工具箱中:

Export plan 把所有当前种植写入您下载的 .imp 文件.
Import plan 从 .imp 加载放置,添加套筒,并跳过已有种植的牙,使您不会意外双重放置.

.imp 和 .pie 不可互换. 当 .pie 是活动项目时,☰ → Save project 写回该 .pie. 要从同一场景生成 .imp,使用 Implant 工具箱中的 Export plan.

接下来会发生什么

您保存的 .pie 与桌面应用打开的是同一文件. 不存在单独的"Studio 版"项目——两个应用读写同一份 XML 文档,Studio 完整 XML 的保留意味着非种植 Segment 在每次往返中存活.

持续协作的方式:

同事在 GuideMia Implant Software 中打开保存的 .pie,阅读您的设计日志条目,并接受您的更改或在下一条目中回复.
他们保存并把文件发回. 您再次 ☰ → Open implant project…——Studio 与仍加载的 DICOM 进行匹配,您接到新状态.
项目图片和截图与 .pie 分开传递. 如果您希望媒体库截图附在病例上,与 .pie 一起保存一个 Cympha .cyp 项目(但请注意:当 .pie 是活动项目时,同一会话中 .cyp 保存目标被暂停——两种格式互斥,因此通过相关菜单条目切换项目).

故障排查

即使我加载了 DICOM,DICOM-required 对话框仍然出现. ** 您 DICOM 上的 Series Instance UID 与 .pie 中存储的不匹配. 最常见原因是重新导出的 CBCT——许多查看器在导出时重新分配 UID. 从采集 CBCT 的人那里拿到原始** DICOM 文件夹,而不是衍生副本.

**种植浏览器行看起来很空(没有品牌或套筒尺寸). ** 较旧的 .pie 项目或来自第三方导入器的项目可能不携带丰富字段. 种植仍然渲染和编辑;只是行摘要更稀疏.

**我无法同时打开 .pie 和 .cyp. ** 没错——两种格式在单个 Studio 会话中互斥. 先保存一种的工作,然后打开另一种. 菜单的启用/禁用状态反映当前活动的保存目标.

Save project 没有明显结果. ** 注意视口底部的状态行**——Studio 在那里报告保存的文件名. 如果浏览器阻止文件写入(某些配置要求用户手势在同一 tick),从菜单直接重试 Save project 而不是通过键盘快捷键.

**设计日志文本区域不接受 Ctrl+Enter. ** 该快捷键仅在焦点位于文本区域内时被处理. 先点击进入文本区域,然后按快捷键. 文本区域之外,Ctrl+Enter 没有效果.