EKG – JSON-viennin muoto

Dokumentaatio EKG:n rakenteesta JSON-vienneissä

Last updated: April 1, 2026

Tällä sivulla

EKG (sähkökardiogrammi)

EKG-data sisältää elektrokardiogrammilukemia yhteensopivilta Apple-laitteilta (kuten Apple Watch Series 4 ja uudemmat). EKG-data tarjoaa yksityiskohtaista sydämen rytmianalyysiä ja voi tunnistaa tiloja kuten eteisvärinä. JSON-vienneissä EKG-data tallennetaan taulukkoon ecg.

Rakenne

Jokainen EKG-merkintä sisältää luokittelutulokset, sykemittaukset, jännitetiedot ja näytteenottotiedot:

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 512,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Kentät

Pakolliset kentät

  • start (Date): EKG-lukeman alkuaika muodossa yyyy-MM-dd HH:mm:ss Z
  • end (Date): EKG-lukeman loppuaika muodossa yyyy-MM-dd HH:mm:ss Z
  • classification (String): Sydämen rytmin luokitus (katso luokitukset alta)
  • averageHeartRate (Number): Keskimääräinen syke EKG-lukeman aikana lyöntinä minuutissa (bpm)
  • numberOfVoltageMeasurements (Number): Jännitemittausten kokonaismäärä EKG-näytteessä
  • voltageMeasurements (Array): Jännitemittausten taulukko (katso Jännitemittaukset alta)
  • samplingFrequency (Number): Näytteenottotaajuus hertseinä (Hz) (tyypillisesti 512 Hz Apple Watchilla)
  • source (String): EKG:n tallentanut laite tai sovellus

Valinnaiset kentät

  • severity (String): EKG-tuloksen vakavuusluokitus (voi olla "Not Set", jos ei sovellu)

EKG-luokitukset

Kenttä classification kertoo havaittu sydämen rytmi:

  • "Sinus Rhythm" – Normaali sydämen rytmi
  • "Atrial Fibrillation" – Epäsäännöllinen rytmi (eteisvärinä) havaittu
  • "High Heart Rate" – Syke normaalialueen yläpuolella
  • "Inconclusive Low Heart Rate" – Luokittelu ei onnistunut matalan sykkeen vuoksi
  • "Inconclusive High Heart Rate" – Luokittelu ei onnistunut korkean sykkeen vuoksi
  • "Inconclusive" – Luokittelua ei voitu määrittää
  • "Inconclusive Poor Recording" – Luokittelu ei onnistunut heikon signaalin vuoksi
  • "Unrecognized" – Luokitus ei tunnistettu

Jännitemittaukset

Jokainen EKG-merkintä sisältää jännitemittausten taulukon, joka kuvaa sydämen sähköistä toimintaa ajan kuluessa:

{
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    },
    {
      "date": "2024-02-06 14:30:00.002 -0800",
      "voltage": 0.125,
      "units": "V"
    }
  ]
}

Jännitemittausten kentät:

  • date (Date): Jännitemittauksen tarkka aikaleima (millisekunnit mukana)
  • voltage (Number): Jännite voltteina
  • units (String): Mittayksikkö (tyypillisesti "V" volteille)

Huom: Jännitemittaukset näytteistetään taajuudella samplingFrequency (tyypillisesti 512 Hz eli 512 mittausta sekunnissa).

Esimerkkimerkinnät

Normaali sinusrytmi

{
  "start": "2024-02-06 14:30:00 -0800",
  "end": "2024-02-06 14:30:30 -0800",
  "classification": "Sinus Rhythm",
  "severity": "Not Set",
  "averageHeartRate": 72,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 14:30:00.000 -0800",
      "voltage": 0.123,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Eteisvärinän havaitseminen

{
  "start": "2024-02-06 16:45:00 -0800",
  "end": "2024-02-06 16:45:30 -0800",
  "classification": "Atrial Fibrillation",
  "severity": "Not Set",
  "averageHeartRate": 95,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 16:45:00.000 -0800",
      "voltage": 0.145,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

Epäselvä lukema

{
  "start": "2024-02-06 18:00:00 -0800",
  "end": "2024-02-06 18:00:30 -0800",
  "classification": "Inconclusive Poor Recording",
  "severity": "Not Set",
  "averageHeartRate": 68,
  "numberOfVoltageMeasurements": 15360,
  "voltageMeasurements": [
    {
      "date": "2024-02-06 18:00:00.000 -0800",
      "voltage": 0.098,
      "units": "V"
    }
  ],
  "samplingFrequency": 512,
  "source": "Apple Watch"
}

EKG-datan ymmärtäminen

Näytteenottotaajuus

samplingFrequency (tyypillisesti 512 Hz) kertoo, montako jännitemittausta otetaan sekunnissa. 30 sekunnin EKG-lukemalle:

  • Mittauksia yhteensä = 512 × 30 = 15 360
  • Jokainen mittaus vastaa noin 0,002 sekuntia (2 millisekuntia) sydämen toimintaa

Jännitemittaukset

Jännitemittaukset kuvaavat sydämen sähköistä toimintaa:

  • Positiiviset arvot: Depolarisaatio (sydänlihaksen supistuminen)
  • Negatiiviset arvot: Repolarisaatio (sydänlihaksen rentoutuminen)
  • Kuvion analyysi: Jännitteen muutoksen kuvio ajan myötä kuvaa sydämen rytmiä

Luokituksen tulkinta

  • Sinus Rhythm: Normaali, terve sydämen rytmi
  • Atrial Fibrillation: Epäsäännöllinen rytmi, voi vaatia lääkärin arviota
  • Inconclusive: Voi viitata heikkoon signaaliin, liikkeeseen lukeman aikana tai muihin tekijöihin
  • High/Low Heart Rate: Syke luokittelun kannalta normaalialueen ulkopuolella

Laitteiden yhteensopivuus

EKG-toiminto vaatii:

  • Apple Watch Series 4 tai uudemman (EKG-sovelluksella)
  • iOS 12.1.1 tai uudemman paritetulla iPhonella
  • EKG-sovelluksen asennettuna ja määritettynä

Käyttötapaukset

EKG-data voi olla hyödyllistä:

  • Sydämen rytmin seuranta: Rytmikuvioiden seuranta ajan myötä
  • Eteisvärinän havaitseminen: Eteisvärinäjaksojen seuranta
  • Potilaskertomukset: EKG-datan jakaminen hoitajille
  • Trendianalyysi: Rytmikuvioiden tai muutosten tunnistaminen
  • Oireiden yhdistäminen: EKG-lukemien ristiinviittaus oireisiin tai aktiviteetteihin

Tärkeitä huomioita

  • Ei lääkinnällinen laite: Apple Watchin EKG ei korvaa ammattilaisten diagnostiikkaa
  • Käänny hoitajan puoleen: Keskustele aina EKG-tuloksista terveydenhuollon ammattilaisten kanssa, erityisesti jos eteisvärinä havaitaan
  • Säännöllinen seuranta: Toistuvat lukemat voivat auttaa kuvioiden tunnistamisessa, mutta eivät korvaa ammattimaista hoitoa
  • Tiedostokoko: EKG-vienti täysillä jännitemittauksilla voi olla suuri korkean näytteenottotaajuuden vuoksi

Vinkit

  • Johdonmukaiset lukemat: Ota EKG samoihin aikoihin parempaa trendianalyysiä varten
  • Oikea asento: Varmista kellon oikea istuvuus ja paikallaan pysyminen lukeman aikana
  • Vienti valikoiden: Harkitse aikaväliä EKG-dataa vietäessä – tiedostot voivat olla suuria täysillä jännitemittauksilla

Liittyvä dokumentaatio