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

6.6 KiB
Raw Blame History

文件命名规范

当一份数据被完整走完标注流程后,数据文件夹目录结构将会是:

.../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