58 lines
3.6 KiB
C++
58 lines
3.6 KiB
C++
#ifndef GEOPRO_DATA_GPRVOLUMEREPOSITORY_HPP
|
||
#define GEOPRO_DATA_GPRVOLUMEREPOSITORY_HPP
|
||
|
||
#include <string>
|
||
|
||
#include "core/algo/GprVolumeBuilder.hpp" // geopro::core::BuiltI16
|
||
#include "repo/I3dSceneRepository.hpp" // geopro::data::VolumeGrid
|
||
|
||
namespace geopro::data {
|
||
|
||
// 把逐线 GPR 处理后量化体(int16 BuiltI16)反量化成 app 渲染链吃的稠密 float 体
|
||
// (VolumeGrid)，使真实雷达三维体可经现成 loadVolume→addVolume→buildVoxel 显示。
|
||
//
|
||
// 数据层方案 A(纯数据层，零 UI/render/controller 改动)：
|
||
// io::gpr::buildLineVolumeFromGpr3dv(P1/P2 链) → core::BuiltI16(int16+Quant)
|
||
// → builtI16ToVolumeGrid(反量化) → data::VolumeGrid(float)。
|
||
// 与现 mock(Api3dRepository 反演剖面 IDW)同格式输出，故下游 addVolume 无需任何改动。
|
||
|
||
// 纯函数适配器：BuiltI16(int16 量化体) → VolumeGrid(float 稠密体)。
|
||
// - 逐体素 Quant::toPhys 反量化；kBlank(空值哨兵)→ NaN(下游 buildVoxel 映射为透明)。
|
||
// - origin/spacing 原样搬运；vmin/vmax 用 BuiltI16 的物理值域。
|
||
// - 布局一致(i 最快、k 最慢)，两体可逐体素对位拷贝。
|
||
VolumeGrid builtI16ToVolumeGrid(const geopro::core::BuiltI16& built);
|
||
|
||
// 走 P1/P2 链建逐线 GPR 体并适配成 app 的 VolumeGrid。
|
||
// lineDir/linePrefix 同 gpr3dv-smoke / build-line(如 "D:/Downloads/明星路", "明星路_001")。
|
||
// coarse(下采样因子，≥1)：沿测线(道/X 轴)每 coarse 道取 1，省内存；横向/深度保全分辨率。
|
||
// 稠密 VolumeGrid 全内存，长线需较大 coarse 控内存(默认 4 = build-line POC 档)。
|
||
// targetDy(米，>0 启用)：线内【通道间插值】目标横向间距(读真实道偏移规则化，不跨线)。
|
||
// 默认 0.025(2.5cm)；0=不插值(Y=原通道数)。详见 io::gpr::buildLineVolumeFromGpr3dv。
|
||
// 失败(加载失败/立方体为空)→ 抛 std::runtime_error(由 io::gpr 链抛出，原样透传)。
|
||
VolumeGrid createGprVolumeGrid(const std::string& lineDir,
|
||
const std::string& linePrefix, int coarse = 4,
|
||
double targetDy = 0.025);
|
||
|
||
// 走【规范化测线链】(io::gpr::buildLineVolumeFromNormalized) 建逐线雷达体并适配
|
||
// 成 app 的 VolumeGrid。读 {lineDir}/{linePrefix}.head + .data(轴 X=道/Y=通道/
|
||
// Z=采样)→ BuiltI16(int16+Quant) → builtI16ToVolumeGrid 反量化 → VolumeGrid。
|
||
// 与 createGprVolumeGrid(P1/P2 链)同输出格式，下游 addVolume 无需改动；区别仅是
|
||
// 上游数据源走规范化 .head/.data 而非 .iprh/.iprb。
|
||
// coarse(≥1)沿测线下采样；targetDy(米，>0 启用)线内通道插值(读 .head CH_X_OFFSETS)。
|
||
// 失败(加载失败/解析失败)→ 抛 std::runtime_error(由 io::gpr 链抛出，原样透传)。
|
||
// 雷达显示增益模式(纯显示、逐道沿深度、不动原始 .data；窗口随增益重取)：
|
||
// Off = 原始振幅；
|
||
// Agc = dewow + 滑窗 RMS 归一：最大化显出深部弱反射(找目标)，但【抹相对振幅】；
|
||
// Tpow = dewow + ×时间^幂：保幅增益(补几何扩散/衰减)，【保留相对强弱】——判振幅/复核异常用。
|
||
// (审阅者点③：标深部目标前应在 Tpow 保幅下也确认，不只信 Agc。)
|
||
enum class RadarGainMode { Off, Agc, Tpow };
|
||
|
||
VolumeGrid createRadarVolumeGrid(const std::string& lineDir,
|
||
const std::string& linePrefix, int coarse = 4,
|
||
double targetDy = 0.025,
|
||
RadarGainMode gainMode = RadarGainMode::Off);
|
||
|
||
} // namespace geopro::data
|
||
|
||
#endif // GEOPRO_DATA_GPRVOLUMEREPOSITORY_HPP
|