Zobrazovanie

DICOMweb vysvetlený: QIDO-RS, WADO-RS a STOW-RS s príkladmi požiadaviek

DICOMweb je REST rozhranie štandardu DICOM: QIDO-RS vyhľadáva štúdie, WADO-RS načítava obrázky a metadata, STOW-RS ich ukladá. Ako sa tvoria URL, ako vyzerá JSON, v čom sa líši od klasického DICOM networkingu a čo vlastne volá webový prehliadač.

od Zverejnené 5 min čítania

Krátka odpoveď: DICOMweb je súbor webových služieb definovaných v časti 18 štandardu DICOM. Sprístupňuje archív DICOM cez bežný HTTPS: QIDO-RS (Query based on ID for DICOM Objects) vyhľadáva štúdie, série a inštancie; WADO-RS (Web Access to DICOM Objects) ich načíta ako plné súbory DICOM, ako metadáta v JSON alebo ako vykreslené JPEG/PNG; STOW-RS (Store Over the Web) nahráva nové objekty. Starší WADO-URI načíta jeden objekt prostredníctvom parametrov dopytu. Prehliadače založené na prehliadači používajú DICOMweb, pretože nedokážu komunikovať pomocou klasického DICOM sieťovania.

Klasický DICOM vs. DICOMweb

Klasické DICOM sieťovanie (časti 7 a 8 štandardu) používa binárny protokol cez TCP so službami ako C-FIND, C-MOVE, C-GET a C-STORE medzi nakonfigurovanými uzlami. DICOMweb (časť 18) mapuje rovnaké operácie na HTTP: QIDO-RS na vyhľadávanie, WADO-RS na načítanie a STOW-RS na ukladanie, čo funguje cez internet a z prehliadačov.

Klasický DICOM (časť 7 a 8) používa svoj vlastný binárny protokol cez TCP s pomenované služby: C-FIND na vyhľadávanie, C-MOVE alebo C-GET na načítanie, C-STORE na odosielanie. Vyžaduje nakonfigurované "asociácie" medzi dvoma známymi uzlami (AE tituly, IP adresy, porty), čo je v poriadku v rámci nemocnice a ťažké cez internet. DICOMweb mapuje rovnaké myšlienky na HTTP:

Úloha Klasický DICOM DICOMweb
Nájsť štúdiu C-FIND QIDO-RS: GET /studies?PatientID=…
Načítať štúdiu C-MOVE / C-GET WADO-RS: GET /studies/{StudyInstanceUID}
Čítať iba metadáta C-FIND na úrovni inštancie WADO-RS: GET /studies/{uid}/metadata
Získať zobraziteľný obrázok načítať a potom vykresliť lokálne WADO-RS vykreslené: GET …/instances/{uid}/rendered
Odoslať obrázky do archívu C-STORE STOW-RS: POST /studies
Spravovať pracovné zoznamy MWL (C-FIND na pracovnom zozname) UPS-RS

Hierarchia zdrojov sleduje vlastný model DICOM: štúdia (jedna návšteva skenera) obsahuje série (každá jedna akvizícia), ktoré obsahujú inštancie (jednotlivé obrázky alebo viacrámcové objekty), každá identifikovaná globálne jedinečným UID.

QIDO-RS: vyhľadávanie

QIDO-RS je vyhľadávacia služba DICOMweb. Klient pošle GET /studies, /series alebo /instances s parametrami dopytu ako PatientID, StudyDate alebo ModalitiesInStudy a hlavičkou Accept application/dicom+json. Archív vráti pole JSON, v ktorom je každý atribút DICOM označený osemciferným tagom spolu s jeho reprezentáciou hodnoty a hodnotami.

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

Odpoveď je JSON pole štúdií. Každý atribút je kľúčovaný jeho značkou (skupina a prvok ako osem hexadecimálnych číslic), s jeho reprezentáciou 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]}
}]

Tu 00201206 je Počet sérií súvisiacich so štúdiou a 00201208 je Počet inštancií súvisiacich so štúdiou. Čísla značiek sú vysvetlené v Vysvetlenie značiek DICOM.

WADO-RS: načítanie

WADO-RS je služba načítania DICOMweb. GET /studies/{StudyInstanceUID} vráti celú štúdiu ako súbory DICOM časť 10 v multipart odpovedi; prípona /metadata vráti hlavičky ako JSON bez pixelových dát; /frames/{n} vráti pixely jedného snímku; a /rendered vráti serverovo vykreslené JPEG alebo PNG s parametrami okna, pohľadu a kvality.

  • GET /studies/{study} s Accept: multipart/related; type="application/dicom" vráti každú inštanciu ako súbor DICOM Part 10, jednu časť za každú.
  • GET /studies/{study}/metadata vráti hlavičky všetkých inštancií ako JSON, bez pixelových dát. Prehliadače to volajú najprv na zostavenie rozloženia, potom načítajú pixely rám po rámčeku.
  • GET /studies/{study}/series/{series}/instances/{instance}/frames/1 vráti pixelové dáta jedného rámčeka, voliteľne transkódované (parameter transfer-syntax).
  • GET …/instances/{instance}/rendered s Accept: image/jpeg vráti serverom vykreslený obrázok, s parametrami window, viewport a quality. Toto používa ľahký pacientsky portál na zobrazenie náhľadu.

STOW-RS: ukladanie

STOW-RS je úložná služba DICOMweb. Klient pošle POST /studies s telom multipart/related, v ktorom je každá časť jeden súbor DICOM. Archív odpovie zoznamom prijatých a neúspešných inštancií a dôvodom každého zlyhania a skontroluje, či sa akékoľvek Study Instance UID uvedené v URL zhoduje s nahranými súbormi.

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

Každá časť je jeden súbor DICOM. Odpoveď uvádza prijaté a neúspešné inštancie s dôvodmi (nesprávna trieda SOP, duplicitné UID). Archívy overujú, že Study Instance UID v URL, ak je uvedený, zodpovedá súborom.

Bezpečnosť

DICOMweb nemá vlastné prihlásenie; spolieha sa na HTTPS a čokoľvek, čo server umiestni pred neho: tokeny nositeľa OAuth 2.0 vo väčšine moderných archívov, často v kombinácii s rozsahmi SMART on FHIR, keď je prehliadač spustený z EHR. Zaznamenávanie toho, kto si akú štúdiu prezeral, je úlohou archívu, nie protokolu.

Kde sa používa

Každý hlavný PACS a neutrálny archív teraz ponúka koncový bod DICOMweb a open-source archívy (Orthanc, dcm4chee, Google Cloud Healthcare API, Azure DICOM service) sú primárne DICOMweb. Webové prehliadače ako OHIF sú postavené výhradne na QIDO-RS a WADO-RS. Vo svete FHIR, zdroj ImagingStudy ukazuje na koncový bod DICOMweb; pixely nikdy neprechádzajú cez FHIR.

Anpheros neukladá obrázky. Záznam pacienta môže obsahovať rádiologickú správu ako DocumentReference alebo DiagnosticReport a tam, kde nemocnica poskytuje, odkaz na jej prehliadač; samotné dáta DICOM zostávajú v archíve nemocnice. Pre získanie vašich vlastných obrázkov ako pacienta si pozrite Ako získať svoje CT alebo MRI snímky.

Súvisiace stránky

Zdroje

Časté otázky

Je DICOMweb iný štandard ako DICOM?

Nie. Je to časť 18 toho istého štandardu DICOM. Objekty, značky a UID sú identické; mení sa iba prenos z vlastného protokolu DICOM na HTTP.

Aký je rozdiel medzi WADO-URI a WADO-RS?

WADO-URI je staršia služba: jeden objekt na požiadavku, vybratý pomocou parametrov dopytu (?requestType=WADO&studyUID=…). WADO-RS je RESTful, môže vracať celé štúdie alebo série, metadáta ako JSON a jednotlivé rámčeky, a je to to, čo implementujú nové systémy.

Môžem použiť DICOMweb bez PACS?

Potrebujete nejaký archív, ktorý ho implementuje. Open-source servery ako Orthanc a dcm4chee poskytujú DICOMweb hneď po vybalení a bežne sa používajú na vývoj a pre malé kliniky.

NHRADÍ FHIR DICOMweb?

Nie. FHIR popisuje štúdiu (ImagingStudy) a správu (DiagnosticReport); DICOMweb doručuje obrázky. Prehliadač používa oboje: FHIR na zistenie, že štúdia existuje, DICOMweb na jej zobrazenie.

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 →