DICOM-Instanz-Frames abrufen von HealthImaging - AWS HealthImaging

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

DICOM-Instanz-Frames abrufen von HealthImaging

Verwenden Sie die GetDICOMInstanceFrames Aktion, um einzelne Bild-Frames oder Batch-Frames (multipartAnfrage) von einer DICOM-Instance in einem HealthImaging Datenspeicher abzurufen, indem Sie die Serien-UID, die Studien-UID, die Instanz und die Frame-Nummern angeben UIDs, die einer Ressource zugeordnet sind. Sie können den Bilddatensatz angeben, aus dem Instanz-Frames abgerufen werden sollen, indem Sie die Bilddatensatz-ID als Abfrageparameter angeben. Die API gibt nur Instanzframes aus primären Bilddatensätzen zurück, es sei denn, der optionale Bildsatzparameter wird bereitgestellt. Sie können jeden Instanz-Frame (aus primären oder nicht primären Bilddatensätzen) im Datenspeicher abrufen, indem Sie den imageSetId als Abfrageparameter angeben.

DICOM-Daten können entweder in der gespeicherten Übertragungssyntax oder im unkomprimierten Format (ELE) abgerufen werden.

Um DICOM-Instanz-Frames () abzurufen multipart

  1. Werte sammeln HealthImaging datastoreId und imageSetId parametrieren.

  2. Verwenden Sie die GetImageSetMetadataAktion mit den imageSetId Parameterwerten datastoreId und, um die zugehörigen Metadatenwerte für studyInstanceUIDseriesInstanceUID, und abzurufensopInstanceUID. Weitere Informationen finden Sie unter Metadaten von Bilddatensätzen abrufen.

  3. Ermitteln Sie die Bildrahmen, die aus den zugehörigen Metadaten abgerufen werden sollen, um den frameList Parameter zu bilden. Der frameList Parameter ist eine durch Kommas getrennte Liste mit einer oder mehreren Frame-Nummern, die nicht doppelt vorhanden sind, in beliebiger Reihenfolge. Der erste Bildrahmen in den Metadaten ist beispielsweise Frame 1.

    • Einzelrahmen-Anfrage: /frames/1

    • Anfrage mit mehreren Frames: /frames/1,2,3,4

  4. Konstruieren Sie eine URL für die Anfrage mit den Werten für datastoreIdstudyInstanceUID,seriesInstanceUID, sopInstanceUIDimageSetId, undframeList. Scrollen Sie über die Schaltfläche Kopieren, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen. Die URL hat die Form:

    GET https://dicom-medical-imaging.region.amazonaws.com/datastore/datastore-id/studies/study-instance-uid/series/series-instance-uid/instances/sop-instance-uid/frames/1?imageSetId=image-set-id

  5. Bereiten Sie Ihre Anfrage vor und senden Sie sie ab. GetDICOMInstanceFramesverwendet eine HTTP-GET-Anfrage mit dem AWS Signaturprotokoll Signature Version 4. Das folgende Codebeispiel verwendet das curl Befehlszeilentool, um Bildrahmen in einer multipart Antwort von abzurufen HealthImaging.

    Shell
    curl --request GET \
  'https://dicom-medical-imaging.us-east-1.amazonaws.com/datastore/d9a2a515ab294163a2d2f4069eed584c/studies/1.3.6.1.4.1.5962.1.2.4.20040826285059.5457/series/1.3.6.1.4.1.5962.1.3.4.1.20040825185059.5457/instances/1.3.6.1.4.1.5962.1.1.4.1.1.20040826186059.5457/frames/1?imageSetId=459e50687f121185f747b67bb60d1bc8' \
  --aws-sigv4 'aws:amz:us-east-1:medical-imaging' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: multipart/related; type=application/octet-stream; transfer-syntax=1.2.840.10008.1.2.1'
    Anmerkung

    Die transfer-syntax UID ist optional und wird standardmäßig auf Explicit VR Little Endian gesetzt, falls sie nicht enthalten ist. Wenn die Transcodierung nach ELE nicht möglich ist (aufgrund eines Imports mit Warnung), werden Pixel ohne Transcodierung zurückgegeben. Zu den unterstützten Übertragungssyntaxen gehören:

    • Explicit VR Little Endian (ELE) — 1.2.840.10008.1.2.1 (Standard für verlustfreie Bildrahmen)

    • transfer-syntax=*Wenn ja, werden die Bildrahmen in der gespeicherten Übertragungssyntax zurückgegeben.

    • JPEG 2000 mit hohem Durchsatz und RPCL-Optionen Bildkomprimierung (nur verlustfrei) — 1.2.840.10008.1.2.4.202 — wenn die Instanz gespeichert ist unter HealthImaging 1.2.840.10008.1.2.4.202

    • JPEG 2000 Lossless — 1.2.840.10008.1.2.4.90 — wenn die Instanz als Lossless gespeichert ist. HealthImaging

    • JPEG-Baseline (Prozess 1): Standardübertragungssyntax für die verlustbehaftete 8-Bit-JPEG-Bildkomprimierung 1.2.840.10008.1.2.4.50 —, wenn die Instanz gespeichert ist in HealthImaging 1.2.840.10008.1.2.4.50

    • JPEG 2000-Bildkomprimierung — 1.2.840.10008.1.2.4.91 — wenn die Instanz gespeichert ist unter HealthImaging 1.2.840.10008.1.2.4.91

    • JPEG 2000-Bildkomprimierung mit hohem Durchsatz 1.2.840.10008.1.2.4.203 - - wenn die Instanz gespeichert ist unter HealthImaging 1.2.840.10008.1.2.4.203

    • JPEG XL-Bildkomprimierung 1.2.840.10008.1.2.4.112 - - wenn die Instanz gespeichert ist unter HealthImaging 1.2.840.10008.1.2.4.112

    • Instanzen, in HealthImaging denen ein oder mehrere Bildrahmen gespeichert sind, die in der MPEG-Familie von Transfersyntaxen (zu der auch MPEG-4 AVC/H.264 and HEVC/H .265 gehören) kodiert sind MPEG2, können mit der entsprechenden Transfer-Syntax-UID abgerufen werden. Dies ist beispielsweise der Fall, 1.2.840.10008.1.2.4.100 wenn die Instanz als Main Profile Main Level gespeichert ist. MPEG2

    • Möglicherweise erhalten Sie einen NotAcceptableException 406-Wert, wenn die angeforderte Übertragungssyntax aufgrund der gespeicherten Übertragungssyntax nicht zurückgegeben werden kann oder wenn es spezielle Verarbeitungswarnungen für die Instanz gibt. Wenn dies der Fall ist, versuchen Sie erneut, den Anruf mittransfer-syntax=*.

    Weitere Informationen erhalten Sie unter Unterstützte Übertragungssyntaxen und Bibliotheken zur Dekodierung von Image-Frames für AWS HealthImaging.