Coronary angiography read: vessels, SYNTAX segments and stenosis with QCA evidence.
What it does
Coronary Angiography reads a whole cath-lab study. Upload the patient CD, a DICOM folder or individual XA cine runs; the run groups the acquisitions into one study, sorts diagnostic, ventriculography and PCI runs, and skips duplicates and non-image objects.
It returns a study-level read: the projection and injected artery of every run, a coronary-tree mask on every frame, SYNTAX coronary segments, and a lesion list where each stenosis carries quantitative coronary angiography (QCA) evidence: percent diameter stenosis, minimal lumen diameter, reference diameter and lesion length. Dominance, TIMI flow, lesion features, the SYNTAX score and stent sizing complete the picture when the runs support them.
Intended use
Decision support for physicians who read coronary angiograms: a quantified second read for the fellow or on-call operator grading a culprit lesion, and a structured summary for the referring cardiologist or general practitioner who holds a CD with a one-line report. Every stenosis comes with its measurement evidence.
Who it is for
Interventional and general cardiologists, cardiology fellows, emergency physicians and heart-team members. Developers call the same run from the API to add coronary angiography analysis to a PACS, reporting system or registry workflow.
Accepted input
- XA cine runs: multi-frame X-Ray Angiographic Image objects, including Enhanced XA, or a zip of the single-frame instances of one run.
- Whole studies: a patient CD or study folder with a DICOMDIR. Viewer software, dose reports and secondary captures are skipped.
- Up to 30 cine runs per study are analysed together, diagnostic and PCI runs alike.
Requirements per run
| Requirement | Why |
|---|---|
| At least 16 frames | Key-frame selection follows the contrast curve |
| Not a rotational acquisition | Rotational runs cannot be graded per projection |
ImagerPixelSpacing with source distances |
Needed for millimetre values; without it, lengths are reported in pixels and flagged |
Frame rate (CineRate, RecommendedDisplayFrameRate or FrameTime) |
Timing of the contrast curve and of TIMI frame counts |
Both coronary arteries injected in at least two projections each give the most complete read: dominance needs the left and right systems, and lesions are confirmed across views.
Optional context
A clinical question, prior findings and the indication (chronic or acute coronary syndrome) can be passed in
clinical_context; they shape the guidance in the result and the draft report.
The result
One JSON result organised in sections, with findings, measurements and quality flags. Every number traces to the
measurement it came from, and the evidence (DICOM SEG, overlay video, key frame) comes with it.
| Section | Content |
|---|---|
| Views | Projection (LAO/RAO, cranial/caudal), injected structure, run type and key frames for every run |
| Quality | Opacification, motion, calibration and segments not seen in two projections |
| Vessel segmentation | Temporally consistent coronary-tree mask on every frame |
| Coronary segments | SYNTAX segment labels on the key frames |
| Stenosis | Lesions per segment: QCA %DS, MLD, reference diameter, length and a visual-equivalent grade |
| Dominance | Right, left or co-dominant circulation |
| TIMI flow | TIMI flow grade, corrected TIMI frame count and myocardial blush grade |
| Lesion features | Calcification, thrombus, bifurcation (Medina), chronic total occlusion, ostial location, tortuosity |
| SYNTAX score | Total score with per-lesion breakdown and tertile |
| Stent sizing | Proximal and distal reference diameters, lesion length and landing zones for a target lesion |
| PCI result | Pre- versus post-PCI residual stenosis, acute gain, flow change and complications |
| LVEF estimate | Left ventricular ejection fraction estimated from coronary runs when no LV gram exists |
| Draft report | Opt-in (options.report): an English narrative that interprets the result for the reader (findings, impression, limitations); every number is checked against the findings |
Standards
- DICOM: SR Measurement Report TID 1500 with one TID 1410 group per lesion; the study-level read follows TID 3800 Cardiac Catheterization Report. SEG for vessel and segment masks, Secondary Capture key frames, PDF and FHIR R4.
- Reporting: structure per the ACC/AHA/SCAI 2014 statement on structured cath-lab reporting and the NCDR CathPCI v5.1 data elements; guidance per the 2024 ESC chronic coronary syndromes, 2023 ESC acute coronary syndromes and 2021 ACC/AHA/SCAI revascularisation guidelines.
- Scores: SYNTAX segment definitions and score (Sianos 2005), TIMI flow grade, corrected TIMI frame count (Gibson 1996), Medina bifurcation classification.
Severity bands
Diameter stenosis below 50 % is mild, 50–69 % moderate and 70 % or more severe; in the left main, 50 % or more is significant. Bands are recomputed by a versioned rule from the measured value.
Related tools
angio/coronary/qca: pick a segment in the result and get its full diameter profile, with catheter calibration.angio/coronary/angio-ffr: angiography-derived FFR with a virtual pullback for a chosen vessel.
Known limitations
- Single-frame stenosis grading is hard. Public benchmarks put single-frame stenosis detection near F1 0.5. Treat lesions as candidates and confirm on the cine.
- Foreshortening and overlap can hide or exaggerate lesions in one projection; fusion across projections is on the roadmap.
- Side branches (diagonals, obtuse marginals, ramus) are outside the 11-segment vocabulary in v1.
- Calibration. Isocenter calibration can be off by 10–20 % when the vessel is far from the isocenter; catheter calibration is available in the QCA tool.
- Diffuse disease without a normal reference segment lowers %DS.
- Ostial and bifurcation lesions are under-segmented more often.
Not yet in the result
Dominance, TIMI flow, lesion features, SYNTAX score, stent sizing, PCI result and the LVEF estimate are planned sections; they appear as planned on this page until they ship.
Performance
No in-house benchmark has been run yet. Validated numbers will be published here only from our evaluation harness, with dataset, split and date.
Result sections
One run returns every section its input supports, at one price. Sections that cannot run say why (for example, not in input).
| Section | What it returns | Standards | Status |
|---|---|---|---|
Views #views | Each run's injected artery (LCA/RCA), positioner angles and projection, contrast and key frames.extensions | — | Since v1.0.0 |
Vessel segmentation #segment-vessels | Temporally consistent coronary-tree mask on every frame, as DICOM SEG and an overlay video.artifacts | DICOM Segmentation IOD (2026d) | Since v1.0.0 |
Coronary segments #segments | SYNTAX coronary segment labels (11 main segments) and the list of visible segments.artifacts · findings | SYNTAX segment definitions (Sianos 2005); DICOM CID 3014 Coronary Artery Segment (2026d) | Since v1.0.0 |
Stenosis #stenosis | Lesion list per segment with QCA %DS, MLD, reference diameter, length and an AI visual-equivalent grade; bands < 50 / 50–69 / ≥ 70 % (LM ≥ 50 %).findings · measurements · artifacts | DICOM SR TID 1500 / TID 1410 (2026d); QCA %DS bands (medrun-1) | Since v1.0.0 |
Draft report #report | Opt-in draft cath report (findings, impression, limitations) written from the structured result; every number is validated against it.report | — | Since v1.0.0 |
Quality #quality | Adequacy flags (short run, panned gantry, missing calibration, segmentation fallback) carried into the report's limitations.quality | — | Since v1.0.0 |
Dominance #dominance | Right, left or co-dominant circulation from the LCA and RCA runs. Requires: Both LCA and RCA runs.classifications | DICOM CID 3710 Coronary Dominance (2026d) | Planned · P1 |
TIMI flow #timi-flow | TIMI flow grade, corrected TIMI frame count and myocardial blush grade.scores | TIMI flow (1985); CTFC (Gibson) (1996) | Planned · P1 |
Lesion features #lesion-features | Calcification, thrombus, bifurcation (Medina), CTO, ostial location, tortuosity and ACC/AHA lesion type.classifications | — | Planned · P2 |
SYNTAX score #syntax-score | SYNTAX score with per-lesion breakdown and tertile.scores | SYNTAX score (Sianos 2005) | Planned · P2 |
Stent sizing #stent-sizing | Proximal and distal reference diameters, lesion length and a suggested stent size for a target lesion.measurements | — | Planned · P2 |
PCI result #pci-result | Pre/post-PCI comparison (residual %DS, acute gain, TIMI change, dissection). Requires: Pre- and post-PCI runs of the same vessel.changes | — | Planned · P2 |
LVEF estimate #lvef | Estimated LVEF from coronary runs when no LV gram or echo is available.measurements | — | Planned · P2 |
Validated performance
Numbers come only from MedRun's own evaluation harness (make bench (models/angio-coronary)), with dataset, split and date.
Evaluation pending
No in-house benchmark yet. Numbers will appear here only from `make bench` runs, with dataset, split and date.
Pricing
| Endpoint | Unit | Price |
|---|---|---|
| angio/coronary/interpret | request | $0.12 up to 600 frames · $0.24 up to 1,500 frames · $0.36 above 1,500 frames |
| angio/coronary/qca | call | $0.02 |
| Draft report (opt-in, options.report) | per run | +$0.02 |
- One price per study, set by the number of analysed cine frames (up to 30 runs). Sections never change the price.
- The top tier is held while the request runs; you are charged the tier of the frames actually analysed.
- Rejected inputs (for example, no XA cine runs) and failed runs are not charged.
- The QCA tool is a flat price per call.
Changelog
- v1.0.0Oct 6, 2026major
- First MedRun release of the coronary angiography read, with files[] input and sectioned results.
- QCA tool endpoint for a doctor-selected segment.