HealthImaging에서 DICOM 인스턴스 프레임 가져오기 - AWS HealthImaging

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

HealthImaging에서 DICOM 인스턴스 프레임 가져오기

GetDICOMInstanceFrames 작업을 사용하여 리소스와 연결된 시리즈 UID, 연구 UID, 인스턴스 UIDs 및 프레임 번호를 지정하여 HealthImaging 데이터 스토어의 DICOM 인스턴스에서 단일 또는 배치 이미지 프레임(multipart 요청)을 검색합니다. 이미지 세트 ID를 쿼리 파라미터로 제공하여 인스턴스 프레임을 검색할 이미지 세트를 지정할 수 있습니다. API는 선택적 이미지 세트 파라미터가 제공되지 않는 한 기본 이미지 세트의 인스턴스 프레임만 반환합니다. 를 쿼리 파라미터imageSetId로 지정하여 데이터 스토어의 모든 인스턴스 프레임(기본 또는 비기본 이미지 세트에서)을 검색할 수 있습니다.

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, 및 값을 사용하여 요청에 대한 URL을 구성합니다seriesInstanceUIDsopInstanceUIDimageSetIdframeList. 다음 예제에서 전체 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 (무손실 이미지 프레임의 기본값)

    • RPCL 옵션 이미지 압축을 사용하는 High-Throughput JPEG 2000(Lossless Only) 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 이미지 압축 - 인스턴스가 HealthImaging에 로 저장된 1.2.840.10008.1.2.4.91 경우 1.2.840.10008.1.2.4.91

    • High-Throughput JPEG 2000 Image Compression 1.2.840.10008.1.2.4.203 - 인스턴스가 HealthImaging에 로 저장된 경우 1.2.840.10008.1.2.4.203

    • 전송 구문의 MPEG 패밀리(MPEG2, MPEG-4 AVC/H.264 및 HEVC/H.265 포함)에 인코딩된 하나 이상의 이미지 프레임이 있는 HealthImaging에 저장된 인스턴스는 해당 전송 구문 UID로 검색할 수 있습니다. 예를 들어 인스턴스가 MPEG2 기본 프로필 기본 레벨로 저장된 1.2.840.10008.1.2.4.100 경우입니다.

    자세한 내용은 지원되는 전송 구문 및 AWS HealthImaging용 HTJ2K 디코딩 라이브러리 섹션을 참조하세요.