Add SepsisPredictionEICU and SepsisPredictionMIMIC4 tasks — pre-ICU window, Sepsis-3 proxy labeling
維護者通常 2 天內回覆
@zhaog100 已經在處理了。
開始於 2026年3月25日。
評估
- 難度
- 5/5
- 預估耗時
- 一週以上
- 新手友好度
- 25/100
- Issue 類型
- 功能
- 描述清晰度
- 基本清楚
- 活躍度
- 停滯
- 技術堆疊
- python
- 領域
- data, machine-learning
研究方向
Start by reading existing task definitions under pyhealth/tasks/, their exports in pyhealth/tasks/__init__.py, and the tests under tests/tasks/. The issue specifies the proposed eICU and MIMIC-IV inputs, label sources, and deliverables, but the configurable time windows and clinical cohort rules need to be resolved before implementation. Done means both task definitions, exports, unit tests, an example notebook, and referenced docstrings are in place.
由索引模型根據 Issue 內容生成。
描述
Summary
PyHealth currently has no sepsis prediction task. This issue proposes adding two
new task definitions:
SepsisPredictionEICU— eICU Collaborative Research DatabaseSepsisPredictionMIMIC4— MIMIC-IV
Both tasks target pre-ICU / early ICU detection windows, filling a confirmed
gap identified in a PROSPERO-registered systematic review (CRD420251164609) covering
14 studies (53,795 participants): nearly all existing sepsis ML models are trained
on in-ICU data with no standardized reproducible benchmark.
Clinical Motivation
Sepsis is defined by the Sepsis-3 consensus (Singer et al., JAMA 2016) as
life-threatening organ dysfunction caused by dysregulated host response to infection.
Early detection — before ICU admission or within the first hours — is where clinical
impact is highest and where published ML models show the widest performance variance
(AUROC 0.72–0.94 across studies), largely due to inconsistent cohort definitions
and labeling strategies.
A reproducible PyHealth task enforces a consistent:
- Observation window (configurable: default 6h from first available data)
- Prediction gap (configurable: 0–12h before onset)
- Sepsis label derivation (Sepsis-3 proxy: ICD codes + SOFA ≥ 2 or
apacheadmissiondxfor eICU)
Proposed Implementation
SepsisPredictionEICU
input_schema = {
"vitals": "time_series", # HR, RR, MAP, SpO2, Temp from vitalPeriodic
"labs": "sequence", # WBC, lactate, creatinine from lab table
"conditions": "sequence", # apacheadmissiondx / pasthistory
"demographics": "static", # age, gender, admissionweight
}
output_schema = {
"sepsis_label": "binary",
}
Label derivation from eICU:
- Positive:
apacheadmissiondxcontaining sepsis/septic shock keywords or
ICD codes indiagnosistable (995.91, 995.92, A41.x) - Negative: non-infectious admission diagnoses
- Excluded: ambiguous/missing diagnosis records
SepsisPredictionMIMIC4
input_schema = {
"vitals": "time_series", # chartevents: HR, RR, MAP, SpO2, GCS
"labs": "sequence", # labevents: WBC, creatinine, bilirubin, lactate
"conditions": "sequence", # diagnoses_icd (ICD-10)
"demographics": "static", # age, gender, admission_type
}
output_schema = {
"sepsis_label": "binary",
}
Label derivation from MIMIC-IV:
- Use
sepsis3flag frommimiciv_derived.sepsis3(already in MIMIC-IV derived
tables) where available - Fallback: ICD-10 codes A40.x, A41.x in
diagnoses_icd
Deliverables
-
pyhealth/tasks/sepsis_prediction_eicu.py -
pyhealth/tasks/sepsis_prediction_mimic4.py - Export in
pyhealth/tasks/__init__.py - Unit tests in
tests/tasks/ - Example notebook in
examples/sepsis_prediction/ - Docstring with clinical references
References
- Singer M et al. The Third International Consensus Definitions for Sepsis and
Septic Shock (Sepsis-3). JAMA. 2016;315(8):801–810. - Johnson AEW et al. MIMIC-IV, a freely accessible electronic health record
dataset. Sci Data. 2023. - Pollard TJ et al. The eICU Collaborative Research Database. Sci Data. 2018.
- Sucandra et al. Time Advantage and Diagnostic Accuracy of Biomarker-Enhanced
ML/DL for Sepsis Detection in Pre-ICU Settings. PROSPERO CRD420251164609.
Notes
Happy to implement this. Will open a PR once approach is confirmed.
- 主要語言
- Python
- 星號
- 1.7k
- 分支
- 803
- 平均合併
- 4 天 18 小時
- 30 天內合併 PR
- 58
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 沒有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
sunlabuiuc/PyHealth 的其他 Issue
-
難度 5/5 一週以上 新手友好度 25/100
sunlabuiuc/PyHealth#1357 · 1 則留言 ·
維護者通常 2 天內回覆
-
難度 5/5 一週以上 新手友好度 35/100
sunlabuiuc/PyHealth#1346 ·
維護者通常 2 天內回覆
-
難度 4/5 3-5 天 新手友好度 30/100
sunlabuiuc/PyHealth#1297 ·
維護者通常 2 天內回覆
-
難度 4/5 3-5 天 新手友好度 22/100
sunlabuiuc/PyHealth#1295 · 1 則留言 ·
維護者通常 2 天內回覆
-
難度 3/5 1-2 天 新手友好度 42/100
sunlabuiuc/PyHealth#1294 · 1 則留言 ·
維護者通常 2 天內回覆
查看 sunlabuiuc/PyHealth 的全部 Issue
相似的 Issue
-
_chunk_scan_fwd launches its Triton kernel without a device guard: NaN when a model is split across GPUs可能已有人在做 @toddwbucy 今天認領。 未關閉
難度 1/5 1 小時以內 新手友好度 85/100
state-spaces/mamba#1072 ·
-
難度 1/5 1 小時以內 新手友好度 85/100
loopj/aiovantage#414 ·
維護者通常 1 天內回覆
-
power_mismatch_deline docstring: the rear-to-total RMAD conversion has an extra bifaciality factor未關閉
難度 1/5 1 小時以內 新手友好度 85/100
pvlib/pvlib-python#2929 ·
維護者通常 1 天內回覆
-
data good first issue launch-day unverified
難度 2/5 1-3 小時 新手友好度 78/100
BradGroux/wow-forever-mission-control#8 ·
維護者通常 1 天內回覆
-
check bilibili falsely reports read/subtitle as broken: live_test fixture BV1GJ411x7h7 is gone (404)未關閉
難度 2/5 1-3 小時 新手友好度 78/100
Panniantong/Agent-Reach#889 ·
維護者通常 2 天內回覆