Mendapatkan bingkai instans DICOM dari HealthImaging - AWS HealthImaging

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mendapatkan bingkai instans DICOM dari HealthImaging

Gunakan GetDICOMInstanceFrames tindakan untuk mengambil bingkai gambar tunggal atau batch (multipartpermintaan) dari instance DICOM di penyimpanan HealthImaging data dengan menentukan UID Seri, UID Studi, Instance UIDs, dan nomor bingkai yang terkait dengan sumber daya. Anda dapat menentukan kumpulan gambar dari mana bingkai instance harus diambil dengan memberikan ID kumpulan gambar sebagai parameter kueri. API hanya akan mengembalikan frame instance dari kumpulan gambar utama kecuali parameter set gambar opsional disediakan. Anda dapat mengambil frame instance apa pun (dari kumpulan gambar primer atau non-primer) di penyimpanan data dengan menentukan parameter imageSetId sebagai kueri.

Data DICOM dapat diambil baik dalam sintaks transfer yang disimpan atau sebagai format tidak terkompresi (ELE).

Untuk mendapatkan frame instance DICOM () multipart

  1. Kumpulkan HealthImaging datastoreId dan nilai imageSetId parameter.

  2. Gunakan GetImageSetMetadatatindakan dengan nilai imageSetId parameter datastoreId dan untuk mengambil nilai metadata terkait untukstudyInstanceUID,, seriesInstanceUID dan. sopInstanceUID Untuk informasi selengkapnya, lihat Mendapatkan metadata set gambar.

  3. Tentukan bingkai gambar untuk diambil dari metadata terkait untuk membentuk parameter. frameList frameListParameternya adalah daftar terpisah koma dari satu atau lebih nomor bingkai non-duplikat, dalam urutan apa pun. Misalnya, bingkai gambar pertama dalam metadata adalah bingkai 1.

    • Permintaan bingkai tunggal: /frames/1

    • Permintaan multi-bingkai: /frames/1,2,3,4

  4. Membangun URL untuk permintaan menggunakan nilai-nilai untukdatastoreId,,studyInstanceUID,seriesInstanceUID, sopInstanceUIDimageSetId, danframeList. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol Salin. URL adalah dari bentuk:

    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. Siapkan dan kirim permintaan Anda. GetDICOMInstanceFramesmenggunakan permintaan HTTP GET dengan protokol penandatanganan AWS Signature Version 4. Contoh kode berikut menggunakan alat baris curl perintah untuk mendapatkan bingkai gambar dalam multipart respons dari 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'
    catatan

    transfer-syntaxUID bersifat opsional dan default ke Explicit VR Little Endian jika tidak disertakan. Sintaks transfer yang didukung meliputi:

    • Eksplisit VR Little Endian (ELE) - 1.2.840.10008.1.2.1 (default untuk bingkai gambar lossless)

    • High-Throughput JPEG 2000 dengan Kompresi Gambar Opsi RPCL (Hanya Tanpa Lossless) - 1.2.840.10008.1.2.4.202 - jika instance disimpan sebagai HealthImaging 1.2.840.10008.1.2.4.202

    • JPEG 2000 Lossless - 1.2.840.10008.1.2.4.90 - jika instance disimpan sebagai lossless. HealthImaging

    • JPEG Baseline (Proses 1): Sintaks Transfer Default untuk Kompresi Gambar 8-bit Lossy JPEG - - 1.2.840.10008.1.2.4.50 jika instance disimpan sebagai HealthImaging 1.2.840.10008.1.2.4.50

    • Kompresi Gambar JPEG 2000 1.2.840.10008.1.2.4.91 - - jika instance disimpan HealthImaging sebagai 1.2.840.10008.1.2.4.91

    • Kompresi Gambar JPEG 2000 High-Throughput 1.2.840.10008.1.2.4.203 - - jika instance disimpan sebagai HealthImaging 1.2.840.10008.1.2.4.203

    • Contoh yang disimpan HealthImaging dengan satu atau lebih bingkai gambar yang dikodekan dalam keluarga MPEG Transfer Syntax (yang mencakup MPEG2, MPEG-4 AVC/H.264 and HEVC/H .265) dapat diambil dengan UID sintaks transfer yang sesuai. Misalnya, 1.2.840.10008.1.2.4.100 jika instance disimpan sebagai MPEG2 Main Profile Main Level.

    Lihat informasi yang lebih lengkap di Sintaks transfer yang didukung dan HTJ2K decoding library untuk AWS HealthImaging.