Cympha
全部文档

如何在 Cympha Studio 中调整正畸规划和分阶段

本文介绍如何在 Cympha Studio 中用 Movement chart 和 IPR 编辑调整正畸分步，再与 GuideMia 的隐形矫治器软件 OrthoPlus 往返交换病例 XML.

适用对象: 直接在 Cympha Studio 中做正畸规划和分阶段工作的临床医生和设计师——无论是审阅来自技工所的病例,还是在把更新方案导回 GuideMia OrthoPlus 之前调整分阶段.

阅读后您将了解: 如何逐步浏览治疗方案,打开 Movement chart 并重新分阶段一颗牙的运动,切换并编辑 IPR 间隙,用 tooth movement 面板推动精细调整,以及在 Studio 和 OrthoPlus 之间往返病例 XML.

所需时间: 首个病例十五到二十分钟. 之后每例五到十分钟.

开始之前

您需要:

  • Studio 理解格式的正畸病例——通常是 GuideMia OrthoPlus .gvw 归档,或 .pac 步骤归档. 本指南中的深度控件(Movement chart、IPR、Case XML)特定要求 GuideMia .gvw;.pac 归档可以播放但不暴露相同的编辑控件.
  • 一个桌面宽度的浏览器窗口. case bar 上的 Movement chart 和 IPR 按钮仅在视口宽度约 1024 像素或以上时才出现. 在较窄窗口中这些控件隐藏——开始之前加宽窗口或移到外部显示器.
  • 在 studio.cympha.com 打开 Cympha Studio.

步骤 1 — 切换到 Orthodontics 工作区并打开病例

在顶部栏中,打开 Workspace nav 并挑选 Orthodontics. 汉堡菜单收窄到正畸工作所需的操作——DICOM、OrthoPlus plan、optical scan、articulation、pictures 等等.

然后加载病例:

  • ☰ → Open OrthoPlus plan… 用于本地 .gvw.
  • ☰ → Open optical scan file… 也接受 .gvw 和 .pac.
  • ☰ → Open URL… 用于托管的 .gvw 链接(受 CORS 约束).
  • 把 .gvw 文件拖放到查看器. URL 中的 .gvw 深链自动切换到 Orthodontics.

等进度指示器清除并且牙齿在 3D 中出现. 方案加载后,浮动 case bar 出现在查看器底部——这是接下来一切的控制面.

步骤 2 — 熟悉 case bar

case bar 从左到右容纳您将在整个工作流中使用的控件.

步骤滑块. ** 显示当前步骤与最大值的对比(5/24 风格,GuideMia 和 .pac 之间标签略有不同). 拖动滑块,场景在您释放**指针时更新——不是每个 tick 都更新,以免在滑动时反复重建模型. 当滑块拥有键盘焦点时,Arrow Left/Right、Home、End 和 Page Up/Down 移动步骤并立即应用.

Previous / Play / Next. ** < 和 > 按钮单步后退和前进,在端点处禁用. Play 每 200 ms 前进一步直到最终步骤,然后停止——它不**循环回步骤 0. 启动 Play 会自动关闭 IPR overlay(若开着),以免标签在视觉上滞后于模型.

Movement chart(表格图标). 切换浮动的 Movement by step 分阶段面板. 仅限桌面宽度 + GuideMia.

IPR(IPR 图标). 切换 IPR 叠加层. 仅限桌面宽度 + GuideMia.

Case XML 操作:

  • Upload(向上箭头图标)— 用您挑选的 .xml 文件替换内存中的方案.
  • Download(向下箭头图标)— 把当前 case DOM 导出为 .xml.
  • Cloud upload(云端向上箭头图标,仅限已登录用户,且 .gvw 是从远程 URL 例如 Cympha 病例链接打开时)— 把当前 XML 上传到云端源 .gvw 旁边作为同级 .xml. 不创建本地文件. 用此把您的审阅送回 Cympha 中的病例,而不经过下载 → 重新上传.

品牌标志位于查看器左下角,在状态行之上. 状态行是 Studio 报告成功、错误和短提示的地方——每当某个控件"看似什么都没做"时,留意它.

步骤 3 — 打开 Movement chart 并读取网格

点击 case bar 上的 Movement chart(表格图标). Movement by step 面板作为浮动窗口打开——拖动其标题以重新定位. 位置在该会话中保留.

网格的布局是:

  • 列是按通用图表顺序的牙齿. 表头行显示 FDI 编号.
  • 行是过渡步骤 1 … N,其中行 s 代表进入步骤 s 的过渡. 当前在查看器中的步骤的行标签被高亮.
  • 蓝色可拖块标记该牙在该过渡上有可见运动的单元格. 仅关键帧单元格可能以不同填充显示但不可拖动.

步骤 4 — 检查单元格

单击任意单元格. 短暂延迟后(以使双击仍能注册),一个浮动提示打开,带:

  • 来自查看器的主分阶段行.
  • 如果该单元格承载运动:此过渡的step Δ 和从步骤 0 起的总 Δ,以紧凑的 mm/° 格式.

提示在大约 2 秒后自动消失,但悬停在提示上保持其打开;离开提示安排一次更长的消失. 视单元格而定,提示中还可能显示编辑控件;如果其中某个操作失败,原因会在状态行中打印.

键盘等价物: 在聚焦的单元格上,Enter 或 Space 打开相同的提示,锚定到该单元格.

步骤 5 — 通过拖放重新分阶段一次运动

要移动牙齿运动发生的时机,在同一牙齿列内垂直拖动蓝色块——您不能跨列拖动.

  • 拖到更低行(更晚的步骤)推迟运动:保持带拉伸,尾部移位.
  • 拖到更高行(≥ 1)把运动提前,但仅当目标停留在该牙的同一连续运动阶段内时才可.
  • 无效目标不会高亮;拖放被静默忽略.

成功拖放后,合成点击被抑制,以免提示立即在您释放点处重新打开.

步骤 6 — 双击单元格以编辑该牙

双击数据单元格以把查看器跳转到该步骤并为该通用牙位进入 tooth movement 模式. 如果策略不允许在该牙/步骤调整(锁定关键帧、固定位姿等),Studio 显示 toast 说明原因,而不是移动任何东西.

双击行表头(步骤编号)以把查看器跳转到该步骤而不挑选牙. 列选择清除.

步骤 7 — 使用 tooth movement 面板进行精细调整

当 tooth movement 激活时——无论是来自网格中的双击,还是主 3D 视图中的牙齿双击——tooth movement 面板打开(左下). 标题显示牙位编号和颌.

每个轴的面板上有:

  • Translate X / Y / Z,单位毫米.
  • Rotate about X / Y / Z,单位度.

每行带数值步长、用于一步的 − / + 按钮和滑块. 拖动滑块以连续推送;释放时,Studio 应用累积的 delta 并把滑块重置为零. 更改牙或病例步骤也会重置精细滑块.

如果当前步骤不允许调整(锁定关键帧等),Studio 显示 toast 而不是静默应用运动.

3D 视图中牙上的手柄仍可并行用于粗略移动——拖动轴以平移,拖动旋转环以倾斜.

步骤 8 — 切换 IPR 并编辑间隙

点击 case bar 上的 IPR 图标. IPR 叠加层沿牙弓在邻接处附近投影标签和线. 标签颜色反映带符号间隙:

  • 偏绿表示间隙(正间隙).
  • 偏红表示碰撞 / 重叠(负间隙).

多个接触可能略微扇形展开它们的标签,以免堆叠.

要编辑一个接触:

  1. 在 3D 视图中点击数值标签. 一个弹出框打开,带 Clearance (mm) 字段. UI 中显示的约定是负 = 碰撞/重叠,正 = 间隙.
  2. 输入想要的值. 按 Enter 或点击 Apply 提交. Escape、Cancel 或弹出框外的点击关闭而不应用.
  3. 提交时,Studio 调整接触并对两颗牙执行远中平移(按近中 → 远中顺序)以实现新间隙.

当您启动 Play 时,IPR 叠加层自动关闭. 要再次看到标签,重新切换 IPR 图标.

临床责任说明: 弹出框中的 IPR 值驱动软件中的自动牙齿移位. 在把值提交到最终病例之前,请对照您的治疗方案和当地法规核实.

步骤 9 — 与 OrthoPlus 往返 XML

case XML 是方案的紧凑"大脑"——牙齿变换、分阶段元数据、关键帧标志. 交换 XML 使 Studio 和 GuideMia OrthoPlus 保持同步,而无需每次都运输完整的网格归档.

Studio → OrthoPlus:

  1. 在 Studio 中完成您的编辑(上面步骤 3–8).
  2. 在 case bar 上,点击 Download(向下箭头)图标. Studio 把当前 case DOM 导出为 .xml,文件名基于病例基名.
  3. 在 GuideMia OrthoPlus 中,按 OrthoPlus 文档导入或合并该 XML.

OrthoPlus → Studio:

  1. 在 OrthoPlus 中,导出更新的 case XML.
  2. 在 Studio 中,点击 case bar 上的 Upload(向上箭头)图标并挑选 .xml. Studio 应用 XML 中的方案.
  3. 上传期间的错误(格式错误的 XML、不匹配的病例)显示在警告中.

如果 OrthoPlus 中的网格资源变更了(为牙齿或其它几何体的新 STL),打开一份新的 .gvw 而不要仅依赖 XML——XML 不携带网格.

云端往返(已登录用户,且 .gvw 是从远程 URL 例如 Cympha 病例链接打开时):点击云端向上图标,把当前 XML 上传到云端源 .gvw 旁边. Cympha 中的病例在下次加载时接收新 XML——无需中间的本地下载 / 重新上传.

步骤 10 — 保存副本以供共享

要生成一个带有您当前方案的单一可共享文件,点击顶部工具栏上的 Download. 浏览器把病例保存到您的默认下载文件夹.

接下来会发生什么

XML 往返之后,病例在 Studio 和 OrthoPlus 之间是同步的. 下一位审阅者可在任一端打开,并看到您的分阶段更改、IPR 调整和牙齿移动.

对于持续审阅工作,Media gallery(顶部工具栏)保存您的 Screen captures 和 Add pictures… 上传,以及来自 .gvw 的任何病例媒体. 把整个工作区另存为 Cympha .cyp 项目(☰ → Save project)以将截图、说明文字和已配准的场景一并保留.

故障排查

**Movement chart 和 IPR 图标没有显示. ** 它们仅限桌面,且需要约 1024 px 或以上的视口宽度. 加宽浏览器窗口,或移到外部显示器. 它们还需要 GuideMia .gvw——.pac 病例不暴露它们.

**Movement chart 中的拖动没有放下. ** Studio 拒绝违反分阶段规则的放下(错误的列、提前时超出连续运动阶段等). 无效目标不高亮;如果您悬停时没有出现高亮,放下不会被接受.

**双击一颗牙显示"tooth move blocked" toast. ** 该步骤的策略禁止手动调整——通常是固定关键帧或不拥有该牙过渡的步骤. 移到不同的步骤(尝试该牙有蓝色块的过渡行)再重试.

**IPR 间隙编辑不保留. ** 弹出框必须用 Enter 或 Apply 提交. 弹出框外的点击取消而不应用——这是有意的,以免意外点击更改值,但容易错过. 重新打开标签并显式提交.

Upload XML 警告"errors." XML 未解析,或与加载的病例不匹配. 从 OrthoPlus 重新导出,确认病例 ID 对齐,然后再试. 底部的状态行通常携带更具体的第二条消息.

**云端上传图标不可见. ** 您没有登录,或 .gvw 是从本地文件而非远程 URL 打开的——云端上传仅在两个条件都满足时才提供(病例有已知的云端同级对象可供写入).

相关指南:Use OrthoPlus essentials · Cympha Studio essentials · Facial scan and the 3D camera · Implant interoperability with .pie · File formats reference

CymphaLMSCymphaStudio