從 HealthImaging 取得 DICOM 執行個體影格 - AWS HealthImaging

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

從 HealthImaging 取得 DICOM 執行個體影格

使用 GetDICOMInstanceFrames動作，透過指定與資源相關聯的系列 UID、研究 UID、執行個體 UID 和影格編號，從 HealthImaging 資料存放區中的 DICOM 執行個體擷取單一或批次影像影格 UIDs (multipart 請求）。您可以透過提供映像集 ID 做為查詢參數，來指定應從中擷取執行個體影格的影像集。DICOM 資料可以以其儲存的傳輸語法或未壓縮 (ELE) 格式擷取。

取得 DICOM 執行個體影格 (multipart)

  1. 收集 HealthImaging datastoreId和imageSetId參數值。

  2. 使用 GetImageSetMetadata動作搭配 datastoreId和 imageSetId 參數值，擷取 studyInstanceUID、 seriesInstanceUID和 的相關聯中繼資料值sopInstanceUID。如需詳細資訊，請參閱取得映像集中繼資料。

  3. 決定要從相關聯中繼資料擷取的影像影格，以形成 frameList 參數。frameList 參數是一或多個非重複影格編號的逗號分隔清單，依任何順序排列。例如，中繼資料中的第一個影像影格將是影格 1。

    • 單一影格請求： /frames/1

    • 多影格請求： /frames/1,2,3,4

  4. 使用 datastoreId、、studyInstanceUID、、 seriesInstanceUID sopInstanceUIDimageSetId和 的值來建構請求的 URLframeList。若要在下列範例中檢視整個 URL 路徑，請捲動至複製按鈕。URL 的格式如下：

    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. 準備並傳送您的請求。 GetDICOMInstanceFrames使用 HTTP GET 請求搭配 AWS Signature 第 4 版簽署通訊協定。下列程式碼範例使用curl命令列工具，從 HealthImaging 取得multipart回應中的影像影格。

    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'
    注意

    transfer-syntax UID 是選用的，如果未包含，則預設為明確 VR Little Endian。支援的傳輸語法包括：

    • 明確 VR Little Endian (ELE) - 1.2.840.10008.1.2.1（預設）

    • 具有 RPCL 選項影像壓縮的高輸送量 JPEG 2000 （僅限無損） 1.2.840.10008.1.2.4.202 - - 如果執行個體存放在 HealthImaging 中 1.2.840.10008.1.2.4.202

    • JPEG 基準 （程序 1)：失真 JPEG 8 位元影像壓縮的預設傳輸語法 1.2.840.10008.1.2.4.50 - - 如果執行個體存放在 HealthImaging 中 1.2.840.10008.1.2.4.50

    • JPEG 2000 Image Compression - 1.2.840.10008.1.2.4.91 - 如果執行個體存放在 HealthImaging 中 1.2.840.10008.1.2.4.91

    • 高輸送量 JPEG 2000 影像壓縮 - 1.2.840.10008.1.2.4.203 - 如果執行個體存放在 HealthImaging 中 1.2.840.10008.1.2.4.203

    如需詳細資訊，請參閱 支援的傳輸語法 和 HTJ2K 解碼 的程式庫 AWS HealthImaging。