Aller au contenu principal

ECG Strips Source (Connect MCT)

Category: Healthcare Standards
Node id: ecg-strips-source
Maturity: beta
Risk tier: B

Standards: HIPAA, GDPR

Fetches a patient's stored ECG strips from tietai-connect (MCT) and emits model-ready waveforms (channels + lead + sample rate + gain) for waveform-perception.

What it does​

  • Reads Connect's ecg_strips store (every ingested format: WFDB, EDF, SCP, ISHNE, MUSE, DICOM-ECG)
  • Emits calibrated waveform payloads (raw counts + µV/LSB gain) ready for waveform-perception
  • Maps Connect lead configs to standard lead names; skips layouts it cannot represent honestly

Use cases​

  • Feed MCT/Holter strips into signal-model screening pipelines
  • Batch-embed a patient's recent strips for similarity analysis

Runtime​

  • Performance tier: medium

Input ports​

NameTypeRequiredDescription
patient_idtextNoPatient whose strips to fetch. Falls back to the patient_id config.
fromtextNoWindow start, RFC3339 (Connect defaults to 7 days ago when empty). Overrides the from config.
totextNoWindow end, RFC3339 (default now). Overrides the to config.

Output ports​

NameTypeRequiredDescription
stripsjsonNoModel-ready strips: strip_id, channels [[samples]], leads, sample_rate_hz, gain_uv_per_lsb, recorded_at, quality, rhythm metadata.
countnumberNoNumber of strips emitted.
warningsjsonNoStrips skipped and why (e.g. unsupported multi-lead layout).

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Patient IDpatient_idstringNoFallback patient id when no patient_id input is wired.
From (RFC3339)fromstringNoFallback window start when no from input is wired.
To (RFC3339)tostringNoFallback window end when no to input is wired.
Max StripslimitnumberNo50Maximum strips to fetch (Connect caps at 500).

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
Lead Label Overridelead_labelstringNoForce the emitted lead name (research use — e.g. treat a SINGLE strip as lead I for ecgfounder-1lead).
Connect Base URLconnect_base_urlstringNoOverride the Connect base URL (default from HYDRA_CONNECT_BASE_URL).

Errors​

CodeDescription
STRIPS_CONFIGpatient_id missing, or no Connect base URL configured
STRIPS_REQUESTConnect was unreachable or returned an error

Runtime notes​

  • Requires HYDRA_CONNECT_BASE_URL (or the connect_base_url config).
  • Multi-lead (12_LEAD) strips are skipped with a warning in v1 — Connect's flat waveform layout for them is unspecified.
  • Strips with no stored gain are treated as µV samples (gain 1.0), matching Connect's ECGPayload contract.

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

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.