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

Core definitions: sources that are U.S. government works (public domain) or openly licensed (CC BY, with attribution). The product stands on these. 31 executable, 4 side-panel, 3 kidney-check rules (their citations are re-sourced with their next version), 3 catalogue.

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 41 in “Core definitions” shown.

Heart failure type by ejection fraction (four categories, 2021 universal definition as restated in 2022) front_hf_ef_type@1.0 judgement Open licence (CC BY) Draft · pending review draft — pending clinical and coding review
Status
draft — pending clinical and coding review (draft)
Condition
Heart failure
Tier
judgement
Licence
Open licence (CC BY)
To confirm
  • To confirm with a clinician: the boundary wording at exactly 40%. This file reads reduced as 40% or lower (the openly licensed source); the federal cross-check says below 40%. A reported 40% is shown as reduced.
  • To confirm with a clinician: the improved-category baseline rule. The baseline is the first earlier ejection fraction of 40% or lower on file and the comparison value is the latest; another reading (lowest earlier value, or the value just before the latest) can give a different answer.
  • To confirm with a clinician: whether the 2021 categories should stay the shown edition now that a 2026 edition reportedly drops fixed cut-offs between reduced and preserved.
Source checked
opened on 2026-11-14: Opened the article page (section 1.3, New universal definition). Each threshold checked against the page: 40% or lower; 41% to 49%; 50% or higher; improved = baseline 40% or lower, a rise of at least 10 points and a second value above 40%. All four match this file's thresholds and boundary tests.
Use here
front condition (side panel options)
Edition
2022
Why not executable
The 2021 categories are shown as the 2021 edition. A 2026 second universal definition reportedly drops fixed cut-offs between reduced and preserved ejection fraction while keeping the improved category (summary of an openly licensed editorial; the consensus document itself was not opened). Clinical decision needed before release. A federal cross-check (NHLBI, 2022) describes reduced ejection fraction as below 40%, not 40% or lower: the boundary at exactly 40% differs between sources.

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

front_hf_ef_type@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. (2021 edition, as restated in an openly licensed 2022 paper.)

HFrEF, LVEF ≤ 40%

Chandramouli C, Stewart S, Almahmeed W, Lam CSP (Clinical Cardiology) (2022) · Section 1.3 'New universal definition' (classification by left ventricular ejection fraction) · 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. No endorsement by the cited bodies is implied.

See also:
  • Universal definition and classification of heart failure, Bozkurt B et al. (J Card Fail / Eur J Heart Fail) (2021), classification by ejection fraction — society consensus (no open licence seen); numbers restated; text not reproduced
  • Second universal definition of heart failure, Walsh MN et al. (Eur Heart J) (2026) — newer edition, not opened; reportedly drops fixed cut-offs between reduced and preserved; numbers not used
  • Accelerating heart failure research, National Heart, Lung, and Blood Institute (2022), description of reduced ejection fraction · link — federal cross-check only; describes reduced ejection fraction as below 40% (boundary at exactly 40% differs)
  • ICD-10-CM FY2027 tabular list and index, CDC National Center for Health Statistics (2026), I50.2-, I50.3- · link — coder reference only; no index entry for mildly reduced or improved ejection fraction

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.