Skip to main content

Arrhythmia Detect

Category: Healthcare Standards
Node id: arrhythmia-detect

Standards: HIPAA

Classifies cardiac arrhythmias from ECG-derived metrics (heart rate, RR intervals, signal quality). Detects bradycardia, tachycardia, asystole, AFib, and PVC using clinical thresholds.

What it does​

  • Bradycardia detection via heart rate threshold
  • Tachycardia detection via heart rate threshold
  • Long pause / asystole detection via RR interval threshold
  • AFib detection via RR coefficient of variation (>15%)
  • PVC detection via short-long RR pattern analysis
  • Signal quality gating (skips detection when quality < 50)

Use cases​

  • Mobile Cardiac Telemetry (MCT) automated event detection
  • Real-time ECG strip analysis in continuous monitoring pipelines
  • Pre-screening for cardiologist review queue prioritization

Runtime​

  • Performance tier: fast

Input ports​

NameTypeRequiredDescription
heart_rate_bpmjsonYesHeart rate in beats per minute
rr_intervalsjsonNoR-R intervals in milliseconds as an array of numbers
quality_scorejsonNoSignal quality score 0-100; values below 50 suppress detection

Output ports​

NameTypeRequiredDescription
resultjsonNoDetection result: events array, event_count, has_critical, summary
successbooleanNoTrue when execution completed without error

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Tachycardia Threshold (bpm)hr_high_bpmnumberNo150min 0
Bradycardia Threshold (bpm)hr_low_bpmnumberNo40min 0
Detect AFibdetect_afibbooleanNotrue
Detect PVCdetect_pvcbooleanNotrue
Detect Long Pause / Asystoledetect_pausebooleanNotrue

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Pause Threshold (ms)pause_threshold_msnumberNo3000min 0
Minimum Confidence (%)min_confidencenumberNo80min 0; max 100

Errors​

CodeDescription
HEART_RATE_REQUIREDheart_rate_bpm input is missing
INVALID_THRESHOLDShr_high_bpm is not greater than hr_low_bpm
INVALID_CONFIDENCEmin_confidence is outside 0-100 range

Runtime notes​

  • When quality_score < 50, detection is skipped entirely and events is empty — check event_count to distinguish no-arrhythmia from low-quality
  • has_critical is true only for asystole events — wire this to an alert node for immediate notification
  • AFib detection requires at least 3 RR intervals; PVC detection also needs 3+ — fewer intervals silently skips those rules
  • Events below min_confidence are filtered out — lower this threshold to increase sensitivity at the cost of specificity

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Something unclear? Send documentation feedback by email.