parsa-hke's picture
Stroke Decision Copilot: page, bank of 195 cases (held-out by alias), EXP-66 results (part 2)
713f736 verified
Raw History Blame Contribute Delete
8.67 kB
"""Triage note text from structured facts, with a fact sheet whose spans are verbatim in the note. Plan §8.3.
Used by scenarios.py now and by notes/generate.py for the ISLES'24 development cases. A few phrasings per field give
controlled variation, so the reasoner does not see one fixed format. A fact left as None is not written: the note is
silent on it, which is not the same as "not recorded" (use `not_recorded` for that).
"""
from strokecopilot.nlp.notes.facts import Fact, FactSheet
MRS_WORDS = {0: "no symptoms", 1: "no significant disability", 2: "slight disability", 3: "moderate disability",
4: "moderately severe disability", 5: "severe disability"}
def _hm(minutes):
minutes = int(round(minutes))
return f"{minutes // 60} h {minutes % 60} min"
def _clock(minutes):
minutes = int(round(minutes)) % 1440
return f"{minutes // 60:02d}:{minutes % 60:02d}"
class _Writer:
def __init__(self, rng):
self.rng, self.lines, self.facts = rng, [], []
def pick(self, options):
return options[self.rng.randrange(len(options))]
def fact(self, key, type_, value, span, unit=None):
self.facts.append(Fact(key=key, type=type_, value=value, span=span, unit=unit))
def render(spec, rng):
"""(note text, FactSheet) for a spec dict. Keys (all optional except age, sex, nihss):
age, sex ("male"/"female"), onset ("witnessed"/"unwitnessed"/"wake_up"), minutes (to imaging), imaging_clock
(minutes after midnight), sleep_minutes (wake-up only: time asleep before waking), deficits, referral, nihss, mrs,
medications (list), anticoagulant (None/False/"apixaban"/"warfarin"...), inr, antiplatelet (bool), history (list),
head_trauma, recent_surgery, previous_ich, recent_bleeding (True/False/None), bp (sys, dia), glucose (mmol/L),
not_recorded (list of keys the note says are not recorded)."""
w = _Writer(rng)
noun = {"male": "man", "female": "woman"}[spec["sex"]]
age_span = f"{spec['age']}-year-old"
w.fact("age", "number", spec["age"], age_span, "years")
w.fact("sex", "text", spec["sex"], noun)
deficits = spec.get("deficits", "right-sided weakness and slurred speech")
onset, minutes = spec.get("onset", "witnessed"), spec.get("minutes")
imaging = spec.get("imaging_clock", 14 * 60)
first = f"{age_span} {noun}."
if minutes is None:
first += f" Found with {deficits}; time of onset not known."
w.fact("deficits", "text", deficits, deficits)
elif onset == "witnessed":
clock = _clock(imaging - minutes)
span = w.pick([f"Witnessed sudden onset of {deficits} at {clock}", f"Sudden {deficits} at {clock}, witnessed by family"])
first += f" {span}."
w.fact("onset_witnessed", "bool", True, span)
w.fact("onset_clock", "time", clock, clock)
w.fact("deficits", "text", deficits, deficits)
elif onset == "unwitnessed":
lkw = _clock(imaging - minutes)
found = _clock(imaging - min(minutes, 60) + 15)
first += f" Last seen well at {lkw}; found at {found} with {deficits}. Onset not witnessed."
w.fact("lkw_clock", "time", lkw, f"Last seen well at {lkw}")
w.fact("found_clock", "time", found, f"found at {found}")
w.fact("onset_witnessed", "bool", False, "Onset not witnessed")
w.fact("deficits", "text", deficits, deficits)
else: # wake-up
lkw_minutes = imaging - minutes
woke = lkw_minutes + spec.get("sleep_minutes", 480)
lkw, found = _clock(lkw_minutes), _clock(woke)
first += f" Went to bed well at {lkw}; woke at {found} with {deficits}. Wake-up stroke; onset not witnessed."
w.fact("lkw_clock", "time", lkw, f"Went to bed well at {lkw}")
w.fact("found_clock", "time", found, f"woke at {found}")
w.fact("wake_up_stroke", "bool", True, "Wake-up stroke")
w.fact("onset_witnessed", "bool", False, "onset not witnessed")
w.fact("deficits", "text", deficits, deficits)
if spec.get("referral"):
referral = spec["referral"][0].upper() + spec["referral"][1:]
first += f" {referral}."
w.fact("referral", "text", spec["referral"], referral)
w.lines.append(first)
if minutes is not None:
basis, key = ("symptom onset", "onset_to_imaging") if onset == "witnessed" else ("last known well", "lkw_to_imaging")
span = f"Time from {basis} to imaging: {_hm(minutes)}."
w.lines.append(span)
w.fact(key, "number", int(round(minutes)), span, "min")
span = w.pick([f"NIHSS on arrival: {spec['nihss']}.", f"Initial NIHSS {spec['nihss']}.", f"NIHSS {spec['nihss']} on arrival."])
w.lines.append(span)
w.fact("nihss", "number", spec["nihss"], span)
if spec.get("mrs") is not None:
span = f"Pre-stroke mRS: {spec['mrs']} ({MRS_WORDS[spec['mrs']]})."
w.lines.append(span)
w.fact("premorbid_mrs", "number", spec["mrs"], span)
meds = list(spec.get("medications", []))
anticoag = spec.get("anticoagulant")
if anticoag:
meds.append(anticoag if anticoag != "apixaban" else "apixaban 5 mg twice daily, last dose this morning")
if spec.get("antiplatelet"):
meds.append("aspirin 75 mg daily")
med_line = f"Medications: {', '.join(meds)}." if meds else "Medications: none."
if meds:
w.fact("medications", "text", ", ".join(meds), med_line)
extra = []
if anticoag is False and spec.get("antiplatelet") is False:
extra.append("No anticoagulant or antiplatelet use.")
w.fact("anticoagulant", "bool", False, extra[-1])
w.fact("antiplatelet", "bool", False, extra[-1])
elif anticoag is False:
extra.append("No anticoagulant use.")
w.fact("anticoagulant", "bool", False, extra[-1])
elif anticoag:
w.fact("anticoagulant", "bool", True, anticoag if anticoag != "apixaban" else "apixaban")
if spec.get("antiplatelet"):
w.fact("antiplatelet", "bool", True, "aspirin")
w.lines.append(" ".join([med_line] + extra))
history = list(spec.get("history", []))
hist = f"History: {', '.join(history)}." if history else "History: nil of note."
for item in history:
key = {"hypertension": "hypertension", "type 2 diabetes": "diabetes", "atrial fibrillation": None,
"hyperlipidaemia": "hyperlipidaemia", "ischaemic heart disease": "ischaemic_heart_disease",
"chronic kidney disease stage 3": "chronic_kidney_disease"}.get(item)
if key:
w.fact(key, "bool", True, item)
positives = {"head_trauma": "Fell and struck his head with brief loss of consciousness 5 days ago",
"recent_surgery": "Hip replacement 6 days ago", "previous_ich": "Previous intracerebral haemorrhage in 2019",
"recent_bleeding": "Upper gastrointestinal bleed 10 days ago"}
parts = [hist]
negatives = [k for k in ("recent_surgery", "head_trauma", "previous_ich") if spec.get(k) is False]
for key, text in positives.items():
if spec.get(key):
text = text if spec["sex"] == "male" or key != "head_trauma" else text.replace("his", "her")
parts.append(text + ".")
w.fact(key, "bool", True, text)
if negatives:
words = {"recent_surgery": "recent surgery", "head_trauma": "head trauma", "previous_ich": "previous intracranial haemorrhage"}
listed = [words[k] for k in negatives]
sentence = "No " + (listed[0] if len(listed) == 1 else ", ".join(listed[:-1]) + " or " + listed[-1]) + "."
parts.append(sentence)
for key in negatives:
w.fact(key, "bool", False, sentence)
w.lines.append(" ".join(parts))
obs = []
if spec.get("bp"):
s, d = spec["bp"]
obs.append(f"BP {s}/{d} mmHg")
w.fact("bp_systolic", "number", s, f"BP {s}/{d} mmHg", "mmHg")
w.fact("bp_diastolic", "number", d, f"BP {s}/{d} mmHg", "mmHg")
if spec.get("glucose") is not None:
obs.append(f"capillary glucose {spec['glucose']} mmol/L")
w.fact("glucose", "number", spec["glucose"], obs[-1], "mmol/L")
if spec.get("inr") is not None:
obs.append(f"INR {spec['inr']}")
w.fact("inr", "number", spec["inr"], obs[-1])
if obs:
w.lines.append("Observations: " + ", ".join(obs) + ".")
for key in spec.get("not_recorded", []):
span = f"{key.replace('_', ' ').capitalize()}: not recorded."
w.lines.append(span)
w.fact(key, "not_recorded", None, span)
note = "ED STROKE TRIAGE NOTE\n" + "\n".join(w.lines)
sheet = FactSheet(w.facts)
sheet.check_against(note)
return note, sheet