5.3 KiB
POC-B 实测结果（gpr_poc headless 度量）
工具：tools/gpr_poc（CLI），构建产物 build/release/tools/gpr_poc/gpr_poc.exe。
执行机：Windows 11，MSVC（VS18 Community）+ Ninja，Release（/O2）。
日期：2026-06-23。
整条地基链路：
assembleGprSurvey → buildGprVolume → ChunkedVolumeStore::write → buildPyramid → WholeVolumeSource(load)。
1. selftest（合成极小数据）—— PASS
命令：gpr_poc selftest
- 构造 2 通道合成 survey（samples=8，traces=12），写临时
.iprb/.iprh/.ord， 走完整assembleGprSurvey → buildGprVolume → write(brick=4) → buildPyramid(1) → WholeVolumeSource。 - 断言：ntraces/samples/channels、channelY 升序、GridSpec
2x2x8、建体维度、 金字塔层数==2、整卷维度一致、(0,0,0) 非 blank。 - 结果：PASS（退出码 0）。
结论：除真实 .iprb 读入外，整条地基管线在合成数据上端到端跑通
（装配几何、建体量化、分块压缩落盘、金字塔降采样、整卷重组加载均正确）。
2. 真实数据（D:\Downloads\明星路，线 001）—— BLOCKED（前置 IO 层与真实数据契约不符）
命令：
gpr_poc build "D:\Downloads\明星路" --line 001 --cellXY 0.2 --cellZ 0.05 --out %TEMP%\gpr_store_001 --levels 2
进度：
- 文件发现 成功：定位 14 通道
明星路_001_A01..A14.iprb+明星路_001.ord。 - 装配 失败：
assembleGprSurvey→readIprb抛文件大小与 samples*traces*2 不符: ..._A01.iprb。
根因（off-by-one：lastTrace+1 vs 真实道数）
readIprb（前置 IO 层，src/io/gpr/IprbReader.cpp:16）硬编码
traces = h.lastTrace + 1 并对文件字节数做严格相等校验。
真实明星路每个通道文件恰好含 lastTrace 条道（少 1 道），逐通道实测：
| 通道 | 文件字节 | samples | LAST TRACE | 期望(=samples·(lastTrace+1)·2) | 实际道数(=bytes/(samples·2)) |
|---|---|---|---|---|---|
| A01 | 74390810 | 821 | 45305 | 74392452 | 45305 |
| A02 | 74394094 | 821 | 45307 | 74395736 | 45307 |
| A03 | 74390810 | 821 | 45305 | 74392452 | 45305 |
| A04 | 74394094 | 821 | 45307 | 74395736 | 45307 |
| A05 | 74390810 | 821 | 45305 | 74392452 | 45305 |
| A06 | 74394094 | 821 | 45307 | 74395736 | 45307 |
| A07 | 74390810 | 821 | 45305 | 74392452 | 45305 |
| A08 | 74394094 | 821 | 45307 | 74395736 | 45307 |
| A09 | 74390810 | 821 | 45305 | 74392452 | 45305 |
| A10 | 74394094 | 821 | 45307 | 74395736 | 45307 |
| A11 | 74390810 | 821 | 45305 | 74392452 | 45305 |
| A12 | 74392452 | 821 | 45306 | 74394094 | 45306 |
| A13 | 74390810 | 821 | 45305 | 74392452 | 45305 |
| A14 | 74394094 | 821 | 45307 | 74395736 | 45307 |
规律一致：所有通道「实际道数 == LAST TRACE」，即真实文件道数 = lastTrace，
而 readIprb 期望 lastTrace + 1，每通道恰差 1 道（samples·2 = 1642 字节）。
这是前置 IO 层契约与真实数据约定的系统性不符，不是 gpr_poc CLI 的问题。
现有单测（tests/io/gpr/test_iprb_reader.cpp:30-31）显式锁定
「字节数 != samples·(lastTrace+1)·2 → 抛异常」，故 lastTrace+1 是被测试钉死的契约。
处置（本任务未擅自改前置/测试）
按任务纪律（外科手术式改动、不动他人已测契约、严禁编造指标），
本会话未修改 readIprb 或其单测，故真实数据的建体/维度/压缩比/加载/峰值内存
暂无法实测，如实记录为 BLOCKED。
不是 OOM、不是超时——是装配前的文件读入契约不符，调粗 --cellXY 也无法绕过
（在到达建体之前就抛了）。
建议解法（需 POC/IO 层 owner 决策，任一）
- 放宽
readIprb：以「文件字节数 / (samples·2)」反推真实道数（容忍 ±N 道）， 而非硬用lastTrace+1；同步更新test_iprb_reader.cpp。这与真实数据约定 （道数 =lastTrace）一致，最贴近现场。 - 明确 LAST TRACE 语义：若约定其为「道数」而非「末道索引」，则
traces = lastTrace（去掉 +1），同样需改实现 + 测试。 - 任一方案落地后，重跑：
gpr_poc build "D:\Downloads\明星路" --line 001 --cellXY 0.2 --cellZ 0.05 --out <store> --levels 2再gpr_poc load <store>，本文件 §2 即可补齐真实指标。
3. 预估几何（供解法落地后核对，非实测）
基于真实头：samples=821，dx≈0.049084 m，通道横偏 Y∈[-0.686, 0.686]（跨度≈1.372 m），
土速 100 m/s、时窗 160.352 ns ⇒ 深度跨度 depthOfSample(820)≈8.0e-6 m（量级极小）。
按 --cellXY 0.2 --cellZ 0.05、X 跨度≈45305·0.049084≈2223 m：
- nx ≈ ceil(2223/0.2)+1 ≈ 11118
- ny ≈ ceil(1.372/0.2)+1 ≈ 8
- nz ≈ ceil(8.0e-6/0.05)+1 = 1（Z 物理跨度远小于 cellZ，故仅 1 层）
注意：因 SOIL VELOCITY 存为 100 m/s（头文件单位 m/µs ×1e6 后），深度尺度为微米级，
--cellZ 0.05（5 cm）会把整个深度压成 1 层。落地解法后，若要在 Z 方向有分辨率，
需把 --cellZ 调到与深度跨度匹配的量级（约 1e-8 m），或复核土速/时窗单位约定。
此项一并提请 POC owner 确认（影响真实体维度与后续渲染基准 9c）。