Add SepsisPredictionEICU and SepsisPredictionMIMIC4 tasks — pre-ICU window, Sepsis-3 proxy labeling
メンテナーはふだん 3 日以内に返信
@zhaog100 がすでに取り組んでいます。
2026年3月25日 から。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 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
- 平均マージ
- 5日 16時間
- マージ済み PR(30日)
- 58
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
sunlabuiuc/PyHealth のほかの issue
-
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
sunlabuiuc/PyHealth#1346 ·
メンテナーはふだん 3 日以内に返信
-
難易度 4/5 3〜5日 初心者へのやさしさ 30/100
sunlabuiuc/PyHealth#1297 ·
メンテナーはふだん 3 日以内に返信
-
難易度 4/5 3〜5日 初心者へのやさしさ 22/100
sunlabuiuc/PyHealth#1295 · コメント 1 件 ·
メンテナーはふだん 3 日以内に返信
-
難易度 3/5 1〜2日 初心者へのやさしさ 42/100
sunlabuiuc/PyHealth#1294 · コメント 1 件 ·
メンテナーはふだん 3 日以内に返信
-
Internal transfers are counted as readmissions対応中かも @thebean27 が 23 日前に担当しました。 オープン
難易度 4/5 3〜5日 初心者へのやさしさ 35/100
sunlabuiuc/PyHealth#1269 · コメント 3 件 ·
メンテナーはふだん 3 日以内に返信
sunlabuiuc/PyHealth の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
Graphify-Labs/graphify#4860 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
:bug: Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
scikit-image/scikit-image#8377 ·
メンテナーはふだん 1 日以内に返信
-
Ingredient import validation accepts negative nutrient values and NaN対応中かも @LukeSekai が今日担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
wger-project/wger#2564 ·
メンテナーはふだん 2 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
apache/ponymail-foal#351 ·
-
難易度 1/5 1時間未満 初心者へのやさしさ 68/100
メンテナーはふだん 4 日以内に返信