Files
Signal_Label_Reborn/数据结构化输入和输出命名规范.md
2025-05-08 23:08:29 +08:00

297 lines
6.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 文件命名规范
### 当一份数据被完整走完标注流程后,数据文件夹目录结构将会是:
```
.../Label/<sampID>
|-Artifact_a.txt
|-Artifact_b.txt
|-Artifact_c.csv
|-SQ_label_10s.csv
|-SQ_label_30s.csv
|-Resp_quality_label.txt
|-Tho_peak.txt
|-SA Label_corrected.csv
|-SA Label_add.csv`
.../OrgBCG_Aligned/<sampID>
|-Align_info.txt
|-BCG_Sync_采样率.txt
|-orgBcg_Sync_采样率.txt
|-Jpeak_Sync.txt
.../OrgBCG_Text/<sampID>
|-orgBcg_Raw_采样率.txt
|-BCG_Raw_采样率.txt
|-JPeak_revise.txt
|-JPeak_revise_corrected.txt
.../OrgBCG_Origin/<sampID>
|-...
.../PSG_Aligned/<sampID>
|-Align_info.txt
|-ECG_Sync_采样率.txt
|-Rpeak_Sync.txt
|-5_class_Sync_1.txt
|-SA Label_Sync.csv
|-Effort Abd_Sync_采样率.txt
|-Effort Tho_Sync_采样率.txt
|-Flow Patient_Sync_采样率.txt
|-Snore_Sync_采样率.txt
|-SpO2_Sync_采样率.txt
.../PSG_Text/<sampID>
|-Axxxxxxx.edf
|-ECG II_Raw_采样率.txt
|-ECG_Raw_采样率.txt
|-Rpeak_final.txt
|-Rpeak_final_corrected.txt
|-5_class_Raw_1.txt
|-SA Label_Raw.csv
|-Effort Abd_Raw_采样率.txt
|-Effort Tho_Raw_采样率.txt
|-Flow Patient_Raw_采样率.txt
|-Snore_Raw_采样率.txt
|-SpO2_Raw_采样率.txt
|-StartTime_Raw.txt
.../PSG_Origin/<sampID>
|-...
.../Receive_Origin
|-...
.../Report
|-...
```
### 1 数据粗同步
输入:
原始orgBcg信号`./OrgBCG_Text/<sampID>/orgBcg_Raw_采样率.txt`
原始PSG信号`./PSG_Text/<sampID>/Axxxxxxx.edf`
输出:
粗同步后的位置索引:`./Sync_Index/<sampID>/Approximately_Align_Info.csv`
### 2 预处理
输入:
原始orgBcg信号`./OrgBCG_Text/<sampID>/orgBcg_Raw_采样率.txt`
原始ECG信号`./PSG_Text/<sampID>/ECG II_Raw_采样率.txt`
输出:
带通滤波BCG信号`./OrgBCG_Text/<sampID>/BCG_Raw_采样率.txt`
滤波后的ECG信号`./PSG_Text/<sampID>/ECG_Raw_采样率.txt`
### 3 数据精同步
#### 3.1 算法定位
#### 3.1.1 R峰算法定位
输入:
滤波后的ECG信号`./PSG_Text/<sampID>/ECG_Raw_采样率.txt`
输出:
算法定位的R峰坐标`./PSG_Text/<sampID>/Rpeak_final.txt`
#### 3.1.2 J峰算法定位
输入:
带通滤波BCG信号`./OrgBCG_Text/<sampID>/BCG_Raw_采样率.txt`
输出:
算法定位的J峰坐标`./OrgBCG_Text/<sampID>/JPeak_revise.txt`
#### 3.2 人工纠正
#### 3.2.1 R峰人工纠正
输入:
滤波后的ECG信号`./PSG_Text/<sampID>/ECG_Raw_采样率.txt`
算法定位的R峰坐标`./PSG_Text/<sampID>/Rpeak_final.txt`
输出:
人工纠正后的R峰坐标`./PSG_Text/<sampID>/Rpeak_final_corrected.txt`
#### 3.2.2 J峰人工纠正*
输入:
带通滤波BCG信号`./OrgBCG_Text/<sampID>/BCG_Raw_采样率.txt`
算法定位的J峰坐标`./OrgBCG_Text/<sampID>/JPeak_revise.txt`
输出:
人工纠正后的J峰坐标`./OrgBCG_Text/<sampID>/JPeak_revise_corrected.txt`
#### 3.3 数据片段起止对齐、数据采样率同步
输入:
滤波后的ECG信号`./PSG_Text/<sampID>/ECG_Raw_采样率.txt`
人工纠正后的R峰坐标`./PSG_Text/<sampID>/Rpeak_final_corrected.txt`
带通滤波BCG信号`./OrgBCG_Text/<sampID>/BCG_Raw_采样率.txt`
人工纠正后的J峰坐标`./OrgBCG_Text/<sampID>/JPeak_revise_corrected.txt`
原始orgBcg信号`./OrgBCG_Text/<sampID>/orgBcg_Raw_采样率.txt`
输出:
PSG的对齐信息`./PSG_Aligned/<sampID>/Align_info.txt`
同步后的ECG信号`./PSG_Aligned/<sampID>/ECG_Sync_采样率.txt`
同步后的R峰坐标`./PSG_Aligned/<sampID>/Rpeak_Sync.txt`
BCG的对齐信息`./OrgBCG_Aligned/<sampID>/Align_info.txt`
同步后的BCG信号`./OrgBCG_Aligned/<sampID>/BCG_Sync_采样率.txt`
同步后的orgBcg信号`./OrgBCG_Aligned/<sampID>/orgBcg_Sync_采样率.txt`
同步后的J峰坐标`./OrgBCG_Aligned/<sampID>/Jpeak_Sync.txt`
#### 3.4、冗余数据切割、标签映射
输入:
PSG的对齐信息`./PSG_Aligned/<sampID>/Align_info.txt`
BCG的对齐信息`./OrgBCG_Aligned/<sampID>/Align_info.txt`
原始的其他PSG通道信号`./PSG_Text/<sampID>/通道名_Raw_采样率.txt`通道名包括Effort Abd, Effort Tho, Flow Patient, Snore, SpO2
原始的睡眠分期标签:`./PSG_Text/<sampID>/5_class_Raw_1.txt`
原始的睡眠呼吸暂停事件标签:`./PSG_Text/<sampID>/SA Label_Raw.csv`
输出:
同步后的其他PSG通道信号`./PSG_Aligned/<sampID>/通道名_Sync_采样率.txt`通道名包括Effort Abd, Effort Tho, Flow Patient, Snore, SpO2
同步后的睡眠分期标签:`./PSG_Aligned/<sampID>/5_class_Sync_1.txt`
同步后的睡眠呼吸暂停事件标签:`./PSG_Aligned/<sampID>/SA Label_Sync.csv`
### 4 体动标记
输入:
同步后的BCG信号`./OrgBCG_Aligned/<sampID>/BCG_Sync_采样率.txt`
同步后的orgBcg信号`./OrgBCG_Aligned/<sampID>/orgBcg_Sync_采样率.txt`
输出:
txt格式的体动标签`./Label/<sampID>/Artifact_a.txt`
体动标签类型数量统计:`./Label/<sampID>/Artifact_b.txt`
csv格式的体动标签`./Label/<sampID>/Artifact_c.csv`
### 5 质量评估
输入:
同步后的BCG信号`./OrgBCG_Aligned/<sampID>/BCG_Sync_采样率.txt`
txt格式的体动标签`./Label/<sampID>/Artifact_a.txt`
输出:
质量标签:`./Label/<sampID>/SQ_label_10s.csv``./Label/<sampID>/SQ_label_30s.csv`
### 6 心搏定位数据标注
输入:
输出:
### 7 呼吸提取
输入:
同步后的orgBcg信号`./OrgBCG_Aligned/<sampID>/orgBcg_Sync_采样率.txt`
同步后的THO信号`./PSG_Aligned/<sampID>/Effort Tho_Sync_采样率.txt`
txt格式的体动标签`./Label/<sampID>/Artifact_a.txt`
输出:
呼吸可用性标签:`./Label/<sampID>/Resp_quality_label.txt`
THO信号呼吸间期标签`./Label/<sampID>/Tho_peak.txt`
### 8 呼吸暂停事件标注
输入:
同步后的orgBcg信号`./OrgBCG_Aligned/<sampID>/orgBcg_Sync_采样率.txt`
txt格式的体动标签`./Label/<sampID>/Artifact_a.txt`
同步后的FlowT信号`./PSG_Aligned/<sampID>/Effort Tho_Sync_采样率.txt`
同步后的FlowP信号`./PSG_Aligned/<sampID>/Effort Tho_Sync_采样率.txt`
同步后的THO信号`./PSG_Aligned/<sampID>/Effort Tho_Sync_采样率.txt`
同步后的ABD信号`./PSG_Aligned/<sampID>/Effort Abd_Sync_采样率.txt`
同步后的SpO2信号`./PSG_Aligned/<sampID>/SpO2_Sync_采样率.txt`
同步后的呼吸暂停标签:`./PSG_Aligned/<sampID>/SA Label_Sync.csv`
输出:
修正后的呼吸暂停标签:`./Label/<sampID>/SA Label_corrected.csv`
新增的呼吸暂停标签:`./Label/<sampID>/SA Label_add.csv`