数据层大重构:文件→分组 / 时间轴一等公民 / 加载器抽象 + CSV 多时间轴 + MF4 支持
一、数据模型解耦(详见 Documents/refactor_report_2026-10-15.md 与 agent_mem §9.27)
1. DataFile → SignalGroup:删除 filePath / fileName / time / timeColumnName / timeMonotonic /
minTime / maxTime —— 「分组」是应用内的逻辑容器,加载完成后与磁盘文件再无关系。
2. 新增 TimeAxis(name / time / minTime / maxTime / monotonic / finiteCount),一个分组可含 1..N 条;
SignalData 新增 axisIndex 指向所属时间轴,采样值与时间的对应关系自包含。
3. SignalData 删除冗余的 rawHeader(name 的副本)与 unit(由列名猜出、全仓无人使用);
名字只保留 name(源名称)+ displayName(用户重命名),Title() 统一展示。
4. SignalRef::fileIndex → groupIndex;DataSet:AddGroup/RemoveGroup/GroupAt/GroupCount/Groups()/
SetGroupDisplayName/RemapSelectionAfterGroupRemoval + 新增 Axis(ref);
TabConfig:SetGroupVisible/GroupHasVisible/GroupAllVisible/RemapAfterGroupRemoval +
RowKind::GROUP / CMD_GROUP_*。
5. 采样与统计 API 首参由 const DataFile& 改为 const TimeAxis&:
SampleSignalAt / SampleDisplayedSignalAt / FindNearestSample(Utilities)与
SampleSpacingPixels / VisibleIndexRange / EdgeIndexRange / MeanFilterValueAt / WeakPeakValueAt /
EdgeCountsFor / EdgeCenterCountsFor / EdgeScanFor(PlotView)。
6. 视图层:ResolvedSignal = { data, style, group, axis, visible };PolylineCacheEntry::file→group;
EdgeScanState::file→axis(统计身份 = 时间轴 + 信号);
ComputeVisibleTimeBounds 只统计可见信号真正用到的时间轴。
二、加载层抽象(格式与模型彻底解耦)
- 新增 Utilities/Inc/DataTable.hpp:DataTable(通用列优先表格)+ LoadProgress/Info +
TableBlock(一个时间轴块)+ LoadedSource(源文件全部块)。
- 新增 Utilities/Inc|Src/DataLoader.*:唯一入口 LoadSignalSource 按扩展名分发 +
IsSupportedSignalFile + SignalFileDialogFilter。
- 新增 Utilities/Inc|Src/CsvLoader.*:CSV 解析 + 多时间轴切分 + 各轴按自己的时间列裁剪。
- 新增 Utilities/Inc|Src/Mf4Loader.*:ASAM MDF v4 解析。
- 删除 Utilities/Inc/CsvTable.hpp 与 Utilities/Src/CsvTable.cpp。
- 唯一装配点 BuildSignalGroup(LoadedSource&&, paletteBase, group, error, progress):
时间轴去重合并 + 信号命名 + 调色板取色 + 统计与粗粒度包络;新增格式只需写一个加载器。
三、CSV 多时间轴(修正用户报告的缺陷)
- 只有名为 t/time/timestamp/simulation time/时间/时间轴 的列是时间轴(判据收紧,
不再用「包含 time」以免把 timeout 误判成时间轴)。
- 每个时间列开启一个新块,其后直到下一个时间列之前的列都属于该块;各块按自己的时间列裁剪
⇒ 支持各轴长度不同(Multi_Timeline.CSV 实测切出 3 条轴,长度 7/4/7);
**不再把其它 time 列当成信号显示**。
- 完全没有时间列时保留旧行为(第一列当时间轴,单轴)。
四、MF4 支持(新功能)
- 加载后新建一个分组、组名 = 文件名,文件内全部信号归入该分组。
- 每个通道组(CG)是一条时间轴,内容相同的时间轴自动合并(实测 27 个 CG → 3 条轴 / 124 条信号)。
- 实现 MDF v4 块解析(HD/DG/CG/CN/CC/DT)、1–64 位整数(任意位偏移、含符号扩展)与
32/64 位 IEEE 浮点解码、无效位(inval bit)处理、线性换算 phys = cc_val[0] + cc_val[1]*raw。
- TX 文本块同时兼容规范写法(U32 长度 + UTF-16/UTF-8)与 CANape 的「无长度前缀 NUL 结尾裸文本」。
- 未实现(跳过该组):压缩块 ##DZ/##HL/##SD、##DL 数据列表、字符串/MIME 通道。
五、顺带修复
- Application::Initialize:窗口类已注册(ERROR_CLASS_ALREADY_EXISTS)时复用而不是弹模态错误框
(旧实现让同一进程第二次构造 Application 永久阻塞);Shutdown 注销窗口类并销毁窗口。
- UI 文案统一到「分组」:选中该分组全部信号 / 取消该分组全部信号 / 关闭该分组(从工作区移除)/
请关闭部分分组或信号后重试。/ 尚未加载数据,请打开数据文件 / 打开数据文件以查看波形 /
(可同时加载多个文件,各自成为一个分组);对话框过滤器增加 *.mf4/*.mdf。
六、验证(全部离屏:BELOW_NORMAL 优先级 + SW_HIDE 窗口 + 只注入合成消息)
- 新增 .preflight/perf/datacheck_main.cpp:69/69 通过(单轴 CSV 回归、多时间轴 CSV、MF4 组名/信号数/
时间轴/主时间轴 ns→s/setSpeed 首样本与原始字节人工核对、DataSet 不变量、派生信号沿用源轴、
MF4 集成 124 信号并一格 60~68ms/帧)。
- 新增 .preflight/perf/edgecheck_main.cpp(ASCII-only,替代被编码破坏的 panelcheck):46/46 通过
(「调整」符号规则走真实菜单路径、边沿统计按帧推进/不饿死/逐位一致/无鼠标输入也完成、
面板两列等宽与信号名限宽、弱峰复位控件)。
- 既有 .preflight/perf/verify_main.cpp(已适配新 API):47/47,另有 2 条本机未同步的旧规则断言
(derived offsetTime kept / mouse in lane1 lower half),与本轮无关。
- make clean && make all 零警告。
This commit is contained in:
1 parent
fba40ee1a2
commit
6eedbe3c5d
18 files changed
+2545
-817
No files matched your search
@@ -0,0 +1,33 @@
|
||||
#ifndef __CSV_LOADER_HPP__
|
||||
#define __CSV_LOADER_HPP__
|
||||
|
||||
#include <string>
|
||||
|
||||
#include "DataTable.hpp"
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief 读取并解析一个 CSV 文本文件。
|
||||
*
|
||||
* 文件以分块流式方式读取(不把整个文件一次性读入内存),
|
||||
* 因此内存占用只与解析结果相关,不会因文件体积成倍放大,也没有体积上限。
|
||||
*
|
||||
* **多时间轴**:CSV 允许出现多个时间列(列名形如 `time`)。每个时间列都会开启一个新的
|
||||
* 时间轴块,它**之后**直到下一个时间列之前的所有列都属于该块。
|
||||
* 各块之间的行数可以不一致(较短的时间轴在数据区提前结束,其余位置留空)。
|
||||
* 只出现一个时间列时结果与旧的单时间轴行为完全一致。
|
||||
*
|
||||
* @param [IN] filePath CSV 文件完整路径(宽字符,支持中文路径)。
|
||||
* @param [OUT] source 解析结果(按时间列切分为若干时间轴块)。
|
||||
* @param [OUT] error 失败原因描述(成功时清空)。
|
||||
* @param [IN] progress 解析进度回调,可为空。
|
||||
* @return 解析成功返回 true,否则返回 false。
|
||||
*/
|
||||
bool LoadCsvSource(const std::wstring& filePath, LoadedSource& source, std::wstring& error,
|
||||
const LoadProgress& progress = LoadProgress());
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __CSV_LOADER_HPP__
|
||||
@@ -1,76 +0,0 @@
|
||||
#ifndef __CSV_TABLE_HPP__
|
||||
#define __CSV_TABLE_HPP__
|
||||
|
||||
#include <cstddef>
|
||||
#include <functional>
|
||||
#include <string>
|
||||
#include <vector>
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief CSV 文件的解析结果,保存列名与**列优先**的数值矩阵。
|
||||
*
|
||||
* 采用列优先(每条信号一整块连续内存)而不是行优先的二维数组,原因有二:
|
||||
* 1. 大型文件(百万行级)若按行存储会产生上百万次独立堆分配,
|
||||
* 每行还要额外承担 vector 的控制块与容量对齐开销,实测内存放大接近 1.5 倍;
|
||||
* 2. 后续构建信号时可以直接把整列**移动**进 SignalData,不再逐元素拷贝。
|
||||
*/
|
||||
struct CsvTable
|
||||
{
|
||||
std::vector<std::wstring> headers; /**< 列名(已去除引号与首尾空白)。 */
|
||||
std::vector<std::vector<double>> columns; /**< 列优先数值矩阵:columns[列][行],缺失处为 NaN。 */
|
||||
std::size_t rowCount = 0; /**< 有效数据行数。 */
|
||||
wchar_t delimiter = L','; /**< 实际使用的分隔符。 */
|
||||
unsigned long long fileBytes = 0; /**< 源文件字节数(用于按比例预留容量)。 */
|
||||
|
||||
/**
|
||||
* @brief 判断解析结果是否包含可用的表格数据。
|
||||
* @return 存在列名且存在数据行时返回 true。
|
||||
*/
|
||||
bool HasData() const
|
||||
{
|
||||
return !headers.empty() && (rowCount > 0);
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 加载进度信息。
|
||||
*
|
||||
* 解析阶段会携带真实的"已读 / 总字节数";列重组与统计阶段没有字节可计,
|
||||
* 此时 `hasBytes` 为 false,界面应只展示百分比。
|
||||
*/
|
||||
struct CsvProgressInfo
|
||||
{
|
||||
double ratio = 0.0; /**< 0-1 总体完成比例。 */
|
||||
unsigned long long bytesRead = 0; /**< 已读取字节数。 */
|
||||
unsigned long long totalBytes = 0; /**< 文件总字节数。 */
|
||||
bool hasBytes = false; /**< 上述字节数字段是否有效。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 解析进度回调。
|
||||
*
|
||||
* 在解析过程中按块回调;返回 false 表示请求取消,解析会尽快停止并返回失败。
|
||||
*/
|
||||
using CsvProgress = std::function<bool(const CsvProgressInfo& info)>;
|
||||
|
||||
/**
|
||||
* @brief 读取并解析一个 CSV 文件。
|
||||
*
|
||||
* 文件以分块流式方式读取(不把整个文件一次性读入内存),
|
||||
* 因此内存占用只与解析结果相关,不会因文件体积成倍放大,也没有体积上限。
|
||||
*
|
||||
* @param [IN] filePath CSV 文件完整路径(宽字符,支持中文路径)。
|
||||
* @param [OUT] table 解析结果输出。
|
||||
* @param [OUT] error 失败原因描述(成功时清空)。
|
||||
* @param [IN] progress 解析进度回调,可为空。
|
||||
* @return 解析成功返回 true,否则返回 false。
|
||||
*/
|
||||
bool LoadCsvTable(const std::wstring& filePath, CsvTable& table, std::wstring& error,
|
||||
const CsvProgress& progress = CsvProgress());
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __CSV_TABLE_HPP__
|
||||
@@ -0,0 +1,45 @@
|
||||
#ifndef __DATA_LOADER_HPP__
|
||||
#define __DATA_LOADER_HPP__
|
||||
|
||||
#include <string>
|
||||
|
||||
#include "DataTable.hpp"
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief 判断路径是否为应用当前支持的测量文件(按扩展名判断,不访问文件内容)。
|
||||
* @param [IN] filePath 文件路径。
|
||||
* @return 支持返回 true。
|
||||
*/
|
||||
bool IsSupportedSignalFile(const std::wstring& filePath);
|
||||
|
||||
/**
|
||||
* @brief 供「打开文件」对话框使用的过滤器文本(`GetOpenFileNameW` 的 `lpstrFilter` 格式)。
|
||||
* @return 双 NUL 结尾的过滤器文本。
|
||||
*/
|
||||
const wchar_t* SignalFileDialogFilter();
|
||||
|
||||
/**
|
||||
* @brief 按扩展名选择加载器并读入一个测量文件(**唯一的文件加载入口**)。
|
||||
*
|
||||
* 上层(数据模型与界面)只依赖本函数返回的 `LoadedSource`,因此新增格式时
|
||||
* **只需新增一个加载器并在这里登记**,其余代码完全不用改。
|
||||
*
|
||||
* 当前支持的格式:
|
||||
* * CSV 文本(`.csv` / `.txt`):支持多个 `time` 列(多时间轴)与各时间轴不等长;
|
||||
* * ASAM MDF v4(`.mf4` / `.mdf`):每个通道组(CG)是一个时间轴。
|
||||
*
|
||||
* @param [IN] filePath 文件完整路径。
|
||||
* @param [OUT] source 解析结果(若干时间轴块)。
|
||||
* @param [OUT] error 失败原因描述(成功时清空)。
|
||||
* @param [IN] progress 进度回调,可为空。
|
||||
* @return 加载成功返回 true。
|
||||
*/
|
||||
bool LoadSignalSource(const std::wstring& filePath, LoadedSource& source, std::wstring& error,
|
||||
const LoadProgress& progress = LoadProgress());
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __DATA_LOADER_HPP__
|
||||
+210
-105
@@ -9,7 +9,8 @@
|
||||
#include <atomic>
|
||||
#include <vector>
|
||||
|
||||
#include "CsvTable.hpp"
|
||||
#include "DataLoader.hpp"
|
||||
#include "DataTable.hpp"
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
@@ -61,18 +62,23 @@ namespace jdi
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 全局信号引用:文件下标 + 文件内信号下标。
|
||||
* @brief 全局信号引用:**分组下标 + 组内信号下标**。
|
||||
*
|
||||
* ⚠️ 这里的「分组」是信号在应用内的**逻辑归属**(加载一个文件形成一个分组,
|
||||
* 用户可以重命名),与磁盘上的文件**没有任何关系**:文件可以在加载后被移动、
|
||||
* 重命名甚至删除,已加载的数据不受影响。因此引用只由两个下标构成,
|
||||
* 不携带路径等易失效的信息。
|
||||
*/
|
||||
struct SignalRef
|
||||
{
|
||||
int fileIndex = -1; /**< 所属文件下标。 */
|
||||
int signalIndex = -1; /**< 文件内信号下标。 */
|
||||
int groupIndex = -1; /**< 所属分组下标。 */
|
||||
int signalIndex = -1; /**< 组内信号下标。 */
|
||||
|
||||
/**
|
||||
* @brief 判断引用是否指向有效位置。
|
||||
* @return 两个下标均非负返回 true。
|
||||
*/
|
||||
bool IsValid() const { return fileIndex >= 0 && signalIndex >= 0; }
|
||||
bool IsValid() const { return groupIndex >= 0 && signalIndex >= 0; }
|
||||
|
||||
/**
|
||||
* @brief 相等比较。
|
||||
@@ -81,7 +87,7 @@ namespace jdi
|
||||
*/
|
||||
bool operator==(const SignalRef& other) const
|
||||
{
|
||||
return fileIndex == other.fileIndex && signalIndex == other.signalIndex;
|
||||
return groupIndex == other.groupIndex && signalIndex == other.signalIndex;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -261,15 +267,42 @@ namespace jdi
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 一条时间轴(时间向量 + 它的取值范围与单调性)。
|
||||
*
|
||||
* 时间轴**独立于信号**:同一分组内多条信号可以共用同一条时间轴(最常见的 CSV 单时间轴文件、
|
||||
* MF4 里同一通道组内的全部通道),也可以各自使用不同的时间轴(多 `time` 列的 CSV、
|
||||
* MF4 的不同通道组)。
|
||||
*/
|
||||
struct TimeAxis
|
||||
{
|
||||
std::wstring name; /**< 时间列名(源文件中的原样名称,如 `time`)。 */
|
||||
std::vector<double> time; /**< 时间数值,缺失处为 NaN。 */
|
||||
double minTime = 0.0; /**< 有限时间最小值。 */
|
||||
double maxTime = 0.0; /**< 有限时间最大值。 */
|
||||
bool monotonic = true; /**< 时间是否单调不减(决定能否用下标区间做二分)。 */
|
||||
std::size_t finiteCount = 0; /**< 有效时间点数量。 */
|
||||
|
||||
/** @brief 时间点数量。 */
|
||||
std::size_t Count() const { return time.size(); }
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 单条信号的元数据与采样值(纯数据,不含可见性配置)。
|
||||
*
|
||||
* ⚠️ 信号**只有两个名字字段,各有明确职责**,不要再引入第三个:
|
||||
* * `name` —— 源名称(列名 / 通道名),加载后**原样保留、永不修改**;
|
||||
* * `displayName` —— 用户在界面上重命名后的名称,为空表示“用源名称”。
|
||||
* 界面展示一律走 `Title()`。
|
||||
*
|
||||
* ⚠️ 信号的时间轴由 `axisIndex` 指向所属分组的时间轴列表,
|
||||
* 因此采样值本身不需要、也不应该携带时间信息。
|
||||
*/
|
||||
struct SignalData
|
||||
{
|
||||
std::wstring name; /**< 名称(取自文件列名,完全保留原样)。 */
|
||||
std::wstring displayName; /**< 用户重命名的显示名;为空时使用 name。 */
|
||||
std::wstring rawHeader; /**< 原始列名。 */
|
||||
std::wstring unit; /**< 从列名括号中提取的单位,可能为空。 */
|
||||
std::wstring name; /**< 源名称(列名 / 通道名,原样保留)。 */
|
||||
std::wstring displayName; /**< 用户重命名后的显示名;为空时使用 name。 */
|
||||
std::size_t axisIndex = 0; /**< 所属时间轴在分组内的下标。 */
|
||||
std::vector<double> values; /**< 采样值,缺失处为 NaN。 */
|
||||
double minValue = 0.0; /**< 有限采样值最小值。 */
|
||||
double maxValue = 0.0; /**< 有限采样值最大值。 */
|
||||
@@ -292,89 +325,154 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 获取用于界面展示的名称。
|
||||
* @return 用户重命名后的显示名,未重命名时返回文件中的原始名称。
|
||||
* @return 用户重命名后的显示名,未重命名时返回源名称。
|
||||
*/
|
||||
const std::wstring& Title() const { return displayName.empty() ? name : displayName; }
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 一个已加载的数据文件及其自有时间轴。
|
||||
* @brief 一个**信号分组**:一次加载产生的全部信号,以及它们使用的若干条时间轴。
|
||||
*
|
||||
* ⚠️ 「分组」是应用内的逻辑容器,**不是文件**:加载完成后二者已无关系,
|
||||
* 因此这里**不保存文件路径**(路径只在加载那一刻用于错误提示,之后毫无用处)。
|
||||
* 分组的默认名称取源文件名(便于用户辨认来源),用户可以重命名。
|
||||
*
|
||||
* 一个分组可以包含**多条时间轴**(CSV 的多个 `time` 列、MF4 的多个通道组),
|
||||
* 每条信号通过 `SignalData::axisIndex` 指向自己那条。
|
||||
*/
|
||||
struct DataFile
|
||||
struct SignalGroup
|
||||
{
|
||||
std::wstring filePath; /**< 文件完整路径(仅用于状态提示)。 */
|
||||
std::wstring fileName; /**< 文件名称。 */
|
||||
std::wstring displayName; /**< 用户重命名的分组名;为空时使用 fileName。 */
|
||||
std::wstring timeColumnName; /**< 时间列列名。 */
|
||||
std::vector<double> time; /**< 时间轴数值。 */
|
||||
std::vector<SignalData> signals; /**< 该文件包含的信号。 */
|
||||
double minTime = 0.0; /**< 时间轴最小值。 */
|
||||
double maxTime = 0.0; /**< 时间轴最大值。 */
|
||||
bool timeMonotonic = true; /**< 时间轴是否单调不减。 */
|
||||
std::wstring name; /**< 分组默认名称(源文件名,含扩展名)。 */
|
||||
std::wstring displayName; /**< 用户重命名后的分组名;为空时使用 name。 */
|
||||
std::vector<TimeAxis> axes; /**< 该分组使用的时间轴(至少一条)。 */
|
||||
std::vector<SignalData> signals; /**< 该分组包含的信号。 */
|
||||
|
||||
/**
|
||||
* @brief 获取用于界面展示的分组名。
|
||||
* @return 用户重命名后的显示名,未重命名时返回文件名。
|
||||
* @return 用户重命名后的显示名,未重命名时返回源文件名。
|
||||
*/
|
||||
const std::wstring& Title() const { return displayName.empty() ? fileName : displayName; }
|
||||
const std::wstring& Title() const { return displayName.empty() ? name : displayName; }
|
||||
|
||||
/**
|
||||
* @brief 取某条信号所属的时间轴(下标越界时回退到第一条,保证永不返回悬空引用)。
|
||||
* @param [IN] signal 目标信号。
|
||||
* @return 时间轴引用;分组没有任何时间轴时返回内部静态空时间轴。
|
||||
*/
|
||||
const TimeAxis& AxisOf(const SignalData& signal) const
|
||||
{
|
||||
return AxisAt(signal.axisIndex);
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 按下标取时间轴(越界时回退到第一条)。
|
||||
* @param [IN] index 时间轴下标。
|
||||
* @return 时间轴引用。
|
||||
*/
|
||||
const TimeAxis& AxisAt(std::size_t index) const
|
||||
{
|
||||
static const TimeAxis kEmptyAxis;
|
||||
if (axes.empty())
|
||||
{
|
||||
return kEmptyAxis;
|
||||
}
|
||||
return axes[(index < axes.size()) ? index : 0];
|
||||
}
|
||||
|
||||
/**
|
||||
* @brief 计算本分组全部时间轴的时间范围并集。
|
||||
* @param [OUT] low 下限。 @param [OUT] high 上限。
|
||||
* @return 至少有一条时间轴有有效时间返回 true。
|
||||
*/
|
||||
bool TimeRange(double& low, double& high) const
|
||||
{
|
||||
low = 0.0;
|
||||
high = 0.0;
|
||||
bool valid = false;
|
||||
for (const TimeAxis& axis : axes)
|
||||
{
|
||||
if (axis.finiteCount == 0)
|
||||
{
|
||||
continue;
|
||||
}
|
||||
if (!valid)
|
||||
{
|
||||
low = axis.minTime;
|
||||
high = axis.maxTime;
|
||||
valid = true;
|
||||
}
|
||||
else
|
||||
{
|
||||
low = std::min(low, axis.minTime);
|
||||
high = std::max(high, axis.maxTime);
|
||||
}
|
||||
}
|
||||
return valid;
|
||||
}
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 由 CSV 解析结果构建可入库的数据文件。
|
||||
* @brief 由一个**格式无关**的加载结果构建应用内的信号分组。
|
||||
*
|
||||
* 该函数**不访问 DataSet**(只依赖传入的 CsvTable 与调色板基准序号),
|
||||
* 因此可以在工作线程上执行:大文件的解析与列重组占整个加载耗时的大头,
|
||||
* 放到工作线程后主线程只需做一次 O(1) 的移动入队,加载过程中的界面不会卡住。
|
||||
* 职责划分(新增文件格式时只需要写一个加载器,本函数完全不用改):
|
||||
* * 加载器:文件 → `LoadedSource`(若干「时间轴块」,纯格子,无应用语义);
|
||||
* * 本函数:`LoadedSource` → `SignalGroup`(时间轴**去重合并**、信号命名、
|
||||
* 调色板取色、统计与粗粒度包络层)。
|
||||
*
|
||||
* table 按右值传入:每列会被**移动**进对应信号的 values(零拷贝)。
|
||||
* 时间轴去重:内容完全相同(长度与全部数值逐位相同)的时间轴只保留一条,
|
||||
* 于是 CSV 里多个同刻度的 `time` 列、MF4 里多个同基线的通道组不会重复占内存,
|
||||
* 也不会让信号各自持有实质上相同的轴。
|
||||
*
|
||||
* @param [IN,OUT] table CSV 解析结果(列会被移走)。
|
||||
* @param [IN] filePath 源文件路径。
|
||||
* 该函数**不访问 DataSet**(只依赖传入数据与调色板基准序号),因此可以在工作线程上执行:
|
||||
* 大文件的解析与列重组占整个加载耗时的大头,放到工作线程后主线程只需做一次 O(1) 的
|
||||
* 移动入队,加载过程中的界面不会卡住。
|
||||
*
|
||||
* @param [IN,OUT] source 加载结果(列会被**移动**进信号,零拷贝)。
|
||||
* @param [IN] paletteBase 调色板起始序号(通常传入当前已有信号数)。
|
||||
* @param [OUT] file 构建结果。
|
||||
* @param [OUT] group 构建结果。
|
||||
* @param [OUT] error 失败原因描述(成功时清空)。
|
||||
* @param [IN] progress 进度回调(0-1),返回 false 表示取消,可为空。
|
||||
* @return 构建成功返回 true。
|
||||
*/
|
||||
bool BuildDataFile(CsvTable&& table, const std::wstring& filePath, std::size_t paletteBase, DataFile& file,
|
||||
std::wstring& error, const CsvProgress& progress = CsvProgress());
|
||||
bool BuildSignalGroup(LoadedSource&& source, std::size_t paletteBase, SignalGroup& group,
|
||||
std::wstring& error, const LoadProgress& progress = LoadProgress());
|
||||
|
||||
/**
|
||||
* @brief 数据集合:统一管理全部已加载文件,与视图配置无关。
|
||||
* @brief 数据集合:统一管理全部已加载的**信号分组**,与视图配置无关。
|
||||
*/
|
||||
class DataSet
|
||||
{
|
||||
public:
|
||||
/**
|
||||
* @brief 追加一个已构建好的数据文件(仅做一次移动,不拷贝采样数据)。
|
||||
* @param [IN,OUT] file 数据文件(内部缓冲会被移走)。
|
||||
* @param [OUT] fileIndex 新文件下标。
|
||||
* @brief 追加一个已构建好的信号分组(仅做一次移动,不拷贝采样数据)。
|
||||
* @param [IN,OUT] group 信号分组(内部缓冲会被移走)。
|
||||
* @param [OUT] groupIndex 新分组下标。
|
||||
* @return 追加成功返回 true。
|
||||
*/
|
||||
bool AddDataFile(DataFile&& file, int& fileIndex);
|
||||
bool AddGroup(SignalGroup&& group, int& groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 在指定文件的指定信号**下方**插入一条新信号(派生信号)。
|
||||
* @brief 在指定分组的指定信号**下方**插入一条新信号(派生信号)。
|
||||
*
|
||||
* 新信号会占据 `afterSignalIndex + 1` 的位置,该位置及其后的信号下标整体后移一位;
|
||||
* 调用方必须紧接着对每个标签页调用 `TabConfig::RemapAfterSignalInsert()` 修正引用。
|
||||
* 采样值会被就地统计(min/max/finiteCount 与粗粒度包络层),显示外观按「全局信号序号」
|
||||
* 取调色板颜色(与普通新信号一致)。
|
||||
*
|
||||
* @param [IN] fileIndex 目标文件下标。
|
||||
* @param [IN] groupIndex 目标分组下标。
|
||||
* @param [IN] afterSignalIndex 插入位置的上一条信号下标。
|
||||
* @param [IN,OUT] signal 待插入的信号(values 会被统计,其余字段原样使用)。
|
||||
* @param [OUT] newSignalIndex 新信号在本文件内的下标。
|
||||
* @param [OUT] newSignalIndex 新信号在本组内的下标。
|
||||
* @return 插入成功返回 true。
|
||||
*/
|
||||
bool InsertDerivedSignal(int fileIndex, int afterSignalIndex, SignalData&& signal, int& newSignalIndex);
|
||||
bool InsertDerivedSignal(int groupIndex, int afterSignalIndex, SignalData&& signal,
|
||||
int& newSignalIndex);
|
||||
|
||||
/**
|
||||
* @brief 移除指定下标的文件,并立即释放其占用的全部采样内存。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @brief 移除指定下标的分组,并立即释放其占用的全部采样内存。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 移除成功返回 true。
|
||||
*/
|
||||
bool RemoveFile(int fileIndex);
|
||||
bool RemoveGroup(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 从某个分组中移除一条信号,并立即释放它的采样内存。
|
||||
@@ -383,30 +481,30 @@ namespace jdi
|
||||
* `TabConfig::RemapAfterSignalRemoval()`,并用 `RemapSelectionAfterSignalRemoval()`
|
||||
* 修正共享选中项。使用者一旦确认不再需要该信号即可调用,本调用后其采样缓冲立即析构。
|
||||
*
|
||||
* @param [IN] fileIndex 信号所属文件下标。
|
||||
* @param [IN] signalIndex 文件内信号下标。
|
||||
* @param [IN] groupIndex 信号所属分组下标。
|
||||
* @param [IN] signalIndex 组内信号下标。
|
||||
* @return 移除成功返回 true。
|
||||
*/
|
||||
bool RemoveSignal(int fileIndex, int signalIndex);
|
||||
bool RemoveSignal(int groupIndex, int signalIndex);
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某条信号之前,按旧下标修正选中引用。
|
||||
* @param [IN] fileIndex 信号所属文件下标。
|
||||
* @param [IN] groupIndex 信号所属分组下标。
|
||||
* @param [IN] signalIndex 即将被移除的信号下标。
|
||||
*/
|
||||
void RemapSelectionAfterSignalRemoval(int fileIndex, int signalIndex);
|
||||
void RemapSelectionAfterSignalRemoval(int groupIndex, int signalIndex);
|
||||
|
||||
/**
|
||||
* @brief 判断数据集合是否为空。
|
||||
* @return 未加载任何文件返回 true。
|
||||
* @return 未加载任何分组返回 true。
|
||||
*/
|
||||
bool Empty() const { return m_files.empty(); }
|
||||
bool Empty() const { return m_groups.empty(); }
|
||||
|
||||
/**
|
||||
* @brief 获取文件数量。
|
||||
* @return 文件数量。
|
||||
* @brief 获取分组数量。
|
||||
* @return 分组数量。
|
||||
*/
|
||||
std::size_t FileCount() const { return m_files.size(); }
|
||||
std::size_t GroupCount() const { return m_groups.size(); }
|
||||
|
||||
/**
|
||||
* @brief 获取信号总数。
|
||||
@@ -415,34 +513,34 @@ namespace jdi
|
||||
std::size_t SignalCount() const;
|
||||
|
||||
/**
|
||||
* @brief 获取全部文件(只读)。
|
||||
* @return 文件集合。
|
||||
* @brief 获取全部分组(只读)。
|
||||
* @return 分组集合。
|
||||
*/
|
||||
const std::vector<DataFile>& Files() const { return m_files; }
|
||||
const std::vector<SignalGroup>& Groups() const { return m_groups; }
|
||||
|
||||
/**
|
||||
* @brief 按下标获取文件。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @return 文件指针,下标非法时返回 nullptr。
|
||||
* @brief 按下标获取分组。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 分组指针,下标非法时返回 nullptr。
|
||||
*/
|
||||
const DataFile* FileAt(int fileIndex) const;
|
||||
const SignalGroup* GroupAt(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 修改某个信号在界面上的显示名称。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] signalIndex 文件内信号下标。
|
||||
* @param [IN] name 新的显示名;传入空串表示恢复使用原始列名。
|
||||
* @brief 修改某条信号在界面上的显示名称。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @param [IN] signalIndex 组内信号下标。
|
||||
* @param [IN] name 新的显示名;传入空串表示恢复使用源名称。
|
||||
* @return 修改成功返回 true。
|
||||
*/
|
||||
bool SetSignalDisplayName(int fileIndex, int signalIndex, const std::wstring& name);
|
||||
bool SetSignalDisplayName(int groupIndex, int signalIndex, const std::wstring& name);
|
||||
|
||||
/**
|
||||
* @brief 修改某个文件分组的显示名称。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] name 新的分组名;传入空串表示恢复使用文件名。
|
||||
* @brief 修改某个分组的显示名称。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @param [IN] name 新的分组名;传入空串表示恢复使用默认名称。
|
||||
* @return 修改成功返回 true。
|
||||
*/
|
||||
bool SetFileDisplayName(int fileIndex, const std::wstring& name);
|
||||
bool SetGroupDisplayName(int groupIndex, const std::wstring& name);
|
||||
|
||||
/**
|
||||
* @brief 解析信号引用。
|
||||
@@ -451,6 +549,13 @@ namespace jdi
|
||||
*/
|
||||
const SignalData* Resolve(const SignalRef& ref) const;
|
||||
|
||||
/**
|
||||
* @brief 取某条信号所属的时间轴。
|
||||
* @param [IN] ref 信号引用。
|
||||
* @return 时间轴指针,引用无效时返回 nullptr。
|
||||
*/
|
||||
const TimeAxis* Axis(const SignalRef& ref) const;
|
||||
|
||||
/**
|
||||
* @brief 获取指定信号的显示外观(只读)。
|
||||
* @param [IN] ref 信号引用。
|
||||
@@ -466,13 +571,13 @@ namespace jdi
|
||||
SignalStyle* Style(const SignalRef& ref);
|
||||
|
||||
/**
|
||||
* @brief 计算全部文件时间范围的并集下限。
|
||||
* @brief 计算全部分组、全部时间轴时间范围的并集下限。
|
||||
* @return 时间下限。
|
||||
*/
|
||||
double MinTime() const;
|
||||
|
||||
/**
|
||||
* @brief 计算全部文件时间范围的并集上限。
|
||||
* @brief 计算全部分组、全部时间轴时间范围的并集上限。
|
||||
* @return 时间上限。
|
||||
*/
|
||||
double MaxTime() const;
|
||||
@@ -490,10 +595,10 @@ namespace jdi
|
||||
void SetSelected(const SignalRef& ref) { m_selected = ref; }
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某文件之前,按旧下标修正选中引用。
|
||||
* @param [IN] fileIndex 即将被移除的文件下标。
|
||||
* @brief 在数据层移除某分组之前,按旧下标修正选中引用。
|
||||
* @param [IN] groupIndex 即将被移除的分组下标。
|
||||
*/
|
||||
void RemapSelectionAfterFileRemoval(int fileIndex);
|
||||
void RemapSelectionAfterGroupRemoval(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 校验选中引用是否仍指向存在的信号,失效则取消选中。
|
||||
@@ -502,8 +607,8 @@ namespace jdi
|
||||
bool ValidateSelection();
|
||||
|
||||
private:
|
||||
std::vector<DataFile> m_files; /**< 已加载文件集合。 */
|
||||
SignalRef m_selected; /**< 当前选中信号(跨标签页共享)。 */
|
||||
std::vector<SignalGroup> m_groups; /**< 已加载信号分组集合。 */
|
||||
SignalRef m_selected; /**< 当前选中信号(跨标签页共享)。 */
|
||||
};
|
||||
|
||||
/**
|
||||
@@ -712,14 +817,14 @@ namespace jdi
|
||||
*
|
||||
* 加载完成后全部采样值已在内存中,本函数只查询内存数据,与源文件无关。
|
||||
*
|
||||
* @param [IN] file 信号所属的已加载数据分组(提供时间轴)。
|
||||
* @param [IN] axis 该信号使用的时间轴。
|
||||
* @param [IN] signal 目标信号。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @param [IN] interpolate 是否在相邻采样点之间做线性插值。
|
||||
* @param [OUT] value 输出采样值,缺失时为 NaN。
|
||||
* @return 时间点落在数据范围内且取到有效值返回 true。
|
||||
*/
|
||||
bool SampleSignalAt(const DataFile& file, const SignalData& signal, double time, bool interpolate,
|
||||
bool SampleSignalAt(const TimeAxis& axis, const SignalData& signal, double time, bool interpolate,
|
||||
double& value);
|
||||
|
||||
/**
|
||||
@@ -732,15 +837,15 @@ namespace jdi
|
||||
* 否则读数会与看到的波形不一致。
|
||||
* ⚠️ 系数 / 绝对值 / 垂直镜像 / `offsetY` 不在这里处理,由 `ApplyDrawTransform` 负责。
|
||||
*
|
||||
* @param [IN] file 信号所属的已加载数据分组(提供时间轴)。
|
||||
* @param [IN] axis 该信号使用的时间轴。
|
||||
* @param [IN] signal 目标信号。
|
||||
* @param [IN] style 显示外观(只用 `mirrorHorizontal`)。
|
||||
* @param [IN] style 显示外观(只用 `mirrorHorizontal` 与 `offsetTime`)。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @param [IN] interpolate 是否在相邻采样点之间做线性插值。
|
||||
* @param [OUT] value 输出采样值,缺失时为 NaN。
|
||||
* @return 时间点落在数据范围内且取到有效值返回 true。
|
||||
*/
|
||||
bool SampleDisplayedSignalAt(const DataFile& file, const SignalData& signal,
|
||||
bool SampleDisplayedSignalAt(const TimeAxis& axis, const SignalData& signal,
|
||||
const SignalStyle& style, double time, bool interpolate, double& value);
|
||||
|
||||
/**
|
||||
@@ -827,12 +932,12 @@ namespace jdi
|
||||
bool throttle = false);
|
||||
|
||||
/**
|
||||
* @brief 在指定文件的时间轴上查找与给定时刻最接近的采样点。
|
||||
* @param [IN] file 目标文件。
|
||||
* @brief 在给定时间轴上查找与给定时刻最接近的采样点。
|
||||
* @param [IN] axis 目标时间轴。
|
||||
* @param [IN] time 采样时刻。
|
||||
* @return 采样点下标,文件为空时返回 -1。
|
||||
* @return 采样点下标,时间轴为空时返回 -1。
|
||||
*/
|
||||
int FindNearestSample(const DataFile& file, double time);
|
||||
int FindNearestSample(const TimeAxis& axis, double time);
|
||||
|
||||
/**
|
||||
* @brief 单个标签页的独立视图配置(信号可见性、网格划分与视图范围)。
|
||||
@@ -865,10 +970,10 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某文件之前,按旧下标修正本配置(不重建网格)。
|
||||
* @param [IN] fileIndex 即将被移除的文件下标。
|
||||
* @note 调用顺序必须为:各标签页 RemapAfterFileRemoval → 数据层 RemoveFile → 各标签页 SyncToDataSet。
|
||||
* @param [IN] groupIndex 即将被移除的分组下标。
|
||||
* @note 调用顺序必须为:各标签页 RemapAfterGroupRemoval → 数据层 RemoveFile → 各标签页 SyncToDataSet。
|
||||
*/
|
||||
void RemapAfterFileRemoval(int fileIndex);
|
||||
void RemapAfterGroupRemoval(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 在数据层移除某条信号之前,按旧下标修正本配置(不重建网格)。
|
||||
@@ -876,12 +981,12 @@ namespace jdi
|
||||
* 会删除该信号的可见性记录与网格归属,并把同一文件内位于其后的引用下标前移一位。
|
||||
* 若某个网格因此变空则一并移除(与“取消勾选后空网格消失”的策略一致)。
|
||||
*
|
||||
* @param [IN] fileIndex 信号所属文件下标。
|
||||
* @param [IN] groupIndex 信号所属分组下标。
|
||||
* @param [IN] signalIndex 即将被移除的信号下标。
|
||||
* @note 调用顺序必须为:各标签页 RemapAfterSignalRemoval → 数据层修正选中 →
|
||||
* 数据层 RemoveSignal → 各标签页 SyncToDataSet。
|
||||
*/
|
||||
void RemapAfterSignalRemoval(int fileIndex, int signalIndex);
|
||||
void RemapAfterSignalRemoval(int groupIndex, int signalIndex);
|
||||
|
||||
/**
|
||||
* @brief 判断指定信号是否可见。
|
||||
@@ -905,10 +1010,10 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 设置某个文件全部信号的可见性,并同步网格划分。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @param [IN] visible 目标可见状态。
|
||||
*/
|
||||
void SetFileVisible(int fileIndex, bool visible);
|
||||
void SetGroupVisible(int groupIndex, bool visible);
|
||||
|
||||
/**
|
||||
* @brief 设置全部信号可见性,并同步网格划分。
|
||||
@@ -924,17 +1029,17 @@ namespace jdi
|
||||
|
||||
/**
|
||||
* @brief 判断某文件是否存在可见信号。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 存在可见信号返回 true。
|
||||
*/
|
||||
bool FileHasVisible(int fileIndex) const;
|
||||
bool GroupHasVisible(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 判断某文件是否全部信号可见。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 全部可见且至少有一条信号返回 true。
|
||||
*/
|
||||
bool FileAllVisible(int fileIndex) const;
|
||||
bool GroupAllVisible(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 判断是否存在任何可见信号。
|
||||
@@ -1010,10 +1115,10 @@ namespace jdi
|
||||
* 数据层在下标 `insertPos` 处插入了一条信号,因此本页可见性表需插入一列,
|
||||
* 且所有指向该文件、下标不小于 `insertPos` 的信号引用都要后移一位。
|
||||
*
|
||||
* @param [IN] fileIndex 发生插入的文件下标。
|
||||
* @param [IN] groupIndex 发生插入的分组下标。
|
||||
* @param [IN] insertPos 新信号的下标。
|
||||
*/
|
||||
void RemapAfterSignalInsert(int fileIndex, int insertPos);
|
||||
void RemapAfterSignalInsert(int groupIndex, int insertPos);
|
||||
|
||||
/**
|
||||
* @brief 把某信号所在的网格移动到另一信号所在网格的下方(紧邻其后)。
|
||||
@@ -1046,16 +1151,16 @@ namespace jdi
|
||||
void RenameLanes();
|
||||
|
||||
/** * @brief 查询某文件的分组是否处于折叠状态。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
* @return 折叠状态。
|
||||
*/
|
||||
bool IsCollapsed(int fileIndex) const;
|
||||
bool IsCollapsed(int groupIndex) const;
|
||||
|
||||
/**
|
||||
* @brief 切换某文件分组的折叠状态。
|
||||
* @param [IN] fileIndex 文件下标。
|
||||
* @param [IN] groupIndex 分组下标。
|
||||
*/
|
||||
void ToggleCollapsed(int fileIndex);
|
||||
void ToggleCollapsed(int groupIndex);
|
||||
|
||||
/**
|
||||
* @brief 设置「新出现的文件分组是否默认折起」。
|
||||
|
||||
@@ -0,0 +1,101 @@
|
||||
#ifndef __DATA_TABLE_HPP__
|
||||
#define __DATA_TABLE_HPP__
|
||||
|
||||
#include <cstddef>
|
||||
#include <functional>
|
||||
#include <string>
|
||||
#include <vector>
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief 内存中的**列优先**数据表(与具体文件格式无关)。
|
||||
*
|
||||
* 这是「从任意格式读出来的原始格子」:一行是表头,其余是各列的数值。
|
||||
* 它**不是**应用的数据模型(不含时间轴语义、不含信号名规范化),
|
||||
* 只是各格式加载器(CSV / MF4 / 以后更多格式)与数据模型之间的中转结构。
|
||||
*
|
||||
* 采用列优先(每列一整块连续内存)而不是行优先的二维数组,原因有二:
|
||||
* 1. 大型文件(百万行级)若按行存储会产生上百万次独立堆分配,
|
||||
* 每行还要额外承担 vector 的控制块与容量对齐开销,实测内存放大接近 1.5 倍;
|
||||
* 2. 构建信号时可以直接把整列**移动**进 `SignalData`,不再逐元素拷贝。
|
||||
*/
|
||||
struct DataTable
|
||||
{
|
||||
std::vector<std::wstring> headers; /**< 列名(已去除引号与首尾空白)。 */
|
||||
std::vector<std::vector<double>> columns; /**< 列优先数值矩阵:columns[列][行],缺失处为 NaN。 */
|
||||
std::size_t rowCount = 0; /**< 有效数据行数。 */
|
||||
wchar_t delimiter = L','; /**< 实际使用的分隔符(仅文本格式有意义)。 */
|
||||
unsigned long long sourceBytes = 0; /**< 源文件字节数(用于按比例预留容量)。 */
|
||||
|
||||
/**
|
||||
* @brief 判断解析结果是否包含可用的表格数据。
|
||||
* @return 存在列名且存在数据行时返回 true。
|
||||
*/
|
||||
bool HasData() const { return !headers.empty() && (rowCount > 0) && (columns.size() >= headers.size()); }
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 加载进度信息。
|
||||
*
|
||||
* 解析阶段会携带真实的"已读 / 总字节数";列重组与统计阶段没有字节可计,
|
||||
* 此时 `hasBytes` 为 false,界面应只展示百分比。
|
||||
*/
|
||||
struct LoadProgressInfo
|
||||
{
|
||||
double ratio = 0.0; /**< 0-1 总体完成比例。 */
|
||||
unsigned long long bytesRead = 0; /**< 已读取字节数。 */
|
||||
unsigned long long totalBytes = 0; /**< 文件总字节数。 */
|
||||
bool hasBytes = false; /**< 上述字节数字段是否有效。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 加载进度回调。
|
||||
*
|
||||
* 在解析过程中按块回调;返回 false 表示请求取消,解析会尽快停止并返回失败。
|
||||
*/
|
||||
using LoadProgress = std::function<bool(const LoadProgressInfo& info)>;
|
||||
|
||||
/**
|
||||
* @brief 一组**共享同一时间轴**的数据列(一个「时间轴块」)。
|
||||
*
|
||||
* 一个源文件可以包含多个这样的块:CSV 里每个 `time` 列都会开启一个新块,
|
||||
* MF4 里每个测量通道组(CG)是一个块。块内的各列长度一致(都等于本块的行数)。
|
||||
*/
|
||||
struct TableBlock
|
||||
{
|
||||
std::wstring timeHeader; /**< 本块时间列的列名(原样保留,如 `time`)。 */
|
||||
DataTable table; /**< 本块的列集合(**含**时间列本身)。 */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief 一个源文件加载后的全部内容(可能包含多个时间轴块)。
|
||||
*
|
||||
* ⚠️ 这是「加载器 → 数据模型」的唯一接口:加载器只负责把文件读成
|
||||
* `LoadedSource`(纯格子,无应用语义),`BuildSignalGroup` 再把它规范化为
|
||||
* `SignalGroup`(含时间轴去重、信号命名、调色板等应用语义)。
|
||||
* 新增文件格式时**只需新增一个加载器**,数据模型与界面代码完全不用改。
|
||||
*/
|
||||
struct LoadedSource
|
||||
{
|
||||
std::wstring sourceName; /**< 源文件名(不含目录,含扩展名)。 */
|
||||
std::vector<TableBlock> blocks; /**< 时间轴块集合(至少一个)。 */
|
||||
|
||||
/** @brief 是否包含可用的数据。 */
|
||||
bool HasData() const
|
||||
{
|
||||
for (const TableBlock& block : blocks)
|
||||
{
|
||||
if (block.table.HasData())
|
||||
{
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
};
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __DATA_TABLE_HPP__
|
||||
@@ -0,0 +1,36 @@
|
||||
#ifndef __MF4_LOADER_HPP__
|
||||
#define __MF4_LOADER_HPP__
|
||||
|
||||
#include <string>
|
||||
|
||||
#include "DataTable.hpp"
|
||||
|
||||
namespace jdi
|
||||
{
|
||||
|
||||
/**
|
||||
* @brief 读取并解析一个 ASAM MDF v4(`.mf4` / `.mdf`)测量文件。
|
||||
*
|
||||
* 只解析**绘制需要的那部分**:头块版本、数据组(DG)→ 通道组(CG)→ 通道(CN)/换算(CC),
|
||||
* 以及每个通道组的原始记录;字符串/字节数组通道、压缩数据块(DZ/HZ)与 MIME 通道一律跳过。
|
||||
*
|
||||
* **时间轴**:MDF 的每个通道组(CG)自带一个时间基准。本加载器把每个 CG 输出为一个
|
||||
* 时间轴块(`TableBlock`):块的时间列取自该组的**时间主通道**(`cn_sync_type == 1`,
|
||||
* 退回名为 `time`/`t` 的通道,再退回第一个数值通道),其余数值通道作为该块的信号列。
|
||||
* 内容完全相同的时间轴在数据模型层会被合并(见 `BuildSignalGroup`)。
|
||||
*
|
||||
* 支持的通道编码:无符号/有符号整数(1–64 位,任意位偏移)与 IEEE-754 浮点(32/64 位)。
|
||||
* 支持的换算:无换算、线性(`phys = c0 + c1 * raw`)。其它换算按“无换算”处理。
|
||||
*
|
||||
* @param [IN] filePath MDF 文件完整路径。
|
||||
* @param [OUT] source 解析结果(每个通道组一个时间轴块)。
|
||||
* @param [OUT] error 失败原因描述(成功时清空)。
|
||||
* @param [IN] progress 进度回调(按字节比例),可为空。
|
||||
* @return 解析成功返回 true。
|
||||
*/
|
||||
bool LoadMf4Source(const std::wstring& filePath, LoadedSource& source, std::wstring& error,
|
||||
const LoadProgress& progress = LoadProgress());
|
||||
|
||||
} // namespace jdi
|
||||
|
||||
#endif // __MF4_LOADER_HPP__
|
||||
Reference in new issue
Block a user