Skip to main content
DataCrafters synthetic data · demonstration

Staff surface Definitions and reviews

Definition library

Every executable definition, side-panel definition and catalogue entry, in three groups by the licence of its source, with its threshold in our own words and the source it is cited to. All are drafts pending review; a definition shows as reviewed only when both a clinical and a coding approval are recorded. Default set library_default_set@1.1.

Local criteria: site choices among published definitions and named local variants of the side-panel definitions, each with a change record, two approvals and an outcome preview.

Coder worklist

Setting: show extended capabilities on clinician screens

Current on clinician screens: Off (default) When on, findings from extended definitions appear on the side panel and the per-note screen under their own heading, after the core findings. Off or on, every check runs and replays the same, and the coder view shows both groups. The guided demo's four cases are unaffected.

CDI or coding staff can change this setting: switch the demo user.

Licence status

Thresholds are stated in our own words. Verbatim text is kept only from U.S. government works and openly licensed (CC BY) sources, with the attribution the licence asks for; copyrighted guidelines are cited by title, body and year, with a locator. No endorsement by the cited bodies is implied. This is not legal advice: counsel should review before commercial release.

Cancer-treatment adverse-event grading scale (NCI CTCAE): off by default

CTCAE grades describe adverse events in people receiving cancer treatment, usually in trials; they are not diagnostic criteria, and several grades depend on the laboratory reference range or on clinical descriptors that are not encoded. Using them outside that setting is a local decision for the clinical reviewer.

Current: Off (default) When on, grading entries are shown only as "another published definition gives …" or as values needing clinical judgement; they never raise a "not stated" item.

CDI or coding staff can change this setting. A clinician account records clinical reviews; a coding or documentation account records coding reviews: switch the demo user.

1 of 75 entries shown.

Heart failure category by LVEF: HFrEF, HFmrEF, HFpEF, HFimpEF (Universal Definition 2021) uhf2021_hf_ef_category@1.0 1 Open licence (CC BY) Draft · pending review draft — pending clinical and coding review
Status
draft — pending clinical and coding review (draft — requires clinical and coding review)
Condition
Heart failure (EF category)
Tier
1
Licence
Open licence (CC BY)
Source checked
opened on 2026-11-14: PMC9254673 opened 2026-11-14 in the resourcing build: reduced 40% or lower, mildly reduced 41% to 49%, preserved 50% or higher, improved = baseline 40% or lower, rise of 10 points or more, second above 40%; matches the categories. CC BY 4.0 licence line read on the page.
Use here
default set (heart_failure_ef)
Edition
2021 universal definition (as restated in 2022) (2021) (a newer edition exists)
Second source
none opened · not found: The co-published Eur J Heart Fail 2021;23:352-380 abstract (PMID:33605000) states the same cut-offs but is the same document, not an independent source. The 2022 AHA/ACC/HFSA guideline abstract does not state them; its full text was not opened.
Contested
no: The same cut-offs appear in the co-published Eur J Heart Fail and J Card Fail versions; some guidelines describe HFmrEF differently in wording only (not opened).

Clinical implications of the universal definition for the prevention and treatment of heart failure

uhf2021_hf_ef_category@1.0

In our words: Reduced ejection fraction: 40% or lower. Mildly reduced: 41% to 49%. Preserved: 50% or higher. Improved: an earlier ejection fraction of 40% or lower, a later one above 40%, and a rise of at least 10 points. Applies only once heart failure is diagnosed (2021 edition).

HFrEF, LVEF ≤ 40%; HF with mildly reduced ejection fraction (HFmrEF), LVEF of 41%–to 49%; ... HFpEF, LVEF ≥ 50%; and HF with improved ejection fraction (HFimpEF): baseline LVEF ≤ 40% with ≥10‐pt increase from baseline and second LVEF > 40%.

Chandramouli C, Stewart S, Almahmeed W, Lam CSP (Clin Cardiol 2022;45(Suppl 1):S2-S12, doi:10.1002/clc.23842) (2022) · Section 1.3 'New universal definition' (LVEF classification; Figure 2) · source

open licence: CC BY 4.0, attribution: Chandramouli C, Stewart S, Almahmeed W, Lam CSP. Clinical implications of the universal definition for the prevention and treatment of heart failure. Clin Cardiol 2022;45(Suppl 1):S2-S12, doi:10.1002/clc.23842. Licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). No endorsement by the cited bodies is implied.

See also:
  • Universal Definition and Classification of Heart Failure, HFSA, HFA-ESC and JHFS (J Card Fail 2021;27:387-413; Eur J Heart Fail 2021;23:352-380) (2021), Abstract · link — earlier primary of this entry; numbers restated; text not reproduced
  • Second Universal Definition of Heart Failure, AHA/ACC/ESC/WHF (Eur Heart J 2026;47:4357-74) (2026) — not opened; reported (secondary summary) to drop fixed cut-offs between reduced and preserved EF
  • Accelerating heart failure research, National Heart, Lung, and Blood Institute (2022) · link — federal cross-check; uses below 40% (not 40% or lower) for reduced EF; not used for the bands
  • ICD-10-CM FY2027 tabular list (I50.2-, I50.3-), CDC/NCHS (2026), I50.2-, I50.3- · link — coding terms: reduced EF under systolic HF, preserved EF under diastolic HF; no index entry for mildly reduced or improved EF

Review

Reviewed only when both a clinical review and a coding review are recorded as approved.

Clinical review: none recorded yet.

Coding review: none recorded yet.