Yorusora/Signal_Label_Reborn
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0be88d9be724b72bab43df2ce9bbebad28393935
Signal_Label_Reborn/数据结构化输入和输出命名规范.md

6.9 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.yaml
    |-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
    |-Approximately_Align_Info.csv
.../OrgBCG_Origin/<sampID>
    |-...
.../PSG_Aligned/<sampID>
    |-Align_info.yaml
    |-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>
    |-orgEcg 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

输出：

粗同步后的位置索引：./OrgBCG_Text/<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

粗同步后的位置索引：./OrgBCG_Text/<sampID>/Approximately_Align_Info.csv

输出：

人工纠正后的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

粗同步后的位置索引：./OrgBCG_Text/<sampID>/Approximately_Align_Info.csv

输出：

人工纠正后的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

粗同步后的位置索引：./OrgBCG_Text/<sampID>/Approximately_Align_Info.csv

输出：

PSG的对齐信息：./PSG_Aligned/<sampID>/Align_info.yaml

同步后的ECG信号：./PSG_Aligned/<sampID>/ECG_Sync_采样率.txt

同步后的R峰坐标：./PSG_Aligned/<sampID>/Rpeak_Sync.txt

BCG的对齐信息：./OrgBCG_Aligned/<sampID>/Align_info.yaml

同步后的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.yaml

BCG的对齐信息：./OrgBCG_Aligned/<sampID>/Align_info.yaml

原始的其他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