이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Cloud Healthcare API를 디지털 병리학에 사용

이 페이지에서는 Cloud Healthcare API를 사용하여 디지털 병리학 전체 슬라이드 이미지 (WSI)를 저장, 액세스, 시각화, 사용하는 방법을 설명합니다.

개요

디지털 병리학은 디지털 워크플로 전반에서 기존 유리 슬라이드를 보관, 시각화, 평가할 수 있도록 지원하여 의료 영상 분야를 혁신하고 있습니다. 디지털 병리학은 다양한 이점을 제공합니다. 그중에서도 신속한 컨설테이션을 지원하고, 환자의 접근성과 이해도를 높이며, 최첨단 AI의 데이터 소스로 병리학 이미지를 활용하여 임상 및 연구 워크플로를 개선합니다.

전체 슬라이드 디지털 병리학은 이미지 모음으로 표현됩니다. 가장 큰 파일은 일반적으로 크기가 수 기가바이트입니다. DICOM은 디지털 병리학의 상호 운용 가능한 표준으로, 전체 슬라이드 이미지와 관련 메타데이터를 효율적으로 저장하고 전자 건강 기록 (예: FHIR)에 저장되며 성능이 우수하고 공급업체 중립적인 API를 통해 액세스됩니다.

디지털 병리학의 DICOM 표현은 기가픽셀 이미지에서 빠르게 이동하고 확대/축소할 수 있는 기능이 필요한 고성능 대화형 사용 사례를 지원하도록 설계되었습니다. DICOM은 전체 슬라이드 디지털 병리학을 이미지 피라미드로 나타냅니다. 피라미드의 수준은 전체 슬라이드 이미지의 배율에 해당합니다. 피라미드 수준 내에 표현된 이미지는 더 작은 이미지 프레임의 모음으로 저장됩니다. 이 표준은 이미지 저장, 검색 (사용 가능한 이미징 검색), 메타데이터 검색, 이미지 검색 전체 피라미드 수준 (확대) 또는 피라미드 수준 내 하위 영역 (프레임)을 선택할 수 있는 API를 정의합니다.

DICOM API는 JSON 및 XML의 메타데이터 응답을 지원하며, Cloud Healthcare API는 DICOM 메타데이터를 다른 데이터 소스와 결합하는 복잡한 관계형 쿼리를 지원하기 위해 BigQuery를 통한 메타데이터 액세스를 추가로 지원합니다. 이미지는 저장된 상태로 반환되거나 대체 형식으로 변환 (트랜스코딩)될 수 있습니다.

전체 슬라이드 DICOM 이미징 생성

점점 더 많은 디지털 병리학 슬라이드 스캐너가 슬라이드 스캐너에서 직접 DICOM 이미지를 생성하는 기능을 지원합니다. 대부분의 경우 슬라이드 스캐너에서 생성된 DICOM은 DICOMweb 또는 DIMSE DICOM API를 사용하여 Cloud Healthcare API로 직접 수집할 수 있습니다. DICOM을 생성하는 슬라이드 스캐너가 실험실 정보 시스템 (LIS)에 연결되어 있지 않으면 DICOM의 비픽셀 메타데이터를 보강하여 (예: 환자)를 추가하거나 (예: 임상 영상 PACS 내에서 사용하기 전에 Study Instance UID) 메타데이터를 익명화해야 합니다.

이전에는 슬라이드 스캐너가 독점 형식으로 이미지를 생성했습니다. 변환 파이프라인을 사용하여 OpenSlide 지원 형식을 DICOM으로 변환하고, 생성된 DICOM과 맞춤 메타데이터를 병합하고, 생성된 DICOM을 Cloud Healthcare API에 직접 수집할 수 있습니다. 이 솔루션은 멀티 페타바이트 보관 파일을 DICOM으로 변환하는 데 사용되었습니다.

디지털 병리학 이미지를 DICOM으로 변환하는 데 사용할 수 있는 도구는 다음과 같습니다.

DICOM 인스턴스는 DICOMweb, DIMSE, Cloud Storage를 사용하여 프로그래매틱 방식으로 Cloud Healthcare API로 가져올 수 있습니다.

이미지 스토리지 티어링

Cloud Healthcare API는 DICOM 인스턴스 단위로 스토리지 티어링을 지원합니다. 전체 슬라이드 이미징의 경우 디지털 병리 이미지 피라미드의 각 배율을 예상 사용에 가장 적합한 계층에 저장할 수 있습니다. DICOM 인스턴스의 스토리지 등급은 데이터 저장, 검색, 경우에 따라 삭제 비용에 영향을 미칩니다. 스토리지 계층화는 데이터 액세스 성능에 영향을 미치지 않습니다. 기본적으로 모든 DICOM 인스턴스는 Standard Storage 등급에 저장됩니다. Cloud Healthcare API는 DICOM 인스턴스의 스토리지 클래스를 보고 변경할 수 있는 API를 제공합니다. 또한 이미지 수명 주기 관리 (ILM) 솔루션을 사용하여 휴리스틱을 기반으로 스토리지 계층 간 DICOM 인스턴스 이동을 자동화할 수 있습니다. 이 솔루션은 크기, 기간, 액세스 패턴에 따라 스토리지 계층을 통해 DICOM 인스턴스의 졸업을 자동화할 수 있습니다.

참고: 아카이브 스토리지를 사용하면 픽셀 데이터 검색 비용이 증가합니다. 데이터 검색 요금은 저장된 데이터 크기가 아닌 검색된 데이터 크기에 대해 지불됩니다. 전체 슬라이드 이미지의 경우 프레임 및 인스턴스 수준 API를 모두 사용하여 픽셀 데이터를 가져올 수 있으므로 이는 중요한 구분입니다. 프레임 API를 사용하여 보관 이미지를 검색하는 것은 특히 인스턴스의 프레임 하위 집합이 필요한 경우 비용 측면에서 유리합니다. 데이터 검색 요금은 저장된 인스턴스의 크기가 아닌 반환된 데이터의 크기를 기준으로 부과되기 때문입니다.

대화형 시각화

Cloud Healthcare API는 제로 풋프린트 웹 뷰어 (JavaScript)부터 독립형 클라이언트 애플리케이션에 이르기까지 다양한 애플리케이션에서 전체 슬라이드 이미징의 대화형 시각화를 지원하는 데 사용할 수 있습니다. 다음 오픈소스 뷰어는 Cloud Healthcare API와 호환되는 것으로 테스트되었습니다.

오픈소스 Google 뷰어: Google Research에서 만든 오픈소스 제로 풋프린트 디지털 병리 뷰어입니다.
Slim (MGH): NIH Imaging Data Commons를 지원하는 오픈소스 제로 풋프린트 디지털 병리 뷰어입니다.
OHIF
QuPath: 오픈 소스 데스크톱 애플리케이션입니다.

대화형 시각화 성능 개선

디지털 병리학 DICOM 프록시는 대화형 전체 슬라이드 이미징 애플리케이션의 프레임 제공 성능을 개선하는 데 사용할 수 있는 Google Research 솔루션입니다. 배포되면 디지털 병리학 DICOM 프록시는 Cloud Healthcare API를 래핑하고 메모리 내 Memorystore for Redis 캐시에서 프레임 이미지를 우선적으로 제공하기 위해 적시 프레임 캐싱을 실행합니다.

전체 슬라이드 이미지 색상 정규화

DICOM 표준에 따라 WSI에는 이미지를 획득한 슬라이드 스캐너의 색상 공간을 정의하는 ICC 색상 프로필이 포함되어야 합니다. 이 색상 공간은 디스플레이나 다른 슬라이드 스캐너에서 사용하는 색상 공간과 눈에 띄게 다를 수 있습니다. 삽입된 ICC 프로필 없이 시각화하면 이미지의 색상이 예상보다 훨씬 더 채도가 높거나 낮게 표시되는 경우가 많습니다. Cloud Healthcare API는 DICOM 인스턴스에 삽입된 ICC 프로필을 검색하고 검색된 이미지를 참조 색상 공간으로 변환하는 API를 제공합니다.

대량 데이터 API 또는 인스턴스 검색 API를 사용하여 DICOM 인스턴스에 삽입된 ICC 프로필을 검색할 수 있습니다. 그런 다음 Little-CMS(C++로 작성) 및 Pillow (Python으로 작성)와 같은 라이브러리를 사용하여 슬라이드 스캐너 색상 공간에서 가져온 이미지를 변환할 수 있습니다.
EZ-WSI DICOMweb Python 라이브러리는 이미지 검색 및 머신러닝 삽입 생성 API의 일부로 ICC 프로필 변환을 지원합니다.

머신러닝

Path Foundation은 디지털 병리학에서 머신러닝 (ML) 개발을 가속화하기 위해 Google Research에서 개발한 파운데이션 모델입니다.

모델은 병리학 이미징의 패치 (하위 영역)를 부동 소수점 숫자 목록인 임베딩으로 변환합니다. 이 임베딩은 머신러닝을 통해 학습된 이미지 표현으로 사용됩니다. 이미지 임베딩을 입력 데이터로 사용하면 효과적인 ML 모델을 개발하는 데 필요한 총 데이터 양과 컴퓨팅 리소스를 줄일 수 있습니다.

Model Garden에서 Google Cloud Path Foundation을 배포할 수 있습니다. Hugging Face에서 오픈 가중치와 함께 오픈소스로도 제공됩니다.

EZ-WSI DICOMweb 오픈소스 Python 라이브러리에는 삽입 생성에 도움이 되는 인터페이스 (병리학 삽입 생성 Colab 노트북 시작 가이드 참고)가 포함되어 있어 Cloud Healthcare API에 저장된 이미지를 삽입으로 쉽게 변환할 수 있습니다. EZ-WSI DICOMweb 및 Pathology Foundations를 사용하여 전체 슬라이드 DICOM 이미징에서 선형 분류기를 학습하는 방법은 DICOM Colab 노트북에 저장된 이미지에서 디지털 병리학 선형 분류기 학습을 참고하세요.

프로그래매틱 방식으로 메타데이터 및 픽셀 이미지 가져오기

이 섹션에서는 Cloud Healthcare API에서 디지털 병리학 메타데이터와 이미지를 가져오는 방법을 설명합니다.

DICOM 정보 모델

DICOM은 세 가지 고유 식별자 (UID)를 사용하여 이미지를 고유하게 식별합니다.

학습 인스턴스 UID: 단일 환자 검사에서 획득하거나 생성된 모든 이미지를 식별합니다.
시리즈 인스턴스 UID: 해당 검사 내에서 각 의료 영상 획득을 식별합니다 (예: 병리학 슬라이드의 고유한 스캔).
SOP 인스턴스 UID: 획득의 일부로 획득하거나 생성된 각 이미지를 식별합니다.

예를 들어 슬라이드 스캐너는 완전한 유리 슬라이드를 캡처하기 위해 여러 이미지를 생성하는 경우가 많습니다. 이러한 이미지에는 다음이 포함될 수 있습니다.

다양한 배율로 촬영된 조직 영역입니다.
슬라이드 라벨입니다.
전체 슬라이드의 이미지입니다.
슬라이드 스캔 작업을 설명하는 데이터입니다.

디지털 병리학 DICOM 시리즈 나열

슬라이드 현미경 이미지를 식별하려면 Modality 태그 (0008,0060)가 SM인 DICOM 시리즈를 검색합니다. 이 검색에는 dicomStores.searchForSeries 메서드를 사용할 수 있습니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
LOCATION: 데이터 세트 위치
DATASET_ID: DICOM 저장소의 상위 데이터 세트
DICOM_STORE_ID: DICOM 저장소 ID

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/series?Modality=SM"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/series?Modality=SM" | Select-Object -Expand Content

API 탐색기

메서드 참조 페이지를 엽니다. 페이지 오른쪽에 API 탐색기 패널이 열립니다. 이 도구를 사용하여 요청을 보낼 수 있습니다. 모든 필수 필드를 입력하고 실행을 클릭합니다.

다음과 비슷한 JSON 응답이 표시됩니다.

응답

[
  {
    "00080005": {
      "vr": "CS",
      "Value": [
        "SPECIFIC_CHARACTER_SET"
      ]
    },
    "00080020": {
      "vr": "DA",
      "Value": [
        "STUDY_DATE"
      ]
    },
    "00080030": {
      "vr": "TM"
    },
    "00080050": {
      "vr": "SH",
      "Value": [
        "ACCESSION_NUMBER"
      ]
    },
    "00080060": {
      "vr": "CS",
      "Value": [
          "SM"
      ]
    },
    "00080090": {
      "vr": "PN"
    },
    "00100010": {
      "vr": "PN"
    },
    "00100020": {
      "vr": "LO",
      "Value": [
        "PATIENT_ID"
      ]
    },
    "00100030": {
      "vr": "DA"
    },
    "00100040": {
      "vr": "CS"
    },
    "0020000D": {
      "vr": "UI",
      "Value": [
        "STUDY_INSTANCE_UID"
      ]
    },
    "0020000E": {
      "vr": "UI",
      "Value": [
      "SERIES_INSTANCE_UID"
      ]
    },
    "00200010": {
      "vr": "SH"
    }
  }
]

디지털 병리학 DICOM 메타데이터 가져오기

전체 슬라이드 이미징을 위한 DICOM 시리즈에는 일반적으로 여러 인스턴스가 포함됩니다. 이러한 DICOM 인스턴스는 이미지 피라미드의 다양한 수준 또는 이미지가 촬영된 슬라이드의 추가 영역을 나타낼 수 있습니다.

연구에서 인스턴스의 인스턴스 메타데이터를 보려면 dicomStores.searchForInstances 메서드를 호출합니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
LOCATION: 데이터 세트 위치
DATASET_ID: DICOM 저장소의 상위 데이터 세트
DICOM_STORE_ID: DICOM 저장소 ID
STUDY_INSTANCE_UID: 연구 인스턴스 고유 식별자(UID)

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/instances?StudyInstanceUID=STUDY_INSTANCE_UID"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/instances?StudyInstanceUID=STUDY_INSTANCE_UID" | Select-Object -Expand Content

API 탐색기

다음과 비슷한 JSON 응답이 표시됩니다.

응답

[
  {
    "00080005": {
      "vr": "CS",
      "Value": [
        "SPECIFIC_CHARACTER_SET"
      ]
    },
    "00080016": {
      "vr": "UI",
      "Value": [
        "SOP_CLASS_UID"
      ]
    },
    "00080018": {
      "vr": "UI",
      "Value": [
        "SOP_INSTANCE_UID"
      ]
    },
    "00080020": {
      "vr": "DA",
      "Value": [
        "STUDY_DATE"
      ]
    },
    "00080030": {
      "vr": "TM"
    },
    "00080050": {
      "vr": "SH",
      "Value": [
        "ACCESSION_NUMBER"
      ]
    },
    "00080060": {
      "vr": "CS",
      "Value": [
        "MODALITY"
      ]
    },
    "00080090": {
      "vr": "PN"
    },
    "00100010": {
      "vr": "PN"
    },
    "00100020": {
      "vr": "LO",
      "Value": [
        "PATIENT_ID"
      ]
    },
    "00100030": {
      "vr": "DA"
    },
    "00100040": {
      "vr": "CS"
    },
    "0020000D": {
      "vr": "UI",
      "Value": [
        "STUDY_INSTANCE_UID"
      ]
    },
    "0020000E": {
      "vr": "UI",
      "Value": [
        "SERIES_INSTANCE_UID"
      ]
    },
    "00200010": {
      "vr": "SH"
    },
    "00200013": {
      "vr": "IS",
      "Value": [
        INSTANCE_NUMBER
      ]
    },
    "00280010": {
      "vr": "US",
      "Value": [
        ROWS
      ]
    },
    "00280011": {
      "vr": "US",
      "Value": [
        COLUMNS
      ]
    },
    "00280100": {
      "vr": "US",
      "Value": [
        BITS_ALLOCATED
      ]
    },
    "00400244": {
      "vr": "DA",
      "Value": [
        "PERFORMED_PROCEDURE_STEP_START_DATE"
      ]
    }
  },
...
]

전체 슬라이드 이미지 픽셀 데이터 가져오기

DICOMweb을 사용하여 전체 슬라이드 영상 픽셀 데이터를 프로그래매틱 방식으로 가져올 수 있습니다. Cloud Healthcare API는 DIMSE 프로토콜을 사용하는 DICOM 어댑터를 통한 검색도 지원합니다.

대부분의 전체 슬라이드 이미지는 멀티프레임 이미지입니다. 이러한 경우 Cloud Healthcare API는 DICOM 프레임 및 렌더링된 프레임 API를 사용하여 픽셀 데이터에 직접 액세스할 수 있도록 지원합니다.

또는 전체 DICOM 인스턴스를 가져온 다음 해당 인스턴스에서 인코딩된 프레임을 프로그래매틱 방식으로 디코딩하여 픽셀 데이터를 간접적으로 가져올 수 있습니다.

프레임 검색 시 성능 고려사항:

전체 인스턴스를 가져오는 것이 일반적으로 일괄 프레임 가져오기보다 프레임당 빠릅니다.
일반적으로 일괄 프레임 검색이 개별 프레임 검색보다 빠릅니다.

EZ-WSI DICOMweb

EZ-WSI DICOMweb은 오픈소스 Python 라이브러리입니다. 기본 DICOMweb 호출을 추상화하여 Cloud Healthcare API에서 디지털 병리학 픽셀 데이터를 쉽게 가져올 수 있습니다. 이 라이브러리는 직렬 이미지 요청을 일괄 요청으로 변환하여 많은 사용 사례에서 프레임 검색을 가속화할 수 있습니다. 프레임 데이터를 일괄적으로 가져오면 필요한 총 시간과 DICOM 저장소 할당량이 줄어드는 경우가 많습니다.

라이브러리를 보여주는 Colab 노트북을 사용할 수 있습니다.

DICOMweb 인스턴스 검색 API

DICOMweb 인스턴스 검색 API는 바이너리 DICOM 인스턴스를 반환합니다. 이 인스턴스에는 인스턴스 내에 저장된 모든 메타데이터와 픽셀 데이터가 포함됩니다.

다음과 같은 다양한 라이브러리를 사용하여 반환된 바이너리 데이터를 디코딩할 수 있습니다.

PyDicom (Python)
Dcm4che (Java)
libdicom (C)
DCMTK (C/C++)
OpenSlide (Python/C)

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
LOCATION: 데이터 세트 위치
DATASET_ID: DICOM 저장소의 상위 데이터 세트
DICOM_STORE_ID: DICOM 저장소 ID
STUDY_INSTANCE_UID: 연구 인스턴스 고유 식별자
SERIES_INSTANCE_UID: 시리즈 인스턴스 고유 식별자
INSTANCE_UID: 인스턴스 고유 식별자
OUTPUT_FILE: DICOM 인스턴스를 쓸 파일입니다.

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Accept: application/dicom" \
     --output OUTPUT_FILE \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "Accept" = "application/dicom" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile OUTPUT_FILE `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID"

API 탐색기

OUTPUT_FILE 파일에 콘텐츠가 채워져야 합니다.

DICOMweb 프레임 API

DICOMweb 프레임 API를 사용하면 DICOM 인스턴스에서 하나 이상의 프레임을 검색할 수 있습니다. API를 사용하여 검색된 Pixel 데이터는 DICOM 저장소에 기본적으로 저장된 형식 이외의 형식으로 트랜스코딩되도록 요청될 수 있습니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
LOCATION: 데이터 세트 위치
DATASET_ID: DICOM 저장소의 상위 데이터 세트
DICOM_STORE_ID: DICOM 저장소 ID
STUDY_INSTANCE_UID: 연구 인스턴스 고유 식별자
SERIES_INSTANCE_UID: 시리즈 인스턴스 고유 식별자
INSTANCE_UID: 인스턴스 고유 식별자
FRAMES: 픽셀 데이터를 가져올 프레임 번호

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Accept: multipart/related; type="image/jpeg"; transfer-syntax=1.2.840.10008.1.2.4.50" \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/frames/FRAMES"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "Accept" = "multipart/related; type="image/jpeg"; transfer-syntax=1.2.840.10008.1.2.4.50" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/frames/FRAMES" | Select-Object -Expand Content

API 탐색기

요청된 이미지를 인코딩하는 멀티파트 응답이 수신됩니다.

DICOMweb 렌더링된 프레임 API

DICOMweb 렌더링된 프레임 API를 사용하면 프레임을 표준 이미지 형식 (예: JPEG 및 PNG)

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
LOCATION: 데이터 세트 위치
DATASET_ID: DICOM 저장소의 상위 데이터 세트
DICOM_STORE_ID: DICOM 저장소 ID
STUDY_INSTANCE_UID: 연구 인스턴스 고유 식별자
SERIES_INSTANCE_UID: 시리즈 인스턴스 고유 식별자
INSTANCE_UID: 인스턴스 고유 식별자
FRAME: 픽셀 데이터를 가져올 프레임 번호

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Accept: image/png" \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/frames/FRAME/rendered"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "Accept" = "image/png" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/frames/FRAME/rendered" | Select-Object -Expand Content

API 탐색기

요청된 이미지를 인코딩하는 바이너리 응답이 표시됩니다.

대량 데이터 가져오기를 사용하여 DICOM 인스턴스 내에 삽입된 ICC 프로필 가져오기

DICOMweb retrieve bulkdata를 사용하여 DICOM 인스턴스 내에 삽입된 ICC (International Color Consortium) 프로필 바이트를 직접 검색할 수 있습니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
LOCATION: 데이터 세트 위치
DATASET_ID: DICOM 저장소의 상위 데이터 세트
DICOM_STORE_ID: DICOM 저장소 ID
STUDY_INSTANCE_UID: 연구 인스턴스 고유 식별자
SERIES_INSTANCE_UID: 시리즈 인스턴스 고유 식별자
INSTANCE_UID: 인스턴스 고유 식별자
OUTPUT_FILE: icc 프로필 인스턴스를 쓸 파일입니다.

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Accept: application/octet-stream; transfer-syntax=*" \
     --output OUTPUT_FILE \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/bulkdata/00480105/0/00282000"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "Accept" = "application/octet-stream; transfer-syntax=*" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile OUTPUT_FILE `
    -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID/bulkdata/00480105/0/00282000"

API 탐색기

OUTPUT_FILE 파일에 콘텐츠가 채워져야 합니다.

Cloud Healthcare API를 디지털 병리학에 사용 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

개요

전체 슬라이드 DICOM 이미징 생성

이미지 스토리지 티어링

대화형 시각화

대화형 시각화 성능 개선

전체 슬라이드 이미지 색상 정규화

머신러닝

프로그래매틱 방식으로 메타데이터 및 픽셀 이미지 가져오기

DICOM 정보 모델

디지털 병리학 DICOM 시리즈 나열

REST

curl

PowerShell

API 탐색기

응답

디지털 병리학 DICOM 메타데이터 가져오기

REST

curl

PowerShell

API 탐색기

응답

전체 슬라이드 이미지 픽셀 데이터 가져오기

EZ-WSI DICOMweb

DICOMweb 인스턴스 검색 API

REST

curl

PowerShell

API 탐색기

DICOMweb 프레임 API

REST

curl

PowerShell

API 탐색기

DICOMweb 렌더링된 프레임 API

REST

curl

PowerShell

API 탐색기

대량 데이터 가져오기를 사용하여 DICOM 인스턴스 내에 삽입된 ICC 프로필 가져오기

REST

curl

PowerShell

API 탐색기

Cloud Healthcare API를 디지털 병리학에 사용