View a markdown version of this page

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

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

HealthImaging에서 DICOM 인스턴스 가져오기

GetDICOMInstance 작업을 사용하여 리소스와 연결된 시리즈, 연구 및 인스턴스 UIDs를 지정하여 HealthImaging 데이터 스토어에서 DICOM 인스턴스(.dcm 파일)를 검색합니다. API는 선택적 이미지 세트 파라미터가 제공되지 않는 한 기본 이미지 세트의 인스턴스만 반환합니다. 를 쿼리 파라미터imageSetId로 지정하여 데이터 스토어의 모든 인스턴스(기본 또는 비기본 이미지 세트에서)를 검색할 수 있습니다. DICOM 데이터는 저장된 전송 구문 또는 비압축(ELE) 형식으로 검색할 수 있습니다.

DICOM 인스턴스를 가져오려면(.dcm)

  1. HealthImaging datastoreId 및 imageSetId 파라미터 값을 수집합니다.

  2. GetImageSetMetadata 작업을 datastoreId 및 imageSetId 파라미터 값과 함께 사용하여 studyInstanceUID, seriesInstanceUID및에 연결된 메타데이터 값을 검색합니다sopInstanceUID. 자세한 내용은 이미지 세트 메타데이터 가져오기 단원을 참조하십시오.

  3. , datastoreId, studyInstanceUID, 및 값을 사용하여 요청에 대한 URL을 구성합니다seriesInstanceUIDsopInstanceUIDimageSetId. 다음 예제에서 전체 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?imageSetId=image-set-id

  4. 요청을 준비하고 전송합니다.는 AWS 서명 버전 4 서명 프로토콜과 함께 HTTP GET 요청을 GetDICOMInstance 사용합니다. 다음 코드 예제에서는 curl 명령줄 도구를 사용하여 HealthImaging에서 DICOM 인스턴스(.dcm 파일)를 가져옵니다.

    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?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: application/dicom; transfer-syntax=1.2.840.10008.1.2.1' \
  --output 'dicom-instance.dcm'
    참고

    transfer-syntax UID는 선택 사항이며 포함되지 않은 경우 기본적으로 Explicit VR Little Endian으로 설정됩니다. 지원되는 전송 구문은 다음과 같습니다.

    • 명시적 VR 리틀 엔디안(ELE) - 1.2.840.10008.1.2.1 (무손실 이미지 프레임의 기본값)

    • 이 transfer-syntax=* 경우 이미지 프레임(들)이 저장된 전송 구문으로 반환됩니다.

    • 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 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

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

    • JPEG XL 이미지 압축 - 인스턴스가 HealthImaging에 로 저장된 1.2.840.10008.1.2.4.112 경우 1.2.840.10008.1.2.4.112

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

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