取得影像集像素資料

影像影格是存在於影像集中的像素資料，用於組成 2D 醫療影像。使用 GetImageFrame動作來擷取中指定影像集的 HTJ2K編碼影像影格 HealthImaging。影像集下列選單提供 AWS CLI 和的程式碼範例 AWS SDKs。如需詳細資訊，請參閱參考 GetImageFrame中的。 AWS HealthImaging API

注意

使用 GetImageFrame動作時，請記住下列幾點：

在匯入期間， HealthImaging 會保留某些傳輸語法的編碼，但依預設會將其他轉碼為無HTJ2K失真。因此，必須先解碼影像影格，才能在影像檢視器中檢視。如需詳細資訊，請參閱支援的傳輸語法和 HTJ2K 解碼程式庫。
根據預設， GetImageFrame動作會在執行個體的儲存傳輸語法中傳回映像影格。如需詳細資訊，請參閱支援的傳輸語法。
您也可以使用 HealthImagingGetDICOMInstanceFrames代表DICOMweb服務的，擷取DICOMweb相容檢視器和應用程式的DICOM執行個體影格（multipart 請求）。如需詳細資訊，請參閱從取得DICOM執行個體影格 HealthImaging。

若要取得影像集像素資料

根據您對的存取偏好設定選擇選單AWS HealthImaging。

注意

影像影格必須以程式設計方式存取和解碼，因為中無法使用影像檢視器 AWS Management Console。

如需解碼和檢視影像影格的詳細資訊，請參閱 HTJ2K 解碼程式庫。

C++

SDK 適用於 C++


//! Routine which downloads an AWS HealthImaging image frame.
/*!
  \param dataStoreID: The HealthImaging data store ID.
  \param imageSetID: The image set ID.
  \param frameID: The image frame ID.
  \param jphFile: File to store the downloaded frame.
  \param clientConfig: Aws client configuration.
  \return bool: Function succeeded.
*/
bool AwsDoc::Medical_Imaging::getImageFrame(const Aws::String &dataStoreID,
                                            const Aws::String &imageSetID,
                                            const Aws::String &frameID,
                                            const Aws::String &jphFile,
                                            const Aws::Client::ClientConfiguration &clientConfig) {
    Aws::MedicalImaging::MedicalImagingClient client(clientConfig);

    Aws::MedicalImaging::Model::GetImageFrameRequest request;
    request.SetDatastoreId(dataStoreID);
    request.SetImageSetId(imageSetID);

    Aws::MedicalImaging::Model::ImageFrameInformation imageFrameInformation;
    imageFrameInformation.SetImageFrameId(frameID);
    request.SetImageFrameInformation(imageFrameInformation);

    Aws::MedicalImaging::Model::GetImageFrameOutcome outcome = client.GetImageFrame(
            request);

    if (outcome.IsSuccess()) {
        std::cout << "Successfully retrieved image frame." << std::endl;
        auto &buffer = outcome.GetResult().GetImageFrameBlob();

        std::ofstream outfile(jphFile, std::ios::binary);
        outfile << buffer.rdbuf();
    }
    else {
        std::cout << "Error retrieving image frame." << outcome.GetError().GetMessage()
                  << std::endl;

    }

    return outcome.IsSuccess();
}

如需API詳細資訊，請參閱參考 GetImageFrame中的。 AWS SDK for C++ API

注意

還有更多。 GitHub尋找完整範例，並了解如何在 AWS 程式碼範例儲存庫中設定和執行。

CLI

AWS CLI

若要取得影像集像素資料

下列get-image-frame程式碼範例會取得影像影格。


aws medical-imaging get-image-frame \
    --datastore-id "12345678901234567890123456789012" \
    --image-set-id "98765412345612345678907890789012" \
    --image-frame-information imageFrameId=3abf5d5d7ae72f80a0ec81b2c0de3ef4 \
    imageframe.jph

注意：此程式碼範例不包含輸出，因為 GetImageFrame 動作會將像素資料串流傳回 imageframe.jph 檔案。如需有關解碼和檢視影像影格的資訊，請參閱HTJ2K解碼程式庫。

如需詳細資訊，請參閱 AWS HealthImaging 開發人員指南 中的取得映像集像素資料。

如需API詳細資訊，請參閱命令參考 GetImageFrame中的。 AWS CLI

Java

SDK 適用於 Java 2.x


        public static void getMedicalImageSetFrame(MedicalImagingClient medicalImagingClient,
                        String destinationPath,
                        String datastoreId,
                        String imagesetId,
                        String imageFrameId) {

                try {
                        GetImageFrameRequest getImageSetMetadataRequest = GetImageFrameRequest.builder()
                                        .datastoreId(datastoreId)
                                        .imageSetId(imagesetId)
                                        .imageFrameInformation(ImageFrameInformation.builder()
                                                        .imageFrameId(imageFrameId)
                                                        .build())
                                        .build();
                        medicalImagingClient.getImageFrame(getImageSetMetadataRequest,
                                        FileSystems.getDefault().getPath(destinationPath));

                        System.out.println("Image frame downloaded to " + destinationPath);
                } catch (MedicalImagingException e) {
                        System.err.println(e.awsErrorDetails().errorMessage());
                        System.exit(1);
                }
        }

如需API詳細資訊，請參閱參考 GetImageFrame中的。 AWS SDK for Java 2.x API

注意

還有更多。 GitHub尋找完整範例，並了解如何在 AWS 程式碼範例儲存庫中設定和執行。

JavaScript

SDK 適用於 JavaScript （v3）


import { GetImageFrameCommand } from "@aws-sdk/client-medical-imaging";
import { medicalImagingClient } from "../libs/medicalImagingClient.js";

/**
 * @param {string} imageFrameFileName - The name of the file for the HTJ2K-encoded image frame.
 * @param {string} datastoreID - The data store's ID.
 * @param {string} imageSetID - The image set's ID.
 * @param {string} imageFrameID - The image frame's ID.
 */
export const getImageFrame = async (
  imageFrameFileName = "image.jph",
  datastoreID = "DATASTORE_ID",
  imageSetID = "IMAGE_SET_ID",
  imageFrameID = "IMAGE_FRAME_ID",
) => {
  const response = await medicalImagingClient.send(
    new GetImageFrameCommand({
      datastoreId: datastoreID,
      imageSetId: imageSetID,
      imageFrameInformation: { imageFrameId: imageFrameID },
    }),
  );
  const buffer = await response.imageFrameBlob.transformToByteArray();
  writeFileSync(imageFrameFileName, buffer);

  console.log(response);
  // {
  //     '$metadata': {
  //         httpStatusCode: 200,
  //         requestId: 'e4ab42a5-25a3-4377-873f-374ecf4380e1',
  //         extendedRequestId: undefined,
  //         cfId: undefined,
  //         attempts: 1,
  //         totalRetryDelay: 0
  //     },
  //     contentType: 'application/octet-stream',
  //     imageFrameBlob: <ref *1> IncomingMessage {}
  // }
  return response;
};

如需API詳細資訊，請參閱參考 GetImageFrame中的。 AWS SDK for JavaScript API

注意

還有更多。 GitHub尋找完整範例，並了解如何在 AWS 程式碼範例儲存庫中設定和執行。

Python

SDK for Python （Boto3）


class MedicalImagingWrapper:
    def __init__(self, health_imaging_client):
        self.health_imaging_client = health_imaging_client


    def get_pixel_data(
        self, file_path_to_write, datastore_id, image_set_id, image_frame_id
    ):
        """
        Get an image frame's pixel data.

        :param file_path_to_write: The path to write the image frame's HTJ2K encoded pixel data.
        :param datastore_id: The ID of the data store.
        :param image_set_id: The ID of the image set.
        :param image_frame_id: The ID of the image frame.
        """
        try:
            image_frame = self.health_imaging_client.get_image_frame(
                datastoreId=datastore_id,
                imageSetId=image_set_id,
                imageFrameInformation={"imageFrameId": image_frame_id},
            )
            with open(file_path_to_write, "wb") as f:
                for chunk in image_frame["imageFrameBlob"].iter_chunks():
                    if chunk:
                        f.write(chunk)
        except ClientError as err:
            logger.error(
                "Couldn't get image frame. Here's why: %s: %s",
                err.response["Error"]["Code"],
                err.response["Error"]["Message"],
            )
            raise

下列程式碼會實例化 MedicalImagingWrapper 物件。


    client = boto3.client("medical-imaging")
    medical_imaging_wrapper = MedicalImagingWrapper(client)

如需API詳細資訊，請參閱 GetImageFrame 中的 AWS SDK for Python （Boto3） API參考 。

注意

還有更多。 GitHub尋找完整範例，並了解如何在 AWS 程式碼範例儲存庫中設定和執行。

可用性範例

找不到所需的內容嗎？使用此頁面底部的提供意見回饋連結請求程式碼範例。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

取得映像集中繼資料

修改影像集