Spaces:
Running
Running
File size: 8,668 Bytes
713f736 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 | """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
|