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

GetDICOMInstanceFrames アクションを使用して、リソースに関連付けられたシリーズ 、調査 UID、インスタンス UID、およびフレーム番号を指定してUIDs、 HealthImaging データストア内のDICOMインスタンスから単一またはバッチイメージフレーム (multipart リクエスト) を取得します。イメージセット ID をクエリパラメータとして指定することで、インスタンスフレームを取得するイメージセットを指定できます。さらに、転送構文を選択してイメージフレームデータを圧縮し、非圧縮 (ELE) または高スループット 2000 () JPEG をサポートできますHTJ2K。

注記

を使用するとGetDICOMInstanceFrames、 の HealthImagingクラウドネイティブアクション を活用しながら、DICOMパート 10 バイナリを利用するシステムと相互運用できます。

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

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

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

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

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

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

4. 、、datastoreId、、studyInstanceUID、および の値を使用してimageSetId、URLリクエストの seriesInstanceUID sopInstanceUIDを構築しますframeList。次の例のURLパス全体を表示するには、コピーボタンをスクロールします。URL は 形式です。

   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. リクエストを準備して送信します。 は Signature AWS Version 4 の署名プロトコルを含むHTTPGETリクエストGetDICOMInstanceFramesを使用します。次のコード例では、 curl コマンドラインツールを使用して、 からのmultipartレスポンスでイメージフレームを取得します 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'
   

   注記

   transfer-syntax UID はオプションで、含まれていない場合はデフォルトで明示的な VR リトルエンディアンになります。サポートされている転送構文は次のとおりです。

   • 明示的な VR リトルエンディアン (ELE) - 1.2.840.10008.1.2.1 (デフォルト）

   • RPCL オプションイメージ圧縮を使用したハイスループット JPEG2000 (ロスレスのみ) - 1.2.840.10008.1.2.4.202

     詳細については、「AWS 用の HTJ2K デコードライブラリ HealthImaging」を参照してください。