Skip to content

About

Interactive 3D difficult-airway teaching atlas with mouth-opening scenarios and staged intubation animation

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Airway Atlas 3D

面向麻醉与气道教学的交互式成人困难气道三维图谱。项目参考 OMFAtlas,将公开头颈解剖模型与张口度、下颌位置、舌体占据、颈部活动及分段插管流程结合起来。

张口受限病例动态演示

演示片段:选择 张口受限 20 mm 教学病例后,镜片推进至预设入口困难点自动暂停;随后可定位困难部位、对照观察路径,并撤回至重新评估。也可查看 高画质 MP4 或 静态封面。

这是教学原型,不是患者风险评分、临床决策工具或经验证的插管模拟器。张口毫米数与困难节点是教学预设,不构成临床阈值。

主要功能

  • 成人头颈解剖三维浏览:剖视、斜位、正位、喉部近景和器械细看。
  • 张口范围 10–50 mm,下颌与下牙联动;舌体和头颈位置可调。
  • 六种教学场景:成人基准、张口受限、下颌后缩、舌体增大、颈部活动受限和多因素组合。
  • 五阶段动态流程:准备与评估、镜片进入、喉部暴露、导管推进、撤出与复盘。
  • 困难节点自动暂停,可定位、对照示意视轴、撤回并重新评估。
  • 解剖名称默认隐藏,点击可见部位后才显示名称和来源说明。
  • Macintosh 形态喉镜和带套囊气管导管教学模型,可独立旋转查看。
  • 完全本地运行,三维模型及前端依赖均随仓库提供。

快速启动

python3 -m http.server 3043 --bind 127.0.0.1

浏览器打开 http://127.0.0.1:3043/。请通过本地 HTTP 服务运行,直接双击 index.html 会受到浏览器模块加载限制。

教学场景与暂停位置

场景 教学参数 动态流程表现
成人基准 40 mm 完成演示片段,仍需临床确认要点
张口受限 10 / 20 mm 预设 镜片接近切牙入口时暂停
30 mm 张口预设 / 舌体增大 舌体占据示意 进入口腔后在暴露阶段暂停
颈部活动受限 后仰上限 5° 喉部暴露阶段暂停
下颌后缩 后移示意参数 导管推进方向受限处暂停
多因素组合 张口受限 + 后缩 + 舌大 + 活动受限 在第一个困难节点暂停,不能跳过

这些映射用于比较教学剧情。40 mm 或 50 mm 演示可以播放到末尾,也不表示真实患者一定能够顺利插管。

本地验证

python3 validate.py
node --check app.js
node --test flow.test.mjs
node --no-warnings --experimental-loader ./test-loader.mjs ./geometry.test.mjs
node --no-warnings --experimental-loader ./test-loader.mjs ./selection.test.mjs
node --no-warnings --experimental-loader ./test-loader.mjs ./instruments.test.mjs

当前验证覆盖 596 份模型缓冲、41 个张口校准点、流程状态机、剖面孔洞、部位选择和器械几何。详见 VALIDATION.md。软件测试不能证明解剖、光学、组织力学或临床有效性。

模型、器械与来源

  • 解剖模型来自 BodyParts3D 4.0,经 OMFAtlas 整理;固定上游提交与文件来源记录在 assets/provenance.json。
  • 模型授权、原始数据及 OMFAtlas / Human Atlas 署名见 assets/ATTRIBUTION.md。
  • Three.js 版本和许可证随本地资源提供。
  • 喉镜与气管导管依据公开尺寸资料自行建立,不是厂家 CAD。尺寸与局限见 INSTRUMENT-SOURCES.md。

当前边界

  • 关节滑移、舌局部变形、软腭和器械接触是教学近似,未进行组织接触力学求解。
  • 喉部近景不是实际喉镜或视频喉镜光学视野,不计算可见声门比例。
  • 未从几何参数自动推算 Mallampati、Cormack–Lehane 或 ASA 身体状态分级。
  • 动画中的导管位置不代表正确深度、持续呼气 CO₂ 确认、有效通气或插管成功。
  • 所有医学位置、动作和适用范围仍需麻醉专科审核。

版本

当前发布候选为 V0.3。V0.1 与 V0.2 保留在本地独立目录,没有被本版覆盖。

About

Interactive 3D difficult-airway teaching atlas with mouth-opening scenarios and staged intubation animation

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages