Zobrazovací metody

DICOMweb vysvětleno: QIDO-RS, WADO-RS a STOW-RS s příklady požadavků

DICOMweb je rozhraní REST standardu DICOM: QIDO-RS vyhledává studie, WADO-RS načítá obrázky a metadata, STOW-RS je ukládá. Jak se sestavují URL, jak vypadá JSON, jak se liší od klasického DICOM síťování a co vlastně volá webový prohlížeč.

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

Krátká odpověď: DICOMweb je soubor webových služeb definovaných v části 18 standardu DICOM. Zpřístupňuje archiv DICOM přes běžný protokol HTTPS: QIDO-RS (Query based on ID for DICOM Objects) vyhledává studie, série a instance; WADO-RS (Web Access to DICOM Objects) je načítá jako plné soubory DICOM, jako metadata ve formátu JSON nebo jako vykreslené obrázky JPEG/PNG; STOW-RS (Store Over the Web) nahrává nové objekty. Starší WADO-URI načítá jeden objekt pomocí parametrů dotazu. Prohlížeče založené na webu používají DICOMweb, protože neumí komunikovat pomocí klasického protokolu DICOM.

Klasický DICOM vs. DICOMweb

Klasické DICOM sítě (části 7 a 8 standardu) používají binární protokol přes TCP se službami jako C-FIND, C-MOVE, C-GET a C-STORE mezi nakonfigurovanými uzly. DICOMweb (část 18) mapuje stejné operace na HTTP: QIDO-RS pro vyhledávání, WADO-RS pro načítání a STOW-RS pro ukládání, což funguje přes internet a z prohlížečů.

Klasický DICOM (část 7 a 8) používá svůj vlastní binární protokol přes TCP s pojmenovanými službami: C-FIND pro dotazování, C-MOVE nebo C-GET pro načítání, C-STORE pro odesílání. Vyžaduje nakonfigurované "sdružení" mezi dvěma známými uzly (AE tituly, IP adresy, porty), což je v pořádku uvnitř nemocnice a obtížné přes internet. DICOMweb mapuje stejné koncepty na HTTP:

Úkol Klasický DICOM DICOMweb
Najít studii C-FIND QIDO-RS: GET /studies?PatientID=…
Načíst studii C-MOVE / C-GET WADO-RS: GET /studies/{StudyInstanceUID}
Číst pouze metadata C-FIND na úrovni instance WADO-RS: GET /studies/{uid}/metadata
Získat zobrazitelný obrázek načíst a poté vykreslit lokálně WADO-RS vykreslený: GET …/instances/{uid}/rendered
Odeslat obrázky do archivu C-STORE STOW-RS: POST /studies
Spravovat pracovní seznamy MWL (C-FIND na pracovním seznamu) UPS-RS

Hierarchie zdrojů sleduje vlastní model DICOM: studie (jedna návštěva skeneru) obsahuje série (každá jedna akvizice), které obsahují instance (jednotlivé obrázky nebo vícerozměrné objekty), každá identifikovaná globálně unikátním UID.

QIDO-RS: vyhledávání

QIDO-RS je vyhledávací služba DICOMweb. Klient odešle GET /studies, /series nebo /instances s parametry dotazu, jako jsou PatientID, StudyDate nebo ModalitiesInStudy, a hlavičkou Accept application/dicom+json. Archiv vrátí pole JSON, ve kterém je každý atribut DICOM označen svým osmimístným tagem spolu s jeho reprezentací hodnoty a hodnotami.

GET /dicomweb/studies?PatientID=12345&StudyDate=20260101-20261231&ModalitiesInStudy=CT
Accept: application/dicom+json

Odpověď je pole JSON studií. Každý atribut je klíčován svým tagem (skupina a prvek jako osm hexadecimálních číslic), s jeho reprezentací hodnoty a hodnotami:

[{
  "00080020": {"vr": "DA", "Value": ["20260314"]},
  "00080060": {"vr": "CS", "Value": ["CT"]},
  "00100010": {"vr": "PN", "Value": [{"Alphabetic": "DOE^JANE"}]},
  "0020000D": {"vr": "UI", "Value": ["1.2.840.113619.2.55.3.2831164356.781.1710415000.1"]},
  "00201206": {"vr": "IS", "Value": [3]},
  "00201208": {"vr": "IS", "Value": [412]}
}]

Zde 00201206 je Počet sérií souvisejících se studií a 00201208 je Počet instancí souvisejících se studií. Čísla tagů jsou vysvětlena v Vysvětlení tagů DICOM.

WADO-RS: načítání

WADO-RS je služba pro načítání DICOMweb. GET /studies/{StudyInstanceUID} vrátí celou studii jako soubory DICOM část 10 v odpovědi multipart; přípona /metadata vrátí hlavičky jako JSON bez dat pixelů; /frames/{n} vrátí pixely jednoho snímku; a /rendered vrátí serverem vykreslené JPEG nebo PNG s parametry okna, zobrazení a kvality.

  • GET /studies/{study} s Accept: multipart/related; type="application/dicom" vrátí každou instanci jako soubor DICOM Part 10, jednu část za každou.
  • GET /studies/{study}/metadata vrátí hlavičky všech instancí jako JSON, bez pixelových dat. Prohlížeče toto volají nejprve k sestavení rozvržení a poté načítají pixely snímek po snímku.
  • GET /studies/{study}/series/{series}/instances/{instance}/frames/1 vrátí pixelová data jednoho snímku, volitelně transkódovaná (parametr transfer-syntax).
  • GET …/instances/{instance}/rendered s Accept: image/jpeg vrátí serverem vykreslený obrázek s parametry window, viewport a quality. Toto používá lehký pacientský portál k zobrazení náhledu.

STOW-RS: ukládání

STOW-RS je služba pro ukládání DICOMweb. Klient odešle POST /studies s tělem multipart/related, ve kterém je každá část jedním souborem DICOM. Archiv odpoví seznamem přijatých a neúspěšných instancí a důvodem každého neúspěchu a zkontroluje, zda se jakékoli Study Instance UID uvedené v URL shoduje s nahranými soubory.

POST /dicomweb/studies
Content-Type: multipart/related; type="application/dicom"; boundary=abc

Každá část je jeden soubor DICOM. Odpověď uvádí přijaté a neúspěšné instance s důvody (špatná třída SOP, duplicitní UID). Archívy ověřují, zda Study Instance UID v URL, pokud je zadán, odpovídá souborům.

Zabezpečení

DICOMweb nemá vlastní přihlašování; spoléhá na HTTPS a cokoli, co server před něj umístí: v moderních archivech nejčastěji tokeny nositele OAuth 2.0, často v kombinaci s rozsahy SMART on FHIR, když je prohlížeč spuštěn z EHR. Zaznamenávání toho, kdo jakou studii načetl, je úkolem archivu, nikoli protokolu.

Kde se používá

Každý hlavní PACS a vendor-neutral archive nyní nabízí koncový bod DICOMweb a open-source archívy (Orthanc, dcm4chee, Google Cloud Healthcare API, Azure DICOM service) jsou primárně DICOMweb. Webové prohlížeče jako OHIF jsou postaveny výhradně na QIDO-RS a WADO-RS. Ve světě FHIR odkazuje zdroj ImagingStudy na koncový bod DICOMweb; pixely nikdy neprocházejí přes FHIR.

Anpheros neukládá obrázky. Záznam pacienta může obsahovat radiologickou zprávu jako DocumentReference nebo DiagnosticReport a tam, kde nemocnice poskytuje odkaz na svůj prohlížeč; samotná data DICOM zůstávají v archivu nemocnice. Pro získání vlastních obrázků jako pacient se podívejte na Jak získat snímky z CT nebo MRI.

Související stránky

Zdroje

Časté otázky

Je DICOMweb jiný standard než DICOM?

Ne. Je to část 18 stejného standardu DICOM. Objekty, tagy a UID jsou identické; mění se pouze přenos z vlastního protokolu DICOM na HTTP.

Jaký je rozdíl mezi WADO-URI a WADO-RS?

WADO-URI je starší služba: jeden objekt na požadavek, vybraný pomocí parametrů dotazu (?requestType=WADO&studyUID=…). WADO-RS je RESTful, může vracet celé studie nebo série, metadata ve formátu JSON a jednotlivé snímky, a je to to, co implementují nové systémy.

Mohu použít DICOMweb bez PACS?

Potřebujete nějaký archiv, který jej implementuje. Open-source servery jako Orthanc a dcm4chee poskytují DICOMweb ihned a jsou běžně používány pro vývoj a pro malé kliniky.

Nahrazuje FHIR DICOMweb?

Ne. FHIR popisuje studii (ImagingStudy) a zprávu (DiagnosticReport); DICOMweb doručuje obrázky. Prohlížeč používá obojí: FHIR k zjištění, že studie existuje, a DICOMweb k jejímu zobrazení.

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 →