HealthImaging からの DICOM インスタンスフレームの取得 - AWS HealthImaging

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

HealthImaging からの DICOM インスタンスフレームの取得

GetDICOMInstanceFrames アクションを使用して、HealthImaging データストアの DICOM インスタンスから単一またはバッチイメージフレーム (multipart リクエスト) を取得するには、リソースに関連付けられたシリーズ UID、治験 UID、インスタンス UIDs、フレーム番号を指定します。イメージセット ID をクエリパラメータとして指定することで、インスタンスフレームを取得するイメージセットを指定できます。API は、オプションのイメージセットパラメータが指定されていない限り、プライマリイメージセットからのインスタンスフレームのみを返します。をクエリパラメータimageSetIdとして指定することで、データストア内の任意のインスタンスフレーム (プライマリまたは非プライマリイメージセットから) を取得できます。

DICOM データは、保存された転送構文または非圧縮 (ELE) 形式で取得できます。

DICOM インスタンスフレームを取得するには (multipart）

  1. HealthImaging datastoreIdとimageSetIdパラメータ値を収集します。

  2. GetImageSetMetadata アクションを datastoreIdおよび imageSetIdパラメータ値とともに使用して、studyInstanceUID、、seriesInstanceUIDおよび の関連するメタデータ値を取得しますsopInstanceUID。詳細については、「画像セットメタデータの取得」を参照してください。

  3. 関連するメタデータから取得するイメージフレームを決定して、 frameListパラメータを形成します。frameList パラメータは、任意の順序で 1 つ以上の重複しないフレーム番号のカンマ区切りリストです。たとえば、メタデータの最初のイメージフレームはフレーム 1 になります。

    • 単一フレームリクエスト: /frames/1

    • マルチフレームリクエスト: /frames/1,2,3,4

  4. 、datastoreId、、studyInstanceUID、seriesInstanceUID、および の値を使用してimageSetId、リクエストの URL sopInstanceUIDを作成しますframeList。次の例の 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. リクエストを準備して送信します。 は署名AWS バージョン 4 の署名プロトコルで HTTP GET リクエストGetDICOMInstanceFramesを使用します。次のコード例では、 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 はオプションで、含まれていない場合はデフォルトで Explicit VR Little Endian になります。サポートされている転送構文は次のとおりです。

    • 明示的な VR リトルエンディアン (ELE) - 1.2.840.10008.1.2.1 (可逆画像フレームのデフォルト）

    • 高スループット JPEG 2000 with RPCL Options Image Compression (Lossless Only) - 1.2.840.10008.1.2.4.202 - インスタンスが HealthImaging に次のように保存されている場合 1.2.840.10008.1.2.4.202

    • JPEG 2000 可逆 - 1.2.840.10008.1.2.4.90 - インスタンスが可逆として HealthImaging に保存されている場合。

    • JPEG ベースライン (プロセス 1): 損失 JPEG 8 ビットイメージ圧縮のデフォルト転送構文 - - 1.2.840.10008.1.2.4.50 インスタンスが HealthImaging に として保存されている場合 1.2.840.10008.1.2.4.50

    • JPEG 2000 イメージ圧縮 - 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

    • HealthImaging に保存されているインスタンスは、転送構文の MPEG ファミリー (MPEG2, MPEG-4 AVC/H.264、HEVC/H.265 を含む) でエンコードされた 1 つ以上のイメージフレームを使用して、対応する転送構文 UID で取得できます。たとえば、インスタンスが MPEG2 Main Profile Main Level として保存1.2.840.10008.1.2.4.100されている場合です。

    詳細については、「サポートされる転送構文」および「AWS HealthImagingの HTJ2K デコーディングライブラリ」を参照してください。