Zobrazovacie metódy

FHIR ImagingStudy vs DICOMweb: metadata vo FHIR, pixely v DICOM, s príkladom

ImagingStudy je FHIR zdroj, ktorý popisuje zobrazovaciu štúdiu (modalita, séria, inštancie, UID) a ukazuje, kde sa obrázky nachádzajú. DICOMweb je spôsob, ako sa obrázky skutočne načítajú. Ako sa tieto dva prvky prepoja cez Endpoint, platný príklad R4 a chyby, ktoré rozbijú prehliadače.

od Zverejnené 4 min čítania

Krátka odpoveď: ImagingStudy je FHIR zdroj, ktorý hovorí tento pacient mal CT v tento dátum, s týmito sériami a týmito UID, a obrázky sú tamto. DICOMweb je to tamto: REST rozhranie archívu, ktorý uchováva pixely. FHIR nesie popis a správu; DICOM nesie obrázky. ImagingStudy odkazuje na zdroj Endpoint, ktorého connectionType je dicom-wado-rs, a prehliadač kombinuje oboje.

Čo obsahuje ImagingStudy

FHIR zdroj ImagingStudy obsahuje metadata jedného zobrazovacieho vyšetrenia: DICOM Study Instance UID ako identifikátor, stav, príslušného pacienta (Patient), návštevu (Encounter), čas začiatku a objednávajúcu žiadosť o službu (ServiceRequest), kódy modalít z DICOM slovníka DCM, počty sérií a inštancií, koncový bod (Endpoint), kde sa obrázky nachádzajú, a každú sériu s jej inštanciami a UID. Neobsahuje žiadne obrazové dáta.

  • identifier: DICOM Study Instance UID, ako urn:oid:1.2.840… so systémom urn:dicom:uid;
  • status: registered, available, cancelled, entered-in-error, unknown;
  • subject: Pacient; encounter, started, referrer, basedOn (ServiceRequest, ktorý to objednal);
  • modality: kódy z vlastného slovníka DICOM (CT, MR, US, CR, DX…), systém http://dicom.nema.org/resources/ontology/DCM;
  • numberOfSeries, numberOfInstances;
  • endpoint: kde získať obrázky;
  • series[]: každý so svojím Series Instance UID, modalitou, telesnou lokalizáciou, instance[] so SOP Instance UID a SOP Class UID.

Čo neobsahuje: obrazové dáta, nastavenia okna, celý DICOM hlavičku, alebo text správy. Správa je DiagnosticReport s odkazom späť na imagingStudy.

Platný príklad FHIR R4

Platný príklad FHIR R4 ImagingStudy obsahuje Study Instance UID ako identifikátor so systémom urn:dicom:uid, stav „available“, modalitu CT z DICOM kódového systému DCM, pacienta, čas začiatku, počty sérií a inštancií, odkaz na koncový bod (Endpoint) s connectionType dicom-wado-rs a položky série s ich UID, miestom na tele a SOP Class UID.

{
  "resourceType": "ImagingStudy",
  "id": "ct-chest-2026-03",
  "identifier": [{"system": "urn:dicom:uid", "value": "urn:oid:1.2.840.113619.2.55.3.2831164356.781.1710415000.1"}],
  "status": "available",
  "modality": [{"system": "http://dicom.nema.org/resources/ontology/DCM", "code": "CT"}],
  "subject": {"reference": "Patient/example"},
  "started": "2026-03-14T09:12:00+01:00",
  "numberOfSeries": 2,
  "numberOfInstances": 412,
  "endpoint": [{"reference": "Endpoint/pacs-dicomweb"}],
  "series": [{
    "uid": "1.2.840.113619.2.55.3.2831164356.781.1710415000.2",
    "number": 1,
    "modality": {"system": "http://dicom.nema.org/resources/ontology/DCM", "code": "CT"},
    "bodySite": {"system": "http://snomed.info/sct", "code": "51185008", "display": "Thoracic structure"},
    "numberOfInstances": 410,
    "instance": [{
      "uid": "1.2.840.113619.2.55.3.2831164356.781.1710415000.3",
      "sopClass": {"system": "urn:ietf:rfc:3986", "code": "urn:oid:1.2.840.10008.5.1.4.1.1.2"},
      "number": 1
    }]
  }]
}

SOP Class UID 1.2.840.10008.5.1.4.1.1.2 je CT Image Storage. Endpoint vyzerá takto:

{
  "resourceType": "Endpoint",
  "id": "pacs-dicomweb",
  "status": "active",
  "connectionType": {"system": "http://terminology.hl7.org/CodeSystem/endpoint-connection-type", "code": "dicom-wado-rs"},
  "payloadType": [{"text": "DICOM WADO-RS"}],
  "address": "https://pacs.example-hospital.org/dicomweb"
}

Prehliadač zostaví URL na načítanie z oboch: {Endpoint.address}/studies/{StudyInstanceUID}, potom zavolá WADO-RS pre metadata a snímky.

Kto vytvára zdroje ImagingStudy

Zdroje ImagingStudy zvyčajne vytvára FHIR fasáda pred PACS alebo VNA, alebo integračný engine, keď je vyšetrenie dokončené. Často je to spúšťané správou HL7 v2 ORU alebo DICOM MPPS. Niektoré archívy ich generujú dynamicky na základe QIDO-RS dotazu. Samotný skener nevytvára zdroje ImagingStudy.

Zvyčajne nie skener. FHIR fasáda pred PACS alebo VNA, alebo integračný engine, vytvorí ImagingStudy, keď je štúdia dokončená (často spustená správou HL7 v2 ORU alebo DICOM MPPS) a udržiava numberOfInstances synchronizované. Niektoré archívy generujú ImagingStudy na požiadanie z QIDO-RS dotazu. Ak ich váš projekt píše ručne, UID sa musia presne zhodovať s archívom, znak po znaku, inak prehliadač zobrazí prázdnu štúdiu.

Chyby, ktoré rozbijú prehliadače

Chyby, ktoré bránia prehliadačom v čítaní FHIR ImagingStudy, sú: umiestnenie Study UID do poľa id namiesto identifier, použitie kódu modality, ktorý nie je DICOM, nasmerovanie koncového bodu (Endpoint) s nesprávnym connectionType na DICOMweb server, ponechanie zastaraných počtov sérií a inštancií po zmene obrázkov a očakávanie obrazových dát vo FHIR Binary namiesto v DICOM archíve.

  • Umiestnenie Study UID do id namiesto identifier; FHIR id sú pridelené serverom a nemusia byť OID.
  • Modalita zo SNOMED alebo lokálneho zoznamu namiesto DICOM DCM kódu.
  • Endpoint s connectionType hl7-fhir-rest ukazujúci na DICOMweb server, alebo naopak.
  • Počítanie sérií a inštancií raz a nikdy ich neaktualizovanie, keď sú obrázky pridané alebo odstránené.
  • Očakávanie obrazových dát vo FHIR Binary. Samotná FHIR špecifikácia hovorí, že obrázky patria do DICOM, nie do Binary.

V zázname Anpheros

Anpheros Platform nehostuje ImagingStudy ani DICOM dáta. Rádiologické nálezy prichádzajú ako DiagnosticReport alebo DocumentReference (správa, s jej kódmi a textom); tam, kde nemocnica sprístupní odkaz na prehliadač, DocumentReference ho môže niesť ako URL prílohy. Obrázky zostávajú v archíve nemocnice pod jej prístupovými pravidlami.

Súvisiace stránky

Zdroje

Časté otázky

Môže FHIR server ukladať samotné obrázky?

Technicky môže Binary obsahovať akékoľvek bajty, ale FHIR špecifikácia to pre zobrazovanie neodporúča a žiadny prehliadač takto nefunguje. Obrázky zostávajú v DICOM archíve; FHIR na ne odkazuje.

Čo sa zmenilo vo FHIR R5 pre ImagingStudy?

R5 si zachováva rovnaký tvar, uhladzuje názvoslovie (napríklad procedure nahrádza procedureReference a procedureCode) a zosúlaďuje spracovanie telesnej lokalizácie. R4 zostáva verziou, ktorú používa väčšina archívov a národných profilov.

Ako sa správa spája s obrázkami?

DiagnosticReport.imagingStudy odkazuje na ImagingStudy; DiagnosticReport.media môže niesť kľúčové obrázky ako zdroje Media. ImagingStudy odkazuje na Endpoint pre celú štúdiu.

Potrebujem ImagingStudy, ak už mám DICOMweb?

Len ak iní FHIR konzumenti potrebujú vedieť, že štúdia existuje, napríklad pacientska aplikácia, plán starostlivosti alebo výskumný export. Samotný rádiologický prehliadač môže fungovať na QIDO-RS a WADO-RS.

Anpheros Daily

Vyskúšajte v Anpheros Daily

Majte svoje skeny a výsledky vyšetrení na jednom mieste v Anpheros Daily, pripravené na ukázanie pri vašej ďalšej návšteve.

Ako to funguje v aplikácii →
Tento návod slúži na informačné účely a nenahrádza lekársku radu. Pri rozhodovaní o svojom zdraví sa poraďte so svojím lekárom. V núdzi volajte miestne tiesňové číslo (v Európe 112).
Napísal
Tím Anpheros

Anpheros vyvíja zdravotný záznam, ktorý pacient ovláda a môže zdieľať s akoukoľvek klinikou, na platforme HL7 FHIR R4, so sídlom v EÚ. Tieto návody vám pomôžu pochopiť a usporiadať si svoje zdravie; nenahrádzajú vášho lekára.

O Anpherose →