Zobrazovací metody

FHIR ImagingStudy vs DICOMweb: metadata ve FHIR, pixely v DICOM, s příkladem

ImagingStudy je FHIR zdroj, který popisuje zobrazovací studii (modalita, série, instance, UID) a odkazuje na místo, kde se obrázky nacházejí. DICOMweb je způsob, jak se obrázky skutečně načítají. Jak se tyto dva prvky propojují přes Endpoint, platný příklad R4 a chyby, které rozbíjejí prohlížeče.

od Publikováno Přečteno za 4 min

Krátká odpověď: ImagingStudy je FHIR zdroj, který říká tento pacient podstoupil CT v tento den, s těmito sériemi a těmito UID instancí, a obrázky jsou tamhle. DICOMweb je to tamhle: REST rozhraní archivu, který drží pixely. FHIR nese popis a zprávu; DICOM nese obrázky. ImagingStudy odkazuje na zdroj Endpoint s connectionType nastaveným na dicom-wado-rs a prohlížeč tyto dva spojuje.

Co ImagingStudy obsahuje

Zdroj FHIR ImagingStudy obsahuje metadata jedné zobrazovací studie: DICOM Study Instance UID jako identifikátor, stav, předmět Pacient, setkání, čas zahájení a objednávající ServiceRequest, kódy modalit z vokabuláře DICOM DCM, počty sérií a instancí, Endpoint, kde se obrázky nacházejí, a každou sérii s jejími instancemi a UID. Neobsahuje žádné pixely.

  • identifier: DICOM Study Instance UID, jako urn:oid:1.2.840… se systémem urn:dicom:uid;
  • status: registered, available, cancelled, entered-in-error, unknown;
  • subject: Pacient; encounter, started, referrer, basedOn (ServiceRequest, který jej objednal);
  • modality: kódy z vlastního slovníku DICOM (CT, MR, US, CR, DX…), systém http://dicom.nema.org/resources/ontology/DCM;
  • numberOfSeries, numberOfInstances;
  • endpoint: kde načíst obrázky;
  • series[]: každý se svým Series Instance UID, modalitou, tělesnou lokalizací, instance[] s SOP Instance UID a SOP Class UID.

Co neobsahuje: obrazová data, nastavení oken, plnou hlavičku DICOM, ani text zprávy. Zpráva je DiagnosticReport s odkazem imagingStudy zpět.

Platný příklad FHIR R4

Platný příklad FHIR R4 ImagingStudy obsahuje Study Instance UID jako identifikátor se systémem urn:dicom:uid, stav dostupný, modalitu CT z kódového systému DICOM DCM, pacienta, čas zahájení, počty sérií a instancí, odkaz na Endpoint s connectionType dicom-wado-rs a položky série s jejich UID, místem těla 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 vypadá 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"
}

Prohlížeč sestaví URL pro načtení z těchto dvou: {Endpoint.address}/studies/{StudyInstanceUID}, poté zavolá WADO-RS pro metadata a snímky.

Kdo vytváří zdroje ImagingStudy

Zdroje ImagingStudy obvykle vytváří FHIR fasáda před PACS nebo VNA, nebo integrační engine, když je studie dokončena, často spuštěna zprávou HL7 v2 ORU nebo DICOM MPPS. Některé archivy je generují za běhu z dotazu QIDO-RS. Samotný skener nevytváří zdroje ImagingStudy.

Obvykle ne skener. FHIR fasáda před PACS nebo VNA, nebo integrační engine, vytvoří ImagingStudy, když je studie dokončena (často spuštěno zprávou HL7 v2 ORU nebo DICOM MPPS) a udržuje numberOfInstances synchronizované. Některé archivy generují ImagingStudy za běhu z QIDO-RS dotazu. Pokud je váš projekt píše ručně, UID se musí přesně shodovat s archivem, znak po znaku, jinak prohlížeč zobrazí prázdnou studii.

Chyby, které rozbíjejí prohlížeče

Chyby, které rozbíjejí prohlížeče čtoucí FHIR ImagingStudy, jsou: umístění Study UID do id místo identifier, použití nekódu modalit DICOM, nasměrování Endpointu s nesprávným connectionType na DICOMweb server, ponechání počtu sérií a instancí zastaralé po změně obrázků a očekávání dat pixelů ve FHIR Binary místo v archivu DICOM.

  • Umístění Study UID do id místo do identifier; FHIR id jsou přiřazena serverem a nemusí být OID.
  • Modalita ze SNOMED nebo lokálního seznamu místo kódového systému DICOM DCM.
  • Endpoint s connectionType hl7-fhir-rest ukazující na DICOMweb server, nebo naopak.
  • Počítání sérií a instancí jednou a nikdy neaktualizování při přidání nebo smazání obrázků.
  • Očekávání obrazových dat ve FHIR Binary. Samotná specifikace FHIR uvádí, že obrázky patří do DICOM, nikoli do Binary.

V záznamu Anpheros

Anpheros Platform nehostuje ImagingStudy ani DICOM data. Radiologické nálezy přicházejí jako DiagnosticReport nebo DocumentReference (zpráva s jejími kódy a textem); tam, kde nemocnice zpřístupní odkaz na prohlížeč, může DocumentReference nést tento odkaz jako přílohu. Obrázky zůstávají v archivu nemocnice pod jejími přístupovými pravidly.

Související stránky

Zdroje

Časté otázky

Může FHIR server ukládat samotné obrázky?

Technicky může Binary držet jakékoli bajty, ale specifikace FHIR to pro zobrazování nedoporučuje a žádný prohlížeč tak nefunguje. Obrázky zůstávají v DICOM archivu; FHIR na něj odkazuje.

Co se změnilo ve FHIR R5 pro ImagingStudy?

R5 zachovává stejný tvar, zpřehledňuje pojmenování (například procedure nahrazuje procedureReference a procedureCode) a sjednocuje zpracování tělesných lokalizací. R4 zůstává verzí, kterou používá většina archivů a národních profilů.

Jak se zpráva propojí s obrázky?

DiagnosticReport.imagingStudy odkazuje na ImagingStudy; DiagnosticReport.media může nést klíčové obrázky jako zdroje Media. ImagingStudy odkazuje na Endpoint pro celou studii.

Potřebuji ImagingStudy, pokud už mám DICOMweb?

Pouze pokud ostatní FHIR konzumenti potřebují vědět, že studie existuje, například klientská aplikace pacienta, plán péče nebo výzkumný export. Samotný radiologický prohlížeč může fungovat na QIDO-RS a WADO-RS.

Anpheros Daily

Vyzkoušejte v Anpheros Daily

Uchovejte si zprávy z vyšetření a testů na jednom místě v Anpheros Daily, připravené k předložení při vaší další návštěvě.

Jak to funguje v aplikaci →
Tento návod slouží pouze pro informační účely a nenahrazuje lékařskou radu. Ohledně rozhodnutí o svém zdraví se poraďte se svým lékařem. V naléhavém případě volejte místní tísňové číslo (v Evropě 112).
Napsal
Tým Anpheros

Anpheros vytváří zdravotní záznamy, které pacient ovládá a může sdílet s jakoukoli klinikou, na platformě HL7 FHIR R4 se sídlem v EU. Tyto průvodce vám pomohou porozumět vašemu zdraví a uspořádat si ho; nenahrazují vašeho lékaře.

O Anpheros →