# 简化信号数据处理流程说明

## 功能概述

本系统提供了一个整合的 `complete_signal_processing_pipeline()` 函数，该函数按照您的逻辑要求，将整个信号数据处理流程整合为一个函数，避免了代码重复。

## 处理流程

### 完整流程步骤

1. **数据读取**: 读取原始二进制文件
2. **数据解析**: 解析设备数据包
3. **通道映射 (MAPPER)**: 执行通道映射处理
4. **信号预处理**: 执行滤波等预处理操作
5. **指标计算**: 计算各项生理指标
6. **结果保存**: 生成多个CSV文件保存结果

## 使用方法

### 1. 运行程序
```bash
./your_program_name
```

### 2. 选择功能
程序启动后会显示以下选项：
```
请选择测试模式:
1. 测试新解析函数 (查看解析结果)
2. 运行原有测试流程
3. 运行完整信号数据处理流程 (推荐)
请输入选择 (1, 2 或 3):
```

选择选项 **3** 来运行完整的信号数据处理流程。

### 3. 自动执行
选择选项3后，程序会自动执行以下步骤：

```
=== 开始完整的信号数据处理流程 ===
步骤1: 读取原始数据...
步骤2: 解析设备数据包...
步骤3: 执行通道映射...
步骤4: 执行信号预处理...
步骤5: 计算生理指标...
步骤6: 生成指标汇总...
=== 完整信号数据处理流程完成 ===
```

## 输出文件

程序会自动生成以下4个CSV文件：

1. **`channel_data_mapped_.csv`** - 通道映射后的数据
2. **`channel_data_processed_.csv`** - 预处理后的数据  
3. **`calculated_metrics_detailed.csv`** - 详细指标数据
4. **`metrics_summary.csv`** - 指标汇总统计

## 技术特点

### 1. 代码整合
- 将原本分散在多个函数中的逻辑整合为一个函数
- 避免了重复的数据读取和解析代码
- 统一的数据流处理

### 2. 错误处理
- 每个步骤都有完善的错误处理
- 如果某个步骤失败，会给出明确的错误信息
- 支持继续处理其他数据对象

### 3. 进度显示
- 实时显示每个步骤的执行进度
- 显示数据对象处理的详细信息
- 最终生成完整的处理报告

## 支持的指标类型

### ECG相关指标
- 心率 (Heart Rate)
- T波振幅 (T Wave Amplitude)  
- QRS宽度 (QRS Width)
- ST段偏移 (ST Offset)

### PPG相关指标
- 心率 (Heart Rate)
- 血氧饱和度 (SpO2)
- 灌注指数 (Perfusion Index)
- 脉搏波宽度 (Pulse Width)

### HRV指标
- SDNN, RMSSD, pNN50, 三角指数

### 统计指标
- 均值、标准差、最小值、最大值、峰峰值、信号质量评分

## 注意事项

1. **文件路径**: 确保原始数据文件路径正确
2. **内存使用**: 大量数据处理时注意内存使用情况
3. **处理时间**: 完整流程可能需要较长时间，请耐心等待
4. **磁盘空间**: 确保有足够的磁盘空间保存输出文件

## 优势

### 相比原有代码的优势
1. **代码简化**: 从多个重复函数整合为一个函数
2. **流程清晰**: 按照逻辑顺序执行，步骤明确
3. **维护性**: 修改流程只需要修改一个函数
4. **可读性**: 代码结构更清晰，易于理解

### 使用建议
- 推荐使用选项3运行完整流程
- 如果需要单独测试某个步骤，可以使用选项1或2
- 首次使用建议先运行完整流程了解整体效果

## 扩展功能

如需添加新的处理步骤或修改现有流程：
1. 在 `complete_signal_processing_pipeline()` 函数中添加新步骤
2. 更新进度显示和错误处理
3. 添加相应的输出文件生成逻辑

## 技术支持

如遇到问题，请检查：
1. 原始数据文件是否存在且格式正确
2. 系统内存是否充足
3. 磁盘空间是否足够
4. 相关依赖库是否正确安装