操作说明

功能与操作说明

每个可视化模块的目的、原理、操作步骤、读图要点与边界。读完可返回演示板对照操作；演示板上各行「操作说明」会跳到本章锚点。

总览 A1 A2观测 FDEM 采动反哺 突水 瓦斯 融合 FAQ 进入回放 →

0. 总览：怎么用这块板子

推荐浏览顺序（与演示板行序一致）： A1 基线 → A2 观测更新 → OpenFDEM 损伤 → 采动反哺示意 → 突水 → 瓦斯 → 融合。

  1. 通用三维操作：在画布上按住拖动可旋转（轨道相机）；底部「播放」自动切帧，「进度条」手动 scrub；「联播轻量行」只播 FDEM/采动反哺/水/气/融合，不联播地质（避免双面卡顿）。
  2. 两类地质更新（必读）：
    • A2 观测更新：新钻孔/掘进揭露 → 数学差值（RBF/AOI），适用于揭露信息修正。
    • 采动反哺：回采采空区 → 力学损伤/下沉 → 顶板修正示意图层；正式写回 ModelPackage 与三维充填标定仍属规划。
  3. 离屏暂停：滚出可视区后动画会自动停，减轻负载。
  4. 改参重算：仅在本机 serve_demo.py 下可用；GitHub Pages / 纯静态打开时表单会禁用并提示只读。
  5. 演示边界（必读）：地质场景是 USGS PRB Roland/Baker 示范块；材料/地应力为 SCREENING 未现场标定； A 地质 CRS=EPSG:26713 local，突水/瓦斯巷道 CRS=ZM_POC_LOCAL_ENU_v1，采动反哺与 FDEM 同剖面局部系，禁止混空间关联。
  6. 验收主戏：A1/A2 VTK + A3 FDEM 回放 + 采动反哺半闭环示意。

打开演示板动态回放 →

1. A1 基线地质 · VTK 对照

目的

展示 ModelPackage v1 更新前的煤层几何：顶/底板三角网、solid 侧壁、夹矸证据体、断层面、基线钻孔。 用来回答「更新前煤层长什么样」。算法标签：普通克里金（ordinary kriging）。

原理（数据从哪来）

  • 输入：USGS PRB 钻孔约束 → A 侧建 ModelPackage/v1。
  • 网页渲染：直接读 VTK 三角面（roof/floor/solid 侧壁/parting/Fault_1·2），不是示意点云。
  • 帧标量：厚度 thickness_m、顶板高程 roof_elev_m、底板高程 floor_elev_m（共 3 帧）。
  • 琥珀面=夹矸；暗红面=断层；线框=工作面四边。

操作步骤

  1. 在演示板点「从 A1 地质开始」，或滚到 A1 行。
  2. 拖底部进度条：第 1 帧厚度 → 第 2 帧顶板高程（基线面常用）→ 第 3 帧底板高程。
  3. 按住画布拖动旋转，从斜上方看清工作面矩形与钻孔点标注。
  4. 左侧「关键参数」核对：来源 v1、三角面约 1.6 万、钻孔 18、CRS 26713。

读图要点

  • 色条：暖/高 = 当前帧标量更大（厚度更厚或高程更高）。
  • 记住顶板起伏与工作面位置，便于下一步和 A2 对比。

不要误解

A1 没有 AOI/残差帧；也不是中煤现场工作面。

打开演示板 · A1 ↑

2. A2 观测更新 · 新孔/揭露差值（非采动演化）

目的

展示 ModelPackage v2「观测约束更新」：在同拓扑上用新钻孔/掘进揭露做 AOI 局部 RBF 残差修正。 适用于掘进揭露信息修正；不承担回采采空区断裂/垮落/充填的物理演化。

原理

  • 几何仍是 VTK 直面；帧含 aoi_weight、v1_to_v2_roof_dz 等。
  • 更新驱动：新孔约束 + 数学差值，不是 OpenFDEM 力学结果。
  • 采空区顶板垮落形态请看 采动反哺示意。

操作步骤

  1. A1 停在 roof_elev_m 记住形态。
  2. 本行拖到 aoi_weight / v1_to_v2_roof_dz 看观测更新区。

边界

CRS=EPSG:26713 local。与采动反哺、水/瓦斯巷道勿混谈同框。

打开演示板 · A2 ↑

3. OpenFDEM 损伤演化 · 历史结果回放

目的

展示 A3 开挖真算的损伤/CZM 破缝历史回放（二维挤出展示）。

与采动反哺的关系

本行是力学过程场；下一行「采动反哺」把损伤映射为顶板修正量，形成半闭环示意。

打开演示板 · FDEM ↑

4. 采动反哺示意 · 力学→顶板修正（半闭环）

目的

回应「回采采空区不能只做数学差值」：用 OpenFDEM 损伤/下沉尺度生成 roof_dz_m 顶板修正示意， 以及末帧 goaf_indicator 扰动指示，形成力学反哺地质的 POC 半闭环。

原理

  • 输入：已有 fdem_volume.json（历史真算损伤场）。
  • roof_dz_m = −损伤 × 下沉尺度 × 开挖进程（顶板点，向下为负）。
  • goaf_indicator：煤层带高损伤 + 顶板下沉归一化示意（非实测充填）。
  • 坐标系：与 FDEM 剖面 mesh2d 局部一致；未写回 ModelPackage，也未与 A2 CRS 同化。

操作

  1. 先播 FDEM 看破缝与损伤，再播本行看顶板修正量增大。
  2. 对照口述：掘进揭露→A2 观测更新；回采采空→采动反哺（示意）。

边界

screening / 示意；正式工程需矿方材料标定、真三维网格与充填模型后再闭环写回地质包。

打开演示板 · 采动反哺 ↑

5. 突水蔓延

目的

演示示范巷道突水/积水三维蔓延（FV3D）。可继续与矿方交流标定优先级。

打开演示板 · 突水 ↑

6. 瓦斯蔓延

目的

演示示范巷道瓦斯对流–扩散（FV3D）。可继续与矿方交流关注点与数据接口。

打开演示板 · 瓦斯 ↑

7. 多源融合 · 应力/渗流属性场

目的

多参数属性场与构造关联；ahead_geology 为条带评分，不是 A2 VTK 预报。

打开演示板 · 融合 ↑

8. 常见问题

  • A2 和采动反哺有何不同？A2=观测差值（掘进/新孔）；采动反哺=力学损伤→顶板修正示意（回采）。
  • 采动反哺是否已写回地质包？POC 半闭环仅出示意图层，未写回 ModelPackage。
  • 为什么看不到电影级垮塌？破缝+下沉+roof_dz 示意；完整块体请 ParaView。
  • 改参按钮灰了？静态 Pages 或未启动 serve_demo。

返回演示板首页 →